Caps Nav

Caps Nav 是一个 macOS 原生菜单栏工具。它把 Caps Lock 固定为前缀键，让你在主键区完成光标移动、文本选择、删词、到行首/行尾等常见文本编辑动作，减少手离开字母区去找方向键和组合键的次数。

为什么会做这个软件

这个项目最早来自我自己的日常使用。

之前我一直用 Karabiner-Elements 做键盘增强，也已经习惯把很多常见编辑动作收回主键区。后来同事看到我平时的快捷输入方式，经常会问“这个怎么用”，但我发现 Karabiner-Elements 虽然很强，配置起来却不算轻松，对新手来说入门门槛也比较高。

于是就有了 Caps Nav：把一套更聚焦文本编辑、也更容易理解和上手的体验，做成一个可以直接给更多人使用的 macOS 工具。

它的定位很明确：

• 面向所有文本编辑场景
• 文本编辑越频繁，收益越明显
• 强调稳定、长期可用、可配置
• 不是窗口管理器
• 不是通用自动化平台
• 不支持自定义前缀键

适合谁

只要你会在 Mac 上持续输入和编辑文字，Caps Nav 都可能带来帮助，尤其适合这些场景：

• 写代码
• 写 Markdown、文档、邮件
• 在浏览器后台、CMS、表格或聊天工具里频繁编辑文本
• 想把常用导航动作尽量收回主键区

它能做什么

当前版本已经支持：

• 菜单栏常驻运行
• Caps Lock 作为固定前缀键
• 光标移动、按词移动、到行首/行尾
• 文本选择、按词选择、选到行首/行尾
• 删除一个字符、删除一个单词
• 自定义快捷键输出
• 多配置方案管理
• 图形化按键映射编辑
• 悬浮帮助提示
• 快捷键练习窗口
• 开机自启
• 应用级启用 / 暂停
• 全局开关快捷键
• 亮色 / 暗色 / 随系统主题
• 基于 GitHub Pages 的版本检查与更新说明展示

系统要求

• macOS 13.0+
• 首次完整使用前，需要授予“辅助功能”权限

下载与首次打开

如果你是从 GitHub Releases 页面下载当前的 pre-release 安装包，请先知道两点：

• 这是一个便于提前体验和测试的 dev 预发布包
• 它基于 Release 构建，但还没有经过 Apple 的正式签名和公证流程

这会带来两个直接影响：

• 第一次打开时，macOS 可能提示“Apple 无法验证 Caps Nav.app 是否包含可能危害 Mac 安全或泄露隐私的恶意软件”
• 当前 GitHub 自动生成的安装包仍然是 dev 预发布包，不等同于经过正式签名、公证的最终公开发布版本

第一次被系统拦截时，通常会看到类似下面这样的提示：

如果第一次打开时被系统拦截，可以这样处理：

1. 先在提示框里点“完成”
2. 打开“系统设置”
3. 进入“隐私与安全性”
4. 在页面下方的“安全性”区域找到 Caps Nav.app 的拦截提示
5. 点击“仍要打开”
6. 再次尝试启动应用，并在确认弹窗里继续打开

这是当前 pre-release 的正常表现，不代表应用本身损坏。

3 分钟开始使用

1. 打开应用

启动后，Caps Nav 默认不会弹出主窗口，而是直接常驻在菜单栏。

你会看到：

• 菜单栏图标出现
• Dock 中不会长期保留主窗口入口
• 设置页、权限说明窗口都需要你主动从菜单栏打开

2. 授予辅助功能权限

Caps Nav 的核心能力依赖 macOS 的“辅助功能”权限。

没有这个权限时：

• 可以打开设置页
• 可以管理配置方案
• 但不能正常监听全局键盘
• 也不能拦截和重发 Caps 映射动作

建议第一次使用时按这个顺序操作：

1. 点击菜单栏图标
2. 打开 设置 或 申请辅助功能权限
3. 在系统设置中允许 Caps Nav 控制你的电脑
4. 回到应用后重新检查权限状态

3. 先用默认键位试一轮

最推荐先在任意文本编辑器、文档编辑器、备忘录应用或聊天输入框里测试默认键位。

按住 Caps Lock 后，再按这些键：

按键	动作
e	光标向上移动
d	光标向下移动
s	光标向左移动
f	光标向右移动
a	光标向左移动一个单词
g	光标向右移动一个单词
p	光标移动到行首
;	光标移动到行尾
w	向左删除一个
r	向右删除一个
q	向左删除一个单词
t	向右删除一个单词
i	向上选中（跨行）
k	向下选中（跨行）
j	向左选中一个
l	向右选中一个
h	向左选中一个单词
n	向右选中一个单词
u	向左选中到行首
o	向右选中到行尾

如果你想看更详细的默认键位说明，可以继续读：

