命令行工具

清风输入法的主程序本身就是命令行工具：不带参数启动时是输入法服务，带子命令时执行一次操作后退出。适合脚本化配置、批量部署与故障排查。

可执行文件

两者都位于安装目录（正式版 C:\Program Files\WindInput\）。wind_cli.bat 做两件事：自动选择 release / dev 变体的 exe；首个参数不是已知子命令时自动补 config 前缀，因此 wind_cli get ui.theme.name 等价于 wind_input config get ui.theme.name。两者可互换使用，下文示例统一用 wind_input。

wind_input schema list > out.txt 2>&1
start /wait wind_input schema rebuild

在线与离线

部分子命令需要输入法服务正在运行（走进程间通信），部分可直接操作文件：

需要在线的命令在服务未运行时会明确报错并退出。这是有意的：这些操作会写入单写者数据库或方案覆盖层，离线直写会与运行中的实例冲突。

顶层命令

wind_input help                :: 顶层帮助（输出到 stdout）
wind_input --version           :: 版本、构建时间与 git hash
wind_input <子命令> help        :: 各子命令详细用法

config

唯一支持完全离线的子命令组。所有写入都经配置注册表校验，未知键、类型错误、枚举越界一律拒绝。

wind_input config list ui.candidate
wind_input config describe ui.candidate.layout
wind_input config get ui.theme.name
wind_input config set ui.candidate.per_page 9
wind_input config export > my-config.toml
wind_input config import my-config.toml

在线成功时提示「已应用 N 项（已热重载）」；离线时提示「已写入 N 项（core 未运行，下次启动生效）」。

schema

管理输入方案配置与分类词库开关。需要服务在线。

wind_input schema list
wind_input schema get wubi86
wind_input schema get wubi86 engine.codetable.max_code_length
wind_input schema set wubi86 engine.codetable.max_code_length 4
wind_input schema dict list wubi86
wind_input schema dict disable wubi86 wubi86_district
wind_input schema dict enable wubi86 wubi86_district wubi86_symbol
wind_input schema rebuild

几条重要约束：

• schema set 拒绝 dictionaries 路径 —— 词库开关请用 schema dict enable|disable。词库是数组，点路径到不了，且覆盖层必须保持稀疏形态，否则会把整份词库定义冻结成快照
• schema dict enable|disable 可一次传多个词库 id —— 会先整体校验（词库须存在、主库不可停用），任一非法即中止，不做部分应用
• schema reset 不支持单键重置 —— 只能整体清除，传第二个参数会报用法错误
• schema rebuild 不接受参数 —— 只支持全量重建
• 值的类型按现有值推断 —— 布尔接受 true/1/yes/on 与 false/0/no/off；数组与对象需写 JSON；现值为空的键会被拒绝
• 不会凭空创建键 —— 拼错的键名会报错而非静默写入覆盖层

schema rebuild 输出「已清除 N 个缓存文件」，若附带「M 个仍被占用」，再执行一次即可清掉，不影响正确性。

dict

导入导出方案的用户数据。需要服务在线。

可选的数据段：userWords（用户词库）、tempWords（临时词库）、freq（词频）、shadow（候选调整）。省略 --sections 时按引擎默认段处理。

wind_input dict export wubi86 backup.wdict
wind_input dict export wubi86 words.wdict --sections userWords,freq
wind_input dict import wubi86 words.wdict --replace --sections userWords

导入时自动识别 WindDict / Rime / TSV 格式，并逐段报告新增、更新、不变、跳过的条数。注意 export 不支持 --replace。

phrase

管理快捷短语。需要服务在线。

wind_input phrase export my-phrases.wdict
wind_input phrase import my-phrases.wdict
wind_input phrase reset-system

phrase import 没有替换模式，只有合并。要清空用户短语请用设置工具。

backup

完整备份与还原。需要服务在线。

可还原的域：config、dict、temp、freq、shadow、phrase、schemas、themes、state、stats。

wind_input backup create D:\bak\wind.zip --stats --state
wind_input backup inspect D:\bak\wind.zip
wind_input backup restore D:\bak\wind.zip --replace --sections config,phrase

