命令直通车

命令直通车（Command Bar）把短语 / 用户词库 / 系统词库的条目从"展开成文本"升级为"执行带副作用的动作"：打开 URL、启动程序、模拟按键、写入剪贴板、加词到用户库、切换输入法状态等，让输入法兼作快捷命令启动器。

如何触发

命令用一段英文字母编码触发：输入编码 → 候选区出现命令条目 → 选中即执行。

系统短语包已内置一批以 co 开头的示例命令，可在 设置 → 词库 → 短语 中浏览、开关或仿写。

编写位置

命令短语可放在三处，都会自动解析：

四种标记

短语与词库条目共用一个 text 字段，靠内容形式区分类型。命令能力通过以 $ 开头的标记触发。

cobd = $CC("打开百度", open("https://baidu.com"))
cobd = $CC1("打开百度", open("https://baidu.com"))
zzbd = $AA("标点", "、。·ˉˇ¨〃々—~‖…")
zzgo = $SS("常用站点", $CC("百度", open("https://baidu.com")), $CC("GitHub", open("https://github.com")))

cobd = $CC("打开百度", open("https://baidu.com"), {prefix: false})

coim = $CC("导入词库", wind.cli("dict import D:\\words.txt"), ui.toast("导入成功"), {on_error: "stop"})

$AA 是 $SS 的字符串简写：$AA 自动按字符拆开，$SS 显式列举每个元素，元素既可是字符串（选中上屏），也可是嵌入的 $CC(...)（选中执行动作）。输入前缀（如 zz）看到组名导航条目，选中后自动补全到完整码进入二级选择；输入完整码（如 zzbd）直接展开为成员候选。

表达式语法

$CC / $CC1 内部是表达式，只有三种形态：

• 字符串内插：字符串中用 {expr} 内插子表达式，如 $CC("百度搜 {clip()}", open("https://baidu.com/s?wd={url(clip())}"))
• $$ 转义：要输出字面 $ 就写 $$，否则 $M 之类会被当模板变量替换。例如 text = "工资: $$M" 显示 工资: $M
• . 仅作命名空间：. 只用于函数名分隔（clip.copy、key.tap），不能取属性或索引。用 last(1) 而非 last.1，用 len(code) 而非 code.length
• 具名参数：部分函数接受 名字=值 形式的可选参数（目前是 proc.run 的 cwd / verb / show、proc.shell 的 cwd，以及 ime.pair 的 jump），如 proc.run("dict.exe", cwd="D:\\Dict")。规则三条：必须写在所有位置参数之后、同一个名字不能写两次、名字必须是该函数登记过的（写错会报错，不会被当没写过）。值和普通参数一样可以内插，如 cwd="{clip()}"。

路径里的反斜杠要写两个

字符串里的 \ 是转义引导符，写 Windows 路径时必须写成 \\：

# ✅ 正确
cotmp = $CC("[打开临时目录]", open("D:\\notes\\temp"))

# ❌ 错误：`\n` 被当成换行、`\t` 被当成 Tab
cotmp = $CC("[打开临时目录]", open("D:\notes\temp"))

被吃掉的是这几个：\n \t \r 分别变成换行、Tab、回车，\\ \" \' \{ \} \( \) \$ 变成对应的单个字符。其余组合（如 \我、\x）原样保留反斜杠——这正是坑人的地方：D:\我的文档 恰好能用，于是很容易以为单反斜杠没问题，直到某天路径里出现 \notes、\tools、\report，才发现路径被截断成了带换行/Tab 的怪字符串，而且看不出哪里错了。

网络共享路径开头是四个

UNC 路径（\\服务器\共享名）本身就以两个反斜杠开头，每个都要按上面的规则写成两个，所以开头一共是四个：

conas = $CC("[打开共享]", open("\\\\nas\\share"))

规则本身没变，仍然是「一个 \ 写成 \\」——只是 UNC 的开头恰好有两个。写成两个（\\nas）解析出来是单个反斜杠开头的 \nas，那不是 UNC 路径，打不开；而这同样属于上面说的「不报错，只是打不开」。

换个地方写，还是两个

输入法内部只有一份真实文本：库里存的就是输入时用的，存储层对转义一无所知。转义只发生在文本进出系统的边界上，一共三类：

命令栏语法条目的反斜杠不参与这三层——$CC / $CC1 / $SS / $AA 以及含 {} 的模板，它们的 \ 由表达式解析独占，边界再转一次就成了双重展开。所以上面那条「写两个」在哪儿写都一样：设置页的输入框、方案的词库文件、配置分发包里内嵌的码表，写法完全相同，照搬不用换算。

