五笔 Rime 小狼毫安装调优：用户目录、schema

简介：面向五笔输入法爱好者与需要稳定中文输入环境的桌面用户，这份基于 Rime 小狼毫平台的整合包提供一套可直接启用的五笔方案。核心是作者长期自用的高级五笔词库，词库历经二十余年维护与优化，常用配置也按多数人的输入习惯调校，兼顾码表准确度、候选排序与日常打字顺手程度；对于不愿反复折腾方案、又希望保留五笔节奏的读者，能减少自建词库与调试配置的时间成本。压缩包共 102 个文件，包含 yaml、json 等方案与配置，ime、dll、exe 等输入法组件，png 图示，以及 bat、cmd 安装脚本，整体约 12.5MB，体积轻量而结构完整，配置、组件与说明性文件分区清楚，便于按用途查找。资源支持 Windows 10，包内附安装入口，降低自行拼装组件的门槛。目前已有 1116 人学习下载，适合五笔初学者和需要长期使用成熟词库配置的中高级用户参考选用。

1. 五笔 Rime 小狼毫：一个 rar 包，双击 !install!.cmd 之前先想清楚的三件事

拿到五笔 Rime 小狼毫输入法这个压缩包的时候，我以为十分钟能收工：解压、双击 !install!.cmd、切输入法，三步走完。结果第一次双击，黑窗口一闪就没，输入法列表里查无此人；换个目录重来，装是装上了，候选框里却能打出一串方块；第三次把配置改对了，五笔字根打出来全是空码。五笔 Rime 小狼毫输入法这类绿色整合包，翻车点几乎全卡在「装」和「配」中间那道缝里——脚本替你做了什么、用户目录落在哪、方案有没有挂进 schema_list，三件事只要有一件没对齐，前面双击多少次都白搭。这篇把从解压到打出第一个五笔字的链路摊开写，新手照着走能通，装过几轮的人也能对着参数取舍看一眼。

2. 装前清点：小狼毫对 Windows 环境的四条硬要求

小狼毫（Weasel）本身是个壳，真正干活的是 librime 内核加一堆 YAML 方案文件，它对系统版本的要求其实不高，Windows 7 SP1 以上就能跑，真正会把人绊住的是路径、权限、旧版残留和用户目录这四样。很多人装完觉得「输入法坏了」，其实内核一直在正常工作，只是配置文件读错了地方，或者读到了一个半旧不新的目录。

我这边的习惯是：拿到包先别解压到桌面，先在脑子里把「程序目录」和「用户目录」这两个概念分开。程序目录是 WeaselSetup.exe 待的地方，一般在C:\Program Files (x86)\Rime\下面；用户目录是%APPDATA%\Rime，也就是C:\Users\你的用户名\AppData\Roaming\Rime。方案、词库、皮肤、你自己改的所有 custom 文件，全在用户目录里；程序目录只放可执行文件和一套出厂默认配置。分不清这两个目录，后面改配置九成会改错文件。

2.1 解压位置的三条硬规则

第一条，路径里不要有中文和空格。D:\输入法\rime 五笔\这种路径，在批处理里一旦没加引号就会在空格处断掉，%~dp0展开出来的东西带空格，cd /d后面不加引号直接报「系统找不到指定的路径」。我一般直接解压到D:\soft\wubi-rime\这种纯英文短路径。

第二条，不要解压到 OneDrive、坚果云这类会被同步的目录，也不要放在C:\Program Files下面。同步盘会在后台不停改文件时间戳，小狼毫部署时读方案文件，读到正在被同步的半截文件就会部署失败；Program Files则涉及 UAC 提权，脚本里的复制动作会因为权限不够静默失败——窗口一闪就没，多半就是这个原因。

第三条，解压完先看目录结构再动手。用一条命令把顶层列出来：

:: 进到解压目录，把顶层文件列出来，先看清楚包里有什么 cd /d "D:\soft\wubi-rime" dir /b

