Hotkey Detective：全局热键冲突诊断工具
项目地址: https://gitcode.com/gh_mirrors/ho/hotkey-detective 一、工具概述
Hotkey Detective 是一款专门用于检测 Windows 系统中全局热键冲突的实用工具。当多个应用程序注册相同的全局快捷键时，该工具能够准确识别哪个进程占用了特定的热键组合，帮助用户快速解决快捷键冲突问题。
二、核心功能特性
2.1 全局热键检测
通过系统钩子机制监听所有进程的 WM_HOTKEY 消息，能够精准捕获系统中已注册的全局热键信息。
2.2 进程路径定位
不仅显示占用热键的进程ID，还能获取完整的进程可执行文件路径，让用户清楚了解是哪个应用程序导致了冲突。
3.3 跨Windows版本支持
完美支持 Windows 8 及更高版本系统，包括 Windows 10 和 Windows 11，确保在不同系统环境下的稳定运行。
三、技术实现原理
3.1 钩子机制工作原理
Hotkey Detective 通过两种系统钩子来监控热键消息：
- WH_GETMESSAGE 钩子：监控发送到消息队列的消息
- WH_CALLWNDPROC 钩子：在消息发送到目标窗口过程之前进行拦截
当检测到 WM_HOTKEY 消息时，工具会记录相关信息并通知主程序显示结果。
3.2 进程注入技术
工具通过 DLL 注入到所有运行中的进程（除了 explorer.exe 和自身），在每个进程中安装消息钩子来捕获热键消息。
3.3 共享内存通信
使用内存映射文件（Memory Mapped File）在主程序和注入的 DLL 之间共享数据，确保高效的信息传递。
四、使用指南
4.1 系统要求
- Windows 8 或更高版本操作系统
- 管理员权限运行
4.2 安装步骤
git clone https://gitcode.com/gh_mirrors/ho/hotkey-detective
cd hotkey-detective
cmake .
make
4.3 操作流程
- 以管理员身份运行 HotkeyDetective.exe
- 程序启动后，按下有冲突的热键组合
- 工具将显示占用该热键的进程信息和文件路径
4.4 注意事项
- 必须使用管理员权限运行，否则无法检测受保护进程的热键占用
- 工具会注入 DLL 到系统进程，退出后可能需要重启系统才能完全卸载
- 只能检测真正注册为全局热键的组合，应用程序内部处理的快捷键无法检测
五、常见应用场景
5.1 多媒体软件冲突
解决音乐播放器、视频编辑软件与系统媒体键的冲突问题。
5.2 办公软件快捷键冲突
当多个办公软件使用相同快捷键时，快速定位冲突源。
5.3 游戏与直播软件
解决游戏快捷键与直播软件热键之间的冲突，确保流畅的游戏和直播体验。
六、技术细节
6.1 核心数据结构
工具使用 HkdHookData 结构体在进程间共享数据，包含注入计数器、主窗口句柄等关键信息。
6.2 进程过滤机制
自动排除对 explorer.exe 和 hotkeydetective.exe 自身的注入，避免系统不稳定。
6.3 线程安全设计
使用原子操作（InterlockedIncrement/Decrement）确保注入计数器的线程安全。
七、故障排除
7.1 无检测结果
- 确认以管理员权限运行
- 尝试 x86 和 x64 两个版本的程序
- 确认热键是真正注册的全局热键
7.2 DLL 卸载问题
由于 DLL 注入到系统进程，退出程序后可能需要重启系统才能完全清理。
7.3 系统兼容性
确保系统为 Windows 8 或更高版本，旧版 Windows 可能无法正常运行。
Hotkey Detective 为解决 Windows 系统中的热键冲突问题提供了一个简单而有效的解决方案，通过先进的技术手段帮助用户快速定位和解决快捷键占用问题。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