而纯文本词条没有表达式那一层，边界规则直接落到它身上：

内部目录变量

不想硬编码安装位置或用户名（换台机器、换个盘符就失效），可以用 ${变量名} 引用输入法自己的目录：

# 打开安装目录
coad = $CC("[打开安装目录]", open("${APP_DIR}"))

# 上屏安装目录路径
cotd = $CC("[输出安装目录]", type("${APP_DIR}"))

# 拼接子目录 —— 反斜杠同样要写两个
colg = $CC("[打开日志]", open("${LOCAL_DATA}\\logs"))

变量在解析阶段就被替换成绝对路径，可用在任何字符串位置（动作参数、显示名、拼接片段）。这三个变量与 CLI 的路径参数完全一致，写法可以互相照搬。

常用示例

# 打开网址
cobd = $CC("打开百度", open("https://baidu.com"))
cogh = $CC("打开 GitHub", open("https://github.com"))

# 搜索剪贴板 / 上次上屏内容
cobs = $CC("百度搜 · {clip()}", web.search("baidu", clip()))
cozd = $CC("汉典 · {last()}", open("https://www.zdic.net/hans/{url(last())}"))

# 配对符号（光标落两段之间，可用跳出键越过右段）
cojk = $CC("「」", ime.pair("「", "」"))

# 删除当前行
codl = $CC("[删行]", key.seq("Home", "Shift+End", "Backspace"))

# 启动程序
cono = $CC("打开记事本", proc.run("notepad.exe"))

# 加词到用户库（编码自动生成）
coac = $CC("加词 · {clip()}", dict.add(clip()))

# 计算剪贴板表达式
coca = $CC("={calc(clip())}", type(calc(clip())))

# 切换输入法状态
coen = $CC("切中英", ime.toggle("cn-en"))
cots = $CC("切主题", ime.theme_cycle())

# 字符组
zzbd = $AA("标点", "、。·ˉˇ¨〃々—~‖…")
zzsx = $AA("数学", "＋－＜＝＞±×÷∈∏∑")

内置函数参考

函数只有一种返回值：字符串——数字、布尔在这里也是字符串（len("abc") 得到 3，可以直接拼进文本），动作函数返回空串。记号：s 字符串、n 整数、参数后 ? 表示可选。

每张表先给速查，表后的小节讲具体怎么写。

四条通用规则

• 索引从 1 起，按字符数。 code(2) / sub(s, 2) / split(s, ",", 2) / dict.rev(s, 2) 里的 2 都指第 2 个字符（第 2 段）；汉字、emoji 各算一个。sub 与 split 还接受负数，-1 是最后一个。
• 取不到就给空串，不报错。 索引越界（sub("abc", 9)）、历史不够长（last(9)）、剪贴板为空，结果都是空串。这是刻意的：$SS 里固定写 N 条各查一个字，取不满是常态，报错会让整条短语连带消失。
• 写错才报错，而报错等于候选消失。 函数名不存在（含拼写、大小写写错）、参数个数不对、该给数字的位置给了别的，都算错误。错误在显示名里 → 打出编码后候选里什么都没有、也没有提示；错误在动作里 → 选中时提示命令执行失败。所以"编码打出来却看不到候选"，第一嫌疑就是函数名或参数写错。
• 显示名里只能用纯函数。 $CC 的第一个参数只接受取值 / 文本 / 计算类函数；写 open、config.set、key.tap 这类动作函数会被判为不纯、整条失效——候选被列出来的时候不该有副作用发生。

取值函数（纯函数）

日期与时间：date / time / now

fmt 里下面这些字母是占位符，其余字符（- / : 年 等）原样输出。三个函数用的是同一套占位符，time 只是默认值不同、now 是写死的格式。

没有星期、上午/下午、月份英文名的占位符。24 小时制补零只有 HH（没有 H），12 小时制只有 h（没有 hh）。

常用配方：

codt = $CC("{date("YYYY-MM-DD")}", type(date("YYYY-MM-DD")))
cotm = $CC("{date("YYYY-MM-DD", "+1d")}", type(date("YYYY-MM-DD", "+1d")))

offset：把日期平移一段。 形如 "+1d"，三部分缺一不可：

单位只有这四个：M 是月、小写 m 不是分钟而是非法单位，也没有小时/分钟级的偏移——要平移时间只能靠 date(fmt, offset)，而它最小的单位是天。

