方案与引擎配置

[schema] 域管理方案选择与全局引擎基线。这里配置的码表、拼音、混输等参数是所有同类方案共用的公共基线；单个方案若需与基线不同，通过 schema_overrides/<方案ID>.toml 逐字段覆盖（仅 schema.codetable 支持方案级 override，schema.pinyin / schema.mix 全局唯一）。方案本身的定义与覆盖机制见自定义方案。

方案选择

[schema]
active = "wubi86"                        # 当前激活方案
available = ["wubi86", "wubi86_pinyin"]  # 可循环切换的方案列表（顺序即切换顺序）
primary_codetable = ""                   # 主码表方案 ID（${code_rev} 的码源），留空按 available 顺序取第一个码表方案
primary_pinyin = ""                      # 主拼音方案 ID（临时拼音目标方案），留空 = 全拼 "pinyin"

码表引擎（schema.codetable）

所有码表方案的公共基线。方案可经 schema_overrides/<方案ID>.toml 的 [codetable] 段（带 enabled 总开关）逐字段覆盖。

[schema.codetable]
top_code_commit = true        # 顶码上屏（超满码长取前 N 码首选上屏）
clear_on_empty_max = false    # 满码无候选时清空缓冲
auto_commit_at_full = false   # 满码唯一精确时自动上屏
auto_commit_min_len = 0       # 自动上屏最短码长：上一项从第几码起判定；0 = 等于全码长
punct_commit = true           # 标点触发上屏
show_code_hint = true         # 显示编码提示
single_code_input = false     # 精确匹配模式（关闭前缀匹配）
single_code_complete = true   # 精确匹配空码补全（无候选时从更长编码取首选）
z_key_repeat = true           # z 键重复输入
z_key_action = ""             # z 键附加功能：空 = 不启用（方案级参数，见下方 Callout）
short_code_yield_level = 0    # 出简让全：0 关 / 2 一二级简码 / 3 全部简码（出厂关）
single_char = false           # 单字输入：候选只出单字，不出词（方案可覆盖）
input_chars = ""              # 码元字符集：哪些字符可进输入缓冲；空 = a-z
leading_chars = ""            # 可作第一码的字符（码元字符集的子集）；空 = 与 input_chars 相同

单字输入 0.121 新增

开启后候选只出单字，不出词。五笔一类的定长码表最用得上：单字恒是全码长，同码的词被滤掉之后「满码唯一即上屏」的成立率大幅提高，可以不看候选窗连续敲；也用于练习拆字、录入人名与古文。

按引擎分成互不共享的两份，因为两边的诉求本就不同：

分成两份之后，「五笔只出单字、拼音照常出词」在全局层就表达得了，不必逐方案配。方案级覆盖只给码表：一台机器上常有多张码表、简码体系深浅不同，逐方案配是真实需求；拼音方案通常只有一张。混输方案不必单独写，它跟随自己的主码表方案。

几条边界：

• 「一个字」按字素簇算，不按码位数——⚽️ 是 2 个码位但算一个字。
• 短语、命令、快捷输入的候选不受管辖，开着也照常显示。它们是用户自己编写的内容，不是词库里的「词」。
• 与 input.filter_mode 是两回事：那个按字的常用度筛，这个按候选长短筛，可以同时生效。
• 英文方案恒不受管辖——英文候选是单词，滤掉就全没了。
• 临时拼音 / 临时英文 / 快捷输入 / 特殊模式各有各的候选装配路径，当前不走这道过滤，别照配置表推断临拼会跟着拼音那一档走。

也可以绑热键随时开关，动词是 single_char（裸写 = 切换，另有 :on / :off / :toggle / :follow），两张按键表通用，见按键功能表。热键切的是临时态，不写配置——重启或切方案后回到这里配的值。

英文候选混入（schema.codetable.english_merge） 0.121 新增

码表方案的候选列表里捎带英文词库候选：打 hello 直接选到 hello，不必切英文方案或走临时英文。

[schema.codetable.english_merge]
enable = false        # 总开关
min_length = 3        # 最小触发长度
block_commit = true   # 有英文候选时否决满码上屏

