Files
qingjian/docs/user/input/aux-code.md
T
yenharvey 7da59a69be feat(render): 辅码用方括号紧跟在候选词后面显示
码是词本身的属性,和译文混在同一条注记里不好认:渲染器的 Row 加 code 字段,画在候选词后面(小字淡色),不再占注记列。
Windows 的渲染器与 GDI 两套画法一致;mac 壳暂时传空,接辅码时按同一格式。
2026-09-20 10:21:48 +08:00

60 lines
3.2 KiB
Markdown

---
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`。不进辅码也能看:纯拼音打字时候选就带着每个词的码(首条),方便边打边记;进了辅码显示的则是命中当前输入的那条码。