# 动作

> 内置动作、可以创建的自定义动作类型、Shell 命令如何获得信任，以及输入法切换。

---

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

---

映射执行的是动作。动作分为内置动作和你自己的动作，「动作」页同时列出两者；内置动作不能
修改，但都可以被映射。

## 内置动作 {#builtin}

| 动作 | ID |
| --- | --- |
| 左移、右移、上移、下移 | `builtin.move_left`、`builtin.move_right`、`builtin.move_up`、`builtin.move_down` |
| 下一个词、上一个词 | `builtin.word_forward`、`builtin.word_back` |
| 行首、行尾 | `builtin.line_start`、`builtin.line_end` |
| 上移 10 行、下移 10 行 | `builtin.jump_up_10`、`builtin.jump_down_10` |
| 退格 | `builtin.backspace` |
| 下一行 | `builtin.new_line` |
| 插入引号 | `builtin.insert_quotes` |
| Escape | `builtin.escape` |
| 切换大写 | `builtin.toggle_caps_lock` |
| 无操作 | `builtin.noop` |
| 保持原键 | `builtin.passthrough` |

这些 ID 是永久的：引用它们的映射在各个版本中都能继续使用。

## 自定义动作 {#custom}

在「动作」页点击「新建动作…」，或在映射编辑器中直接定义。可用的类型有：

| 类型 | 作用 |
| --- | --- |
| 「组合键」 | 发送一个按键，可附带 ⌃ ⌥ ⇧ ⌘。 |
| 「跳转」 | 朝一个方向一次移动若干行。 |
| 「打开 App」 | 打开或前置一个从「应用程序」中选择的 App。 |
| 「Shell 命令」 | 用 `/bin/sh` 运行一条命令，需要你的确认，见下文。 |
| 「按住修饰键」 | 按住触发键期间保持某个修饰键按下，类似「按住说话」。配合 Caps + 按键使用。 |
| 「切换输入法」 | 切换到某个已安装的指定输入法，在映射编辑器中可用。 |

Classic 布局使用的鼠标、滚动、睡眠、剪贴板槽位和媒体动作列在「鼠标与系统」下。你可以把
它们映射到其他键，但不能新建这类动作。

正在被映射使用的动作不能删除；「动作」页会列出需要先移除的映射。

## Shell 命令与信任 {#trust}

保存 Shell 命令时会询问「信任此动作？」：受信任的动作以你的用户权限运行，可以修改文件、
访问网络，暂停和撤销都无法挽回它已做的事。点击「信任并保存」保留它。「Mac 睡眠」和
「显示器睡眠」动作也会出现同样的询问。

命令不会在无意中获得信任：

- 修改命令文本会撤销信任，直到你再次确认。
- 导入的配置中的所有命令和睡眠动作都处于停用状态，显示为「已停用 · 待审阅」；在编辑器
  中打开并保存即可确认。
- 未受信任的命令不会运行，无论配置文件里写了什么。

命令在后台运行，输出被丢弃；Capslock 不会记录它们打印的内容。

## 切换输入法 {#input-sources}

默认布局中的 `⇪ Space` 发送 ⌃Space，因此 macOS 会使用你为「选择上一个输入法」设置的
快捷键。如果想直接切换到某个输入法，把一个键映射到「切换输入法」并选中它。

部分中文、日文和韩文输入法在被直接切换时不能可靠生效。「设置 › 输入法」为切换输入法的
Caps + 按键映射提供两种修正方式：

- 「模拟快捷键」：按下「选择上一个输入法」快捷键。在 macOS 26 之前更可靠，需要在系统设置
  中打开该快捷键。
- 「切换焦点」：短暂移动焦点，让新的输入法生效。在 macOS 26 上效果更好，但在浮动窗口中无效。

---

反链：

- [键盘编辑器](/zh/docs/guide/editor/)
- [设置、菜单栏与统计](/zh/docs/guide/settings/)