dir /b是精简模式，只列名字不带详情，一眼能扫完。正常应该能看到!install!.cmd、WeaselSetup.exe或weasel之类的子目录、一个data或rime目录（里面是方案和词库）。如果dir /b出来只有一个 rar 里的说明 txt，说明你解压的是外层壳，真正的包还在里面一层，得再解压一次。

提示：解压工具用 7-Zip 或 Bandizip，别用系统自带的那套。有些包的文件名带特殊字符，自带的解压会悄悄改名，!install!.cmd前面的感叹号被吃掉，双击就变成找不到文件。

2.2 系统侧要提前确认的四件事

第一件，确认当前有没有装过小狼毫。已经装过旧版再装新版，最常见的现象是新旧两套注册信息打架，输入法列表里出现两个「小狼毫」，切过去一个能用、一个点了没反应。查的办法是看两个地方：C:\Program Files (x86)\Rime\下有没有 weasel-开头的目录，以及控制面板的「程序和功能」里有没有对应条目。有就先把旧的卸干净再装。

第二件，确认用户目录有没有历史残留。%APPDATA%\Rime这个目录如果之前存在过，里面可能躺着一份老配置，新装的小狼毫会直接读它，然后你就会遇到「明明包里带了五笔方案，装完却没有五笔」这种反直觉的情况。

:: 看用户目录是否已存在，存在就先备份再清空 if exist "%APPDATA%\Rime" ( echo 发现历史用户目录，先打包备份 ren "%APPDATA%\Rime" "Rime_bak_20240101" )

ren是重命名，比直接删安全得多，万一新配置有问题还能换回来。备份这一步别省，用户词库全在里面，删了就是真丢。

第三件，确认当前账户是管理员。WeaselSetup.exe /install要往系统里注册输入法，标准用户跑会失败。判断方法是开一个 cmd，标题栏没写「管理员」就右键「以管理员身份运行」再开。

第四件，确认系统里至少有一个可用的中文字体。小狼毫的候选框如果指定了一个系统里没有的字体，你会看到方块或者空白。默认配置用的字体一般没问题，但如果你后面要改成某个自己装的字体，先确认它真的在C:\Windows\Fonts里。

2.3 环境对照表

把上面这些整理成一张表，装之前对一遍，能省掉后面一大半排查时间。

项目	合格状态	不合格的典型现象
解压路径	纯英文、无空格，如`D:\soft\wubi-rime`	双击脚本一闪就没
是否存在旧版	程序和功能里无小狼毫条目	输入法列表出现两个同名项
用户目录	`%APPDATA%\Rime`已备份或不存在	装完没有五笔方案
账户权限	cmd 标题栏显示「管理员」	安装脚本执行到一半退出
系统字体	至少一个中文字体可用	候选框显示方块
系统版本	Windows 7 SP1 及以上	安装程序直接拒绝运行

表格里最后一行值得多说一句。小狼毫的 32 位和 64 位安装包是分开的，64 位系统装 32 位包能用，但输入法会以 32 位进程挂在 64 位程序里，某些 64 位编辑器里会掉输入法。常见做法是系统多少位就装多少位的包，别图省事混装。

3. 安装落地：从双击 !install!.cmd 到打出第一个五笔字的完整链路

到这一步路径清了、残留清了、权限也够了，可以动手。但我建议双击之前先花两分钟把脚本打开看一眼，这一步在血泪经验里价值极高——整合包的脚本质量参差不齐，有的只做复制，有的会顺手改注册表，还有的会在你没注意的时候把用户目录整个覆盖掉。

3.1 先看 !install!.cmd 里到底写了什么

右键!install!.cmd，选「编辑」，或者用记事本打开。典型结构大概长这样：

@echo off :: 切到脚本自身所在目录，保证后续相对路径都能找到 cd /d "%~dp0" :: 把方案和词库复制到用户目录，已存在的直接覆盖 if not exist "%APPDATA%\Rime" mkdir "%APPDATA%\Rime" xcopy /e /y "data\*.*" "%APPDATA%\Rime\" :: 调用安装器，把输入法注册进系统 "WeaselSetup.exe" /install :: 触发一次部署，让方案立即生效 "WeaselDeployer.exe" /deploy pause

