清风输入法 WindInput 自定义码表教程:从五笔到形码,打造专属输入方案

原创2026-10-14 13:45:342,338 阅读

清风输入法 WindInput 自定义码表教程:从五笔到形码,打造专属输入方案

清风输入法(WindInput)是一款轻量、快速、可定制的开源中文输入法,专为五笔和码表输入方案设计。它的核心能力是方案驱动:只要写一个 TOML 方案文件、准备一份词库文件,就能在 Windows / macOS / Linux 上跑起一套属于自己的输入方案——从五笔 86 到任何形码、音码、速记码表,本文带你从零完成。

清风输入法 WindInput 自定义码表教程

为什么清风输入法适合做自定义码表 🧩

大多数输入法想加一张自己的码表,要么只能改注册表、要么依赖插件。WindInput 把这件事做成了三件简单的事:

  1. 方案即文件:输入行为由 *.schema.toml 声明,引擎类型写一行 type = "codetable" 就是码表方案;
  2. 词库即词表:词库是纯文本 .dict.yaml,文本 编码 权重 一行一条,记事本就能编辑;
  3. 安装即放文件:方案文件放进用户目录的 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。

登录后查看全文
WindInput