Klipper Manager 是一个面向 Klipper 3D 打印机的 AI 驱动配置与诊断技能,通过 Moonraker API 对打印机进行管理。它能够读取和编辑 printer.cfg、运行诊断、执行校准序列、监控实时状态,并在充分了解配置的情况下修复问题。
用途 该技能适用于连接和管理 Klipper 打印机、读取或修改 printer.cfg 设置、诊断 Klipper 错误或警告、运行校准(床网、探针、PID、共振、压力提前、轴扭曲、螺丝等)、监控温度、位置或打印状态、发送 GCode 命令,以及重启固件或 Klipper。
主要能力 技能启动时始终先读取 state/printer_context.json,若存在则向用户概述已知打印机信息;若缺失或用户提供新 IP,则进入第一阶段。第一阶段为打印机发现:连接 Moonraker、获取 printer.cfg 及 [include] 引用的文件、解析并清点配置、运行自动诊断、展示摘要。第二阶段为配置管理:读取设置、编辑设置(获取当前文件、定向修改、验证、保存临时文件、通过 Moonraker 上传、固件重启、验证状态、更新上下文、清理临时文件),并强调绝不手动编辑 SAVE_CONFIG 块。第三阶段为诊断与验证,包含探针偏移边界、床网边界、安全 Z 归位位置、SAVE_CONFIG 一致性、TMC 驱动警告、输入整形、压力提前、旋转距离合理性、PID 调谐、缺失推荐段等检查规则。第四阶段为实时状态监控,通过 Moonraker 对象 API 查询 toolhead、extruder、heater_bed、probe、bed_mesh、print_stats 等对象,并发送 GCode。第五阶段为校准序列,涵盖 PROBE_CALIBRATE、床网校准、轴扭曲补偿、PID 调谐、压力提前、共振/输入整形校准、螺丝倾斜调整、TMC 驱动诊断。第六阶段为故障排查,提供错误到原因到修复的数据库及常见错误模式快速参考。第七阶段为配置段参考,列出 [printer]、[stepper_x/y/z]、[extruder] 等关键段及常用参数。
使用方式 通过 Moonraker API 的 HTTP 接口与打印机交互,使用 curl 命令进行连接、文件获取、上传、固件重启、对象查询和 GCode 发送。配置编辑遵循获取当前文件、修改、验证、上传、重启、验证的流程。校准通过发送相应 GCode 命令完成。
适用场景 适用于任何运行 Klipper 并通过 Moonraker 暴露 API 的 3D 打印机,用于日常配置管理、故障诊断、校准和状态监控。
限制 需要打印机 IP 和 Moonraker 服务可用;配置编辑需谨慎处理 SAVE_CONFIG 块;部分诊断和校准依赖具体硬件(如探针、加速度计)配置。