方案可逐项覆盖本段：在方案文件的 [engine.codetable.english_merge] 里写同名字段，不写即跟随全局（与 frequency 同一套三态覆盖）。

英文候选的位次由协调器在所有排序（含调频）之后统一定位：插在开头那段连续的中文常用精确解之后、其余候选之前。于是「中文解得好就让位、解不出就上前」是自动的——hen 排在 很/恨/狠/痕 之后，github 排第 1（中文侧无候选）。代价是英文不参与词频学习，换来位次完全确定。

另外，整串恰好是一个英文词时，引擎新合成的整句（词库里没有这个词、由智能组句拼出来的，如 hello → 「和理论哦」）不得排在它前面；有词库背书的候选不受影响（data → 「打他」照旧排在英文之前）。

码表调频（schema.codetable.frequency）

[schema.codetable.frequency]
enabled = false          # 码表调频总开关
strategy = "top"         # top = 一次到顶 MRU / step = 逐次提升 / position = 位次渐进
promote_prefix = "all"   # 补全词参与调频：none / single / all（仅 position 下生效）
protect_top_n = 0        # 全码位（码长 ≥ 4）锁定原始前 N 位
protect_top_n_len1 = 1   # 一简位（码长 1）
protect_top_n_len2 = 1   # 二简位（码长 2）
protect_top_n_len3 = 0   # 三简位（码长 3）
half_life = 0.0          # 热度衰减半衰期（小时），0 = 内置 72 小时；仅 position 下生效

三个策略相关键的生效条件

• strategy 三档的语义与取舍见词频与候选排序 · 四种调频策略
• promote_prefix 与 half_life 仅 strategy = "position" 时生效，其余策略下设置页会置灰
• half_life 的单位是小时，0 = 内置 72 小时，见热度衰减半衰期

单个方案要与这份全局基线不同，用 schema_overrides/<方案ID>.toml 的 [codetable] 段覆盖；图形界面入口是方案级码表配置。

英文 [schema.english] 0.114 新增

英文是一个普通的可切换方案，有自己的配置段，不再共用码表那套——此前英文的调频策略挂在 schema.codetable.frequency 下，改它会连带改掉五笔的。设置工具位置：方案 → 英文方案配置。

[schema.english]
commit_space = false      # 上屏一个英文词后再补一个空格
raw_candidate = "always"  # 首候选是不是所打原文：always / in_dict / off
case_variants = false     # 大小写变形候选（全小写/首字母大写/全大写）
case_follow_input = true  # 候选跟随输入的大小写（打 Hi 出 Hill）
phrase_seg = false        # 词组分词输入：ip'max → iPhone 15 Pro Max

[schema.english.frequency]
enabled = false          # 英文调频总开关
strategy = "position"    # position（默认）/ top / step
promote_prefix = "all"   # 补全词参与调频：none / single / all（仅 position 下生效）
half_life = 0.0          # 热度衰减半衰期（小时），0 = 内置 72 小时；仅 position 下生效
code_scope = "candidate" # 调频记账方式：candidate（按整词）/ input（按编码）

默认策略与码表不同（position vs top），且没有 protect_top_n*——原因见英文方案配置。

code_scope 按候选来源生效（混输里混进来的英文候选同样按它记账）。两者的完整语义与补空格的边界见英文方案配置。

• 本段同时管辖临时英文 0.118 新增——两者打同一份英文词库，调频是同一套配置、同一份学习数据；临英里选过的词，切到英文方案照样排在前面，反之亦然。补空格自 0.122 起两侧各一份（临英那份是 input.temp_english.commit_space），临英独有的按键语义（字符白名单、空格作输入）同样在 input.temp_english 段

• 跟随输入大小写也是两侧各一份 0.121 新增——case_follow_input 同样互不影响，但默认都是开。⚠️ 临英由 Shift + 字母 进入、缓冲首字母恒大写，于是开着它临英候选恒为首字母大写形态；不想要这个观感就单独关掉临英那一侧，词库候选即回到词库原文（大小写仍可由变形候选取到）

