SuperAPI AI 工具集

cmux-workspace

通用与其它

查看项目

更新于 10-16 00:04

技能介绍

用途:将代理的操作范围限定在唤起它的 cmux 工作区内,并按需读取或调整窗格、表面等结构。核心概念:Window 是 macOS 窗口;Workspace 是侧边栏条目;Pane 是工作区内的分屏;Surface 是窗格内的标签页(终端或浏览器);Panel 是表面内部内容类型,优先用 CLI surface 命令而非面板内部接口。

默认规则:除非用户明确要求其它工作区、窗口或全局状态,操作都锚定当前调用方工作区。不能假设视觉焦点处就是目标,代理运行的工作区可能不是用户正看的那一个。识别方式:printf 'workspace=%s\nsurface=%s\nsocket=%s\n' "${CMUX_WORKSPACE_ID:-}" "${CMUX_SURFACE_ID:-}" "${CMUX_SOCKET_PATH:-}",或 cmux identify --json;缺失时回退到 identify 并说明使用的是当前焦点上下文。

主要能力:非破坏式自动化(把布局与焦点分开,避免投机性调用 select-workspace、focus-pane、focus-panel 等影响用户的操作);用 cmux new-pane --workspace ... --type browser|terminal --direction ... 一步创建带表面的窗格,已知首条命令时用 --command,并尽量传 --focus false;右侧辅助窗格用于预览、TUI、日志等,先 identify、list-panes、list-pane-surfaces 再复用;向调用方终端发送用 cmux send --surface、cmux send-key;代理间通信用 cmux agent message / agent inbox,绝不向别的代理终端键入;移动表面用 move-surface --before/--after/--index;侧边栏状态用 set-status、set-progress、log、sidebar-state。

限制与已知问题:drag-surface-to-split 经 V1 并以 UI 焦点解析工作区,调用方工作区非视觉焦点时会报 Surface not found,此时应改为增量建布局,不要用聚焦绕过;布局命令拒绝合法 surface/pane 引用时应报告并停止;socket 访问可能关闭、仅限 cmux 派生的进程或对所有本地进程开放,连不上先看 cmux capabilities --json 和 cmux ping。源码检出的贡献者改动用带标签重载 ./scripts/reload.sh --tag <short-tag>,不要构建或启动未加标签的 cmux DEV。