---
title: 辅码
order: 5
description: 拼音之后补充字母缩小候选范围；触发键、码表导入与候选上的码。
---

翻页找词很费事。辅码是在拼音之后补充几个字母，把候选范围直接缩小到想要的词。

辅码缺省关闭：在配置文件 `[aux_code]` 分节里把 `enabled` 改为 `true` 打开。打开但没有可用码表（尚未导入、或全被关掉）时，触发键不生效，`;` 仍按原有行为工作。

## 用法

先按平常的方式输入拼音，再按触发键（缺省 `;`）进入辅码状态：此时候选不变，拼音行末尾多一个 `;`。
接着输入码表里的码字母，候选随每多一个字母即时收窄，剩下的词就是码以所输字母开头的词。

例如码表里「开发」的码是 `kf`，输入 `kaifa` 后按 `;` 再输入 `kf`，候选只剩「开发」。

- 码只筛词，不改变拼音的输入方式，也不影响整句转换。
- 码表未收录的词在辅码状态下不显示。把码删空后仍停留在辅码状态，候选全部回来；再按一次退格才退出辅码（配置 `[general] aux_code_keep_empty` 改为 `false` 可回到删空即退出）。
- 码不需要敲满：敲到候选合适即可按空格或数字上屏。
- `Backspace` 删除码的最后一个字母，删空后仍停留在辅码状态，再按一次才退出；`Esc` 直接清掉码。
- 配置 `[general] shift_letter = "compose"` 时，辅码状态里输入大写字母等同于先按 `Esc`：清掉码回到拼音状态，字母照常参与组句。
- 辅码状态下选择过的词同样会被记住，下次纯拼音输入它会更靠前。

## 触发键

缺省为 `;`，在「设置 → 辅码」中修改。可改为 `/` 或反引号等单个可见字符。

双拼的微软方案与搜狗方案用 `;` 表示韵母 ing：拼音末尾有落单的声母时，`;` 作为拼音使用（`x;` 得到 xing），其他情况下才是触发键。

## 码表

码表需自行导入：「设置 → 辅码 → 导入码表…」，接受 Rime 的 `.dict.yaml` 与现成的 `.qj`。
导入完成后显示读入条数、有码条数、无码条数与跳过条数。随包只提供笔画表，第三方码表由用户自行取得。

导入的码表列在「设置 → 辅码」页中，可单独开关或移除。

### 文件格式

最小的一份 `my.dict.yaml`（正文每行是「词 + 制表符 + 码」）：

```yaml
---
name: 我的码表
version: "1"
...

开发	kf
开放	kf
鹤	hn
```

- 码只用小写字母 a–z；同一个词写多行就有多条码，码列里也可用空格分隔多个码。
- 头部 `---` 到 `...` 之间可写 `name`（码表列表里显示的名字）、`version`、`columns` 列名与 `import_tables` 合表；没有头、直接每行「词 + 制表符 + 码」的纯文本也接受。
- 形码码表（如小鹤形）由用户从其官方渠道取得，按上述格式整理后导入。

## 候选上显示码

开启「设置 → 辅码 → 候选上显示码」后，码用方括号紧跟在候选词后面显示，例如 `鹤[rbm] crane`。不进辅码也能看：纯拼音打字时候选就带着每个词的码（首条），方便边打边记；进了辅码显示的则是命中当前输入的那条码。