CLI 与应用如何共享状态
应用拥有实时项目状态，大多数 CLI 命令通过 API 访问该状态。
桌面应用拥有活动项目、机器连接和服务状态。大多数 CLI 命令通过应用的本地 HTTP API 访问这些状态。前端本身使用 Tauri IPC 调用共享服务，正常桌面使用不需要启用 HTTP 服务器。
实时命令
agent state、project open/save、设计渲染、矢量导出和机器控制通常需要应用的 API 服务器。在常规设置中启用 Local API，并在 CLI 与应用运行于同一台计算机时关闭网络访问。
这些命令作用于应用中的当前项目。打开其他项目的脚本会改变桌面用户看到的内容。
渲染
设计渲染由后端执行，不需要画布可见，但仍需要 API 服务器。相机叠加层渲染会请求前端渲染当前叠加层，因此桌面 UI 也必须响应。
直接本地命令
帮助、串口列表和位置参数形式的 export gcode 不需要 API 服务器。独立 G-code 导出会通过共享的检查生成器加载指定项目和本地保存的机器配置文件。它无法读取运行中机器的位置。请参阅 G-code 输出。
并发编辑
设计事务会在提交前检查项目快照。如果项目已更改、切换或关闭，事务会失败，而不会覆盖更新后的状态。请刷新状态，重新考虑请求的编辑内容，然后重试。
服务端项目编辑会将项目标记为已更改，以便桌面应用显示未保存的工作。保存、恢复和撤销不应被视为项目的独立副本。
UI 状态
CLI 不会公开每一项前端交互。选择工具、打开对话框和排列面板停靠区仍属于桌面操作。