方案配置

本页面向要自制或改造输入方案的用户，讲清楚三件事：方案文件里能写什么、词库文件的格式规范、以及排序相关的几个字段各自作用在哪一层。

日常使用不需要读本页——启用、排序、扩展词库开关、导入导出都在方案设置里点几下就行。

方案文件的位置与命名

方案文件为 TOML 格式，位于 %APPDATA%\WindInput\schemas\，命名为 <方案ID>.schema.toml。方案 ID 必须与文件名前缀一致。

内置方案对应文件（在安装目录的 data\schemas\ 下）：

在用户目录放一个同名文件即整份替换内置那份，见同结构覆盖机制。

最小结构

[schema]
id = "my_schema"        # 方案 ID，须与文件名前缀一致
name = "我的方案"
icon_label = "我"       # 模式指示 / 状态气泡的图标短称（可选）
version = "1.0"
author = "作者"
description = "方案说明"

[engine]
type = "codetable"      # 引擎类型：pinyin / codetable / mixed

引擎类型

三种引擎各有一段固定参数：

# 拼音引擎（全拼 / 双拼）
[engine.pinyin]
scheme = "full"                      # full（全拼）/ shuangpin（双拼）
unigram_path = "pinyin/unigram.txt"  # 长句打分用语言模型（可选）
[engine.pinyin.shuangpin]
layout = "xiaohe"                    # xiaohe / ziranma / mspy / sogou / abc / ziguang

# 码表引擎（五笔等）
[engine.codetable]
max_code_length = 4             # 最大码长（0 = 回退 4）
base_sort = "weight"            # 基础排序维度，见下文「排序配置」
input_chars = ""                # 码元字符集（空 = a-z），见下
leading_chars = ""              # 可作第一码的字符（空 = 同 input_chars）

# 混合引擎（码表优先、拼音兜底）
[engine.mixed]
primary_schema = "wubi86"       # 主方案（码表）
secondary_schema = "pinyin"     # 辅助方案（拼音）

码元字符集 0.114 新增

默认只有 26 个字母算「输入码」，按别的键就走标点、选词或直接上屏。方案的编码里若含别的字符，用 input_chars 声明：

[engine.codetable]
input_chars = "a-y"     # 五笔码元集：z 不进编码
input_chars = "a-y/"    # 再加一个 /，供 /test 这类词条
input_chars = "a-z0-9"  # 字母加数字，词库里有 Win10 这类词条时需要

写法是范围 + 字面的组合，大小写不敏感；- 写在首位或末位时作字面字符（a-z-）。不在集内的字符按下时会终结当前编码：先上屏当前候选，再输出该字符本身。

数字通常要配 leading_chars。数字键在空编码时是选词键，直接让它作码元会把这个用法整个占掉：

[engine.codetable]
input_chars = "a-z0-9"
leading_chars = "a-z"   # 数字能作码元，但不能起头

这样 win10 里的 1、0 正常进编码，而空编码时按数字键仍是选词或输出数字。

字符集写错（如 z-a 逆序、含空格）不会让方案失灵，会回落默认 a-z 并记录告警。

词库配置

码表、拼音、英文方案用 dictionaries 数组列出自己的所有词库，分两类：主词库仅 1 个（default = true，始终启用），扩展词库任意多个（可被用户独立开关）。

[[dictionaries]]
id = "wubi86_main"
label = "极点五笔主词库"
path = "wubi86/wubi86_jidian.dict.yaml"
type = "rime_codetable"
default = true

[[dictionaries]]
id = "wubi86_emoji"
label = "Emoji 表情"
path = "wubi86/wubi86_jidian_emoji.dict.yaml"
type = "rime_codetable"
default_enabled = true          # 方案默认启用

[[dictionaries]]
id = "wubi86_district"
label = "行政区域"
path = "wubi86/wubi86_jidian_district.dict.yaml"
type = "rime_codetable"
base_order = 1                  # 排在主库（0）之后
default_weight = 500            # 该库无权重列，整库定档 500