• 候选面那两个键两侧各有一份 0.119 新增——raw_candidate 与 case_variants 在 schema.english 与 input.temp_english 下各自独立，互不影响，case_variants 的默认值还刻意相反（临英 true / 英文方案 false）。两个场景不是一回事：临英是「中文里插一个英文词」，首字母大写是刚需；英文方案是长时输入，每条变形都吃掉一个候选位

码表与拼音的记账口径不受 code_scope 影响：码表恒用输入码，拼音恒用候选码，见词频与候选排序 · 记账口径。

首候选给不给原文 0.122 新增

in_dict 补的是另外两档各只满足一半的那个缺口：打 hel（词库里没有这个词）时 always 会多出一条占位的 hel；打 hell（词库里有）时 off 又让它被用得更多的 hello 顶下去。in_dict 下这两件事同时成立——不是词库词就不产，是词库词就恒排第一、不受调频影响。

老配置的 true / false 仍可读入，等价于 always / off。⚠️ 命令行写入侧不再接受布尔，config set 该键时要写三档之一。

词组分词输入 0.122 新增

用 ' 把词组切成几段，每段只打前缀：

段序必须与词序一致，且首段锚定第一个词——否则 pro 会命中一切含 Pro 的词组，候选直接爆炸。

作用域是英文方案 + 快捷输入里的英文成员（后者用的就是英文方案那个引擎，同一份词库同一套规则）；临时英文另有独立的一份开关 input.temp_english.phrase_seg。

不影响含撇号的词：查询是合并而非劫持，原路径照查——打 o'c 会同时拿到 OS X El Capitan（分词命中）与 o'clock（原路径命中）。

首选保护按码长分级 0.113 新增

四个 protect_top_n* 只对纯码表方案（及混输的码表侧）生效，按本次输入的码长决定用哪一档。出厂即为「一简二简保护、三简与全码放开」。

保护名额只在精确匹配的候选里取，不足则少保护。分档的来龙去脉、老配置的迁移注意事项见词频与候选排序 · 首选保护。

码表自动造词（schema.codetable.auto_phrase）

连续单字上屏累积成序列，遇终止符（标点 / 回车 / 空格 / 焦点切换 / 光标移动 / 多字词上屏）或超时后，为整个序列算词组编码并写入临时词库（立即可作候选）；累计使用达 promote_count 次才晋升进用户词库。

[schema.codetable.auto_phrase]
enabled = false          # 自动造词总开关

# 以下均为隐藏 / 内部字段，见下方 Callout：

# min_phrase_len = 2     # 造词最小字数

# max_phrase_len = 5     # 造词最大字数（超长整体放弃，不截末尾 N 字）

# promote_count = 0      # 晋升进用户词库所需使用次数，0 = 不晋升（一直留临时词库）

# idle_timeout_ms = 0    # 连续单字最大间隔（毫秒），0 = 默认 5000

# temp_max_entries = 5000 # 临时词库条目上限，0 = 不限

拼音引擎（schema.pinyin）

所有拼音类方案（全拼 / 双拼 / 混输拼音子方案 / 临时拼音反查）共用。除 separator 外无方案级 override——方案文件的 [pinyin] separator 会盖过这里的值，不写则回落到这里。出厂就靠它让全拼与双拼分头处置反引号：全拼拿它当分隔符，双拼拿它进辅助码。

[schema.pinyin]
code_hint_source = "auto"   # 编码提示来源：off / codetable / schema / auto
use_smart_compose = true    # 智能组词
single_char = false         # 单字输入：候选只出单字
separator = "auto"          # 分隔策略：auto / quote / backtick / none

| single_char 0.121 新增 | 布尔 | — | false | 单字输入：候选只出单字。与码表那份是两件独立的事——拼音没有定长码，开了只是「不出词」，无方案级覆盖，写在这里就够了 | | separator | 字符串（隐性枚举） | auto / quote / backtick / none | "auto" | 拼音分隔策略。auto = 自动挑一个空闲的符号键（未被选词键、也未被本方案 [key_actions] 占用）：先看 '，再看反引号，都不空闲就不启用；quote = 强制 '；backtick = 强制反引号；none = 禁用分隔符。双拼同样支持，但 auto 下不会占键（' 是选词键、反引号归辅助码），要用得显式配 quote |

