用途：以 CLI 方式程序化控制 AutoPCB Shell GUI，适用于可视化验证、UI 测试、截图驱动流程，以及打开文件或项目等操作。
主要能力：通过 Unix socket IPC 向唯一运行实例发送 JSON 请求；支持生命周期管理（start/gui/stop/restart/ping）、发送命令（cmd）、截图（screenshot，基于 egui 内部截图，无需外部工具）、打开文件/项目/导入 Altium 文件、会话保存与恢复、拖动分隔条等 UI 测试操作。命令覆盖应用、工作区与文件、导航与布局、面板、PCB 视图、工具、选择与交叉探测、编辑器、会话、主题、智能体与评审、任务等类别。
使用方式：先 ping 确认运行，未运行则 start；随后 cmd 发送命令并等待 200-500ms（文件操作用 1-2s），再用 screenshot 截图，读取 PNG 判断下一动作。文件路径应使用绝对路径，路径相对于 GUI 自身工作目录解析。套接字默认 $XDG_RUNTIME_DIR/autopcb-shell.sock，可用 --socket 覆盖。部分命令有前置条件（如需已打开工作区、板文档或参数）。
限制：IPC 返回 ok:true 仅表示被接受，意图仍可能被管线拒绝，需以截图确认；每次仅一个 GUI 实例；资料未提供收费、价格与平台信息。