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 操作流程

1. 以管理员身份运行 HotkeyDetective.exe
2. 程序启动后，按下有冲突的热键组合
3. 工具将显示占用该热键的进程信息和文件路径

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 系统中的热键冲突问题提供了一个简单而有效的解决方案，通过先进的技术手段帮助用户快速定位和解决快捷键占用问题。