键谱 keymap：100KB+ 的快捷键可视化记录工具 #

键谱是什么？ #

键谱（keymap）是一款用于记录、展示软件快捷键的本机网页应用，整个程序仅 100KB+，双击 HTML 文件即可在浏览器中打开使用。

日常使用的软件往往带有大量快捷键，靠记忆很容易混淆或遗忘，而网上现有的快捷键管理方案要么需要联网、要么要求自建 Web 服务，安装包动辄几十上百兆。键谱针对这些痛点给出了一个极简答案：它是一个单网页文件，无需联网、无需部署服务器，打开即用；数据保存在浏览器本地，支持导入导出与多套配置管理；展示上提供键盘图、列表等多种图形化模式，还可通过"键盘层"组织不同修饰键下的映射关系。此外，官方还附带"谱匣"辅助增强程序，为键谱补充文件存储能力，使其运行体验接近一个独立单机程序。

键谱有哪些亮点特色？ #

• 单网页文件，零部署：整个键谱就是一个 HTML 文件，浏览器直接打开即可运行，无需联网、无需自建 Web 服务，也不依赖任何后端环境。
• 体积小巧到极致：核心程序仅 100KB+，相比动辄几十上百兆的同类安装包，几乎不占用磁盘空间，拷贝到 U 盘随身携带也毫无压力。
• 多种可视化展示模式：提供键盘图、列表等多种展示方式，把抽象的文字快捷键变成直观的键位布局，一眼就能看清哪个键对应哪个功能。
• 录入方便，支持多配置：快捷键录入流程简单，并且支持同时维护多套键谱配置，方便为不同软件、不同工作场景分别建立专属快捷键档案。
• 支持键盘层（Layer）：可通过键盘层组织快捷键映射，让同一套键谱能够覆盖不同修饰键或模式下的按键组合，结构更清晰。
• 丰富的自定义选项：提供 custom.example.css、custom.example.js、present.example.js 等示例文件，具备一定前端基础的用户可以自行调整样式与展示逻辑。
• 数据本地存储，隐私可控：所有键谱数据保存在浏览器本地，不上传云端，配合导入导出功能，既能防止数据丢失，也便于在设备之间迁移。
• 附带"谱匣"增强程序：谱匣让键谱像独立的单机程序一样运行，为其增加文件存储能力（键盘映射配置会保存到同目录下的同名文件中），并支持通过命令行参数 -PLVSH 自定义载入的键谱及显示界面。

免费下载键谱 #

以下为官方发布的两个版本压缩包，点击链接即可下载。若只想体验核心功能，下载体积更小的网页版即可；若还需要"谱匣"辅助增强程序，请选择完整包。

键谱基于 MIT 协议开源，源码与最新版本可访问官方仓库：https://github.com/cataerogong/keymap

键谱 如何使用？ #

键谱的使用门槛极低，基本流程如下：

1. 打开程序：解压下载的压缩包，双击其中的 keymap.html 文件，系统默认浏览器会自动打开键谱界面。整个过程不需要安装、不需要联网。
2. 新建或选择配置：进入界面后新建一套键谱（配置），每套配置可以对应一个软件或一个使用场景，例如"编辑器""设计软件""IDE"等。
3. 录入快捷键：在录入界面依次添加按键组合与对应的功能说明，键盘层可用于区分不同修饰键或模式下的映射。
4. 切换展示模式：在键盘图、列表等展示模式之间切换，找到最适合自己查阅的呈现方式；键盘图适合快速定位键位，列表适合逐条核对功能。
5. 导出与分享：通过导入导出功能把键谱保存为文件，既可以作为备份，也可以分享给同事或社区。官方 README 中"键谱分享"章节还收录了网友制作分享的键谱，欢迎通过 PR 或到相关论坛帖子中交流。

如果使用完整包中的谱匣，操作方式略有不同：运行谱匣程序后，键谱会以接近独立单机程序的形式启动（实际仍调用系统浏览器），键盘映射配置会保存到同目录下的同名文件中，并可通过命令行参数 -PLVSH 自定义载入的键谱及显示界面。

键谱的常见问题？ #

键谱需要联网或搭建服务器吗？ 不需要。键谱是一个单网页文件，浏览器直接打开即可运行，官方明确说明"无需联网，无需自建 web 服务"，所有功能都在本地完成。

我的快捷键数据保存在哪里？ 键谱的数据存放在浏览器本地。使用"谱匣"时，键盘映射配置会存储在同目录下的同名文件里，便于随程序一起携带和备份。

键谱和"谱匣"是什么关系？ 键谱是核心网页应用，"谱匣"是官方提供的辅助增强程序。谱匣让键谱像独立的单机程序一样运行，为它增加文件存储能力，并支持命令行参数自定义载入的键谱及显示界面。

换了电脑后键谱数据会同步吗？ 键谱本身不提供云端同步。跨设备迁移需要通过导入导出功能手动搬运键谱文件，或直接使用"谱匣"保存在同目录文件中的配置。

键谱能在 macOS 或 Linux 上使用吗？ 键谱本体是网页应用，任何具备现代浏览器的系统都可以打开 keymap.html 使用。官方随包提供的"谱匣"为可执行程序，官网未说明其支持的全部操作系统范围。

键盘层（Layer）是什么？ 键盘层用于在同一套键谱中区分不同修饰键或模式下的按键映射（参考社区常见反馈），使一份键谱能够承载更复杂的快捷键体系，而不必拆分成多个配置。

键谱如何安装？ #

键谱是绿色免安装的网页应用，绝大多数情况下"解压即用"。

Windows

1. 从上方下载表格中获取 keymap-3.5.3-html.zip（仅网页）或 keymap-3.5.3-all.zip（含谱匣）。
2. 使用任意解压工具将压缩包解压到任意目录，例如 D:\keymap。
3. 双击目录中的 keymap.html，默认浏览器会打开键谱界面，安装完成。
4. 如需使用"谱匣"：进入完整包中的 exe 目录，运行对应的可执行程序即可，无需额外安装步骤。

macOS / Linux

1. 下载并解压 keymap-3.5.3-html.zip。
2. 双击 keymap.html，或右键选择用浏览器打开。
3. 官网未提供针对 macOS / Linux 的专用安装包，"谱匣"在非 Windows 平台上的可用性官网未说明。

小提示

• 可以把 keymap.html 添加到浏览器书签，或固定到浏览器标签页，随时一键打开。
• 如果希望键谱开机即用，可将 HTML 文件创建为桌面快捷方式。

键谱如何卸载？ #

键谱不写入系统注册表，也不在系统目录留下后台服务，卸载过程非常干净。

Windows

1. 直接删除解压出的键谱目录（例如 D:\keymap）即可完成卸载。
2. 若曾使用"谱匣"，其保存的键谱配置文件位于程序同目录下，会随目录一并删除，如有需要请先备份。
3. 如需彻底清理，可在浏览器中清除键谱页面产生的本地存储数据（浏览器设置 → 站点数据/本地存储），此后键谱在本地不再保留任何记录。

macOS / Linux

1. 删除解压出的文件夹及其中的 keymap.html 文件。
2. 同样可在浏览器中清除对应的站点数据，以移除保存在浏览器本地的键谱内容。

建议：卸载前先通过键谱的导出功能备份重要键谱，避免数据丢失。