按一下,找接收者
遇到系统派发的热键事件,直接显示这次事件接收软件。
原生 Mac 快捷键诊断工具
按了没反应,或打开了另一个软件。
在 KeyScope 按一次,看看接收软件和配置线索。
这是 Mac 应用。把本页留到 Mac 上打开,就可以下载安装。
遇到系统派发的热键事件,直接显示这次事件接收软件。
用「手动选择」指定组合,检查应用支持识别的快捷键配置。
接收事件、配置绑定、候选监听者分别呈现,帮你判断下一步。
资源占用
SwiftUI 与系统框架,零第三方依赖;无后台进程、登录项或定时任务。只在点「开始检测」后建立只读键盘监听,收到组合即停止;检测期间每 2 秒自检一次权限,结束即销毁。
1.4 MB
下载文件大小;装好后 2.4 MB。
27.3 MB
所列采样窗口内存,口径为 phys_footprint。
0 %
不操作时 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 秒一次权限/安全输入自检),检测结束即销毁。
从下载到第一次检测
不需要终端知识,也不需要注册。
首次运行的系统提示,按这里的顺序处理。
下载 KeyScope-1.0.6-arm64.dmg 后,在访达的「下载」文件夹双击打开。把磁盘映像中的 KeyScope.app 拖到旁边的 Applications(应用程序),再从「应用程序」打开 KeyScope。
升级时先退出旧版,再替换应用。发行包已通过 Apple 公证。
在 KeyScope 点击「打开输入监控设置」。进入「系统设置 → 隐私与安全性 → 输入监控」,打开 KeyScope 旁的开关。系统要求时,输入的是 Mac 登录密码或使用触控 ID。
按系统提示退出并重新打开 KeyScope,再点击「重新检查权限」。这项权限让应用能观察你主动检测的快捷键。
列表中没有 KeyScope?点输入监控列表的「+」,在「应用程序」中选择 KeyScope。授权后仍未就绪,先完全退出再打开。
看到「按下你想检查的快捷键」后,按一次你遇到冲突的组合,例如 ⌃ G。收到组合后会自动结束本轮监听并保留结果,说明找到了接收者、配置绑定,还是只有排查线索。继续检查其他组合,点击「再次检测」。
如果按键被提前拦住,点「手动选择」,选好修饰键和按键,再点「查询此组合」。下方演示以 ⌃ ↑ 为例。检测尚未完成时,也可以点击「停止检测」结束监听。
看懂不同结果从 KeyScope 菜单打开「配置与更新…」,可选择默认展开排查详情、关闭或修改应用刷新键(默认⌘L)。iCloud 同步由你选择开启,也可以导入或导出配置;仅同步便携设置与更新选项,输入监控权限、目录授权和诊断结果留在本机。
窗口内可检查新版、设置自动检查间隔;关闭自动检查后保留原选择。下面是当前下载版的真实离屏设置截图,原诊断录像只覆盖检测与手动查询。

找到线索之后
Mac 上有多种快捷键机制。
有接收记录,可以定位;只有监听器,需要继续确认。
按键与系统热键路由能可靠对应时,显示接收软件。这是本次事件的直接线索;仅时间相邻的事件会单独标为线索。
查询系统绑定、Keyboard Maestro、Karabiner、skhd、Hammerspoon 的可识别配置,以及 Raycast 的全局唤起快捷键。带触发条件的规则单独标明。
列出有键盘过滤能力的软件,帮助缩小排查范围。候选名单本身不证明谁占用了这次按键。
没有检测到,不等于快捷键空闲。应用内部快捷键、条件改键、被提前吞掉的事件,可能无法直接归属。KeyScope 不会替你停用软件或修改它们的快捷键。
跟着真实界面操作
两段来自 macOS 27 的独立实机录制。第一段为归属验证构建的真实按键;正式版已改为收到组合后自动停止。第二段展示最终签名版手动查询 ⌃↑,选择和查询结果分段录制。
真实按下 ⌃⌥⇧G,识别到独立测试接收程序。含结果停帧解读。
选择 Control + ↑,查询并查看 macOS 系统绑定。查询结果为另段补录。
视频可以暂停、拖动、全屏。首段裁去本机配置并标明结果停帧;第二段略去等待,补录衔接均有字幕说明。下载完整教程 ↓
你按下的键,留在你的 Mac
快捷键和配置读取都在本机处理。无需账号,不上传按键或扫描结果。程序仅在检测期间监听;收到组合后自动停止并保留结果,也可以随时点击「停止检测」。
遇到问题
先对照状态,再决定怎么排查。
KeyScope 是独立制作的 Mac 应用,沿用「打开、按键、查看接收软件」这一熟悉的诊断体验,同时提供手动查询和监听者线索。它与 ShortcutDetective 及其原作者没有隶属关系。
需要 macOS 14.0 或更新版本。Apple Silicon (arm64)。最低 macOS 14;真实运行验收环境为 macOS 27、Apple Silicon。其他系统版本未逐一实测。点击屏幕左上角 →「关于本机」可以查看系统和芯片。
先在应用菜单选择「退出 KeyScope」,再从「应用程序」重新打开。回到「系统设置 → 隐私与安全性 → 输入监控」,确认开关对应的是安装在「应用程序」里的这一份 KeyScope,然后点击「重新检查权限」。如果刚替换过应用,可移除旧条目后重新添加。
确认已开始检测且输入监控已授权。如果键盘事件被其他工具提前吞掉,或快捷键由应用自身处理,系统可能不会提供可归属的接收记录。用「手动选择」查询已知配置,再查看候选监听者。没有检测到,不代表没有占用。
先看有没有系统接收记录或明确配置。只有候选时,可以在候选软件自身的设置里暂停一个,再按同一组合比较。一次只改变一个软件,排查完恢复原设置。KeyScope 不会自动结束其他应用。
不会。KeyScope 用于观察事件和读取配置。解除冲突需要你到对应软件的设置里改键或禁用规则;应用不会擅自改写其他软件的配置。
不会。点击「开始检测」开启一轮监听,收到组合后自动停止并保留结果;等待期间也能点「停止检测」。按键、诊断结果和读取到的其它软件配置不上传。你可以另行选择用 iCloud 同步 KeyScope 的便携设置;权限和诊断数据不随配置传输。不需要常驻后台,查完可以直接退出。
记录 macOS 版本、KeyScope 版本、快捷键组合,以及界面显示的结果和操作步骤。截图前遮住不希望公开的软件名与路径。提交问题 ↗
当前版本
2026-10-16 发布 · 发行包已通过 Apple 公证。
keyscope,支持只读查询、权限状态、检查更新及确认后升级。