# 键盘编辑器

> 查看、改绑、停用或恢复任意按键，新建映射，重新安装 Classic 布局；每次修改都作为一个事务整体生效。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

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

## 修改一个键 {#popover}

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

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

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

| 按钮 | 之后这个组合键… |
| --- | --- |
| 「停用」 | 什么也不做，按键被吞掉。 |
| 「保持原键」 | 总是输出按键本身，就像没有按住 Caps Lock 一样。 |
| 「移除映射」 | 按方案中[未映射组合键](/zh/docs/guide/hyper-mode/#unmapped)的规则处理：可能输出原键、忽略，或发送 Hyper。 |

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

## 新建映射 {#mapping-editor}

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

**触发方式**，可选：

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

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

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

**App 规则**：可选。每条规则指定一个或多个 App，以及在这些 App 中执行的动作。见
[App 规则](/zh/docs/guide/apps/)。

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

## 修改如何生效 {#transactions}

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

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

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

## 导入、导出与 Classic 布局 {#import-export}

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

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

---

反链：

- [Hyper 模式与方案行为](/zh/docs/guide/hyper-mode/)
- [Karabiner 版](/zh/docs/karabiner/)
- [导航与选择](/zh/docs/layout/navigation/)
- [窗口与应用](/zh/docs/layout/windows-apps/)
- [与 Karabiner-Elements 共存](/zh/docs/start/karabiner/)
- [学习布局](/zh/docs/start/learn/)