HotkeyClash for Mac v0.9.2 开源软件(Mac 快捷键冲突检测)

HotkeyClash 是一款开源的 macOS 菜单栏快捷键冲突检测工具，可集中扫描运行中应用的菜单快捷键、常见自动化工具的配置文件及系统快捷键，帮助查明同一组合键被哪些操作占用。它支持 Karabiner-Elements、skhd、Keyboard Maestro、BetterTouchTool、Hammerspoon 和 Alfred，并能读取 Spotlight、Mission Control、截图及 Globe 功能键相关快捷键。软件将冲突区分为确定冲突与潜在冲突，根据驱动层、事件拦截层、系统层、全局快捷键层和应用菜单层的处理顺序，提示哪个操作更可能优先响应；同层竞争无法确定时不会强行判断。用户还可实际按键，检查哪个应用真正接收了输入。界面采用冲突列表与详情面板的双栏布局，支持按应用、操作或组合键搜索、导出 Markdown 报告，以及固定面板方便对照修改配置。扫描运行中应用需要辅助功能权限，读取配置文件和系统快捷键则不需要该权限。软件使用纯 Apple 框架，无外部依赖，要求 macOS 14 或更新版本。

功能

HotkeyClash 是面向 macOS 的开源菜单栏工具，将应用菜单、自动化配置和系统设置中的快捷键汇集到同一视图，结合冲突分类、处理层级分析与实际按键测试，帮助定位快捷键失效或响应不符合预期的原因。

• 运行中应用扫描： 通过辅助功能 API 遍历运行中应用的菜单栏，提取菜单项目对应的快捷键，识别不同应用之间的重复绑定；此项扫描需要授予辅助功能权限。
• 多工具配置解析： 支持读取 Karabiner-Elements、skhd、Keyboard Maestro、BetterTouchTool、Hammerspoon 和 Alfred 的相关配置，涵盖键盘映射、自动化宏、全局热键及工作流热键触发器。
• 系统快捷键读取： 从 macOS 系统快捷键配置中识别 Spotlight、Mission Control、截图等操作的组合键，便于检查第三方工具与系统功能之间的占用关系。
• 冲突类型区分： 将全局快捷键之间的重复绑定标记为确定冲突，将应用菜单快捷键之间的重复绑定标记为潜在冲突，避免把所有相同组合键都视为同等严重的问题。
• 响应优先级分析： 按驱动、事件拦截、系统快捷键、全局热键和应用菜单等处理层级，提示哪个绑定更可能优先响应。对于处于同一层级的工具，会说明无法仅凭配置确定先后，因为实际结果还取决于注册顺序。
• 实际按键验证： 观察一次真实按键并报告实际接收输入的应用，用于核对配置分析结果，辅助排查快捷键被其他程序截获的问题。
• 双栏冲突视图： 使用约 800×580 的分栏面板，左侧列出冲突，右侧展示详细信息，并配合应用图标和来源标记帮助辨认相关程序及配置来源。
• 快捷搜索定位： 支持按应用名称、操作名称或组合键搜索，快速缩小排查范围，适合在较多快捷键绑定中寻找具体冲突。
• Markdown 报告导出： 可将完整检测报告导出为 Markdown，方便保存排查记录、整理快捷键清单或与他人共享冲突信息。
• 面板固定显示： 支持将面板固定保持打开，在切换至系统设置或相关应用修改快捷键时，可继续对照冲突详情。
• Globe 功能键识别： 能读取 Globe 即 fn 相关快捷键，并将 HotkeyClash 自身的热键纳入列表，避免遗漏检测工具本身造成的占用。
• 权限范围清晰： 配置文件和系统快捷键的读取不依赖辅助功能权限；BetterTouchTool 的数据库采用只读方式访问。Raycast 的加密存储无法直接解析，可借助实际按键测试排查其响应情况。
• 原生框架与开源实现： 使用纯 Apple 框架，无外部依赖，采用 GPL-2.0 开源许可。支持通过 Homebrew、DMG 或 ZIP 安装，源码构建要求 Xcode 16 及以上版本，运行要求 macOS 14 及以上版本。

下载地址