inspect 会打印备份类型、创建时间、平台、版本与条目清单。restore 报告已还原项数，有冲突时提示「M 项已存在跳过；用 --replace 覆盖」。

还原后部分改动即时刷新，若界面显示异常重启输入法即可。

路径与内部目录变量

dict / phrase / backup 的文件参数支持相对路径（相对当前终端的工作目录），也支持内部目录变量——用 ${变量名} 写法引用输入法自己的目录，无需硬编码安装位置或用户名（脚本跨机可移植）：

wind_input backup create ${LOCAL_DATA}\backups\wind.zip
wind_input dict export wubi86 ${USER_DATA}\my-words.wdict
wind_input phrase import .\phrases.wdict

dev 变体（wind_input_dev.exe）自动指向 WindInputDev 对应目录。变量名拼错或 ${ 未闭合会报错退出，不会静默按字面目录写文件。含空格的路径在短语里用 wind.cli 时须用多参形式。

同样这三个变量在命令栏短语里也能用，写法一致。但两处对路径的转义规则不同，照搬时要留意：

差异的来由：命令行参数由 shell 直接传给程序，不经短语解析；而短语字符串里 \ 是转义引导符，且 ${YC} 这类模板变量也用同样写法，不能把不认识的名字当错误吞掉。

restart

重启输入法服务，不接受任何参数。

wind_input restart

服务在线时通过服务通道请求重启（与托盘菜单的「重启服务」同一条路径）；服务未运行时直接启动它，提示「服务未运行，已直接启动」。

输出与退出码

输出流：成功结果走 stdout；错误走 stderr。注意各子命令的用法帮助输出到 stderr，只有顶层 wind_input help 走 stdout——管道处理时需留意。

成功提示统一以 ✓ 开头，警告以 ⚠ 开头。

JSON 输出出现在这几处：schema get <方案id>（不带键时输出格式化 JSON）、schema get 命中数组或对象时、config get / config describe 的非字符串值（紧凑 JSON）。字符串值一律去掉引号裸输出。config export 输出的是 TOML。

退出码：

特例：config set / import 在线执行且全部条目都被跳过时返回 1。

设置工具的命令行参数

以上子命令属于主程序 wind_input.exe。设置工具是另一个可执行文件 wind_setting.exe（同在安装目录），它不接受上述子命令，只认自己的一组参数——用来在启动时直接定位到某个页面：

wind_setting.exe --page keys
wind_setting.exe --about

设置工具是单实例的：已经开着时再执行一次，会激活已有窗口并切到目标页，不会开出第二个窗口。

直达词库的指定方案与类型 0.113 新增

--page dict 时可再带两个参数，直接落到某个方案的某类数据，省去进页面后手动选两级下拉：

两个参数各自可选，也可与快捷式 --dict 连用：

wind_setting.exe --page dict --schema wubi86 --type shadow   :: 五笔的候选调整
wind_setting.exe --page dict --type freq                     :: 当前数据域的词频
wind_setting.exe --dict --schema pinyin                      :: 拼音域，子标签沿用上次

双拼等方案在词库页被折叠进「拼音」域，传它们的 id 会落到拼音域。

这组参数同样可以从命令直通车里用 setting.open("dict", "--schema=wubi86 --type=shadow") 触发，无需自己拼命令行。

在短语中调用

命令直通车的 wind.cli(...) 可以把上述任意子命令挂到短语上：

cocr = $CC("重建词库缓存", wind.cli("schema rebuild"))
cobk = $CC("备份", wind.cli("backup", "create", "D:\我的 备份\wind.zip"))

含空格的参数须用多参形式。注意它是发射后不管的，命令失败不会有任何提示。详见命令直通车。

相关阅读

• 命令直通车 —— 在短语中执行动作与调用 CLI
• 配置文件与数据目录 —— config 子命令的键路径
• 备份与还原 —— 图形界面的备份操作
• 输入方案管理 —— 方案文件结构与排序配置