moonraker_IT运维与安全 skill-PHP中文网

moonraker

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 Moonraker API 控制与监控 Klipper 3D 打印机 — 包括打印状态、温度、暂停、恢复、取消及紧急停止。

通过月光学 REST API 控制您的 3D 打印机

功能概述

通过月光学 REST API 控制您的 3D 打印机是一项面向实际任务的技能，主要用于热度 : http://$MOONRAKER HOST: 7125. 帮助脚本 : {baseDir}/ monraker.sh；Q快速命令( 通过月光学 .sh).；

核心要点

API 参考.；
Base URL: http://$MOONR。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

通过 Moonraker REST API 控制您的 3D 打印机。

主机地址：http://$MOONRAKER_HOST:7125
辅助脚本：{baseDir}/moonraker.sh

常用命令（通过 moonraker.sh）

moonraker.sh status   # 输出打印进度、温度、当前状态
moonraker.sh pause    # 暂停当前打印任务
moonraker.sh resume   # 恢复已暂停的打印任务
moonraker.sh cancel   # 取消当前打印任务
moonraker.sh estop    # 紧急停止（之后需执行固件重启）
moonraker.sh files    # 列出打印机上的 GCode 文件

API 参考文档

基础 URL：http://$MOONRAKER_HOST:7125

获取打印机状态

GET /printer/info

返回固件版本、Klipper 状态（如 ready、error、shutdown 等）及主机名。

获取打印状态与温度信息

GET /printer/objects/query?print_stats&heater_bed&extruder

返回以下字段：

print_stats.state — 当前状态，取值为 standby、printing、paused、complete 或 error
print_stats.filename — 当前加载的文件名
print_stats.print_duration — 已打印时长（秒）
print_stats.total_duration — 自打印开始至今的总耗时（秒）
extruder.temperature / extruder.target — 挤出头实际温度 / 目标温度（单位：°C）
heater_bed.temperature / heater_bed.target — 热床实际温度 / 目标温度（单位：°C）

暂停打印

POST /printer/print/pause

恢复打印

POST /printer/print/resume

取消打印

POST /printer/print/cancel

紧急停止

POST /printer/emergency_stop

⚠️ 立即停止所有运动轴和加热元件。在重新开始打印前，必须通过 POST /printer/firmware_restart 重启 Klipper 固件。

列出 GCode 文件

GET /server/files/list

返回 gcodes 目录下的文件列表，包含文件名、大小及最后修改时间。

固件重启（紧急停止后必需）

POST /printer/firmware_restart

原始 curl 示例

# 获取打印机状态
curl -s http://$MOONRAKER_HOST:7125/printer/info | jq .

# 获取温度与打印状态
curl -s "http://$MOONRAKER_HOST:7125/printer/objects/query?print_stats&heater_bed&extruder" | jq .

# 暂停打印
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/pause | jq .

# 恢复打印
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/resume | jq .

# 取消打印
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/print/cancel | jq .

# 紧急停止
curl -s -X POST http://$MOONRAKER_HOST:7125/printer/emergency_stop | jq .

# 列出文件
curl -s http://$MOONRAKER_HOST:7125/server/files/list | jq .

注意事项

所有 POST 接口在成功执行后均返回 {"result": "ok"}。
若 Klipper 处于 error 或 shutdown 状态，则大多数命令将失败，直至完成固件重启。
打印进度百分比 ≈ print_stats.print_duration / print_stats.total_duration * 100（粗略估算；更精确的进度可通过 virtual_sdcard 对象获取）。
获取精确进度：发送 GET /printer/objects/query?virtual_sdcard，读取响应中的 virtual_sdcard.progress 字段（取值范围：0.0–1.0）。