snapmaker-2

这是一款专为 Snapmaker 2.0 3D 打印机设计的本地网络控制工具，基于官方 HTTP API 构建，提供从设备发现到打印完成的全流程管理能力。

核心用法方面，该技能支持通过 UDP 广播或 HTTP 探测自动发现局域网内的打印机设备，用户只需配置 IP 地址和 API Token 即可建立连接。功能涵盖实时状态监控（温度、进度、坐标位置）、完整的打印作业生命周期管理（发送 G-code 文件、启动、暂停、恢复、停止）以及持续性的进度追踪。所有操作均通过 Python 脚本封装，支持 JSON 格式输出，便于与其他自动化工具集成。

显著优点体现在其完善的安全设计上。首先，具备活跃打印保护机制，防止在打印过程中误操作发送新文件；其次，所有破坏性操作（如停止打印）都强制要求用户确认，并提供 --yes 和 --force 标志供脚本化场景使用；再者，文件传输支持严格的扩展名白名单（.gcode、.nc 等）和目录沙箱限制，有效防止路径遍历攻击。此外，实时监控功能可以检测打印完成、断料、舱门开启等事件，适合无人值守场景。

潜在缺点主要包括来源可信度限制（T3 级个人社区项目），虽然代码质量达到 A 级，但长期维护稳定性存在不确定性。功能上仅限局域网使用（LAN-only），无法跨网络远程控制，且依赖的 requests 库版本未锁定，可能因依赖更新引入兼容性问题。另外，API Token 以 URL 查询参数形式传输，虽受设备限制但存在潜在泄露风险。

适合的目标群体主要是拥有 Snapmaker 2.0 打印机的个人爱好者、小型工作室以及教育机构的 3D 打印实验室。特别适合需要自动化打印流程、批量监控多台设备或将打印任务集成到现有工作流中的技术型用户。

使用风险方面，除常规的网络连接稳定性问题外，需特别注意 Token 的安全保管，避免配置文件泄露导致打印机被未授权控制。由于技能具备直接控制物理设备的能力，误操作可能导致正在进行的打印任务失败、材料浪费甚至设备损坏，建议在正式使用前充分测试命令行为。此外，该技能仅支持 Snapmaker 2.0 系列，不兼容其他品牌或型号的 3D 打印机。