启用判定优先级：enabled > default_enabled > 主词库始终启用。

词库文件（.dict.yaml）

词库文件沿用 Rime 的 .dict.yaml 外形，但解析器是本输入法自己的，与 librime 并不等价。理解下面这几条能避免绝大多数「词库加载了却不生效」的问题。

YAML 头只有两个键被读取

sort: 是个特例：它会被读取，但只用来打一条日志告警，不影响排序。要控制排序请用下文的排序配置四件套。

---
name: my_dict          # 被忽略（显示名取方案文件的 label）
version: "1.0"         # 被忽略
sort: by_weight        # 读取，但只触发一条 WARN 日志，不生效
columns:               # ← 真正生效的键
  - text
  - code
  - weight
...
你好	nihao	1000

分隔行：... 必需，--- 可选

正文的起点是首个恰好等于 ... 的行。--- 只是头部里的一行普通内容，写不写都行。

columns 支持的列名

columns 只认三个名字，两种 YAML 写法（块序列 - text 与流式 [text, code, weight]）都支持：

其他列名（如 Rime 的 stem）语法合法但不取用，只作占位——占位会顺延其后各列的下标，所以必须写全，不能省略中间列。

不写 columns 会走启发式猜测

省略 columns: 时，解析器会采样正文（最多 200 行 / 攒够 32 票）投票判断列序：逐列检查是否「像编码」（全部字符属于 a-z、0-9 及少数符号），恰有一列像码才计一票。

• 平票或零票 → 回退 text code weight
• 无论投票结果如何，权重恒取第 3 列
• 每次走启发式都会记 WARN，日志里带票数与建议写法

其他正文规则

• # no comment 指令 —— 整行恰好等于它时，其后所有 # 开头的行按数据而非注释解析
• 只剥行尾空白，保留行首 —— 因为全角空格 U+3000 属于 Unicode 空白，用常规 trim 会把「全角空格」这个词条本身削掉
• 空 text 或空 code 的行被跳过
• 权重解析失败记为 0 —— Rime 的 50% 相对权重语法未实现，会落到这里

排序配置四件套

base_sort、base_order、default_weight、sort 名字相近但分属三个不同的文件层，作用点完全不同。这是方案定制里最容易混淆的一组：

base_sort —— 选定排序维度

只对码表引擎生效，写在拼音方案里无效。

natural 即「字根序 / 文件原序」，适合按编码规则天然有序的码表。

base_order —— 词库之间的硬分档

小整数档位，排序时作为独立层级参与，位置在权重之后、库内出现序之前。

它存在的理由是：库内出现序是每个词库各自从 0 起的局部序号。没有 base_order 时跨库直接比较，会让小词库靠前的词条反超主词库深处的词条。给扩展库配 base_order = 1 就能让它整体排在主库（0）之后。

default_weight —— 整库权重硬覆盖

设置后无条件替换该词库每一条词条的权重，词库自身的权重信息完全丢弃。

用途是没有权重列的扩展库：不设时全库 weight = 0，在权重模式下会整体沉底。给行政区域库配 default_weight = 500 就能让它落在设计者选定的档位。

优先级串联

base_sort 选定比较器
  ├─ weight  → 权重降序 → base_order 升序 → 库内出现序 → …
  └─ natural → base_order 升序 → 库内出现序 → …（权重不参与）

其中权重的值 = default_weight（若配置）或词库原始权重
                └─ 覆盖发生在更早的取数层，不是排序层

词组编码器

码表方案通常需要编码器为自动造出来的词组生成编码。规则写在方案文件的 [encoder] 段：

[encoder]
max_word_length = 10

[[encoder.rules]]
length_equal = 2             # 二字词
formula = "AaAbBaBb"         # 第一字前两码 + 第二字前两码

[[encoder.rules]]
length_equal = 3             # 三字词
formula = "AaBaCaCb"

[[encoder.rules]]
length_in_range = [4, 10]    # 四字及以上
formula = "AaBaCaZa"

公式语法：A / B / C / Z = 第 1、2、3、末个字；a / b = 该字的第 1、2 个编码（如 Aa = 第 1 字第 1 码）。

