OctoPrint中的Action Commands功能详解

OctoPrint中的Action Commands功能详解

OctoPrint OctoPrint is the snappy web interface for your 3D printer! 项目地址: https://gitcode.com/gh_mirrors/oc/OctoPrint

什么是Action Commands

Action Commands是RepRap基于GCODE通信协议定义的一项特殊功能。它允许3D打印机固件通过发送特定格式的注释指令，与OctoPrint主机软件进行交互控制。这项功能为打印机与主机之间的双向通信提供了标准化的方式。

Action Commands的基本语法

所有Action Commands都以双斜杠"//"开头，后跟"action:"前缀和具体的命令名称，格式如下：

// action:command_name

这种设计使得不支持Action Commands的主机软件会将其视为普通注释而忽略，而支持的主机软件（如OctoPrint）则可以识别并执行相应操作。

OctoPrint支持的核心Action Commands

打印控制命令

1. start
   当打印机发送此命令时，如果OctoPrint当前有已选择但未激活的打印任务，将自动启动该任务，效果等同于点击"开始/重新开始"按钮。

2. cancel
   接收到此命令后，OctoPrint将取消当前打印任务，等同于点击"取消"按钮。

3. pause
   使OctoPrint暂停当前打印任务，等同于点击"暂停"按钮。此命令会触发相关的GCODE脚本和SD打印控制命令。

4. paused
   与pause类似，但不会触发任何GCODE脚本或发送SD控制命令。适用于固件完全自主管理的暂停场景（如固件控制的换料过程）。

5. resume
   使OctoPrint恢复当前打印任务，等同于点击"恢复"按钮。此命令会触发相关的GCODE脚本和SD打印控制命令。

6. resumed
   与resume类似，但不会触发任何GCODE脚本或发送SD控制命令。适用于固件完全自主管理的恢复场景。

连接管理命令

7. disconnect
   使OctoPrint立即断开与打印机的连接。

SD卡状态命令

8. sd_inserted
   通知OctoPrint打印机中已插入SD卡，OctoPrint会更新内部状态并请求文件列表（需启用SD支持）。

9. sd_ejected
   通知OctoPrintSD卡已被移除，OctoPrint会清除相关状态标志（需启用SD支持）。

10. sd_updated
    通知OctoPrintSD卡内容已更改，触发文件列表请求（需启用SD支持）。

系统命令

11. shutdown
    使OctoPrint立即关闭系统（需在设置中明确启用此功能并配置有效的关机命令）。出于安全考虑，此功能默认禁用，防止恶意固件或篡改的GCODE滥用。

高级功能与扩展性

OctoPrint默认启用的"Action Command Prompt Support"插件进一步扩展了交互能力，支持通过Action Commands创建交互式对话框。开发者还可以通过实现特定的插件钩子来添加对自定义Action Commands的支持，为系统功能扩展提供了灵活的方式。

安全注意事项

由于Action Commands具有直接控制系统行为的能力，特别是像shutdown这样的敏感命令，用户应当：

1. 仅从可信来源获取固件和GCODE文件
2. 谨慎启用高风险命令（如shutdown）
3. 定期更新OctoPrint以获取最新的安全修复

实际应用场景

这项功能在以下场景特别有用：

1. 固件控制的暂停/恢复流程（如自动换料）
2. 打印机自主触发的紧急停止
3. SD卡状态同步
4. 打印机与主机间的复杂交互流程

通过合理使用Action Commands，可以实现更加智能和自动化的3D打印工作流程，减少人工干预，提高打印过程的可靠性。

OctoPrint OctoPrint is the snappy web interface for your 3D printer! 项目地址: https://gitcode.com/gh_mirrors/oc/OctoPrint