英文候选混入（schema.pinyin.english_merge） 0.121 新增

口径同码表那份，但取值完全独立——全拼的英文词与拼音串大面积重叠（hen / men / she 既是音节又是英文词），要不要开与码表方案是两个判断。一个总开关只会逼人在「两个都开」和「两个都关」之间二选一。

[schema.pinyin.english_merge]
enable = false
min_length = 3

本段刻意没有 block_commit：那一项否决的是满码自动上屏与顶码上屏，拼音方案两者都没有——放在这里会是一个恒不生效的开关。拼音侧暂无方案级覆盖。

双拼（schema.pinyin.shuangpin）

双拼相关的全局行为，一次配置对所有双拼方案生效。与方案级 engine.pinyin.shuangpin（那里放 layout，即某个方案的编码规则）分工不同：这里放的是「这台机器怎么用双拼」的偏好，无方案级 override。

[schema.pinyin.shuangpin]
allow_full_pinyin = false   # 双拼方案下额外把击键当全拼再解释一遍

面向「多人共用一台机器」：主力用户打双拼，偶尔来的人只会全拼。开启后，双拼方案在自己的候选之外，额外把击键串当全拼解释一遍，覆盖精确整词、子短语、前缀补全与整句。

只有低置信的全拼候选（前缀补全、子短语）会沉到候选列表末尾；精确整词与整句和双拼候选同层竞争，由消费长度决定先后。同一个词双拼也打得出时，保留的是双拼那条。模糊音跟随 [schema.pinyin.fuzzy]，与双拼流共用同一套设置。

关闭时（默认）对候选无任何影响，纯全拼方案与码表、混输三条路径也都不受此项影响。用法与候选顺序示例见拼音方案配置 · 全拼降级输入。

辅助码（schema.pinyin.aux_code） 0.118 新增

在拼音候选上再按字形筛一轮：打出「时间」的拼音后，续敲形码只留字形对得上的候选。本段是全局行为基线；用哪张码表由方案文件的 [engine.aux_code] 段声明，方案也可用同名段逐字段覆盖本节（缺省回落，与方案级码表配置同一套分层）。

[schema.pinyin.aux_code]
enabled = false
max_phrase_len = 0

开了总开关还要有触发键，两张表都能绑，取决于键的种类：

# 符号键与 z 走这张（键名值域只有它们）
[keys.key_actions]
backslash = "aux_code"

# Tab / PageDown / 方向键那一批走这张
[keys.session_actions]
tab = "aux_code"

两条通向同一个功能。方案文件里写同名段即为只对该方案生效（双拼出厂就是 [key_actions] backtick = "aux_code"）。

session_actions 还有一个共键写法，让同一个键既能进辅助码又能翻页：

[keys.session_actions]
tab = "aux_code:page_next"

语义是「能进辅助码就进、进不去就翻下一页」：第一次按 Tab 进筛选，之后按继续翻页；已经在辅助码里、辅助码没开、方案没配码表，它都退化成纯翻页键；空闲无候选时仍原样交还给应用。