拆字配置

形码方案可挂拆字库，在候选悬停提示与候选注释里显示构字信息。整段配置写在 [engine.chaizi] 下，路径相对 schemas\：

[engine.chaizi]
db_path = "wubi86/wubi86_chaizi.txt"   # 拆字库（字\t字根\t编码）
font_path = "wubi86/HeiTiZiGen.ttf"    # 字根字体 TTF（可选，仅参与导入导出打包）
font_family = "黑体字根"               # 字根字体的 DirectWrite 家族名（可选，实际渲染依据）

两个字体项的分工与直觉不同：

• font_path —— 在 Windows 上不会被直接加载渲染。它只在方案的导入 / 导出时起作用：导出时把这个 TTF 一并打包进方案包，导入时随方案落到用户数据目录。要让字体真正可用，必须把该字体文件手动安装到系统
• font_family —— 决定渲染时实际使用哪套字体，必须填写字体安装到 Windows 后的家族名，而不是文件名或路径。家族名可在「设置 → 个性化 → 字体」或双击字体文件的预览窗口中查看

overlay 段 0.115 新增

[overlay] 声明「本方案可以被引导键临时叠加进入」——按引导键进去打一段，选完候选自动退回原方案。快符、生僻字表这类小码表就靠它，用法见引导键特殊模式。

段存在即声明，没有总开关：方案有这一段就是特殊方案，没有就只能作常驻方案切换使用。

[overlay]
show_all_on_enter = false        # 进入模式即展示候选
candidate_layout = "follow"      # 本模式期间的候选窗布局
comment_template_vertical   = "" # 本模式期间的候选注释模板（竖排）
comment_template_horizontal = "" # 同上（横排）

这一段装的不是「这张码表是什么」（那是 [engine.codetable]），而是「这张码表被叠加使用时怎么表现」——三个字段的语义都依赖「进入 / 退出」这条生命周期。

[overlay] 与 [schema].hidden 是正交的两件事：hidden 管「列不列进方案切换列表」，[overlay] 管「能不能被引导键叠加进入」。特殊模式通常两个都写，但并非必须——只写 [overlay] 的方案照样能被引导键进入，只是它同时也留在方案列表里。

本段也可以写进 schema_overrides\<方案ID>.toml，设置工具的「特殊模式」一节改的就是那里。

差异化覆盖（schema_overrides）

全局引擎配置是所有同类方案的基线；当某个方案需要与全局值不同的行为时，用 schema_overrides\<方案ID>.toml 只覆盖个别项，未覆盖项跟随全局值。设置工具的扩展词库开关、双拼布局、方案级码表配置都写入这个文件。它不会被安装包升级覆盖。

覆盖采用深合并，但有两条例外：

• 数组整体替换 —— 如 encoder.rules 写了就是整份替换，不会逐条合并
• [[dictionaries]] 按 id 稀疏合并，且只接受 enabled 一个字段 —— path、label、base_order、default_weight 等永远以方案文件为准，覆盖层改不了

第二条是刻意的：它保证用户层的词库开关不会把整份词库定义冻结成快照，否则方案升级后新增或改路径的词库都会失效。

从零创建自定义方案

1. 准备方案文件 —— 建议先在方案页导出一个内置方案作模板，在其基础上修改；方案 ID 必须与文件名前缀一致
2. 放置文件 —— 方案文件存入 %APPDATA%\WindInput\schemas\；引用的词库文件（.dict.yaml）放在用户数据目录 schemas\ 下，或复用 data\ 下的内置词库路径
3. 登记方案 —— 在 config.toml 的 schema.available 中加入方案 ID
4. 生效 —— 重启输入法或切换方案；扩展词库开关等热重载项除外

相关阅读

• 方案设置 —— 图形界面下的方案管理
• 配置文件与数据目录 —— 覆盖机制与目录结构
• 导入与导出 —— 方案包的打包格式与资源收集规则
• 引导键特殊模式 —— 用引导键进入的小码表