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

首页专区 Skill 文章专题 AI工具学习编程手册

updream

一键生成高质量推广成片

剧云

中文短剧剧本制作平台

Seko

AI短剧一键生成成片

AniShort

AI短剧协同制作平台

PHP MySQL jquery HTML CSS

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）。