SuperAPI AI 工具集

cmux-customize

通用与其它

查看项目

更新于 10-16 00:04

技能介绍

用途:cmux-customize 用于个性化 cmux 配置,配置存放在应用源码树之外,主要是全局 ~/.config/cmux/cmux.json 和项目本地 .cmux/cmux.json。涉及动作注册表、surface 标签栏按钮、加号按钮点击与右键菜单行为、自定义工作区命令、右侧栏接线及相关配置清理。

前置条件:读写全局配置需使用 cmux-settings 技能的 cmux-settings 辅助脚本。若任务涉及 app、terminal、notifications、sidebar、sidebarAppearance、workspaceColors、automation、browser、shortcuts 等标准设置,应先阅读 cmux-settings 技能。

主要配置段:actions 为自定义 UI 与命令使用的动作注册表;ui.surfaceTabBar.buttons 为标签栏按钮;ui.newWorkspace.action 为加号按钮普通点击触发的动作;ui.newWorkspace.contextMenu 为加号按钮右键菜单项;commands 为命名工作区命令与布局;rightSidebar 为自定义右侧栏接线;vault 为自定义 Vault 代理注册。标签栏按钮可包含内置动作 id 字符串或对象引用,例如 "cmux.newTerminal"、"cmux.newBrowser"、"cmux.splitRight"、"cmux.splitDown" 或 { "action": "custom-action-id" }。右键菜单应使用 ui.newWorkspace.contextMenu,ui.newWorkspace.rightClick 是旧别名。

使用方式:先读取现有配置,如 cmux-settings dump --no-comments,并用 rg 搜索相关 id。修改时用辅助脚本做最小编辑,例如 cmux-settings set ui.surfaceTabBar.buttons '["cmux.newTerminal","cmux.newBrowser","cmux.splitRight","cmux.splitDown"]';删除某个动作注册项用 cmux-settings unset actions.<action-id>;设置加号按钮与右键菜单用 cmux-settings set ui.newWorkspace.action 和 cmux-settings set ui.newWorkspace.contextMenu。修改后必须读回验证,如 cmux-settings get ui.surfaceTabBar.buttons、cmux-settings get ui.newWorkspace.contextMenu,并确认文件可解析。cmux 会监视 ~/.config/cmux/cmux.json,保存后即生效,无需重建或应用重载。

限制与规则:保留无关的自定义动作、命令、菜单、Vault 条目和右侧栏配置;不要因为按钮从标签栏移除就删除动作定义;不要用 defaults write 写持久产品配置;不要编辑 repo/ 来改用户配置;纯配置或技能变更不要运行应用重载。严格校验器可能对较新结构键报警,此时不要删除无关键,确认可解析并报告该警告。回复应简短并包含实际修改的路径或键。