词频与候选排序

方案页里那几个调频选项——「调频策略」「补全词参与调频」「热度衰减半衰期」「保护前 N 项」——单看每一项都很短，但选错组合会让候选顺序变得难以预测。本页讲清楚它们背后的模型，方案页只列选项。

两个独立的维度

清风的候选排序由两个彼此独立的量决定：

• 权重（weight） —— 候选自带的静态排序分，来自词库文件或语言模型。这是默认排序维度
• 词频（frequency） —— 你实际使用候选的统计（用了多少次、最近何时用）

关键在于：词频不加到 weight 上。 排序时它作为独立维度与权重组合，全程绝不修改任何候选的 weight。

这一点有实际后果：删掉某条词频记录，该候选就精确回落到它的原始位置——不会留下任何「被调过」的残留。你在词库页的「词频」子标签里删除或清空，效果是干净可逆的。

排序是分层的，词频跨不出层

候选按来源分层：整句 → 精确码短语 → 精确全码 → 简码 → 前缀补全 → …

词频的提升只在同一层内发生。 前缀补全出来的词再怎么常用，也排不到精确全码的候选之前；整句候选与精确码短语恒占顶部，根本不参与提升。

这条硬约束保证了两件事：

• 混输方案的「五笔优先」不会被调频破坏——码表层整体压在拼音字之前，是层间隔离干的事，词频动不了它
• 打半个码时冒出来的长词，不会因为你选过一次就永久顶掉精确匹配的字

四种调频策略

设置页上码表与英文有「调频策略」下拉，拼音没有（它固定用位次渐进）。

「置顶」与「步进」本质是同一个

两者都是布尔的「用过优先」：只要用过一次，就整体跳到未用过的那批之前，策略只决定已用过的内部怎么排。

• 好处：立竿见影。选一次就到位，符合直觉
• 代价：一次误选就把词顶到很显眼的位置。而且码表侧的「用过」永不衰减——错了就一直错，只能手动去词频页删掉那条记录

这在候选以精确匹配为主的场景没问题（五笔全码位就是这样）。但对前缀匹配为主的方案过于粗暴：英文几乎所有候选都是前缀匹配（打 hel 出 hello / help / helper），选过一次就顶到最前，一次误选就很显眼。这正是英文方案出厂用「位次渐进」而不是「置顶」的原因。

「位次渐进」的模型

目标位次 = 原始位次 / 2^有效使用次数
有效使用次数 = 累计次数 × 时间衰减

第 8 位 → 4 → 2 → 1 → 0，四次到顶。没有「用过 / 没用过」那道台阶，误选一次只前移一档，用得多才爬得前。

四条要点：

• 提升速度与权重无关。 位次天生是归一化的——第 2 位就是第 2 位，与它的绝对权重是 1500 万还是 2 万无关。所以不管候选之间差 486 倍还是 2 倍，第 2 位的候选都是用一次到首位
• 只在层内提升（见上一节）
• 同位次时用得多的在前
• 累计有效使用不足半次的记录不提升——避免一年前用过一次、已衰减到几乎为零的记录仍把第 2 位顶上首位

热度衰减半衰期

「热度衰减到一半所需的小时数」。某个词最后一次使用过去越久，它累积的使用次数就越不算数。出厂 0 表示用内置的 72 小时（3 天）。

• 调大 —— 久不用的词也保持靠前，适合用词稳定的人
• 调小 —— 更贴近「最近在写什么」

只在带衰减的策略下生效：码表与英文的「位次渐进」，以及拼音（它固定带衰减）。选了「置顶」或「步进」时这一项在设置页会置灰。

码表、拼音、英文各有一份同名设置，三者完全独立、各管各的。

补全词参与调频 0.114 新增

控制前缀补全出来的候选是否参与位置提升。三档：

判据是语义单元数而不是字符数：「东西」是 2 个单元，hello 是 1 个，thank you 是 2 个。用字符数判会把英文整个挡死（hello 有 5 个字符），语义单元让同一条规则在中英文下都成立。

三种引擎的出厂值不同，各有道理：

首选保护 0.113 新增

仅码表方案（及混输的码表侧）有。 把基础排序原本的前 N 个候选按原序回填到最前——即使某候选词频极高，不在保护集内也进不了前 N 位。

按本次输入的码长分成四档：

为什么必须分档

失守的根源是词库与调频用了两条不同的轴。

词库靠权重表达简码的钦定地位（生成时给一简 9999、二简 9950、三简 9000），而调频重排的比较链不看权重，只看「有没有被选过」。五笔一简的 25 个编码每个都是二选一（如 a → 工 9999 / 戈 9998），次选字被误选一次就永久翻转，且码表侧的「用过」不衰减。

0.112 及以前只有一个标量，对所有码长一视同仁，无论取什么值都有一头顾不上：

• 取 1（旧出厂值）：一简二简保住了，但全码位的首选也被永久锁死，调频只对第 2 位以后有效
• 取 0：全码位调频正常，但一简二简当场失守

分档之后简码位保住词库钦定的首选，全码位仍可正常调频——那里才是调频该起作用的地方。

英文没有这一组：它的判据是本次输入的码长，而英文没有简码位这回事——一个 a 后面跟的是几万个词而不是钦定首选。

记账口径：用哪个编码存这条记录

词频记录按「方案 + 编码 + 文本」存储。这个「编码」三类引擎取法不同，是刻意的。

码表用输入码，是首选保护按码长分档成立的前提——不按输入码记，就无从谈「这次输入是一简位还是全码位」。

拼音用候选码，是因为拼音下不能用输入缓冲：双拼的 siyr 与候选码 siyuan、带分隔符的 xi'an 与 xian 都对不上，用输入码会让同一个词分裂成一堆记录。

英文的记账方式可选

英文方案有一项「调频记账方式」：

这一项按候选来源生效——混输方案里混进来的英文候选同样按它记账。

混输方案怎么记

混输方案自己不拥有词库，词频也按候选来源分流：

所以在混输下调的频，切回纯五笔照样生效——本就是同一份数据。详见混输方案配置。

候选调整不是词频

两者容易混淆，但机制完全不同：

想让某个词稳定在首位，用候选调整而不是指望调频。尤其在拼音方案下——拼音候选权重是百万级，把用户词的 weight 调到几千也压不过常用词。

拼音自 0.115 起支持置顶（前移 / 后移仍不可用，理由见词库页）。置顶排在候选装配的最后一步，能翻过拼音的匹配层级闸门，是调频做不到的；代价是它不衰减、不会自动让位，只能手动撤销。不想上硬规则的话，给那个词一个不易碰撞的精确编码仍是可选项。

相关页面

• 码表方案配置 · 词频调整
• 拼音方案配置 · 词频调整
• 英文方案配置 · 词频调整
• 词库管理 · 词频——查看与删除记录
• 配置参考 · 码表调频——确切键名与取值