命令直通车

命令直通车（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")))

$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 的怪字符串，而且看不出哪里错了。

内部目录变量

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

# 打开安装目录
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()}", 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("数学", "＋－＜＝＞±×÷∈∏∑")

内置函数参考

所有函数都返回字符串，动作函数返回空串。记号：s 字符串、n 整数、参数后 ? 表示可选。

取值函数（纯函数）

文本处理（纯函数）

计算与内省

动作函数（有副作用）

部分函数有等价别名（run = proc.run、shell = proc.shell、search = web.search、dict.addword = dict.add、ime.setting = setting.open），推荐写规范名。

工作目录：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.web(page) 是等价别名（旧 Web 版设置已废弃）。

附加参数：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：  （【】）|     ← 出外层

撤销上屏：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。

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

按键 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()。
• 副作用会求值两次：$CC 的显示名和动作里的表达式都会被求值。若在两处各写一次 config.toggle 会切换两次（净效果为零）。想"切一次并显示新状态"，让显示名用 config.get、动作用 config.toggle。

相关阅读

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