KeyClu：macOS 应用快捷键速查工具 #

KeyClu 是什么？ #

KeyClu 是一款专为 macOS 打造的开源应用快捷键速查工具，只需连按两次 ⌘ 键并按住，即可在屏幕中央呼出当前应用的完整快捷键列表。

它的核心价值在于解决「快捷键记不住、用不起来」的普遍痛点。无论是 Photoshop、Final Cut Pro 这类专业软件，还是浏览器、编辑器等日常工具，KeyClu 都能自动读取并整理其菜单中的快捷键条目，以悬浮面板形式清晰呈现。用户可以为主流快捷键添加书签、隐藏已经掌握的条目、按菜单分组折叠查看，甚至将整套快捷键导出为 Markdown 文件长期保存。此外，它还统一汇总了 macOS 系统热键与手势、skhd 热键、Jitouch2 手势以及用户自定义快捷键，让你在一个面板里看懂整台 Mac 的操作方式。KeyClu 完全免费、开源、不收集任何个人数据，适合追求极致效率的 Mac 用户。

KeyClu 有哪些亮点特色？ #

• 一键唤起，零学习成本：默认连按两次 ⌘ 键并按住即可呈现当前应用快捷键列表；也可切换为「按住 ⌘ 键」的备选触发方式，无需记忆额外组合键。
• 界面随心调整：外观可自由切换为跟随系统、浅色或深色主题，与 macOS 原生风格保持一致，长时间查看也不刺眼。
• 书签与隐藏机制：可为高频快捷键添加书签置顶显示，也可一键隐藏已经熟练的快捷键，让面板只保留真正需要记忆的内容。
• 分组可折叠：快捷键按应用菜单结构自动分组，支持折叠/展开，面对数百条快捷键时依然能够快速定位。
• 一键导出 Markdown：可将任意应用的快捷键列表导出为 Markdown 文件，方便整理成个人速查手册或团队共享文档。
• 系统级热键与手势全覆盖：除应用快捷键外，还能展示 macOS 热键、macOS 手势、skhd 热键以及 Jitouch2 手势，一屏掌握整机操作方式。
• 支持自有快捷键与深度集成：可展示用户自行定义的快捷键，并与 CustomShortcuts 集成以自定义快捷键、与 skhd 集成以列出热键，同时提供 CLI 参数支持（详见官方 Wiki）。
• 隐私安全，零数据采集：KeyClu 不收集任何个人信息，也不使用任何分析、广告类第三方服务；采用 BSD-3-Clause-Clear 开源许可证，代码完全公开可审计。

免费下载 KeyClu #

以下为官方及镜像提供的 macOS 安装包，点击链接即可下载。

KeyClu 如何使用？ #

1. 首次启动并授权：安装后打开 KeyClu，按提示在「系统设置 → 隐私与安全性 → 辅助功能」中勾选 KeyClu，授予辅助功能（Accessibility API）访问权限，这是其读取应用菜单快捷键的必要条件。建议同时允许通知中心访问，以便接收更新提醒。
2. 唤起快捷键面板：切换到任意应用（如 Safari、Finder、Photoshop），连按两次 ⌘ 键并按住，屏幕即会弹出该应用当前可用的快捷键列表。
3. 切换触发方式：若双按 ⌘ 与其他软件的快捷键冲突，可在设置中改为「按住 ⌘ 键」的备选方式唤起面板。
4. 整理你的快捷键清单：在面板中为常用快捷键添加书签、对已掌握的条目选择隐藏，或折叠不需要查看的分组；点击相应用户操作即可将整套快捷键导出为 Markdown 文件。
5. 查看系统级热键与手势：在同一面板中切换分类，可查看 macOS 热键、macOS 手势、skhd 热键、Jitouch2 手势以及你自己定义的自定义快捷键。

提示：若图标被隐藏，直接再次启动应用即可打开设置界面。高级用户还可通过 CLI 参数在终端中调用 KeyClu 的能力，具体用法参见官方 Wiki 的 CLI params 页面。

KeyClu 的常见问题？ #

图标被隐藏了，如何打开设置？ 再次启动一次 KeyClu 应用即可打开设置界面，这是官方推荐的快捷方式。

KeyClu 需要哪些系统权限？ 它必须获得辅助功能（Accessibility API）访问权限才能正常读取应用菜单与快捷键；此外官方建议授予通知中心访问权限，用于发送温和的更新提醒。

应用突然崩溃了怎么办？ 请在 GitHub 仓库提交 Issue，并附上详细信息、相关日志，以及可能触发崩溃的操作步骤描述。官方 FAQ 页面「KeyClu just crashed」提供了收集所需信息的指引。

KeyClu 会收集我的个人数据吗？ 不会。根据官方隐私政策，KeyClu 不收集任何个人信息，也不使用分析、广告等任何第三方服务。

为什么某些快捷键没有显示出来？ KeyClu 主要读取应用菜单中定义的快捷键。若使用了自定义快捷键方案，可借助 CustomShortcuts 集成或 skhd 集成来展示；文中未覆盖的自定义场景可参考官方 Wiki 相关说明。

支持哪些界面语言？ 官方 README 提供 English、简体中文（readme.zh-CN.md）与 日本語（readme.ja-JP.md）三种语言的文档，界面同样已由社区贡献者完成多语言适配。

KeyClu 如何安装？ #

方式一：Homebrew（推荐） #

1. 打开「终端」（Terminal）应用。
2. 输入以下命令并回车：

   brew install --cask keyclu
   

3. 安装完成后，从「启动台」或「应用程序」文件夹启动 KeyClu。
4. 首次启动时按提示授予辅助功能权限。

方式二：手动安装 #

1. 从上方下载表格获取最新版本的 .dmg 安装包。
2. 双击打开 .dmg 文件。
3. 将 KeyClu 应用图标拖拽至「应用程序」（Applications）文件夹。
4. 在「应用程序」中双击 KeyClu 启动；若系统提示「来自未识别开发者」，可在「系统设置 → 隐私与安全性」中点击「仍要打开」。
5. 按引导前往「系统设置 → 隐私与安全性 → 辅助功能」勾选 KeyClu，完成授权后即可使用。

注意：KeyClu 为 macOS 专属应用，不支持 Windows、Linux 等其他平台。安装包体积仅 5 MB 左右，安装过程无需重启系统。

KeyClu 如何卸载？ #

通过 Homebrew 卸载（适用于使用 brew 安装的用户） #

1. 打开「终端」应用。
2. 执行命令：

   brew uninstall --cask keyclu
   

3. 如需一并清除残留配置，可执行 brew uninstall --zap --cask keyclu。

手动卸载 #

1. 在菜单栏或 Dock 中退出 KeyClu（确保进程未在后台运行）。
2. 打开「访达 → 应用程序」，将 KeyClu 拖入「废纸篓」。
3. 清空废纸篓完成卸载。
4. 如需彻底清理残留数据，可手动检查并删除以下位置的 KeyClu 相关文件（macOS 通用清理路径，具体文件名以实际安装为准）：
   • ~/Library/Preferences/ 下的 KeyClu 偏好设置文件
   • ~/Library/Application Support/ 下的 KeyClu 数据目录
   • ~/Library/Caches/ 下的 KeyClu 缓存目录

提醒：卸载后建议回到「系统设置 → 隐私与安全性 → 辅助功能」，确认 KeyClu 条目已从权限列表中移除，避免残留无效授权项。