键盘编辑器

「键盘」页就是编辑器。它按所选平面画出你的键盘，并在每个已映射的键上标注动作。你的键盘上没有的键（例如 F16，或笔记本上的数字小键盘）列在「不在此键盘上的键」中；轻按和双击类映射列在「其他触发方式」中。在工具栏切换到「列表」，可以看到按触发方式分组的列表。

修改一个键

点按一个键，弹出框显示它的组合键、所在平面和当前「动作」：

• 「更改」：改选另一个内置动作或你的自定义动作。
• 「编辑…」：打开完整的映射编辑器，见下文。
• 「显示 YAML」：显示这条映射在文件中的原样内容。
• 「恢复 Classic 默认」：恢复 Capslock Classic 中的动作；只有当该键与 Classic 布局不同时才出现。

有三个按钮可以让一个键不再执行映射的动作，区别在于之后这个键做什么：

没有映射的键会显示「此平面上未映射。」、它当前的行为，以及「指定动作」按钮。

新建映射

点击工具栏中的「+」，或在某个键上点「编辑…」，即可打开映射编辑器。

触发方式，可选：

• 「Caps + 按键」：按下要捕获的键，再用 ⌘ ⌥ ⌃ ⇧ 开关选择平面。
• 「轻按 Caps」：轻按 Caps Lock 时执行的动作（默认是 Escape）。
• 「双击 Caps」：在双击间隔内连按两次。设置后，单击会等过这个间隔再执行。
• 「双击修饰键」：连按两次左侧或右侧的 ⌘、⌃、⌥、⇧ 或 fn（fn 为实验性）。

「更改触发方式」可以把已有映射移到另一个键、平面或触发方式上，动作和 App 规则随之移动。

默认动作：在所有 App 中生效，除非下方有 App 规则匹配。可以选择内置动作、你的自定义动作、「新建动作…」，或直接在此定义。

App 规则：可选。每条规则指定一个或多个 App，以及在这些 App 中执行的动作。见App 规则。

每个键在每个平面上只能有一条映射，编辑器会拒绝重复。

修改如何生效

每次保存都会先校验，然后把整份配置一次性写入磁盘，最后才切换正在运行的键盘。一处修改要么完整生效，要么完全不生效。

工具栏中的「撤销」「重做」，或 ⌘Z 与 ⇧⌘Z，可以撤回或重做最近一次映射修改。只保留一步， Capslock 重新启动后历史清空。

如果你在其他应用中编辑了配置文件，下次切回 Capslock 时它会重新加载。会覆盖这类外部修改的保存会被拒绝，你可以在新内容之上重新修改。

导入、导出与 Classic 布局

工具栏的「更多」菜单中有三条命令：

• 「导出」：把整份配置（包括自定义动作和方案行为）写入一个 YAML 文件，默认名为capslock-config.yml。
• 「导入」：读取这样的文件，替换你当前的全部映射；自定义动作会合并。当前文件会先备份。导入文件中的 Shell 命令和睡眠动作会被停用，直到你重新复核并信任。
• 「安装 Capslock Classic V3」：重新安装内置布局。它会先展示经过校验的预览（包括它要打开的哪些 App 尚未安装），然后在替换映射之前请你确认。你的自定义动作、App 设置和 Hyper 模式保持不变，并且会先保存备份。