核心用法
该skill为Snapmaker 2.0 3D打印机提供完整的HTTP API封装，支持Python脚本调用。核心功能包括：
状态监控：实时获取打印机的温度（喷嘴/热床）、打印进度（0.0-1.0）、G-code行数进度、剩余时间、当前坐标位置、耗材状态、舱门状态等完整运行数据。
任务管理：支持文件上传（prepare）、立即启动（--start）、暂停、恢复、停止/取消打印任务。所有破坏性操作默认需要确认，可通过--yes跳过。
实时监控：watch命令提供每5秒自动刷新的进度追踪，结合--json输出可配合jq进行自动化处理，如温度监控、剩余时间计算、打印完成检测等。
配置需手动设置IP地址和token（从Luban软件的machine.json提取），运行于本地网络环境。
显著优点
1. 完整功能覆盖：涵盖官方API v1全部核心端点，从连接管理到文件传输、打印控制形成闭环
2. 安全性设计：内置多重保护——活动打印期间禁止发送新文件、所有状态变更需确认、强制覆盖需--force显式声明
3. 自动化友好：JSON输出格式便于脚本集成，watch模式支持轮询监控，适合CI/CD打印流程
4. 跨平台兼容：Python 3.6+单依赖（requests），配置文件路径遵循XDG规范
5. 社区驱动：基于官方论坛披露的非公开API文档实现，持续跟进用户实际需求
潜在缺点与局限性
- 私有API风险：依赖Snapmaker未正式文档化的HTTP API，固件更新可能导致兼容性问题
- 网络依赖：仅限局域网使用，无云连接能力，IP/token需手动维护
- 无加密传输：API通信为明文HTTP，存在局域网嗅探风险（敏感程度取决于网络环境）
- 功能边界：不支持切片（slicing），仅控制已准备的G-code文件；无摄像头监控集成
- 维护状态：v1.0.0版本，作者个人项目，长期更新保障存疑
适合人群
- 拥有Snapmaker 2.0且希望自动化打印流程的技术用户
- 需要将3D打印集成到现有工作流（如版本控制触发自动打印）的开发者
- 偏好命令行/脚本控制而非图形界面Luban的高级用户
- 构建打印农场（print farm）监控系统的管理员
常规风险
| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| 设备损坏 | 强制中断打印或温度控制异常可能导致堵头/热床损伤 | 严格使用确认机制，避免`--force` |
| 数据泄露 | token明文存储于config.json，HTTP传输无加密 | 限制skill运行环境访问权限，隔离IoT网络 |
| 服务中断 | API变动导致skill失效 | 关注论坛API更新帖，保留Luban作为备用 |
| 物理安全 | 远程启动打印无人看管存在火灾风险 | 配置enclosure门检测，避免无人值守 |