SuperAPI AI 工具集

change-keybinding

办公与效率

查看项目

更新于 10-16 07:17

技能介绍

用途:当用户想重映射、重新绑定或移除 Warp 键盘快捷键时使用本技能,操作对象是用户的 keybindings.yaml 文件。

文件位置:用户自定义配置位于 {{keybindings_file_path}},这是 Warp 启动时读取的确切路径,随平台和发布渠道不同(如 macOS 的 ~/.warp*/、Linux 的 ~/.config/warp-terminal/、Windows 的 %LocalAppData%)。须原样使用该路径,不要根据用户主目录结构推断其它路径;文件或父目录不存在时需创建。

文件格式:action_name → key_trigger 的扁平 YAML 映射,动作名含冒号必须加引号,例如 "workspace:toggle_ai_assistant": ctrl-s。

编码规则:修饰键组合顺序为 ctrl-alt-shift-cmd-meta-;跨平台别名 cmdorctrl-(macOS 变 cmd,其它平台变 ctrl)。字母大小写仅对单字母键生效:无 shift 用小写,有 shift 用大写(shift-A,不能写 shift-a)。特殊键包括 space、enter、escape、tab、backspace、delete、insert、方向键、home、end、pageup、pagedown、f1–f20、numpadenter,始终小写,即使配合 shift(如 ctrl-shift-space);空格须写单词 space。标点直接写字符。移除默认绑定将值设为 none。

识别动作:默认绑定编译在 Warp 内,无法从磁盘文件发现,也没有可查询的目录。用户给出动作名时直接写入;只给出描述或当前组合键时,不要臆造动作名,应引导用户打开快捷键编辑器(workspace:show_keybinding_settings,macOS 默认 cmd-ctrl-k;其它平台为 Settings → Keyboard Shortcuts)搜索后编辑或提供规范的 namespace:action_name。

流程:确定动作和新触发键;读取现有文件并保留所有条目,只增改本次内容;写入文件并按规则规范化;提醒用户必须重启 Warp 才生效(该文件仅在启动时加载,与热重载的 settings.toml 不同),macOS 用 cmd-Q 退出后重开。

限制:无法自动从描述推断动作名;写入的触发键格式错误会导致绑定静默加载失败。