用途:把用户的快捷键偏好转化为 cmux 的快捷键绑定,写入 ~/.config/cmux/cmux.json,涵盖指导、推荐紧凑模板、应用所选修改,并确认配置能通过解析且键名被识别。
主要能力:支持一次性改绑/解绑、快捷键审计(只读检查并汇总覆盖与解绑项)、重置,以及批量自定义(提供 tmux 前缀、Vim 窗格导航、Agent 分诊、工作区与面板分层、浏览器式终端导航、macOS Terminal/iTerm 恢复、浏览器默认恢复、终端优先精简等模板)。
绑定模型:设置路径为 shortcuts.bindings.<actionId>。单次按键如 "cmd+b";组合键如 ["ctrl+b","c"],第一段需带修饰键(Space 除外),第二段可裸键。解绑优先用 null,""、"none"、"clear"、"unbound"、"disabled" 为可接受别名。selectSurfaceByNumber、selectWorkspaceByNumber、focusPaneByNumber 必须使用 1–9 的数字,cmd+1 表示 cmd+1 到 cmd+9 整个系列。showHideAllWindows 是唯一的系统级快捷键,不能是组合键,必须带修饰键,且可能被 macOS 拒绝,还需在 Settings > Global Hotkey 中启用系统级热键;该绑定能在 cmux.json 中通过校验但功能可能仍处于关闭状态。globalSearch 仅作用于应用内。
必要用法:尽量从 cmux checkout 或 worktree 根目录操作;所有读写都使用 skills/cmux-settings/scripts/cmux-settings(读取 JSONC、原子写入、校验 JSON 与已识别键)。常用命令:"$CMUX_SETTINGS" path、"$CMUX_SETTINGS" get shortcuts.bindings、"$CMUX_SETTINGS" validate、"$CMUX_SETTINGS" set shortcuts.bindings.newSurface '["ctrl+b","c"]'、"$CMUX_SETTINGS" unset shortcuts.bindings.focusLeft。逐个 action 应用,不要整体覆盖 shortcuts.bindings。保存 cmux.json 会实时重载,无需重启 cmux。
限制:cmux-settings validate 只校验 JSON 与受支持键,不检测快捷键语法冲突、macOS 保留键或焦点上下文冲突,不能承诺冲突检测。unset 只删除 cmux.json 覆盖项,不清除通过 Settings UI/UserDefaults 保存的更改;要恢复真正内置默认值需在清除文件覆盖后使用 Settings > Keyboard Shortcuts > Reset Default Shortcuts,showHideAllWindows 则用 Settings > Global Hotkey 恢复为 ctrl+opt+cmd+。除非用户明确要求,不要编辑旧版回退配置 ~/.config/cmux/settings.json;不要臆造 action ID。资料未提供的价格、平台要求等信息暂未说明。