Hotkey Detective：Windows全局热键冲突诊断工具

Hotkey Detective是一款专为Windows 8及更高版本设计的实用工具，用于诊断和解决全局快捷键冲突问题。当多个应用程序注册了相同的全局热键时，该工具能够准确识别占用热键的进程，帮助用户快速定位问题源。

核心功能特点

全局快捷键冲突诊断引擎

通过系统钩子机制监听全局键盘事件，Hotkey Detective能够捕获已注册的热键信息，并通过进程ID准确定位占用程序。与传统的暴力测试方法不同，该工具仅在用户按下冲突热键时进行检测，避免了不必要的系统干扰。

跨Windows版本适配

完美支持Windows 7至最新版本，采用动态调用Windows API的方式，根据不同系统版本自动选择合适的接口，确保在各Windows环境下稳定运行。

直观的用户界面

提供友好的图形界面替代传统的控制台应用，显示清晰的检测结果和进程信息，让普通用户也能轻松使用专业级工具。

技术原理

钩子机制工作原理

Hotkey Detective通过WH_GETMESSAGE和WH_CALLWNDPROC系统钩子监听全局键盘事件。当用户按下热键时，工具会捕获热键注册信息并分析进程ID，从而确定占用热键的应用程序。

共享内存通信

工具使用内存映射文件(MMF)在主程序和注入的DLL之间共享数据，包括主窗口句柄和注入计数器等信息，确保各个进程间的有效通信。

安全的进程注入

通过将专用DLL注入到系统进程中，Hotkey Detective能够监控各个应用程序的热键注册情况，同时确保系统稳定性。

使用指南

安装步骤

git clone https://gitcode.com/gh_mirrors/ho/hotkey-detective
cd hotkey-detective
cmake .
make

操作流程

1. 以管理员权限运行HotkeyDetective.exe
2. 程序启动后，按下疑似冲突的热键
3. 查看程序显示的占用进程信息

权限要求

运行程序时必须使用管理员权限，否则可能无法准确检测部分受保护进程的热键占用情况。当以非管理员权限运行时，程序会显示警告提示。

应用场景

游戏直播环境

解决OBS直播软件与游戏快捷键冲突的问题，避免直播过程中因热键失效导致的操作失误。

多软件协同办公

在同时运行设计软件、文档编辑器和通讯工具时，诊断因快捷键冲突导致的工作流程中断问题。

远程协助场景

远程协助他人操作时，通过诊断热键冲突快速排查因快捷键问题导致的操作障碍。

常见问题解答

检测不到热键占用

如果看不到检测结果，请尝试以下步骤：

• 确保以管理员权限运行程序
• 在x64系统上尝试运行x86和x64两个版本
• 确认热键是真正的全局热键（注册到系统级别）

程序关闭后DLL残留

由于系统将DLL注入到各个进程中，关闭主程序后DLL可能仍然保留在内存中。目前建议的解决方法是重启系统，开发者正在努力实现DLL的自动卸载功能。

区分全局和局部热键

请注意，像浏览器中的Ctrl+T这样的组合键是应用程序级别的局部热键，不会被本工具检测到，因为它们没有在系统级别注册。

技术限制与注意事项

• 需要管理员权限才能完全发挥作用
• 关闭程序后可能需要重启系统以彻底清除注入的DLL
• 只能检测系统级别注册的全局热键
• 支持Windows 8及以上版本系统

Hotkey Detective为解决Windows系统中的热键冲突问题提供了一个简单而有效的解决方案，特别适合需要同时运行多个应用程序的高级用户和专业人士。