使用 CLI
通过本地 API 检查和编辑运行中的应用，或直接导出 G-code。
beambench-cli 二进制文件与桌面应用一起分发。大多数项目、设计、机器、配置文件和状态命令都是应用本地 API 的客户端。这些命令要求应用正在运行，并启用 Settings > General > Local API。
对于在同一台计算机上运行的脚本，请关闭 Allow network devices to connect。CLI 会从应用设置中读取已配置的 API 端口，默认值为 5900。
查找可用命令
beambench-cli --help
beambench-cli agent capabilities --json
beambench-cli agent guide --json帮助功能不需要应用。功能和实时状态使用 API。使用 --help 运行子命令，可以查看已安装版本的参数。
打开并检查项目
beambench-cli project open /abs/path/project.lzrproj
beambench-cli agent state --json打开项目会更改桌面应用中的项目。在运行会替换或编辑项目的脚本前，请先保存工作。
beambench-cli project save
beambench-cli project save-as /abs/path/copy.lzrproj渲染与导出
beambench-cli design render --png /tmp/design.png --pixels-per-mm 4
beambench-cli export svg --path /tmp/design.svg这些命令通过 API 使用运行中应用的项目。设计渲染不要求画布可见，但仍需要服务器。
beambench-cli camera overlay render --output /tmp/overlay.png --view fit相机叠加层渲染还要求应用的前端处理渲染请求。它不是相机工作流的无头替代方案。
不依赖应用的命令
串口列表、帮助和位置参数形式的 G-code 导出具有直接的本地路径：
beambench-cli ports
beambench-cli export gcode /abs/path/project.lzrproj /abs/path/out.gcode独立 G-code 导出使用本地保存的机器配置文件以及桌面的规划和输出检查。它无法读取实时机器位置。有关配置文件和放置要求，请阅读 G-code 输出。
自动化与冲突
设计事务使用当前项目修订版本。如果其他编辑、项目切换或关闭操作使捕获的项目失效，事务会被拒绝。请刷新状态并重新评估操作后再重试，不要使用旧快照覆盖并发的用户编辑。
能够移动机器、触发激光、发送原始 G-code 或更改辅助气体的命令，需要相应的确认标志。提供这些标志前，请检查命令帮助和预期操作。
CLI 不会选择画布工具、重新排列面板或触发快捷键。这些属于桌面 UI 操作。