• default_shortcut_description.md
• 配置方案格式说明

4. 打开设置做个性化调整

设置页主要分为这些区域：

• 概览
  • 查看运行状态、权限状态
  • 启用 / 暂停 Caps Nav
  • 设置全局开关快捷键
  • 打开快捷键练习
• 键盘
  • 调整 Caps 短按回退阈值
  • 查看前缀键状态
• 悬浮提示
  • 开关悬浮提示
  • 设置提示位置和透明度
• 配置方案
  • 新增、复制、重命名、删除、排序配置方案
  • 编辑当前方案的按键映射
• 高级
  • 调整主题和菜单栏图标
  • 开机自启
  • 检查最新版本与查看最近一次检查结果
  • 打开数据目录和配置目录

使用方式建议

先熟悉默认方案，再复制修改

默认方案是只读的，不能直接改。推荐做法是：

1. 先用默认方案体验
2. 确认这套思路适合自己
3. 复制出一个新方案
4. 在副本上继续微调

这样更安全，也更不容易把“官方默认键位”和你自己的习惯混在一起。

先练移动，再练选择和删除

比较适合新手的顺序通常是：

1. 先记住 e / d / s / f
2. 再记 a / g / p / ;
3. 最后再练 i / j / k / l / h / n / u / o

如果你想更快形成肌肉记忆，可以直接用内置的快捷键练习功能。

快捷键练习

Caps Nav 内置了一个独立的“快捷键练习”窗口，适合两种人：

• 第一次接触默认键位的新用户
• 切到新配置方案后，需要重新熟悉映射的用户

当前支持两种模式：

• 认键练习
  • 更适合第一次熟悉键位
• 连招挑战
  • 更适合已经知道大致位置后做提速训练

练习题目会直接读取当前激活配置方案，所以你在设置页改完映射后，练习窗口会立即跟着变化。

详细说明见：

• 快捷键练习

常见问题

为什么按了 Caps Lock + 字母 没反应？

优先检查这几件事：

1. 是否已经授予辅助功能权限
2. Caps Nav 当前是否被暂停
3. 当前是否处于中文输入法候选框、终端特殊模式或某些应用的自定义按键上下文里

如果只是想快速验证，请先在任意普通文本输入场景里测试，例如备忘录、文档编辑器或聊天输入框。

第一次打开时提示“Apple 无法验证 Caps Nav.app”怎么办？

如果你下载的是 GitHub 上的当前 pre-release 安装包，这属于预期行为。

处理方法是：

1. 先关闭拦截提示
2. 打开“系统设置 -> 隐私与安全性”
3. 在“安全性”区域找到 Caps Nav.app
4. 点击“仍要打开”
5. 再次启动应用

原因是当前公开提供的 pre-release 主要用于提前体验和测试，还没有走正式签名与公证流程。

为什么启动后没有主窗口？

这是当前产品的默认行为。Caps Nav 是菜单栏常驻应用，启动后默认不主动打开设置页或权限窗口。请从菜单栏图标进入。

现在支持应用内检查更新吗？

支持，但第一版只做“检查与跳转下载”。

你可以通过这两个入口手动检查：

1. 菜单栏里的 检查更新
2. 设置页 高级 -> 软件更新

当前更新源来自 GitHub Pages 上的 latest.json，应用会直接展示你在 GitHub Release 里手写的 Markdown 更新说明；如果发现新版本，会提供：

• 下载更新
• 查看完整发布说明

当前版本还不包含应用内自动下载安装与替换。

能不能把前缀键改成别的键？

不能。Caps Nav 当前固定使用 Caps Lock 作为前缀键，这属于产品核心规则。

Caps Lock 原生大小写切换还在吗？

在。

默认情况下，Caps Nav 支持“短按回退”：

• 如果你在很短时间内按下并松开 Caps Lock
• 并且期间没有触发映射
• 就会回退执行系统原生大小写切换

默认阈值是 200 ms，可以在设置页中调整，也可以设为 0 来关闭。

配置文件存在哪里？

应用数据默认保存在：

~/Library/Application Support/Caps Nav/

其中包括：

• settings.json
• profiles/
• statistics.json

更多细节见：

• 配置方案编辑
• 配置方案格式

文档导航

我只是想用起来

• 产品总览
• 快捷键练习
• 配置方案编辑
• 自定义快捷键

我想了解配置和默认行为

• 配置方案格式
• 内置动作
• 默认快捷键说明

我想自己编译、运行或打包

• 从源码构建与打包
• 发布与打包

我想了解架构实现

• 文档索引
• 架构总览
• 事件流转

从源码构建

README 主要面向使用者，所以源码构建、调试和打包说明已经单独挪到文档里：

• 从源码构建与打包

如果你准备做正式签名、公证和发布，请继续看：

• 发布与打包