Files
qingjian/docs/user/input/aux-code.md
yenharvey f325ddad78 feat(settings): 换掉旧设置程序,旧版留一个版本作回退
- macOS:设置程序作为独立 .app 装进 Qingjian.app/Contents/Applications,菜单「设置…」打开它,包里没有时退回旧版;原偏好设置改名「旧版设置…」
- Windows:qingjian-settings.exe 换成新程序(状态条齿轮、开始菜单「青简设置」),旧 WinUI 程序改名 qingjian-settings-legacy.exe,开始菜单「青简旧版设置」,互斥体与窗口标题分开以便同时开
- Linux:安装与预编译包带上 qingjian-settings 与应用菜单项
- 新程序:Windows 不弹控制台、嵌图标、只开一个;日志另写一份到输入法日志目录,按天留 7 天;随包数据按各平台安装布局找
- 测试 config_keys 离屏点遍每页控件,写了的键用输入法的 Config 读回核对;补上「英文模式也给候选」漏掉的 ⓘ
- ⓘ 点了打开官网文档对应的一段,测试核对锚点在 docs/user 里真有、行在那页上真有 ⓘ
- 用户文档按新的页重写设置一页,各处「偏好设置 → 通用」这类指路改成新页名;contributing「控件面原生」一条改为设置程序自绘
2026-10-12 10:07:26 +08:00

3.2 KiB

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

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

辅码缺省关闭:在配置文件 [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(正文每行是「词 + 制表符 + 码」):

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

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

候选上显示码

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