概述
Snapmaker 2.0 Skill 是一款专为 Snapmaker 2.0 系列3D打印机设计的开源控制工具，通过官方HTTP API实现远程管理。该工具支持实时状态监控、打印任务管理、进度追踪及事件通知，为创客和自动化工作流提供命令行操作能力。
核心用法
配置准备：在 ~/clawd/snapmaker/config.json 中配置打印机IP、Token和端口（默认8080）。Token需从Snapmaker Luban应用获取。
设备发现：python3 scripts/snapmaker.py discover 通过UDP广播（端口20054）自动发现局域网内设备，或指定IP探测。
状态监控：status 获取完整状态（温度、进度、位置、耗材状态），watch 提供5秒刷新的实时进度追踪。
任务管理：
send上传G-code文件（--start --yes立即开始）pause/resume/stop控制打印流程（默认需确认）
显著优点
1. 完整API覆盖：支持连接管理、文件上传、打印控制、状态查询等全功能
2. 安全设计：主动打印保护、操作确认机制、状态验证，防止误操作损坏设备
3. 实时反馈：详细的温度、进度、时间估算，支持JSON格式便于脚本集成
4. 事件检测：内置耗材耗尽、舱门开启、打印完成等关键事件识别
5. 轻量依赖：仅需Python 3.6+和requests库
潜在局限
- 网络依赖：必须局域网连接，无云端功能
- Token管理：需手动从Luban应用复制，Token变更需重新配置
- 功能边界：不支持G-code编辑、切片等前置处理
- 平台限制：仅兼容Snapmaker 2.0系列（1.0/Artisan未明确支持）
适合人群
- 需要自动化打印工作流的高级用户
- 希望远程监控打印进度的创客
- 开发打印农场管理系统的开发者
- 熟悉命令行和JSON数据处理的进阶用户
常规风险
- 物理安全：远程控制高温设备（喷嘴200°C+/热床100°C+），
--force可能损坏进行中的打印 - 网络暴露：8080端口若暴露公网存在未授权访问风险（建议仅内网使用）
- Token泄露：长期有效的Token若被盗可导致打印机被恶意控制
- 固件兼容性：API变更可能导致功能失效，需关注官方更新
- 文件传输：大G-code文件传输可能失败，建议先验证文件完整性