用途:用于查询车间里 Qidi 3D 打印机的运行情况,例如“打印进行得怎么样”“在打什么”“还剩多久”“热床热了吗”“上一个打印完成了吗”“打印机上有哪些文件”“给我看看打印画面”。所有工具都是对固定 Moonraker 路径白名单的 GET 请求,只能查看,没有任何工具、参数或代码路径可以启动、暂停、取消、加热、归位、重启或更改打印机。若需要打印机执行动作,需在打印机上或浏览器中操作。
主要能力:printer_status 一次返回完整仪表盘信息,包括状态、文件、百分比与层数、已打印/剩余时间、挤出机/热床/腔体温度、风扇、耗材、Klipper 健康状态,可用 formatted 获取通俗回答。printer_job_history 返回最近 N 个任务的结果、时间、时长与耗材用量。printer_files 列出打印机上的 G-code 文件;带 filename 时返回该文件的切片元数据(预计时间、层数、高度、耗材)。printer_camera_snapshot 从打印机摄像头取一张 JPEG,保存到工作区并内联显示,可配合 analyze_image 描述画面。
读数说明:progress_percent 与打印机自身显示一致;layer 来自切片器的层消息(Qidi Studio 会发送),因此“第 119 层/共 216 层”是准确的。剩余时间为切片器估算减去已打印时间(time_remaining_basis 为 slicer estimate),无估算时按进度外推,前几层会有偏差,宜说“大约”。加热器的 power_percent 表示工作强度,挤出机达到目标温度且功率约 10% 属正常稳态;热床与腔体低功率维持目标温度说明打印机在保温 ASA/ABS。打印中 detected: false 表示断料,需立即告知。Klipper 状态非 ready 或存在 warnings/failed_components 时,即使打印看似正常也应提及。state 取值包括 printing、paused、complete、cancelled、error、standby(空闲)。
端点(均为 GET):/printer/objects/query?print_stats&extruder&…(对象作为裸查询键,不是 targets=)、/server/info、/server/files/metadata?filename=、/server/history/list、/server/files/list?root=gcodes、/server/webcams/list、webcam 的 ?action=snapshot。注意 Moonraker 上不存在 /printer/queue/status,该路径是此前 404 的来源。打印机地址由 .env 中的 MOONRAKER_URL 指定,默认 http://192.168.1.139,与浏览器仪表盘同一台机器。
限制:仅只读,无法控制打印机;具体收费、价格、平台支持等信息暂未提供。