读到这三段就够了。cd /d "%~dp0"是把工作目录切到脚本自己所在的位置，%~dp0是批处理里代表「当前脚本所在目录」的变量，带引号是为了防路径里有空格。xcopy /e /y里/e表示连空子目录一起复制，/y表示覆盖时不询问；如果脚本写的是xcopy而不是robocopy，说明它不做差异比对，每次都是全量覆盖，这就是为什么改过的配置会被冲掉。

WeaselSetup.exe /install是注册输入法到系统的动作，WeaselDeployer.exe /deploy是让 Rime 重新读一遍方案文件生成 build 目录。这两步分开是有原因的：装上了不等于部署好了，注册只是让系统知道有这么个输入法，部署才是让它能打出字。

如果你的包里脚本内容和上面差得远，比如只有一行WeaselSetup.exe /install，那说明方案文件需要你手工放；如果脚本里有reg add之类的注册表操作，看清楚它改的是哪个键再决定要不要跑。看不太懂就别跑脚本，走下面这套手动流程，效果一样，风险可控。

3.2 不放心脚本：手动等价流程四步

手动流程的前提是管理员身份开一个 cmd。四条命令，一条一条来。

:: 第一步：进到解压目录，确认文件都在 cd /d "D:\soft\wubi-rime" dir /b WeaselSetup.exe WeaselDeployer.exe :: 第二步：手工把方案目录复制到用户目录 if not exist "%APPDATA%\Rime" mkdir "%APPDATA%\Rime" xcopy /e /y "data\*.*" "%APPDATA%\Rime\" :: 第三步：注册输入法 "WeaselSetup.exe" /install :: 第四步：部署，让方案生效 "WeaselDeployer.exe" /deploy

第二步里data这个目录名要按你包里的实际名字改，有的包叫rime，有的叫userdir，dir /b一眼能看出来。复制完可以再列一次用户目录，确认方案文件真的进去了：

:: 确认用户目录里已经有方案和词库 dir /b "%APPDATA%\Rime\*.yaml"

正常输出里应该能看到default.yaml、weasel.yaml、installation.yaml，以及wubi86.schema.yaml、wubi86.dict.yaml这类方案文件。看不到方案文件，后面怎么配都是空码，因为内核根本没东西可查。

第三步的/install参数是注册，对应的卸载参数是/uninstall；部署器这边/deploy是重新部署，/sync是同步用户词典。这几个参数在排查时会反复用到，记下来比翻文档快。

注意：/install之前一定要确认没有旧版在跑。托盘里还挂着旧版小狼毫的图标时执行安装，注册表会写进旧路径，装完切过去可能是一个已经被删掉的程序目录。

3.3 把五笔方案挂进 schema_list

输入法注册好了，方案文件也复制过去了，但还有一个关键动作：告诉 Rime「我要用五笔」。这个开关在default.custom.yaml里，改的是schema_list。用户目录下如果没有这个文件，自己建一个纯文本文件，扩展名必须是.yaml，不要留.txt。

# %APPDATA%\Rime\default.custom.yaml patch: # 方案列表，顺序就是 Ctrl+` 切换时的顺序，五笔放第一个 schema_list: - schema: wubi86 - schema: luna_pinyin # 候选框每页显示几个，五笔用户一般 5 到 7 个够用 menu/page_size: 7

patch:是 Rime 的补丁语法，意思是「在出厂配置的基础上改这些项」，没写的项保持原样。这种写法的好处是升级版本时你的改动不会被覆盖。schema_list是个数组，- schema: 名字里的名字必须和方案文件的文件名前缀完全一致——文件叫wubi86.schema.yaml，这里就写wubi86，写成wubi或者五笔86都会导致方案加载不到。

luna_pinyin那一行是拼音方案，作用是反查：打不出五笔的时候用拼音救急。你包里如果没带拼音方案，把这行删掉，否则部署时会报找不到方案的警告。删掉不影响五笔使用，只是少了条退路。

改完必须重新部署，YAML 是启动时读的，改文件不部署等于没改。部署有两种方式：右键托盘的小狼毫图标选「重新部署」，或者在命令行里跑WeaselDeployer.exe /deploy。部署过程中托盘图标会转一下，转完就生效。

