Hotkey Detective可精准定位占用QoderWake快捷键的进程，通过管理员运行、点击GetHotKey、查找对应键值及路径、终止冲突进程五步完成排查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QoderWake 数字员工时发现自定义快捷键无法触发、误响应或被静默拦截，很可能是数字员工所绑定的热键与操作系统、输入法、安全软件或第三方工具发生冲突。以下是多种可独立执行的排查与修复步骤：
一、检查并禁用系统级高优先级热键
Windows/macOS 系统默认注册了大量全局热键（如 Win+D、Cmd+Space），这些热键具有最高拦截权限，会直接覆盖 QoderWake 的按键监听逻辑。禁用或重映射此类组合可立即释放底层信号通路。
1、按下 Win + I（Windows）或 Cmd + 空格（macOS）打开系统设置。
2、Windows 用户导航至「系统 > 快捷键」；macOS 用户进入「系统设置 > 键盘 > 键盘快捷键」。
3、依次展开「常规」「辅助功能」「服务」分类，查找名称含“显示桌面”“聚焦搜索”“粘滞键”“旁白”的条目。
4、对已启用且与 QoderWake 自定义组合重叠的条目（例如 Win+Shift+Q 或 Cmd+Option+K），点击右侧“禁用”按钮。
5、若需保留功能但更换组合，点击“更改快捷方式”，然后按下新组合；新组合若显示红色叉号，表示已被其他进程占用，不可提交。
二、使用 Hotkey Detective 定位热键劫持进程
Hotkey Detective 能穿透所有用户态进程，实时捕获 Windows 全局热键注册行为，精准识别哪个进程正在监听您为 QoderWake 设置的快捷键，包括隐藏服务、后台托盘程序及未签名插件。
1、从官方仓库下载最新版 Hotkey Detective（x64 架构），解压后以管理员身份运行。
2、点击主界面左下角「GetHotKey」按钮，等待 3 秒后右侧列表将刷新全部已注册热键。
3、在「Key」列中定位您的 QoderWake 快捷键（如 Ctrl+Alt+U），观察其对应「PATH」列中的完整进程路径。
4、若路径指向非系统文件（如 C:\Program Files\XXInputMethod\XXIME.exe 或 C:\Users\XXX\AppData\Local\Temp\guardian.dll），即为冲突源。
5、右键该条目选择「Terminate Process」可临时终止劫持进程，验证 QoderWake 是否恢复正常响应。
三、重置 QoderWake 输入上下文与键盘监听状态
QoderWake 在启动时会缓存当前输入法状态与键盘布局映射表；若切换过中文输入法、远程桌面连接或外接键盘，可能导致按键码解析错位，使 Ctrl+Shift+T 等组合被识别为 Ctrl+T 或完全丢弃。
1、关闭所有 QoderWake 实例，包括系统托盘图标与后台服务进程。
2、将系统输入法强制切换为纯英文（美式键盘），并禁用所有输入法热键（如搜狗的 Ctrl+空格、微软拼音的 Shift+Ctrl）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、按住 Ctrl + Shift + Alt 不松开，再双击 QoderWake 启动器，触发强制键盘状态重同步模式。
4、启动后立即进入「Settings > Hotkey Management」页面，点击「Test Input Capture」按钮。
5、在弹出窗口中按下您配置的快捷键，观察左侧显示的原始扫描码（Scan Code）与右侧解析出的功能键（Virtual Key）是否一致；若两者不匹配，说明底层驱动层存在干扰，需跳转至第四步。
四、通过 PowerToys Keyboard Manager 屏蔽干扰组合
当 Hotkey Detective 检测到某进程持续劫持热键但无法卸载（如企业级 DLP 软件、银行 UKey 驱动），可利用 PowerToys 在按键传递链最前端进行物理级屏蔽，确保该组合永不抵达系统消息队列，从而为 QoderWake 留出独占通道。
1、下载安装 PowerToys（v0.80 或更高版本），启动后确认「Keyboard Manager」模块已启用。
2、点击「Remap a shortcut」右侧的「+」号。
3、在「Physical Shortcut」栏点击「Type」，按下您希望 QoderWake 使用、但当前被劫持的组合（例如 Ctrl+Win+R）。
4、在「Mapped To」栏下拉菜单中选择「Disable shortcut」。
5、点击「OK」保存规则；该操作后，无论任何软件注册此组合，均不会触发任何响应，QoderWake 可安全复用该键位。
五、校验 QoderWake Connector 与 Agent 运行时热键策略
QoderWake 的部分快捷键由 Connector 插件动态注入（如 Slack Connector 注册 Cmd+Shift+M 响应消息事件），若多个 Connector 同时启用且热键未做隔离声明，将导致内部监听器互相覆盖。
1、打开 QoderWake CLI，执行 qoderwake connector list --verbose 查看各 Connector 加载状态与绑定热键清单。
2、对输出中重复出现的热键（如两个 Connector 均声明 Ctrl+Alt+E），记录其对应 Connector 名称（如 notion-connector 与 jira-connector）。
3、进入「Settings > Connectors」页面，逐个点击冲突 Connector 右侧「Configure」按钮。
4、在配置弹窗中找到「Hotkey Override」字段，将重复组合修改为唯一值（例如将 Jira 的 Ctrl+Alt+E 改为 Ctrl+Alt+J）。
5、修改后必须点击「Apply & Reload」而非仅「Save」，否则变更不会注入运行时监听器。
