快速开始

• 1: 安装与首次运行
• 2: 学习布局
• 3: 与 Karabiner-Elements 共存

1 - 安装与首次运行

系统要求

• macOS 14 Sonoma 或更高版本，Apple 芯片或 Intel 处理器均可。
• 辅助功能权限。Capslock 从不申请输入监控权限。
• Caps Lock 没有被其他工具改键。如果你在用 Karabiner-Elements，请先阅读与 Karabiner-Elements 共存。

安装

打开 Capslock.dmg，把 Capslock 拖进「应用程序」，然后从「应用程序」或聚焦搜索中打开。

Capslock 是一个普通应用：有窗口、Dock 图标和菜单栏图标。关闭窗口后，它会继续在菜单栏中运行。

首次引导

首次启动时，Capslock 不会接管任何按键。在你完成引导之前，键盘一切照旧。

1. **欢迎使用 Capslock。**点击「继续」。
2. **选择 Hyper 模式。**默认的「经典」模式在按住 Caps Lock 时同时按住 ⌃⌥⇧⌘， 因此 Alfred、Raycast 等应用里的 Hyper 快捷键照常可用；「原生」模式让 Caps Lock 组合键只在 Capslock 内部处理。之后可以随时更改，见 Hyper 模式。
3. 开始之前。「键盘权限」卡片显示 Capslock 是否可以识别 Caps 组合键并发送按键。点击「打开系统设置」，macOS 会打开「隐私与安全性 › 辅助功能」；打开 Capslock 的开关并输入密码确认。回到 Capslock，点击「启动 Capslock」。下方的「冲突」卡片列出其他占用 Caps Lock 的工具。如果暂时不想启动，点击「暂不启用」完成引导。
4. **探索你的键盘。**点击「打开键盘」。「键盘」页展示整套布局；即使 Capslock 已暂停， 你也可以浏览和编辑。

确认工作正常

主页显示「运行中」和「Caps Lock 已是你的 Hyper 键。」，状态卡片应为：

然后试试主页「入门」中的四个手势：

• 轻按 Caps Lock：Escape。
• 按住 Caps Lock，再按 H、J、K 或 L：光标向左、下、上、右移动，任何应用都适用。
• 按住 Caps Lock，再按空格：切换输入法（前提是你有多个输入法，且 ⌃Space 快捷键已打开）。
• 按住 Caps Lock 稍等：屏幕上显示当前平面的全部按键。

如果某一行不正常，点击它的链接打开诊断，每项检查都附有编号步骤和一键修复按钮。

日常操作

• 主页、设置或菜单栏菜单中的「暂停」会把 Caps Lock 还给 macOS，直到你点击「继续」。
• 「登录时打开」位于「设置 › 通用」，默认关闭。
• 同一处的「隐藏 Dock 图标」会只保留菜单栏图标。
• 退出 Capslock 时，它会先恢复 Caps Lock 再退出。

2 - 学习布局

没人能一开始就记住 357 个绑定。Capslock 用三种方式教你这套布局：你停顿时显示当前平面， 动作执行时在屏幕上提示，以及 Playground 里跟随你自己映射的简短课程。

Hold-to-Reveal

按住 Caps Lock，不按其他键。稍等片刻，屏幕上会以整块键盘的形式显示当前平面，每个键上写着它的动作。显示期间按 ⌘、⌥、⌃ 或 ⇧ 可切换平面；松开 Caps Lock 即关闭。

此功能默认开启。在「设置 › Hyper 键」中可以关闭它、调整延迟（默认 550 毫秒，范围 250 到 1500 毫秒），并选择在执行动作时隐藏，还是只在松开 Caps Lock 时隐藏。

在屏幕上显示动作

「设置 › Hyper 键 › 在屏幕上显示动作」会在每次组合键执行时，在屏幕底部显示一个小提示： 你按下的键和它产生的动作。默认关闭；提示停留 1.35 秒，时长可调。

Playground

「练习」页在「课程」下分为三部分：

