Qoder快捷键自定义配置：高效打字效率提升方案
快捷键冲突看似小事，实则直接影响工作效率。按下组合键毫无反应，或者意外打开系统设置，这种体验足以打断整个开发节奏。问题的根源往往不在 Qoder 本身，而是默认快捷键配置是否真正贴合你的操作习惯。
核心判断依据很清晰：如果快捷键频繁与其他软件或插件冲突，最稳妥的方式是在 IDE 插件内部直接修改绑定；如果需要在浏览器、终端等任意前台应用快速呼出数字员工，则必须启用 QoderWake 的全局热键；只有当全局监听也失效时（例如全屏游戏或远程桌面），才考虑系统级按键重映射。
实际情况往往比预期更棘手：你希望用 Ctrl+Shift+R 一键触发根因分析，用 Cmd+Ctrl+Space 瞬间唤起数字员工，用 Alt+P 无缝切换角色模式——但这些组合要么被操作系统拦截，要么与其他插件占用。归根结底，你需要一套完全为自己工作流定制的快捷键方案。
在 Qoder 插件内重映射冲突快捷键
这是最安全、优先级最高的解决路径。无需修改系统配置，所有更改仅生效于当前 IDE 实例，干净且可逆。
第一步：按下 Ctrl+Alt+S（Windows）或 Cmd+,（macOS） 打开设置面板。
第二步：左侧导航栏依次展开「Keymap」→「Plugins」→「Qoder」。
第三步：在右侧列表中找到冲突条目（例如「Open AI Panel」），右键选择「Add Keyboard Shortcard」。
第四步：按下新的组合键。这里有一条实战经验——优先使用 Ctrl+Alt+Shift+字母 或 Cmd+Option+Shift+字母 这类四键组合。这些组合在绝大多数软件中均处于闲置状态，能规避约 90% 的冲突场景。
第五步：若弹出「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）、选择作用域（用户级或项目级）、填写完整提示词即可保存。
这一步操作很简单，直接把文件拖进去就行。