码表方案配置

方案 → 码表方案配置。这里的设置是所有码表方案共享的基线——五笔 86、导入的五笔 98 / 虎码、快符表都读同一份。个别方案要不一样，用方案级码表配置覆盖。

对应配置段是 config.toml 的 [schema.codetable]，完整键名与默认值见方案与引擎配置。

码表方案是什么

码表方案按「编码 → 词条」的固定映射出候选，编码由方案的码表文件写死，不做拼音那样的语言模型推断。清风内置的五笔 86（ID wubi86）基于极点五笔码表，最大码长 4：

q    → 我（一级简码）
dd   → 大（二码简码）
gggg → 王（全码）
ggtt → 五笔（二字词）

导入第三方码表（五笔 98、新世纪、虎码等）后也是同一套配置在管。

上屏行为

这一组决定「什么时候自动把候选送出去」：

自动上屏最短码长 0.122 新增

「全码唯一自动上屏」默认只在打满全码时才动手：四码方案得打够 4 码。这一项把门槛往前挪。

门槛只是第一道闸，另外两道照旧：该编码得只有一个精确匹配，且词库里没有以它开头的更长编码。所以调到 2 码并不等于「打两码就走」——gg 底下还有 ggtt 之类后继时仍会等你。真正用得上的是短码即到头的码表：快符表那种最大码长 1 的方案，把门槛设成 1 码就能唯一即上屏。

短语的自动上屏跟着同一个门槛走（同一个开关下，短语与码表的「满码」规格必须一致），方案里另设的码表覆盖同样适用。

常用功能

精确匹配模式适合谁

默认（关）时，打 gg 会同时出精确匹配的「王」和前缀补全的 ggtt「五笔」等长词。开启后只剩精确匹配的，候选干净、位置稳定，适合已经打熟、靠肌肉记忆盲打的用户；代价是失去「打半个码就看到长词」的便利。

「精确匹配空码补全」是它的安全网：某个编码在词库里恰好没有精确条目时，不至于面对空候选卡住。

z 键引导功能

z 在五笔 86 里是死码（不参与任何编码），可以借来当引导键。空码状态下按 z 直接进入所选模式：

其它引导键（符号键）在临时拼音 / 临时英文 / 快捷输入各自的触发键设置里配——那三处只收符号键，字母键统一走这一项。

出简让全 0.117 新增

一个字如果有简码，打全码时就不该再占着首选——那个位置留给词组更划算。

以五笔的「大」为例，它的一简是 d：

打一个键就能出「大」，那么打满四码时再把它摆在第一位只是浪费一次翻页。让位之后「大」不会消失，而是沉到该编码所有候选之后——它已经有更短的打法了。

档位说的是「简码算到第几级」，它同时决定两件事：哪些字让位，以及从第几码开始让：

两档的差别落在只有三简、没有更短打法的字上：选「全部简码」，它们在全码位让位；选「一、二级简码」，它们不在范围内，全码位仍保留首选。

代价是后者让得更早——一简、二简的字从三简位就开始让位了。想让三简位也保持词库原样，选「全部简码」。

出厂关，要用请自己开

「有简码的字，短码首选就是它自己」这个前提只对五笔这类前缀式简码成立。别的码表（词频码、 二三重码表等）的短码首选是作者按频次排定的常用字，让位会把它们沉到底——所以这一项出厂是关的， 内置的五笔方案也一样，不替你做主。词库侧同理：发行的五笔词库保留极点上游排定的候选次序， 没有在生成阶段做过任何让位。

用五笔并且想要这个功能，在上面那个下拉里选「全部简码」就行——这里改的是全局，对所有码表方案生效。 只想给其中一个方案开，用方案级码表配置：勾上「出简让全」 那一行单独设，没勾时那一行显示的是它当前跟随的档位。

单字输入 0.121 新增

开启后候选只出单字，不出词。

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

几条边界：

• 短语、命令、快捷输入的候选不受管辖，开着也照常显示——它们是你自己写的内容，不是词库里的「词」。
• 与候选检索范围是两回事：那个按字的常用度筛，这个按候选长短筛，可以同时生效。
• 「一个字」按显示上的一个字算，⚽️ 这类由多个码位组成的图形也算一个。
• 拼音方案另有自己的一份开关，取值互不共享——「五笔只出单字、拼音照常出词」在全局层就配得了。
• 临时拼音、临时英文、快捷输入、特殊模式各有各的候选路径，当前不走这道过滤。

这一项可以逐方案覆盖：一台机器上常有多张码表、简码体系深浅不同。也可以绑一个热键随时开关（动词 single_char，见按键功能表），热键切的是临时状态，重启或切方案后回到设置里的值。

英文候选 0.121 新增