月和年按自然月平移，落到不存在的日期时夹到当月最后一天：3 月 31 日 -1M 得到 2 月 28 日（闰年 29 日）。

编码、历史与剪贴板：code / tail / last / clip

历史只记真正上屏的文本，纯副作用命令（open / proc.run 等）不进历史，所以 last() 不会被命令自己污染（见行为细节）。

last() 与前台信息在命令触发的那一刻冻结成快照，之后动作里再读也是同一份。

环境变量与随机 ID：env / uuid

env(name) 读输入法进程的环境变量，读不到返回空串（不报错）：

couser = $CC("{env("USERNAME")}", type(env("USERNAME")))
cohome = $CC("[打开用户主目录]", open(env("USERPROFILE")))

uuid() 生成随机 UUID（v4），flags 控制形态，字母不区分大小写：

只认 n 和 u，写别的字母（uuid("x")）会报错、候选消失——这是刻意的，静默忽略会让人以为"格式没生效"。短语层的 $uuid 模板变量走的是同一套实现。

文本处理（纯函数）

照着抄的例子（左边是写法，右边是结果）：

trim(s, chars) 的第二个参数是字符集合不是子串：trim("xxabcxx", "x") 与 trim("xxabcxx", "xy") 结果相同，都是 abc。

正则替换：regex(s, pat, rep)

pat 用 Rust regex 语法（与 RE2 同族）：\d \w \s、[[:alpha:]]、+ * ? {n,m}、|、分组都支持，不支持反向引用和环视（(?<=...)、\1）。

