如何快速上手Hotkey Detective？全局热键检测工具5分钟快速开始教程
【免费下载链接】hotkey-detectiveA small program for investigating stolen key combinations under Windows 7 and later.项目地址: https://gitcode.com/gh_mirrors/ho/hotkey-detective
Hotkey Detective 是一款专为 Windows 设计的全局热键检测工具，它能快速查明到底是哪个应用"偷走"了你的快捷键组合。只需按下那个被占用的热键，它立刻显示占用进程的路径，帮你 5 分钟内定位"元凶"。
一、Hotkey Detective 能解决什么问题？🔍
你是否遇到过这种情况：按下Ctrl + Shift + X时，自己程序的热键毫无反应？原因很可能是某个后台应用提前注册了这个全局热键，把按键事件"截胡"了。
传统做法是用 Hotkey Explorer 等工具逐个尝试所有组合来试探，但在 Windows 8 及之后的系统上，这种"盲试"方式会把按键发给所有程序，副作用很大。Hotkey Detective 的思路完全不同：
它不猜测，而是等待——你只需按下被占用的热键，它就能告诉你哪个进程收到了这个热键命令。
项目作者最初就是因为找不到简单好用的热键进程查询工具，才编写了这款轻量小工具（详见 README.adoc 的项目起源说明）。
二、一键上手：3 步运行热键检测工具
Hotkey Detective 以 ZIP 压缩包形式发布，无需安装。跟着下面三步走：
- 选择版本目录：解压后你会看到
x64和x86两个目录。64 位 Windows 运行x64目录下的HotkeyDetective.exe；32 位 Windows 运行x86目录版本。 - 以管理员身份运行：右键可执行文件 → "以管理员身份运行"。非管理员运行时程序会弹出警告提示（见 src/main.cpp 中的提权检查逻辑）。
- 按下被偷的热键：窗口弹出后，直接按下那个失效的热键组合，工具会在表格中显示"罪魁祸首"进程的完整路径。
整个操作流程在 README.adoc 中有官方说明，全程不到 1 分钟。
三、它是如何抓到"偷键者"的？🕵️
对好奇的同学，原理其实很优雅：
- 注入监控 DLL：主程序会把自己的钩子 DLL 注入到所有运行中的进程（
explorer.exe除外），监控逻辑位于 dll/HkdHook.cpp。 - 挂钩消息队列：DLL 通过
WH_GETMESSAGE与WH_CALLWNDPROC两类钩子，捕获进程收到的WM_HOTKEY消息，相关钩子实现见 dll/HkdHook.cpp。 - 共享内存通信：检测到热键后，DLL 通过内存映射文件把消息回传给主窗口，共享数据结构定义在 dll/HkdHook.h。
- 展示结果表格：主界面用一个两列表格展示"热键组合 → 进程路径"，表项结构与逻辑见 include/HotkeyTable.h；主窗口消息处理在 src/MainWindow.cpp 中实现。
核心管理逻辑（创建共享内存、建立/移除钩子）封装在 include/Core.h 的Core类中。
四、项目结构速览 📁
| 模块 | 路径 | 说明 |
|---|---|---|
| 程序入口 | src/main.cpp | WinMain 入口与消息循环 |
| 主窗口与 UI | src/MainWindow.cpp | 键盘消息处理、窗口逻辑 |
| 钩子 DLL | dll/HkdHook.cpp | 进程注入与热键监听 |
| 热键表格 | src/HotkeyTable.cpp | 结果展示组件 |
| 按键序列解析 | src/KeySequence.cpp | 把按键组合转成可读文本 |
| 构建脚本 | CMakeLists.txt | CMake 构建配置 |
五、从源码构建：CMake 一键编译
如果你有 CMake 3.17+ 和 MSVC 环境，也可以自己编译。项目使用 C++17 标准，构建入口为根目录的 CMakeLists.txt，钩子 DLL 的独立构建脚本在 dll/CMakeLists.txt。典型的构建步骤：
cmake -B build -G "Visual Studio 17 2022" -A x64 cmake --build build --config Release编译产物即HotkeyDetective.exe，可直接分发给同事使用。
六、常见问题 FAQ 💬
❓ 表格里没有任何结果？
- 确认以管理员身份运行；
- 64 位系统上如果
x64版本没查到，换个x86版本再试（或反过来）。
❓ 为什么我按了热键却检测不到？Hotkey Detective 只能识别真正注册到系统的全局热键。例如浏览器的Ctrl + T只在浏览器前台有效，并未注册为系统级热键，这类组合无法被检测（参见 README.adoc 的 FAQ 说明）。
❓ 用完之后为什么删不掉文件？因为监控 DLL 被加载到了系统中各进程里，主程序关闭后 DLL 仍驻留，文件会被占用。官方给出的临时方案是重启系统（见 README.adoc）。
七、总结 ✅
Hotkey Detective 把"找出热键占用者"这件繁琐的事压缩成了 3 步：解压 → 管理员运行 → 按下热键。它小巧、无需安装、原理透明，是 Windows 开发者排查快捷键冲突时值得放进工具箱的实用小工具。
💡 提示：排查热键冲突时，建议先列出所有可能注册该组合的应用（输入法、录屏软件、远程工具是"惯犯"），再用 Hotkey Detective 验证。
【免费下载链接】hotkey-detectiveA small program for investigating stolen key combinations under Windows 7 and later.项目地址: https://gitcode.com/gh_mirrors/ho/hotkey-detective
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
