核心用法
Snapmaker 2.0 Skill 基于官方 HTTP API v1，提供完整的 3D 打印机远程控制能力。用户需配置 IP 地址和 API Token（从 Luban 应用获取），即可通过命令行完成状态查询、文件传输、打印启停等操作。支持 UDP 广播自动发现打印机，或指定 IP 跨子网探测。
主要命令包括：
- 状态监控：
status获取实时温度、进度、坐标、耗材状态等完整信息 - 进度追踪：
watch每 5 秒自动刷新打印进度 - 任务管理：
send上传 G-code，start/pause/resume/stop控制打印流程 - 事件检测：通过轮询识别打印完成、断料、舱门开启等状态
显著优点
1. 原生 API 支持：直接调用官方端点，非逆向工程，协议稳定可靠
2. 安全机制完善：所有破坏性操作强制确认，--yes 显式豁免；活跃打印保护防止误操作
3. 实时性良好：HTTP 长连接会话持久化，状态查询延迟低
4. 输出灵活：支持纯文本和 JSON 格式，便于脚本集成与自动化
5. 发现机制健全：UDP 广播 + HTTP 探测双模式，适配不同网络环境
潜在缺点与局限性
1. 依赖单一：必须保持与打印机的网络连通，无离线/本地缓存能力
2. Token 管理繁琐：API Token 需通过 Luban 应用手动获取，无 OAuth 等现代认证流程
3. 无推送机制：事件检测依赖主动轮询（如 watch 或自定义循环），非 WebSocket 实时推送
4. 文件传输限制：仅支持 G-code 上传，无切片功能；大文件传输受网络稳定性影响
5. 版本锁定：明确针对 Snapmaker 2.0，不保证兼容 Artisan 或其他机型
适合人群
- 拥有 Snapmaker 2.0 打印机、需远程监控或自动化打印流程的用户
- 希望通过脚本集成打印任务到 CI/CD 或工作流的技术爱好者
- 多机管理的创客空间或小型工作室管理员
常规风险
- 网络暴露风险：HTTP 明文传输 + 固定 Token，若打印机暴露于公网易被未授权访问
- 误操作风险：
--force标志可绕过安全保护，可能导致打印失败或硬件损伤 - Token 泄露：配置文件明文存储 Token，需确保文件权限控制（建议 600）
- 中断恢复：打印中断后无自动断点续传机制，需人工干预