• 模式里的反斜杠按字符串规则写两个：\\d 才是一个 \d（见路径里的反斜杠要写两个）
• 量词的大括号要转义成 \{ \}：{ 在字符串里是插值语法，"\\d{3}" 会被求值成 \d3——正则悄悄变成了另一个意思，还不报错
• 替换串里用 ${1} ${2} 引用捕获组。${...} 不会被当插值（那是内部目录变量的写法，名字不认识就原样保留），可以照写；$1 也认，但后面紧跟字母数字时会被吞进组名，统一写 ${1} 更稳
• 匹配处全部替换，没有"只换第一处"的开关
• 正则本身写错（括号不配对等）→ 求值报错 → 候选消失

# 把连续数字换成 #
como = $CC("[数字打码]", type(regex(clip(), "\\d+", "#")))

# 日期换成中文写法（捕获组用 ${1}）
cocn = $CC("[日期转中文]", type(regex(clip(), "(\\d+)-(\\d+)-(\\d+)", "${1}年${2}月${3}日")))

# 手机号中间四位打码：注意量词的大括号写成 \{3\}
comask = $CC("[手机号打码]", type(regex(clip(), "(\\d\{3\})\\d\{4\}(\\d\{4\})", "${1}****${2}")))

# 多行粘贴合成一行：\r?\n 才能同时吃掉 \r\n 和 \n
cojoin = $CC("[多行并一行]", type(regex(clip(), "\\r?\\n", "、")))

四个编码函数：url / html / json / base64

url() 正是搜索类命令的关键一环——open("https://www.zdic.net/hans/{url(last())}") 里少了它，含空格或标点的词就会把 URL 拼坏。

计算与内省

算术：calc(expr)

支持 + - * / %（取余）、圆括号、一元正负号、小数与空格。

不支持：乘方 ^、科学计数法 1e3、千分位逗号、全角符号（（1＋2））、sin 之类的函数、变量。碰到不认识的字符就报错，整条候选消失。

最后两行是配剪贴板算式用的：calc(clip()) 在没复制东西时静默给空串，所以出厂那条 coca = $CC("={calc(clip())}", type(calc(clip()))) 只会显示一个 =，而不是整条消失。

进制：num(s, base)

s 的进制由前缀自动识别，base 是输出进制：

输入前缀：0x/0X 十六进制、0o/0O 八进制、0b/0B 二进制、无前缀按十进制，可带正负号，首尾空格自动去掉。base 只能是 2 / 8 / 10 / 16，其它值报错；只处理整数，num("3.5", 10) 报错。

查手册：help(name)

help("date") 返回 date 的一行内置简介。配上剪贴板就是一条随手可查的手册：

cohelp = $CC("{default(help(clip()), "复制一个函数名再查")}", type(help(clip())))

动作函数（有副作用）

type(s) 是唯一被特殊对待的名字：它只能作为 $CC 的动作直接写出来，不能嵌进别的函数里、也不能出现在显示名中，且只接受 1 个参数、不接受具名参数。help("type") 也查不到它。别和 key.type 搞混——后者是模拟键盘直输，走的是另一条路径。

web.search(engine, q) 的 engine 不区分大小写、首尾空格会被去掉；q 为空时不会打开浏览器，而是报错——避免开出一个空搜索页却让人以为命令没执行。zdic 走的是汉典的词条页而非搜索参数。

工作目录：cwd=

被启动的程序总有一个确定的工作目录，规则如下：

不写 cwd 时，proc.run 默认取被启动程序所在的目录——等同于你在资源管理器里双击它。靠相对路径找数据文件的程序（各类词典、绿色版工具）正是按这个前提写的，所以多数情况下不需要写 cwd。

proc.shell 是把整条命令行交给 shell，认不出目标程序，所以默认只能落到主目录。命令里带相对路径就必须显式写 cwd。

cwd 支持内部目录变量，也支持内插：

# 用输入法自己的目录
cotool = $CC("[跑工具]", proc.run("${APP_DIR}\\tools\\t.exe", cwd="${APP_DIR}\\tools"))

# 查词：词库在程序目录下，靠相对路径加载
codc = $CC("查 {last(1)}", proc.run("D:\\Dict\\dict.exe", "{last(1)}", cwd="D:\\Dict"))

管理员运行与窗口状态：verb= show=

只对 proc.run 有效，且只在 Windows 生效（macOS 会忽略并在日志留一条说明）。

# 以管理员身份跑一个维护脚本
coadm = $CC("[管理员运行]", proc.run("D:\\tools\\fix.exe", verb="runas"))

# 后台静默启动，不打断当前打字
cobg = $CC("[后台同步]", proc.run("D:\\tools\\sync.exe", show="hidden", cwd="D:\\tools"))

取值必须是上表里的小写词，写错（含大小写不符，如 verb="RUNAS"）会直接报错并列出合法取值——这个校验在所有平台一致，所以在 macOS 上写错也会当场发现，不会等到换台 Windows 机器才炸。

打开设置页：setting.open(page)

page 是目标页的规范 id，直接跳到对应标签页：

cost = $CC("打开设置", setting.open(""))
codc = $CC("词库管理", setting.open("dict"))

未知 id 会被设置端忽略并落到默认页。

附加参数：setting.open(page, args) 0.113 新增

第二个参数是原样直通给设置工具的命令行参数串，写法与设置工具的命令行参数完全一致。最常用的是直接落到某个方案的某类词库数据：

codw = $CC("五笔用户词库", setting.open("dict", "--schema=wubi86 --type=user-dict"))
cods = $CC("五笔候选调整", setting.open("dict", "--schema=wubi86 --type=shadow"))
copy = $CC("拼音词频", setting.open("dict", "--schema=pinyin --type=freq"))

输入法只负责转交，不解析这串参数——设置工具支持什么就能写什么，新版本加的参数无需等输入法跟进。参数不认识或方案不存在时，设置工具会退到最接近的位置并给出提示，不会打不开。

配对符号：ime.pair(left, right, jump?)

上屏 left + right、光标落在两段之间，并把这一层压入配对状态——之后按跳出键（在设置里配的 Tab / Enter）就能越过右段，和自动配对打出来的括号完全一样。

cojk = $CC("「」", ime.pair("「", "」"))
cozs = $CC("注释", ime.pair("<!--", "-->"))

两段都可以是任意文本，不限于单个符号：

输入后：  <!--|-->
按 Tab：  <!---->|

jump：跳出时光标右移的格数。 省略时按右段的字符数推导（"-->" → 3），一般不用写。它存在是因为跳出靠合成方向键，而"一次右键越过多少内容"是宿主行为——多数宿主一次跨整个 emoji，少数按编码单元走。若在某个程序里发现跳出后光标位置差了几格，用它手动校准：

cozs = $CC("注释", ime.pair("<!--", "-->", jump=3))

分级跳出：同一条词条里写多个 ime.pair 即可，无需额外语法。后写的是内层，跳出时也先出内层：

cokh = $CC("（【】）", ime.pair("（", "）"), ime.pair("【", "】"))

输入后：  （【|】）
按 Tab：  （【】|）     ← 出内层
按 Tab：  （【】）|     ← 出外层

反查剪贴板里的字 0.117 新增

平时的反查要先把字打出来，才能在悬停提示里看它的编码和读音。碰到不认识的字（从网页、 PDF、聊天记录里看到的），这条路走不通——你根本不知道怎么打它。

dict.rev 反过来走：先复制，再查。

出厂已带 cofc，直接可用：

cofc = $CC(default(dict.rev(clip()), "剪贴板反查（需先复制文字）"), type(dict.rev(clip())))

复制一个「我」，切回输入法打 cofc，候选就是：

我: q/trn/trnt wǒ

编码给的是全部码位（简码在前），因为反查回答的是「这个字怎么打」——q 这样的简码才是 最有用的答案。编码来自码表的反查索引，不是按取码规则算出来的，所以给出的码一定打得出来。

选中即上屏这行文字。

查第几个字

默认查第 1 个字。dict.rev(s, n) 查第 n 个（1 起）；n 超出字数返回空串，不报错。

想一次看多个字，用 $SS 列若干条、各查一个：

cofd = $SS("反查", "{dict.rev(clip(),1)}", "{dict.rev(clip(),2)}", "{dict.rev(clip(),3)}")

写几条就是最多查几个字。剪贴板不足位数时，多出来的那几条自动不出现，不会留空白候选。

换版式：format=

版式用候选注释的同一套 ${...} 模板语法， 变量名也一样，学一次即可：

可用变量：${char}（被查的字）、${code_all}（全部码位）、${code}（只要最长的全码）、 ${pinyin}、${chaizi}、${chaizi_code}、${dict}（注释词库释义）。

为什么用 $CC 而不是直接写模板

直接写 {dict.rev(clip())} 也能用，但候选的显示文本就是上屏文本，两者绑死。于是剪贴板 为空时只有两个都不好的结果：整条候选消失（分不清是没复制还是功能坏了），或者把提示语本身 打进文档。

$CC 把两者拆开：display 只管显示（查不到时用 default 回落到提示语），上屏走 type(dict.rev(clip()))（查不到时求值为空，选中什么也不打）。

撤销上屏：ime.undo_commit()

按上屏历史删除最近一次上屏的内容——记录上屏了几个字符，就往前删几个。连续触发可逐条回退。

coun = $CC("撤销上屏", ime.undo_commit())

配合快捷键使用更顺手：把这条短语绑一个好按的编码，或用 config.set 给它挂全局热键。

行为细节：

• 正在打字时不动作 —— 输入缓冲非空（组合区有内容）时直接忽略，不会误删
• 无上屏历史时删除 1 个字符
• 每撤销一次就从历史中弹出一条，推送失败会回滚该条记录

调用命令行：wind.cli(...)

把命令行工具的任意子命令挂到短语上，用主程序自身执行。两种传参形式：

# 单参形式：按空白拆分
cocr = $CC("重建词库缓存", wind.cli("schema rebuild"))
codf = $CC("停用辅码库", wind.cli("schema dict disable wubi86 fl"))

# 多参形式：逐个原样传递，用于含空格的路径
cobk = $CC("备份", wind.cli("backup", "create", "D:\\我的 备份\\wind.zip"))

# 配合内部目录变量，免去硬编码路径
cobu = $CC("备份到用户目录", wind.cli("backup", "create", "${USER_DATA}\\backups\\wind.zip"))

含空格的参数（尤其是文件路径）必须用多参形式，否则会被空白拆散成多个参数。路径里的反斜杠仍按短语字符串规则写成 \\（见路径里的反斜杠要写两个）——这一层与 CLI 无关，是短语先解析、再把结果交给 CLI。

照搬终端命令的两道坎

从终端里跑通一条命令、再原样贴进 wind.cli(...)，是最常见的写法，也最容易连撞两道坎。拿一条真实的命令举例——把竖排候选的注释模板设成 {${chaizi}}{ [${chaizi_code}]}{ ${pinyin}}（这是模板本身的样子，下面写进短语时还要再转义一层）：

# ❌ 错误：整条命令行塞进一个参数，大括号也没转义
[[phrases]]
code = 'comm'
text = '$CC1("切注释全", wind.cli("config set ui.candidate.comment_template_vertical {${chaizi}}{ [${chaizi_code}]}{ ${pinyin}}"))'

# ✅ 正确：按空格拆成 4 个参数，大括号写成 \{ \}
[[phrases]]
code = 'comm'
text = '$CC1("切注释全", wind.cli("config", "set", "ui.candidate.comment_template_vertical", "\{${chaizi}\}\{ [${chaizi_code}]\}\{ ${pinyin}\}"))'
weight = 1000
position = 1

第一道：参数得你自己拆开。 单参形式只是把整串按空白切一刀（每遇到空白就分出一个参数），它只适合参数本身不含空格的命令。上面那条模板串自己带空格，切完就散成了六七个参数，CLI 收到的东西跟你写的完全不是一回事。只要有任何一个参数可能含空格，就把命令行的每一段写成独立的字符串参数——包括 config、set 这些子命令名。

第二道：\{ 和 \} 要转义。 字符串里的 {...} 是内插语法，{${chaizi}} 会被当成「求值这个表达式」而不是字面的大括号。要输出大括号本身，必须按转义表写成 \{ \}（见路径里的反斜杠要写两个）。

${chaizi} 这类 ${名字} 不用转义：只有内部目录变量那三个名字会被替换，其余原样穿过，正好交给 CLI。

执行完给出反馈 0.121 新增

wind.cli 会等命令跑完，按退出码把结果弹成 toast：成功文案取 CLI 自己打印的最后一行（「✓ 用户词库: 新增 12 · 更新 3」），失败取 stderr 的首行。三个具名参数管这件事，都不影响命令本身：

# 导入用户词库，失败时才提示
coim = $CC("导入词库", wind.cli("dict import D:\\words.txt", toast="error"))

# 服务侧本来就会弹提示的子命令，把这一层关掉，免得撞车
cort = $CC("重启服务", wind.cli("restart", toast="off"))

# 自定成功文案，并把等待放宽到 30 秒
corb = $CC("重建缓存", wind.cli("schema rebuild", ok="缓存已重建", wait="30000"))

从短语调用时输入法服务必然在线，所以 schema / dict / phrase / backup 这些需要在线的子命令都能正常连上。

弹一条提示：ui.toast(...) 0.121 新增

# 最简形式
$CC("提示", ui.toast("已完成"))

# 指定类型与位置
$CC("提示", ui.toast("导入完成", kind="success", pos="top_right", ms="4000"))

# 自定强调色
$CC("提示", ui.toast("注意", color="#FF8800"))

除文案外全部具名、与顺序无关：

底色与文字色仍归主题，不开放到词条——只有强调色可以在这里改。

外部脚本与计划任务也能弹：命令行 wind_input ui toast "文案"，见命令行工具。

按键 combo 格式

key.* 的 combo 为 [修饰键+]...主键，大小写不敏感，+ 分隔。修饰键：Ctrl、Shift、Alt、Win（各有别名如 Control / Menu / Super）。主键支持常见控制键（Enter、Tab、Escape、Home、End、Up 等）、功能键 F1–F24、字母数字键，以及标点键（Comma、Period、Slash 等）。

key.tap("Ctrl+C")                       # 复制
key.tap("Alt+F4")                       # 关闭窗口
key.seq("Home", "Shift+End", "Delete")  # 删除整行
key.type("Hello, 世界")                  # Unicode 直输

未列出的特殊键用 vk: 前缀指定 Windows 虚拟键值，0x 前缀为十六进制、无前缀为十进制，有效范围 0x01–0xFF：

key.tap("vk:0x5D")    # 右键菜单键（VK_APPS）
key.tap("vk:0x60")    # 数字小键盘 0
key.tap("Shift+vk:0x5D")

行为细节

• 权重：命令短语与普通短语一样默认权重 1000。命令用的精确英文编码极少与自然候选撞码，默认值通常已足够靠前；拼音方案下更应选一个不与自然词碰撞的编码，而非堆高 weight。
• 自动上屏 / 顶码：纯文本命令（只产出文本）与短语一样可自动上屏、顶码上屏；含副作用的命令不自动上屏，始终等待手动选择，被顶屏时异步执行动作。只有短语的编码（如 date）不参与顶码，也不会被"满码空码清空"误清。
• 不污染历史：last() 只记录真正上屏的文本。有 type() 的命令进入历史；仅副作用命令（open / proc.run 等）不进入，避免显示文字污染下一次 last()。
• 显示与执行是两次独立求值：显示名在候选生成时算一遍，动作在选中时再算一遍。所以 uuid()、now() 写在两处会得到两个值。想"切一次并显示新状态"，让显示名用 config.get、动作用 config.toggle——把 config.toggle 写进显示名不会切换两次，而是整条候选直接失效（显示名不允许有副作用）。

相关阅读

• 短语与模板 — 权重、词频与短语管理
• 词库与词频
• 配置文件与数据目录 — config.get / config.set 的键路径