CLI 和应用如何共享状态
Beam Bench 的代理状态模型。CLI 能看到什幺，应用能看到什幺，以及它们在哪里交汇。
Beam Bench CLI 和桌面应用是同一后端的两个客户端。它们都可以检查同一个项目、同一个机器连接和同一个相机状态。当你想通过脚本驱动应用时，了解它们如何共享状态会很有帮助。
模型
Beam Bench 内部有一个唯一的事实来源，负责管理：
- 当前项目。
- 机器连接。
- 相机状态。
- 代理能力/状态面。
桌面应用的 UI 是该状态的一个用户。CLI 是另一个用户。HTTP / WebSocket API 也是同一接口。
CLI 可以做什幺
beambench-cli agent state --json 以稳定的 JSON 架构返回项目、机器、选择内容和相机的当前状态。使用它可以检查应用当前加载的内容。
beambench-cli agent capabilities --json 返回可用操作的注册表，以及各个 CLI 子命令映射到哪些后端操作。
beambench-cli agent guide --json 返回一条工作流提示，说明外部代理（如 Claude）应如何驱动应用。
CLI 不能做什幺
CLI 没有自己的 UI 状态。它无法选择工具、打开面板或打开对话框。这些都是应用端操作，请在应用中执行，而不是通过 CLI 执行。
CLI 需要应用运行时
某些操作需要应用执行实际工作（渲染带叠加层的画布、捕获相机画面）。CLI 会转发请求，应用执行工作；结果再返回 CLI。
camera overlay render 命令就是这样工作的。CLI 会一直阻塞，直到应用完成或超时（15 s）。
无头命令与需要应用的命令
| 需要应用运行？ | 示例 |
|---|---|
| 否（无头） | beambench-cli design render --png、beambench-cli project save、beambench-cli export svg、beambench-cli agent state |
| 是 | beambench-cli camera overlay render、beambench-cli camera capture（使用原生相机时），以及任何 UI 状态检查 |