KeyScope 快捷键侦探 GitHub 下载 Mac 版

原生 Mac 快捷键诊断工具

这个快捷键,
被谁接走了?

按了没反应,或打开了另一个软件。
在 KeyScope 按一次,看看接收软件和配置线索。

v1.0.6 · 安装包 1.4 MB · macOS 14.0 或更新版本
Apple Silicon (arm64)

GitHub Release 安装包与校验 · MIT 公开源码

这是 Mac 应用。把本页留到 Mac 上打开,就可以下载安装。

免费使用无需账号本机处理v1.0.5 (10) 实测空闲 27.3 MB 内存
真实应用界面KeyScope v1.0.0
KeyScope 1.0.0 已查询 Control + ↑,显示 macOS 系统已启用绑定,当前未在监听
macOS 27 实机截图。示例 ⌃↑ 展示系统绑定,其他排查线索保持折叠;它不代表本次按键已被实时归属。

按一下,找接收者

遇到系统派发的热键事件,直接显示这次事件接收软件。

按不进来,也能查

用「手动选择」指定组合,检查应用支持识别的快捷键配置。

线索,标明来源

接收事件、配置绑定、候选监听者分别呈现,帮你判断下一步。

资源占用

资源占用与响应速度。

SwiftUI 与系统框架,零第三方依赖;无后台进程、登录项或定时任务。只在点「开始检测」后建立只读键盘监听,收到组合即停止;检测期间每 2 秒自检一次权限,结束即销毁。

1.4 MB

安装包

下载文件大小;装好后 2.4 MB。

27.3 MB

空闲内存

所列采样窗口内存,口径为 phys_footprint。

0 %

空闲 CPU

不操作时 60 秒内的平均占用。

325 ms

速度

冷启动到首屏就绪(中位数)。

v1.0.5 (10) · Mac16,12 / Apple M4 / macOS 27.2 · 运行资源来自所列版本的静默隔离副本;启动到首屏就绪,不建立键盘监听。安装包大小取所列发行 DMG。 · 测量日期 2026-10-15。数字来自所列版本与设备的测量记录;当前版本与测量范围以本页说明为准。

历史实测范围:以下为 v1.0.5 (10) 的测量记录,不代表当前公开发行 v1.0.6 (11);本轮未重复采样。当前下载包大小见下载按钮。

内存口径为 phys_footprint(活动监视器「内存」列同口径),按十进制 MB 展示。

静默启动后静置 45 秒,再采样 60 秒;内存与 CPU 包含主进程及辅助进程。CPU 为同窗 CPU 时间 ÷ 墙钟时间。

冷启动到首屏就绪以 App 就绪日志为准,5 次取中位数。

无 launchd、登录项或后台定时任务;计时器只在「开始检测」期间存在(2 秒一次权限/安全输入自检),检测结束即销毁。

未测范围与原因

  • 可见窗口下的空闲内存:为不抢焦点只测隐藏启动(-j),可见窗口会多出窗口缓冲,未测
  • 检测进行中的内存/CPU:需要真实按键与输入监控授权,不能合成按键,未测

从下载到第一次检测

装好,授权,
再按下那个快捷键。

不需要终端知识,也不需要注册。
首次运行的系统提示,按这里的顺序处理。

  1. 把 KeyScope 放进「应用程序」

    下载 KeyScope-1.0.6-arm64.dmg 后,在访达的「下载」文件夹双击打开。把磁盘映像中的 KeyScope.app 拖到旁边的 Applications(应用程序),再从「应用程序」打开 KeyScope。

    打开 DMGKeyScope.appApplications

    升级时先退出旧版,再替换应用。发行包已通过 Apple 公证。

  2. 允许「输入监控」

    在 KeyScope 点击「打开输入监控设置」。进入「系统设置 → 隐私与安全性 → 输入监控」,打开 KeyScope 旁的开关。系统要求时,输入的是 Mac 登录密码或使用触控 ID。

    按系统提示退出并重新打开 KeyScope,再点击「重新检查权限」。这项权限让应用能观察你主动检测的快捷键。

    列表中没有 KeyScope?点输入监控列表的「+」,在「应用程序」中选择 KeyScope。授权后仍未就绪,先完全退出再打开。

  3. 点击「开始检测」,按下想检查的组合

    看到「按下你想检查的快捷键」后,按一次你遇到冲突的组合,例如 ⌃ G。收到组合后会自动结束本轮监听并保留结果,说明找到了接收者、配置绑定,还是只有排查线索。继续检查其他组合,点击「再次检测」。

    如果按键被提前拦住,点「手动选择」,选好修饰键和按键,再点「查询此组合」。下方演示以 ⌃ ↑ 为例。检测尚未完成时,也可以点击「停止检测」结束监听。

    看懂不同结果

设置、改键和同步,在同一个窗口。

从 KeyScope 菜单打开「配置与更新…」,可选择默认展开排查详情、关闭或修改应用刷新键(默认⌘L)。iCloud 同步由你选择开启,也可以导入或导出配置;仅同步便携设置与更新选项,输入监控权限、目录授权和诊断结果留在本机。

窗口内可检查新版、设置自动检查间隔;关闭自动检查后保留原选择。下面是当前下载版的真实离屏设置截图,原诊断录像只覆盖检测与手动查询。

KeyScope 配置与更新窗口,包含默认详情、应用刷新键、iCloud 和更新选项

