快捷短语

短语让你用一个简短编码上屏一段常用文本：邮箱、地址、签名、常用回复等。短语是全局共享的，不区分方案，写入后跨所有输入方案立即生效，无需编辑方案文件。

管理位置：设置工具 →「词库」页 → 顶部「词库类型」选择快捷短语。分「系统短语」与「用户短语」两个子标签。

系统短语

内置短语，只读，但可以逐条开关：

系统预置的短语分三类，都可以在任何中文输入状态下直接打编码触发（短语候选追加在当前方案候选之后）。

日期时间类

zz 系列符号

输入 zz 前缀 + 分类缩写，可快速输入各类特殊符号：

打前缀 zz 会先看到分类导航条目，选中后自动补全到完整码进入二级选择；直接打完整码（如 zzbd）则展开为该组的字符候选。

co 系列命令

以 co 开头的一批示例命令短语——选中后执行动作而非上屏文本（打开网址、启动程序、切换输入法状态等）。可在系统短语列表里浏览、开关或仿写。

用户短语

自定义短语，支持完整管理：

触发方式

短语的编码就是你为它设定的缩写。在中文输入状态下键入该编码，短语内容会作为候选出现，按空格或数字键即可上屏。例如把编码 dz 绑定到你的地址，输入 dz 即可选出整段地址。

编码可以与方案的正常编码共存：短语候选与码表 / 拼音候选一同排序，按各自权重呈现。给短语选一个不易与自然词碰撞的编码（例如较长的字母组合），能让它更稳定地出现在你想要的位置。

模板变量

在自定义短语中可使用以下变量，支持 $var 和 ${var} 两种语法，$$ 转义为 $。这是日期时间类的完整清单：

农历 0.116 新增，取的是当天的农历，与快捷输入的农历候选同一套：

例如短语 nl 配 农历$LMD，打 nl 就得到今天的农历日期。

此外还有两类非日期时间变量：

需要比日期时间更复杂的动态内容（打开网址、调用命令行、读剪贴板、算式求值），用命令直通车的函数语法。

短语权重

添加 / 编辑对话框中的权重字段决定短语在同编码候选中的排序，默认 1000。在码表方案下，提高权重可让短语在同编码候选中靠前。

position：仅在权重相同时起作用

短语除权重外还有一个 position 字段，缺省为 0。它的作用范围非常窄，用错方向是常见误解：

# 同为 code = "dz"，权重相同 → 按 position 升序
dz  weight=1000  position=0   →  北京市朝阳区……      ← 排在前
dz  weight=1000  position=1   →  上海市浦东新区……

# 权重不同 → position 被忽略
dz  weight=1000  position=9   →  北京市朝阳区……      ← 仍排在前
dz  weight=500   position=0   →  上海市浦东新区……

还有三条边界需要知道：

• 跨编码、跨来源无效 —— position 只在同一编码的短语内部生效。短语与码表候选、拼音候选之间的先后由权重等因素决定，position 不参与
• 前缀导航列表不看 position —— 输入 zz、co 这类前缀列举出的候选，按「权重降序、完整编码字母序升序」排列，position 无效
• 与候选置顶的 position 不是一回事 —— 设置页候选调整里的置顶位置也叫 position，那是页内插入下标，语义完全不同，别混用

字符组

短语内容支持字符组语法，把一组字符打包在同一个编码下。例如：

$AA("标点", "、。·…")

该组内所有字符候选的权重都等于这条短语条目的权重值，组内字符的相对顺序由字符串顺序决定，与权重无关。zz 系列符号就是这样实现的。

字符组、数组、命令候选、模板短语等更进阶的短语形态详见命令直通车。

短语存储在哪里

所有短语——系统预置的和你自建的——统一存储在用户数据目录的 userdata.redb 中，同一张表里靠一个「是否系统短语」标记区分。

系统短语的种子是安装目录下的 data\system.phrases.toml（TOML 格式，不是 YAML）。启动时会比对种子文件的内容哈希，发现变化才同步进库。

在 %APPDATA%\WindInput\ 放一份同名文件可以整份替换这个种子（见同结构覆盖机制），适合成套定制系统短语。但它只决定「初始有哪些系统短语」——日常添加和修改短语一律通过设置工具完成，数据存在库里，不会回写这个文件。

同步遵循「归属先到先得」，用户数据永不被覆盖：

所以「覆盖系统短语」的正确做法有三种：关掉那条系统短语；用同编码但不同内容新增一条更高权重的用户短语；或直接编辑那条系统短语的权重（会就地改写系统条目本身）。