3.4 参数取舍：几个容易改错的地方

menu/page_size这个值不要贪大。设到 9 以上，候选框会变得很长，横排模式下容易超出屏幕边缘；设成 3，五笔重码多的字（比如一些生僻字）就要多翻页。我的习惯是 7，既不会一眼扫不完，也不至于频繁翻页。

schema_list的顺序有实际意义。第一个就是默认方案，切进小狼毫直接能用五笔；如果你把拼音放第一个，每次切换都要按 Ctrl+` 再选一次，很快就会烦。

还有一处常见误用：直接去改程序目录下的default.yaml。那个文件是出厂默认，升级会被覆盖，而且有的版本会优先读它，导致你在用户目录改的 custom 文件看起来「不生效」。正确做法永远是只改用户目录下的*.custom.yaml，出厂文件当参考看就行。

4. 配置调优：五笔打得顺手的四个参数开关

装完能用只是及格线，五笔这个东西讲究的是手感——四码要不要自动上屏、重码怎么提示、词库怎么养、候选框长什么样，这些参数不调，用起来总觉得别扭。这一章改的全是用户目录下的 custom 文件，改完统一重新部署一次。

4.1 四码上屏：auto_select 与 max_code_length

五笔全码是四码，绝大多数单字四码唯一，理论上敲完第四下就该上屏，不用再按空格。这个行为在方案文件里控制，改的是wubi86.custom.yaml，不是wubi86.schema.yaml。

# %APPDATA%\Rime\wubi86.custom.yaml patch: # 最长码长，五笔固定 4，不要改 speller/max_code_length: 4 # 四码唯一时直接上屏，不唯一时仍然显示候选 speller/auto_select: true

max_code_length: 4是告诉内核「这个方案最多输入四个字母」，超过就不再接收。auto_select: true是四码打满且只有一个候选时直接上屏。这两项合起来才是完整的手感，只开auto_select不改码长，打到第四码之后还能继续敲，候选会变得很奇怪。

有个细节要提醒：不是所有整合包的五笔方案都写了这两行。打开wubi86.schema.yaml搜一下speller:，里面原本有没有这两项。有就改值，没有就在 custom 文件里按上面的写法加，patch 语法允许新增原先不存在的键。

另一个常见需求是「三码唯一也上屏」。这个不建议开，五笔里三码重码率不低，自动上屏会让你打出意料之外的字，改回来的成本比省下的那一下空格高得多。

4.2 词库、用户词典与同步目录

小狼毫的词库分两层：一层是方案自带的静态词库wubi86.dict.yaml，另一层是你打字过程中自动攒的用户词库，存在wubi86.userdb这个目录里（LevelDB 格式，别用文本编辑器打开）。用户词库是跟着人走的资产，用久了价值很高，所以同步这件事要提前配。

# %APPDATA%\Rime\installation.yaml # 同步目录，指向一个你本地固定存在、且不会被自动清理的位置 sync_dir: 'D:\RimeSync'

sync_dir写的是绝对路径，单引号包起来防转义。配好之后，托盘菜单里的「同步」会把用户词库打包写到这个目录下，换机器的时候把整个目录拷过去再同步一次，词就回来了。这一项很多人装完根本不看，等到换电脑那天才发现几年的词全没了。

静态词库想扩的话，往wubi86.dict.yaml里追加词条，格式是「词 + 制表符 + 编码 + 制表符 + 权重」，追加完必须重新部署，部署时会重新编译成 build 目录下的二进制词库。追加的位置有讲究，必须放在文件里...那一行之前，放后面会被当成注释忽略掉。

提示：改静态词库之前先复制一份原文件出来。词条格式错一行（比如用了空格而不是制表符），部署时会直接报错，而且报错信息不会告诉你错在第几行。

4.3 候选框与按键：字体、横排、翻页键

候选框的观感全在weasel.custom.yaml里。这个文件控制的是「壳」的外观，和方案无关，改一次所有方案都受益。

# %APPDATA%\Rime\weasel.custom.yaml patch: # 字体用系统自带的黑体，避免指定了不存在的字体导致方块 "style/font_face": "SimHei" "style/font_point": 14 # 横排候选，习惯竖排的把 true 改成 false "style/horizontal": true # 候选序号格式，%c 是序号，%@ 是候选词 "style/candidate_format": "%c. %@ "

font_point是字号，单位是磅，14 在 1080p 屏上比较舒服，2K 屏可以提到 16。注意这里的键名带斜杠，必须用引号把整个键包起来，YAML 里裸写style/font_face会被解析成嵌套结构，结果就是配置不生效且不报错——这类问题最难查。

按键绑定在同一份文件里，翻页键是五笔用户改得最多的一项：

# %APPDATA%\Rime\weasel.custom.yaml（追加在同一份 patch 下） patch: key_binder/bindings: # 组字状态下用 Ctrl+N / Ctrl+P 上下选候选，手不用离开主键区 - { when: composing, accept: Control+n, send: Down } - { when: composing, accept: Control+p, send: Up }

when: composing限定只在打字过程中生效，不影响其他程序的快捷键。accept是收到的键，send是转成的动作。这两个绑定加完，翻页就不用去够方向键了。

4.4 中英切换与标点

默认 Shift 是中英切换，但默认行为是「切换时把已输入的编码上屏」。如果你习惯按 Esc 取消，或者在组字到一半时手滑碰到 Shift，就会打出一串莫名其妙的字母。

# %APPDATA%\Rime\default.custom.yaml 里追加 patch: ascii_composer/switch_key: # 左 Shift 切换时把编码提交上屏，右 Shift 直接丢弃 Shift_L: commit_code Shift_R: clear Caps_Lock: clear Control_L: noop Control_R: noop

commit_code是提交当前编码，clear是清空，noop是不响应。左右 Shift 分开设是我个人的习惯：左边常用来切换中英，右边基本不碰，设成 clear 防误触。Caps Lock 设成 clear 而不是 commit_code，是因为大写锁定在写代码时用得多，误提交的代价更大。

改完这几个文件，跑一次部署：

:: 所有 custom 文件改完，统一部署一次 "C:\Program Files (x86)\Rime\weasel-*\WeaselDeployer.exe" /deploy

路径里的星号是通配，实际执行时按你的版本目录名替换。不确定路径就直接右键托盘图标点「重新部署」，效果一样。

5. 避坑与排查：装完不出字、不出候选框的五个现场

这一章全是踩过的坑，按「现象 → 原因 → 解决」写，遇到对得上的直接抄。排查有个总原则：先看用户目录里文件在不在，再看部署有没有报错，最后才怀疑程序本身。九成的「输入法坏了」都停在第一步。

5.1 现象：输入法列表里根本找不到小狼毫

原因基本只有一个：/install没执行成功。要么脚本因为权限静默失败了，要么你双击的时候不是管理员。还有一种少见情况是系统输入法列表里被手动移除了，但程序其实装好了。

解决分两步。先用管理员 cmd 重跑一次注册：

:: 以管理员身份运行，重新注册输入法 cd /d "C:\Program Files (x86)\Rime\weasel-你的版本目录" "WeaselSetup.exe" /install

跑完在任务栏输入法图标上右键，「设置」里找小狼毫并添加。如果还是看不到，去%APPDATA%\Rime确认目录存在，目录不存在说明脚本连复制都没做到，回到 3.2 走手动流程。

5.2 现象：能切到小狼毫，但打出来的字全是空码

这是最典型的「方案没挂上」。你按了四个字母，候选框里一个候选都没有，或者出现「无候选」提示。原因有两种：schema_list里写的名字和方案文件名对不上，或者方案文件压根没复制进用户目录。

解决：先列一遍用户目录里的方案文件，确认wubi86.schema.yaml在里面；再打开default.custom.yaml看schema后面的名字是不是wubi86，多一个字符都不行。改完重新部署。部署时如果托盘图标闪一下就恢复正常，说明加载成功；如果转了很久，大概率是某个 YAML 缩进错了，文件里混了 Tab 字符也会这样。

5.3 现象：候选框里显示方块或乱码

原因是候选框指定的字体在系统里不存在。整合包的作者可能在他自己机器上装了个特殊字体，配置里写死了名字，到你这台机器上就找不到。

解决：改weasel.custom.yaml里的style/font_face，换成系统自带字体，SimHei、DengXian都行。改完必须重新部署，只重启输入法不生效。顺带检查一下文件的保存编码，用记事本另存成 UTF-8，带 BOM 的 UTF-8 在老版本上会读出乱码。

5.4 现象：改了 custom 文件，怎么部署都没变化

原因有三个，按概率排：改错了文件（改的是程序目录下的出厂配置）、YAML 语法错误导致整份 patch 被跳过、以及改了文件但文件根本没保存成.yaml扩展名。第二点最阴，YAML 对缩进极其敏感，两个空格写成三个、或者用了 Tab，解析器会整段忽略，而且不报错。

解决：先确认文件路径是%APPDATA%\Rime\xxx.custom.yaml；再用在线 YAML 校验或者随便找个编辑器看缩进是不是纯空格；最后确认扩展名——Windows 默认隐藏已知扩展名，你以为存成了default.custom.yaml，实际是default.custom.yaml.txt。这一点我在三台机器上翻过车，从那以后装完系统第一件事就是打开「显示文件扩展名」。

5.5 现象：用了几天，用户词库突然清空

原因是重装或者重新解压时，脚本里的xcopy /y把整个用户目录覆盖了，wubi86.userdb目录也跟着被覆盖。整合包脚本一般不做差异比对，全量覆盖，用户词库首当其冲。

解决：装之前先备份用户目录，把%APPDATA%\Rime整个复制一份出来，装完再只把*.userdb目录复制回去，配置文件别往回拷，避免又带回旧问题。已经丢了的话，检查installation.yaml里配的sync_dir有没有历史同步快照，有的话恢复一份回来。

注意：*.userdb是目录不是文件，复制的时候要连目录一起拷。只拷里面的文件会因为缺少 LevelDB 的清单文件而读不出来。

6. 装完怎么验证：三个动作确认五笔真的跑通了

装完别急着关窗口，做三个动作确认它真的能用，比装完就用、出问题再猜要省事得多。

第一个动作，验证切换链路。随便开一个记事本，按 Win+Space 或 Ctrl+Shift 切到小狼毫，看托盘图标有没有变化。然后按 Ctrl+（反引号，Esc 下面那个键），看能不能弹方案选单。能弹出来，说明schema_list` 至少被读到了一个有效方案；弹不出来，回去看第 3.3 节。这一步排除的是「装上了但没部署」的情况。