找到线索之后

结果有多确定,
界面就说到哪里。

Mac 上有多种快捷键机制。
有接收记录,可以定位;只有监听器,需要继续确认。

观察到接收软件

这次事件,派给了它。

按键与系统热键路由能可靠对应时,显示接收软件。这是本次事件的直接线索;仅时间相邻的事件会单独标为线索。

接下来到这个软件的快捷键设置中检查对应功能。
匹配配置

配置中,写着这个组合。

查询系统绑定、Keyboard Maestro、Karabiner、skhd、Hammerspoon 的可识别配置,以及 Raycast 的全局唤起快捷键。带触发条件的规则单独标明。

接下来结合当前应用和规则条件,核对是否生效。
可能拦截的监听器

能拦截,不等于拦了它。

列出有键盘过滤能力的软件,帮助缩小排查范围。候选名单本身不证明谁占用了这次按键。

接下来自行暂停一个候选软件,再按同一组合对照。

没有检测到,不等于快捷键空闲。应用内部快捷键、条件改键、被提前吞掉的事件,可能无法直接归属。KeyScope 不会替你停用软件或修改它们的快捷键。

跟着真实界面操作

两段演示,
看清检测和继续排查。

两段来自 macOS 27 的独立实机录制。第一段为归属验证构建的真实按键;正式版已改为收到组合后自动停止。第二段展示最终签名版手动查询 ⌃↑,选择和查询结果分段录制。

01

真实按键,验证接收软件

真实按下 ⌃⌥⇧G,识别到独立测试接收程序。含结果停帧解读。

02

手动选择,查看线索

选择 Control + ↑,查询并查看 macOS 系统绑定。查询结果为另段补录。

视频可以暂停、拖动、全屏。首段裁去本机配置并标明结果停帧;第二段略去等待,补录衔接均有字幕说明。下载完整教程 ↓

你按下的键,留在你的 Mac

需要时开始,查完就停止。

快捷键和配置读取都在本机处理。无需账号,不上传按键或扫描结果。程序仅在检测期间监听;收到组合后自动停止并保留结果,也可以随时点击「停止检测」。

遇到问题

这里有下一步。

先对照状态,再决定怎么排查。

它是 ShortcutDetective 的新版吗?

KeyScope 是独立制作的 Mac 应用,沿用「打开、按键、查看接收软件」这一熟悉的诊断体验,同时提供手动查询和监听者线索。它与 ShortcutDetective 及其原作者没有隶属关系。

我的 Mac 能运行吗?

需要 macOS 14.0 或更新版本。Apple Silicon (arm64)。最低 macOS 14;真实运行验收环境为 macOS 27、Apple Silicon。其他系统版本未逐一实测。点击屏幕左上角  →「关于本机」可以查看系统和芯片。

打开时提示无法验证开发者或应用已损坏。

先确认安装包来自本页指向的 GitHub Release,已完整下载并拖入「应用程序」。若仍被系统阻止,重新下载该发行页的安装包后再试。

查看安装步骤 ↑
已允许输入监控,仍然提示需要权限。

先在应用菜单选择「退出 KeyScope」,再从「应用程序」重新打开。回到「系统设置 → 隐私与安全性 → 输入监控」,确认开关对应的是安装在「应用程序」里的这一份 KeyScope,然后点击「重新检查权限」。如果刚替换过应用,可移除旧条目后重新添加。

按下快捷键,却没有显示接收软件。

确认已开始检测且输入监控已授权。如果键盘事件被其他工具提前吞掉,或快捷键由应用自身处理,系统可能不会提供可归属的接收记录。用「手动选择」查询已知配置,再查看候选监听者。没有检测到,不代表没有占用。

列出了几个候选,怎么知道究竟是哪一个?

先看有没有系统接收记录或明确配置。只有候选时,可以在候选软件自身的设置里暂停一个,再按同一组合比较。一次只改变一个软件,排查完恢复原设置。KeyScope 不会自动结束其他应用。

查询结果会自动修改我的快捷键吗?

不会。KeyScope 用于观察事件和读取配置。解除冲突需要你到对应软件的设置里改键或禁用规则;应用不会擅自改写其他软件的配置。

会一直记录我输入的内容吗?

不会。点击「开始检测」开启一轮监听,收到组合后自动停止并保留结果;等待期间也能点「停止检测」。按键、诊断结果和读取到的其它软件配置不上传。你可以另行选择用 iCloud 同步 KeyScope 的便携设置;权限和诊断数据不随配置传输。不需要常驻后台,查完可以直接退出。

问题仍然存在,怎样反馈?

记录 macOS 版本、KeyScope 版本、快捷键组合,以及界面显示的结果和操作步骤。截图前遮住不希望公开的软件名与路径。提交问题 ↗

当前版本

KeyScope 1.0.6

2026-10-16 发布 · 发行包已通过 Apple 公证。

  • 查看系统热键事件的接收进程。
  • 手动选择组合,查找可识别的本机配置。
  • 呈现候选监听者与清楚的证据级别。
  • App 内附命令行 keyscope,支持只读查询、权限状态、检查更新及确认后升级。
发行文件与更新记录 ↗
KeyScope 图标

从那个失灵的快捷键开始

把线索,找出来。

打开 KeyScope,再按一次。

GitHub 下载 Mac 版 v1.0.6

1.4 MB · GitHub SHA-256 校验 · 安装教程