• 入门：练习四个手势——轻按 Caps Lock 发送 Escape、按住显示平面、⇪ Esc 切换大写锁定、⇪ Space 切换输入法。
• 导航：练习用 ⇪ H、⇪ J、⇪ K、⇪ L 移动光标。
• 自由练习：显示你最近按下的键：所在平面、动作、前台应用，以及动作是已执行、仅预览、被拦截，还是按键被原样放行。

课程读取你当前的映射。如果课程用到的键被你改绑或停用，课程会直接说明，而不是让你去按一个已经不再做那件事的键。

真实执行与安全练习

「模式」开关在「真实执行」与「安全练习」之间切换。真实执行时组合键会真正运行；安全练习时， 有副作用的动作只做预览而不执行：打开应用、Shell 命令、睡眠、剪贴板槽位和切换大写锁定。按键与鼠标动作仍会执行，所以你能看到光标移动。

离开 Playground、隐藏窗口或切换到其他应用时，安全练习会自动关闭。

自由练习只保留最近一次按键，且仅在 Playground 位于前台时保留，离开即清除。你输入的内容不会被记录。

「键盘」页

「键盘」页画出你的键盘，并在每个键上标注它的动作。可以从菜单或用 ⌘ ⌥ ⌃ ⇧ 开关选择平面。按住 Caps Lock 时，画面会跟随你实际所在的平面，并显示「实时」标记。键帽文字跟随当前键盘布局，Dvorak 或 AZERTY 用户看到的是自己的字母。点按任意键即可查看或修改，见键盘编辑器。

3 - 与 Karabiner-Elements 共存

Capslock 需要独占 Caps Lock 和 F18 键。它从不修改、停用或卸载 Karabiner-Elements 或其他任何工具。当别的工具已经在用这些键时，Capslock 会拒绝启动，并告诉你需要改什么。

哪些情况算冲突

• **系统层面对 Caps Lock 的改键。**如果其他工具已经重映射了 Caps Lock，诊断页显示「Caps Lock 被其他工具占用」。
• **F18 的其他用途。**如果有任何改键以 F18 为来源或目标，诊断页显示「F18 已被占用」。
• Karabiner-Elements 规则。 Karabiner-Elements 运行时，Capslock 会读取当前选中的配置，查找从 Caps Lock 或 F18 出发、或输出 F18 的规则。它只报告找到的数量，从不读取规则名称或内容。

Karabiner-Elements 可以继续负责其他按键，只有作用于 Caps Lock 和 F18 的规则才会冲突。

解决 Karabiner 冲突

1. 打开 Karabiner-Elements › Complex Modifications。
2. 关闭从 Caps Lock 出发的规则（例如「CapsLock to Hyper」），或切换到不含该规则的配置。
3. 回到 Capslock，在主页或诊断页点击「重新启用」。

诊断页提供「打开 Karabiner-Elements」按钮来完成第 1 步。每次你切回 Capslock，它都会重新检查；之后才出现的冲突会让 Capslock 停止并归还 Caps Lock，而不是让两个工具互相争抢。

从 Karabiner 配置迁移

原生应用内置同一套 Capslock Classic 布局，你不需要迁移任何东西就能保留熟悉的绑定。有几处行为不同：

• 轻按 Caps Lock 发送 Escape；⇪ Space 发送 ⌃Space 用于切换输入法。
• 你可以选择 Hyper 模式。默认的「经典」模式仍会为监听 Hyper 的应用按住右侧 ⌃⌥⇧⌘。
• 剪贴板槽位加密保存在 Capslock 内部，Karabiner 方案留下的 ~/.clip6 等文件不会被读取。
• 应用按 Bundle ID 打开，而不是在 Shell 里执行 open -a。
• 你对自己的 Karabiner JSON 所做的修改不会被导入，请在键盘编辑器中重新设置。

准备好之后，按上文所述在 Karabiner-Elements 中关闭 Capslock 规则，然后启动 Capslock。如果想回到 Karabiner 方案，它的完整文档仍在 Karabiner 版中。