# 自定快捷键与重新映射

Tessera 中的每一个键盘快捷键都可以按你的意愿设置：重新映射任意内置组合键，
也可以添加你自己的、能替你输入的快捷键 —— 由硬件键盘组合键触发、由
[辅助栏](https://bambouville.com/docs/zh-hans/keyboard/#辅助栏)上的按钮触发，或者两者皆可。

这一切都在 **设置 → 键盘与输入 → 快捷键** 中：一张概要卡片会统计已绑定、
已变更和自定的数量，**自定…** 则会打开编辑器。

![快捷键编辑器覆盖在设置之上，按分组列出内置快捷键及其组合键和「默认」标记，自定分组中有一个已创建的快捷键，下方是「+ 自定快捷键」按钮。](https://bambouville.com/docs/assets/img/shortcuts-editor.png)

*所有应用快捷键都在同一个编辑器中 —— 分组在左侧，你自己的归在自定之下。*

## 自定快捷键

编辑器底部的 **+ 自定快捷键** 可以创建一个。一个快捷键包含：

- 一个**名称** —— 同时也是该小按钮的 VoiceOver 标签，
- **发送** —— 它输入的文本，按字面发送，包括空格。打开**之后按下回车**
  可让它立即运行；编辑器会给出警告，因为这样一来命令会在快捷键触发的瞬间
  执行。
- 一个**触发方式** —— 一个录制的**键盘快捷键**、一个**辅助栏按钮**，或两者
  皆可。至少需要一个。按钮的标签要么是一小组精选单色图标中的一个，要么是
  最多六个字符的文本 —— 一个表情符号算一个字符。

你创建的按钮会出现在辅助栏上，并在布局调色板中归入**你的快捷键**，可以像
其他按钮一样重新排序。

![自定快捷键面板：名称字段、键盘快捷键与辅助栏按钮的开关、用于按钮标签的图标网格、它发送的文本、一个「之后按下回车」开关，以及实时的字节数显示。](https://bambouville.com/docs/assets/img/custom-shortcut-editor.png)

*一个快捷键：一个名称、一两种触发方式，以及它发送的文本。*

## 适用范围

每个自定快捷键都带有一个适用范围：

| 适用范围 | 含义 |
| --- | --- |
| **所有位置** | 所有会话、所有传输方式 |
| **这些主机** | 仅限你选择的主机 |
| **本程序** | 仅在某个特定程序处于前台时 |

**本程序** 接受进程名原文（`claude`、`vim`）或加 `regex:` 前缀 —— 与
[滑动板配置](https://bambouville.com/docs/zh-hans/swipe-pad/#配置)使用同一套匹配规则 —— 因此「批准」快捷键
可以只在智能体运行时才存在。Tessera 通过 tmux 读取前台进程，所以程序范围
在**自动 tmux** 和**具名 tmux** 会话中有效；在自定命令的会话里，这类快捷键
会保持休眠。不在适用范围内的按钮只会在辅助栏上变暗，而不会消失。

## 重新映射内置快捷键

轻点任意一行上的铅笔图标，然后按下新的组合键。录制器会立即给出答复：

- **可用** —— 没有其他功能占用它；保存即可。
- **已在使用** —— 保存即**占用它**，原先的持有者在你为它另行指定组合键
  之前将处于未绑定状态。
- **已拒绝** —— 有少数组合键无法占用：
  - 应用快捷键必须带 **⌘** —— 不带它的组合键都归终端所有（^E 在任何 shell
    中都是行尾），
  - 如果 **⌥** 会改变某个键输出的字符，这样的组合键永远不会匹配，因此录制器
    会拒绝它们，
  - iPadOS 自己保留了少数几个（⌘space、⌘tab、⌘H、⌘W 以及截屏组合键）——
    正因如此，Tessera 用 **⇧⌘W** 关闭 tmux 窗口，
  - 方向键和 ⌃tab 被系统的焦点引擎占用，无法捕获。

**⌘1–⌘9** 作为一个整体重新映射：你改变的是修饰键，数字保持不变。
**全部恢复默认** 会把每个内置快捷键都还原；你的自定快捷键不受影响。

录制组合键需要连接硬件键盘 —— iPhone 还是 iPad 都无所谓，关键在键盘而不是
设备。只用按钮触发的自定快捷键则完全不需要键盘。

## 符号还是文字

**设置 → 键盘与输入 → 修饰键写法** 决定组合键在应用各处的写法 —— 辅助栏、
快捷键列表、窗口标签和提示：

- **符号** —— ⌘⇧E（默认），
- **文字** —— cmd-shift-e。

控件下方的实时示例会在你确定之前展示两者的差别。

[键盘与输入](https://bambouville.com/docs/zh-hans/keyboard/)页面列出了所有默认组合键。