Qoder 快捷键自定义：让手指在键盘上飞速舞动的配置方案

需自定义Qoder快捷键以解决冲突：优先在IDE内重映射（Settings→Keymap→Qoder插件）；全局唤醒用QoderWake配置event_hotkey_enabled；系统级失效时用PowerToys/Karabiner重映射；高频指令可用命令面板输入/调用。

你想在 Qoder IDE 中彻底摆脱鼠标依赖，让 Ctrl+Shift+R 一键根因分析、Cmd+Ctrl+Space 瞬间唤醒数字员工、Alt+P 切换角色模式成为肌肉记忆——但默认快捷键总和系统或其他插件打架，按下去没反应，或误触 Windows 设置，这说明你还没完成真正适配自己工作流的快捷键自定义。

在 Qoder 插件内重映射冲突快捷键

这是最安全、最优先尝试的方案，不碰系统设置，所有修改仅作用于当前 IDE 实例。

1、按下 Ctrl+Alt+S（Windows）或 Cmd+,（macOS） 打开 Settings/Preferences。

2、左侧导航栏依次展开「Keymap」→「Plugins」→「Qoder」。

3、在右侧列表中找到具体冲突项，例如「Open AI Panel」，右键→「Add Keyboard Shortcut」。

4、按下新组合键，强烈推荐使用 Ctrl+Alt+Shift+字母 或 Cmd+Option+Shift+字母类四键组合，这类组合在绝大多数软件中处于闲置状态，能避开 90% 的冲突源头。

5、若弹出“Already assigned”提示，说明该键已被其他功能占用，不要强行覆盖——立刻换一个，否则后续可能触发不可预期行为。

启用 QoderWake 内置全局热键

当你需要在任意应用前台（比如浏览器写文档、终端跑日志）下，无需切换窗口就能唤起 QoderWake 数字员工时，必须启用其底层事件监听模块。

第一步：确保 QoderWake 主进程已完全退出。右键菜单栏图标→退出，或终端执行 killall QoderWake。

第二步：打开配置文件。Windows 路径为 %APPDATA%QoderWakeconfig.yaml，macOS 路径为 ~/Library/Application Support/Qoder/Wake/config.yaml。

第三步：用文本编辑器打开 config.yaml，在 agent_runtime 节点下严格使用空格缩进（禁止 Tab），新增两行：

event_hotkey_enabled: true

event_hotkey_combination: "Cmd+Ctrl+Space"

第四步：保存文件，重新启动 QoderWake。务必检查启动日志是否出现 [EVENT] Hotkey listener active: Cmd+Ctrl+Space 字样，没有这行就代表热键未生效。

用 PowerToys 或 Karabiner 重映射物理按键

当内置监听在全屏游戏、远程桌面或沙盒应用中失效时，系统级重映射是唯一可靠路径——它把你的物理按键直接翻译成 QoderWake 能识别的虚拟事件码。

方法一（Windows）：安装 PowerToys v0.89+ → Settings → Keyboard Manager → Remap a shortcut → 点击“+” → Physical Shortcut 栏按下你习惯的组合（如 Win+Shift+E）→ Mapped To 栏选择 Cmd+Ctrl+Space（注意：PowerToys 中 Cmd 对应 Windows 徽标键）。

方法二（macOS）：安装 Karabiner-Elements v14.12+ → Complex Modifications → Add rule → 搜索“QoderWake quick summon”并启用对应规则。

验证方式统一：按下你设定的自定义组合键后，立即查看 QoderWake 日志是否输出 [INPUT] Forwarded from system mapper。

通过命令面板快速调用自定义指令

不用记复杂快捷键，只要记住斜杠 /，就能从对话框里拉出所有预设指令，适合高频但非实时性要求极高的任务。

① 在 Qoder 会话输入框中，直接输入 /，底部会自动弹出指令候选列表。

② 使用上下方向键快速筛选，回车确认执行。

③ 若列表为空，说明尚未创建任何自定义指令——此时点击底部“添加指令”入口，输入名称（如 gen-test）、选择作用域（用户级 or 项目级）、填写完整提示词即可保存。

这一步操作起来很简单，直接把文件拖进去就行。