第二个动作，验证五笔真的出字。打一个最简单的字，比如「我」的全码是trnt，敲完四下看候选框。四码唯一且开了 auto_select 的话，字会直接上屏；没开的话候选框里应该只有一个候选。如果打完四个字母候选框是空的，去%APPDATA%\Rime\build目录看有没有wubi86.prism.bin之类的编译产物，没有就说明部署没成功，重新部署一次并留意报错。

:: 验证部署产物是否生成，这是方案真正生效的证据 dir /b "%APPDATA%\Rime\build\wubi86*"

build目录是部署时生成的，里面的.bin、.prism.bin、.table.bin是编译后的词库和索引。这个目录里看不到对应方案的文件，配置改得再对也没用——内核读的是这里，不是原始 YAML。

第三个动作，验证持久性。关掉记事本，重启一次资源管理器或者直接重启机器，再切回小狼毫打同一个字。这一步很多人省略，但它能筛出「临时生效」这类问题：有的机器上配置文件权限不对，部署时能读、重启后读不到，表现就是重启后方案全没了。

验证动作	判断标准	不通过时先查
切换与方案选单	Ctrl+` 能弹出方案列表	`default.custom.yaml`的`schema_list`
打出第一个五笔字	四码后有候选或直接上屏	`build`目录是否有方案产物
重启后仍可用	重启后切回仍能打字	用户目录文件权限与路径