用途:本技能用于 cmux CLI/socket 相关开发,在新增或修改 socket 命令、CLI 命令、遥测命令时提供线程与焦点策略依据。
主要能力与规则: 一、线程策略。高频遥测类命令(如 report_*、ports_kick、状态/进度更新、日志元数据更新)不得使用 DispatchQueue.main.sync。遥测热路径应在主线程外解析与校验参数,先在主线程外去重与合并,仅在需要时用 DispatchQueue.main.async 调度最小的 UI/模型变更。直接操作 AppKit/Ghostty UI 状态的命令允许在主 actor 上运行。新增 socket 命令默认采用主线程外处理,若必须主线程执行需在代码注释中给出明确理由。
二、焦点策略。socket/CLI 命令不得抢占 macOS 应用焦点,除非命令具备显式焦点意图,否则不得激活应用或提升窗口。只有显式焦点意图命令可改动应用内焦点/选择,例如 window.focus、workspace.select/next/previous/last、surface.focus、pane.focus/last、浏览器焦点命令及 v1 等价命令。非焦点命令应在保留用户当前焦点上下文的同时应用数据/模型变更。open 类命令(vm/cloud shell、tui、open、new、base、workspace new/open、agent;surface open/new-terminal;cmux open;cmux ssh)仅在交互式运行时聚焦,由 agent 或脚本运行时保持后台(defaultFocusForUserOpen);--focus 表示选择聚焦,--no-focus 表示不聚焦。其 socket 方法默认 focus 为 false,无焦点打开的 pane 标记为未读。
三、远程中继授权。每个 v2 方法都可能是 cmux ssh 中继载荷,RemoteRelayCommandPolicy 默认拒绝;将某方法加入允许列表需经过安全分析与策略测试。
使用方式:新增命令、变更命令执行上下文或判断是否允许焦点变更时,阅读 references/threading-and-focus.md;新增或修改 v2 方法、远程 CLI 命令或中继策略时,阅读 references/remote-relay-authorization.md。
限制:资料未提供收费、价格、平台范围与效果信息;具体实现细节以随附参考文档为准。