码表方案的候选列表里捎带英文词库候选：打 hello 直接选到 hello，不必切英文方案、也不必走临时英文。适合常打命令行与变量名的用户。

整串恰好是一个英文词时才混入——打 githu 不出 GitHub，想打某个词就敲完它。收窄到精确之后英文天然只剩一两条，不会刷屏。

「最小触发长度」只约束「中文侧有候选」那一路。中文候选为空时不受它约束，2 码起就给英文补全——wi / vi / hi 这类不成音节、中文一条也给不出的串，因此不再是空码。

英文候选的位次是自动的：中文解得好就让位、解不出就上前。hen 排在 很/恨/狠/痕 之后，github 排第 1（中文侧本来就没候选）。代价是英文不参与词频学习——选多少次它的位置都由上面这条规则决定。

这三项可以逐方案覆盖。拼音方案另有自己的一份，取值独立。

词频调整

三种调频策略 0.114 新增

「置顶」与「步进」的本质是同一个：布尔的「用过优先」——只要用过一次就整体跳到未用过的之前，策略只决定已用过的内部怎么排。好处是立竿见影，代价是一次误选就把词顶到很显眼的位置，且码表侧的「用过」永不衰减。

「位次渐进」没有这道台阶，用连续的位次表达强弱，误选一次只前移一档；也是唯一带时间衰减的策略，所以「补全词参与调频」和「热度衰减半衰期」两项只在它下面可用，其余策略下会置灰。

三者都不会破坏「五笔优先」：提升只在同一来源档内发生，补全词再怎么用也跨不到精确全码之前。

简码位的首选保护 0.113 新增

首选保护按本次输入的码长分成四档，出厂即为「一简二简保护、三简与全码放开」。

五笔的一简是肌肉记忆的核心，而 25 个一简编码每个都是二选一（a → 工 / 戈、s → 要 / 五……）。调频只看「有没有被选过」、不看词库权重，因此不保护的话，误选一次次选字就会永久换掉首选。分档之后简码位保住词库钦定的首选，全码位仍可正常调频——那里才是调频该起作用的地方。

保护名额只在精确匹配的候选里取，不足则少保护，不会把前缀补全的长词一并钉死。

自动造词

连续上屏的单字会被自动组成词条，算出编码后存入临时词库，此后可直接用该编码打出。

累积与终止

引擎维护一个连续单字缓冲：每上屏一个汉字单字即追加，遇到终止信号则取出已累积的序列尝试造词，随后清空。

只有汉字单字会进入缓冲。混输方案下由拼音打出的单字同样计入，因为造词时的编码由词组编码器按字重新计算，与该字的输入来源无关。

终止信号有七种：

超时的处理与其余六种不同：它先将旧序列取出造词，再以当前字开启新序列，而非丢弃。此举用于避免跨句拼接，例如间隔十分钟的两次「加好」不会被拼成「加好加好」。间隔阈值由 idle_timeout_ms 控制，0 表示取默认值 5000 毫秒。

造词条件

取出的序列还需满足四项条件，任一不满足则整词作废。

长度 —— 少于 2 字不造词；超过 5 字同样不造词，且是整体放弃而非截取末尾若干字。在连续 8 字的中间切分，结果多半不成词，是杂词的主要来源。上下限为 min_phrase_len（默认 2）与 max_phrase_len（默认 5），均未在设置界面暴露。

取码 —— 按方案文件 [[encoder.rules]] 定义的词组编码器规则，从各字的编码推导词条编码。

查重 —— 若「编码 + 词条」在系统词库或用户词库中已存在则跳过，避免候选出现重复项。

归属 —— 混输方案下，出码与入库均使用主码表方案。因此在混输中造出的词，切回纯码表方案后同样可用。

存储与晋升

新词条写入临时词库，初始权重 800，即时可用。

重复造出同一词条不会重复入库，而是将其使用计数加一，权重不再增长。计数达到「转入用户词库次数」后自动转入用户词库；该项为 0 时不会自动转入，词条一直留在临时词库，可在词库页手动转正、删除或清空。

临时词库默认保留 5000 条（temp_max_entries，0 表示不限），超出时删除权重最低的若干条。检查按写入次数节流，每造词 64 次执行一次，故实际条数可能短暂略高于上限。

排查

将日志级别调至 debug，日志中 auto-phrase: 开头的记录覆盖整条链路：终止信号及其原因、取码失败及具体词条、查重跳过、造词成功及计数、临时词库淘汰。排查完毕后调回 info。

隐藏字段 min_phrase_len / max_phrase_len / idle_timeout_ms / temp_max_entries 的取值范围见配置参考。

相关页面

• 混输方案配置——五笔优先、拼音兜底
• 临时模式——忘码时的临时拼音
• 词频与候选排序——调频的完整原理
• 方案配置——码长、码元字符集、词组编码器等方案文件字段