清风输入法 WindInput 自定义码表教程:从五笔到形码,打造专属输入方案
清风输入法 WindInput 自定义码表教程:从五笔到形码,打造专属输入方案
清风输入法(WindInput)是一款轻量、快速、可定制的开源中文输入法,专为五笔和码表输入方案设计。它的核心能力是方案驱动:只要写一个 TOML 方案文件、准备一份词库文件,就能在 Windows / macOS / Linux 上跑起一套属于自己的输入方案——从五笔 86 到任何形码、音码、速记码表,本文带你从零完成。
为什么清风输入法适合做自定义码表 🧩
大多数输入法想加一张自己的码表,要么只能改注册表、要么依赖插件。WindInput 把这件事做成了三件简单的事:
- 方案即文件:输入行为由
*.schema.toml声明,引擎类型写一行type = "codetable"就是码表方案; - 词库即词表:词库是纯文本
.dict.yaml,文本 编码 权重一行一条,记事本就能编辑; - 安装即放文件:方案文件放进用户目录的
schemas\下即被识别,无需编译。
内置的五笔 86、笔画方案就是现成的模板,可以参考 data/schemas/wubi86.schema.toml 和 data/schemas/stroke.schema.toml。
认识三样核心文件
| 文件 | 作用 | 示例 |
|---|---|---|
xxx.schema.toml |
方案定义:名字、引擎类型、码长、词库声明 | wubi86.schema.toml |
xxx.dict.yaml |
词库:逐行「文本 编码 权重」 | 见下节 |
用户目录 schemas\ |
放置方案与词库的位置,优先级高于安装目录 | 见「安装方案」一节 |
词库的列顺序默认是 text(文本)/ code(编码)/ weight(权重),两列之间用空格或 Tab 分隔,# 开头是注释。格式契约的完整说明见 docs/architecture/rime-dict-loading.md。
第一步:编写你的码表词库
假设做一张简易「形码」方案:每字 3 码。新建文件 mycode.dict.yaml,内容形如:
name: 我的形码表
version: "1.0"
我 jgh 1000
人 wvh 900
大 vgg 800
你好 jghwvh 700
三点提醒:
- 权重决定同码排序:同编码下权重高的排前面,给常用词更高权重即可,刻度没有绝对意义,库内相对大小才有用;
- 词条格式宽容:不写
columns:时按默认列序解析;text和code两列不可缺,整库会因此被跳过并报错; - 词库是 UTF-8 文本,避免用 ANSI/GBK 保存,否则加载会失败。
第二步:编写方案文件 mycode.schema.toml
照抄结构、替换成你的参数即可(对照 wubi86.schema.toml):
[schema]
id = "mycode"
name = "我的形码"
icon_label = "形"
[engine]
type = "codetable" # 关键:声明这是码表引擎
[engine.codetable]
max_code_length = 3 # 满码长度,按你的码表定
base_sort = "weight" # 同码内按权重排序
[[dictionaries]]
id = "mycode_main"
label = "形码主词库"
path = "mycode/mycode.dict.yaml" # 相对 schemas 目录
type = "rime_codetable"
default = true
想让方案支持数字或符号作码元(26 码元以上的设计很常见),加一行 input_chars = "a-z/" 之类的字符集声明即可,细节见 docs/design/codetable-input-chars.md。
第三步:安装方案并启用
把两个文件按下面的结构放进用户目录(Windows 正常安装为 %APPDATA%\WindInput\,便携版为 exe 目录\userdata\,macOS / Linux 为对应用户数据目录):
schemas/
├── mycode.schema.toml
└── mycode/
└── mycode.dict.yaml
然后重启输入法服务(或重新打开设置窗口),在方案列表里选择「我的形码」即可开打。方案发现与用户层优先规则参见 docs/architecture/user-override.md。
进阶玩法:让码表方案更顺手 🚀
- 扩展词库(丢文件即识别):码表方案会自动扫描
<主词库目录>/ext/(本例即schemas/mycode/ext/)下的.dict.yaml,放进设置页「扩展词库」里勾选启用,无需再改方案文件。机制见 docs/design/schema-dict-discovery.md。 - 通配键(万能键):不确定的码元用通配键代替,候选会显示完整编码,适合学码查字。26 码元方案建议把
wildcard_key设为符号键,避免吞掉真实码元,完整契约见 docs/design/codetable-wildcard.md。 - 逆切分(切分模式):满码空码时自动切成「二简 + 后段」拼出候选,是音形码表的效率神器;注意它仅适用于纯码表方案(五笔类二简位全是单字,开启收益极低)。设计动机见 docs/design/codetable-split-input.md。
- 方案级行为覆盖:不想动方案文件时,可在用户目录的
schema_overrides/{方案id}.toml里写[engine.codetable]段单独覆盖,例如split_input = true、auto_commit_at_full = true。 - 做定制版整包分发:给他人提供「换了一套码表的输入法」时,用安装目录下与
data/同级的data_custom/层,升级零冲突;制作要点见 docs/design/data-custom-layer.md。
常见问题排查 ✅
| 现象 | 原因与处理 |
|---|---|
| 方案列表里看不到新方案 | 文件名必须是 *.schema.toml 且放在 schemas\ 根下;[schema] id 与文件名一致最稳妥 |
| 候选为空 / 词库没加载 | 词库 text、code 两列缺失,或文件被存成 GBK 编码 |
| 改了配置没生效 | 方案与词库改动后需重启服务再切回该方案 |
| 同码顺序不对 | 检查权重:整库权重相同会退化为文件顺序,可用 default_weight 给整库定档 |
小结
用清风输入法做自定义码表的路径非常短:写词库 → 写方案 → 放目录 → 重启启用。内置的五笔 86 方案就是最好的模板,把 data/schemas/ 里的方案与词库抄一份改编码,十分钟就能得到一张能用的形码码表;再配合扩展词库、通配键与逆切分,逐步打磨成只属于你的输入方案。更多配置键参考 docs/architecture/config-design-rules.md,候选生成链路细节见 docs/architecture/engine-candidate-pipeline.md。