⚠️ 全拼不能绑 `：出厂 separator = "auto" 且 ' 作次选键，于是反引号被判为音节分隔符——绑了也走不到辅助码，内核会为此打一条告警（共键写法在这里则退化成纯翻页键，反引号也就不再是分隔符了）。

模糊音（schema.pinyin.fuzzy）

各模糊音配对开关默认全关，需先开 enabled 总开关再逐项启用。

[schema.pinyin.fuzzy]
enabled = false
zh_z = false
ch_c = false
sh_s = false
n_l = false
f_h = false
r_l = false
an_ang = false
en_eng = false
in_ing = false
ian_iang = false
uan_uang = false

拼音调频（schema.pinyin.frequency）

0.114 起为位置提升模型：按候选位次前移，不打分。只有 half_life 参与（衰减），为 0 时用词频存储的内置默认（72 小时）。

[schema.pinyin.frequency]
enabled = true             # 拼音调频总开关
promote_prefix = "single"  # 补全词参与调频：none / single / all

# half_life = 0.0          # 半衰期（小时），0 = 用 store 默认（72）

# base_scale = 0.0         # 当前模型不使用，改动无效

# recency_peak = 0.0       # 当前模型不使用，改动无效

拼音词组补全（schema.pinyin.completion）

[schema.pinyin.completion]
min_syllables = 4         # 至少输入几个音节才给词组候选
max_extra_syllables = 5   # 词组最多比输入多几个音节

两项约束的都是词组补全——即码比输入长、引擎在预测你尚未输入的音节的那些候选。精确匹配、分段子词、整句、简拼一律不受影响，它们没有预测成分。

判据的尺子是输入自身的音节数：完整音节数 +（有未成音节的尾部字母则算起头的一个）。所以 dian 算 1 个音节，dianh 算 2 个。

逐档的候选对照表、「堤岸」为何仍在、以及两项如何配合，见拼音方案配置 · 词组补全。

上下文语言模型（schema.pinyin.grammar） 0.117 新增

整句转换的 n-gram 上下文打分。实验性，尚未正式发布：默认关闭，且模型文件不随安装包分发（许可与体积），需自行获取并放到 data/schemas/pinyin/grammar/ 下。

[schema.pinyin.grammar]
weight = 0.0   # 语言模型权重，0 = 关闭
model = ""     # 模型文件名，空 = 不启用

拼音自动造词（schema.pinyin.auto_learn）

[schema.pinyin.auto_learn]
enabled = true          # 拼音自动造词总开关

# min_word_length = 0   # 造词最小字数，0 = 回退 2

# max_word_length = 10  # 造词最大字数，0 = 不限

# promote_count = 0     # 临时词晋升所需使用次数

自动造词的来源有两类：分步选词（逐段确认组成的词）与智能组句（一次选中引擎合成的 整句）。后者只产生一段，故 max_word_length 对它等价于「超过这个字数就不学」——不会 把长句截成片段入库。学到的词进临时词库，简拼可直接召回；已在用户词库里的词不重复学。

混输（schema.mix）

融合策略，全局唯一，无方案级 override。控制码表 / 拼音 / 英文候选如何在混输方案里融合与竞争上屏。

[schema.mix]
show_source_hint = false             # 显示候选来源标记
enable_english = false               # 启用英文候选
pinyin_only_overflow = true          # 超码长时仅查拼音
top_code_override_pinyin = false     # 顶码覆盖拼音
auto_commit_block_on_pinyin = true   # 满码上屏遇拼音候选则否决
auto_commit_block_on_english = false # 满码上屏遇英文候选则否决
min_pinyin_length = 2                # 拼音最小触发长度
min_english_length = 3               # 英文最小触发长度
block_commit_on_pinyin_word = true   # 拼音歧义拦截（词强度启发式）
pinyin_word_min_weight = 0           # 拼音歧义拦截的权重阈值
enable_pinyin_abbrev = false         # 拼音产出简拼候选（声母缩写，nh→你好）
pinyin_partial_candidates = false    # 码长内保留「未消费整串」的拼音候选
pinyin_partial_candidates_overflow = true # 超码长时保留同类候选

快捷输入（schema.quick_input）

只放与候选来源无关的全局行为，目前仅一个键。

[schema.quick_input]
decimal_places = 6       # 计算器结果小数位数

快捷输入的其余设置都不在这一段，而在内置「快捷」融合模式（schema.mix_modes 里 id 为 quick_mix 的那一项）上：

更多用法见快捷输入。

混输模式（mix_modes）

# schema.mix_modes 是数组（对象列表），此处不展开子字段

这是每实例配置：同一份列表里的不同条目各有自己的候选来源与 candidate_layout，互不影响。

mix_modes 每一项的常用子字段：

相关阅读

• 自定义方案 — 方案定义与 schema_overrides 覆盖
• 混合输入 — 混输方案的实际使用
• 快捷输入 — 日期 / 计算等内置方案
• 配置文件与数据目录 — config.toml 的分层合并与手工编辑