HotkeyClash icon

HotkeyClash

HotkeyClash 是一款 macOS 工具,可扫描正在运行的应用、Karabiner、skhd 和系统快捷键,查找键盘快捷键冲突,帮你快速定位哪个应用占用了某个热键,以及该去哪里修改。

HotkeyClash

概述

HotkeyClash 是一款 macOS 工具,用于查找键盘快捷键在正在运行的应用、自动化工具和内置系统快捷键之间的冲突位置。它会扫描来自实时应用的菜单栏快捷键,读取 Karabiner-Elements 和 skhd 配置文件,并检查 macOS 符号热键,让你一次性看到所有被占用的按键组合。

这款应用面向在同一台 Mac 上使用多个快捷键密集型工具的人,帮助你在某个组合失效时快速确认到底是哪个应用占用了它。它会区分确定冲突与依赖焦点的重叠,然后展示占用者及其来源,这样你就能修改正确的设置,而不是盲目猜测。

功能

实时扫描正在运行的应用

扫描每个正在运行的应用通过辅助功能 API 暴露的快捷键,因此你可以看到 macOS 原样呈现的菜单栏快捷键。

解析自动化配置

直接读取 `karabiner.json` 和 `skhdrc`,因此即使映射后的快捷键或配置中定义的热键从未传递到其他应用,也会被纳入。

包含系统快捷键

纳入 macOS 符号热键,包括 Mission Control、Spotlight、屏幕截图和 Dock 隐藏等内置快捷键。

冲突严重程度分类

按按键组合对所有绑定进行分组,并标记确定冲突与潜在冲突,帮助你区分真正的冲突和依赖焦点的重叠。

清晰来源标注的可读 Mac 界面

显示原生分栏界面,带有来源徽标、应用图标,以及会统计确定冲突数量的菜单栏徽标。

以隐私优先的本地运行

保持应用轻量且可审查,不发起网络请求、不需要账户、不收集遥测,并且在退出后不会保留扫描结果。

使用场景

  • 排查全局热键冲突

    在你手动排查之前,先检查启动器、窗口管理器或快捷键工具是否占用了与另一个全局热键相同的按键组合。

  • 诊断依赖焦点的快捷键冲突

    将应用的菜单快捷键与系统级绑定进行比较,了解为什么某个命令只会在该应用打开并获得焦点时失效。

  • 审查快捷键密集的自动化配置

    将 Karabiner-Elements 和 skhd 规则与应用快捷键放在一起查看,让重映射按键和 shell 驱动的绑定都纳入同一份清单。

  • 在分配前检查快捷键

    在 System Settings 或应用偏好设置中分配新快捷键之前,先验证你的选择,尤其是当你已经运行多个注册全局热键的工具时。

  • 整理繁忙 Mac 上的快捷键

    在整理一个将内置快捷键与第三方应用混合使用的繁忙 Mac 时,把扫描结果当作权威清单来使用。

Pros and Cons

Pros

  • 一次扫描即可检查正在运行的应用、Karabiner、skhd 和 macOS 系统快捷键。
  • 将确定冲突与潜在冲突分开,让结果列表更便于处理。
  • 提供来源徽标和占用详情,帮助你找到需要修改的位置。
  • 本地运行,不发起网络请求,不需要账户,也不收集遥测。
  • 根据 GPL-2.0 免费开源,代码可供审查。

Cons

  • 它不会编辑或重新分配快捷键;修复冲突仍需在受影响的应用或系统设置中完成。
  • 覆盖范围仅限于网站上列出的扫描器和解析器,尽管路线图中提到了更多解析器。

FAQ

HotkeyClash 需要辅助功能访问权限吗?

HotkeyClash 会在首次扫描时请求辅助功能权限,以便读取正在运行应用中的菜单快捷键。即使没有该权限,它仍然可以扫描 Karabiner、skhd 和 macOS 系统快捷键,但在获得访问权限之前无法检查正在运行应用的菜单。

HotkeyClash 会扫描哪些来源?

它会一次性扫描正在运行应用的菜单快捷键、Karabiner-Elements 规则、skhd 热键以及 macOS 系统快捷键。功能页面还提到,路线图中包括更多解析器,例如 Keyboard Maestro、BetterTouchTool、Hammerspoon、Alfred 和 Raycast。

HotkeyClash 如何分类冲突?

该应用会突出显示确定冲突和潜在冲突。确定冲突是指两个全局热键使用了相同的组合键;潜在冲突是指全局热键与某个应用的菜单快捷键重叠,且只会在该应用获得焦点时失效。

HotkeyClash 可以帮我修复快捷键吗?

HotkeyClash 不会编辑或重新分配快捷键。扫描显示冲突后,你需要在相关应用或系统设置中修改快捷键,然后再次扫描以确认冲突已消失。

支持哪些平台和安装方式?

HotkeyClash 是一款用于查找快捷键冲突的 macOS 工具,下载方式包括 DMG 或通过 Homebrew。网站说明它支持 macOS 14+,包括 Apple Silicon 和 Intel Mac,并且根据 GPL-2.0 许可免费开源。

Quick Facts

类别
开发者工具
平台
macOS 14+;Apple Silicon 和 Intel
许可证
GPL-2.0
定价
永久免费
主要任务
查找键盘快捷键冲突
安装方式
DMG 下载或 Homebrew cask