1. 项目概述为什么我们需要一份“任务导向”的修改指南如果你是一名 Rime 输入法特别是“小狼毫”Weasel的用户那么你大概率已经领略过它的强大与自由。它不像搜狗、百度那样开箱即用而是像一套乐高积木给你一堆基础模块和一份说明书让你自己搭建出最趁手的输入工具。这份“说明书”就是它的配置文件。然而也正是这份自由让许多用户在初次面对default.yaml、weasel.custom.yaml里密密麻麻的符号和缩进时感到无从下手。网上的教程要么是零散的代码片段要么是过于深入底层原理的“天书”缺少一条清晰的、以解决实际问题为目标的路径。这就是“任务导向式常用参数修改指南”的价值所在。它不打算教你成为 Rime 配置专家而是聚焦于一个核心目标让你能像完成一个个小任务一样快速找到并修改那些最影响日常输入体验的参数。比如你想让候选词从5个变成9个想关闭烦人的英文联想或者想给某个特定的输入方案如朙月拼音增加几个自定义短语。我们的指南将围绕这些具体的、高频的“任务”来组织直接告诉你“改哪里、改成什么、为什么这么改”。这就像一份家电的“常用功能速查表”你不需要懂电路原理也能轻松使用微波炉加热、用洗衣机选择模式。对于绝大多数用户而言深度定制 Rime 的“引擎”部分如词库算法、分词逻辑并非刚需。真正的痛点在于“交互层”和“词库层”的微调。本指南将严格限定在这个范围内确保每个修改都立竿见影且风险可控所有修改均通过xxx.custom.yaml文件进行不会破坏原始配置一键即可还原。让我们开始吧从最影响视觉和操作习惯的界面参数调起。2. 核心界面与交互调优打造你的专属输入窗口输入法首先是一个“看”和“选”的工具。候选框的大小、位置、颜色、翻页方式直接决定了输入时的流畅度和舒适感。小狼毫默认的界面比较朴素但通过修改weasel.custom.yaml文件我们可以让它变得既美观又高效。2.1 定制候选词外观与布局候选框的视觉表现主要在style区块下定义。这个区块的配置会全局生效影响所有输入方案。# weasel.custom.yaml patch: style: # 任务1调整候选词数量与排列 horizontal: true # 候选窗横向显示。false 则为纵向显示。 candidate_list_layout: linear # 候选列表布局linear 为单行stack 为堆叠多行。 max_candidates: 9 # 最多显示候选词数目。默认是5改成9能减少翻页。 page_size: 9 # 每页候选词数量通常与 max_candidates 一致。 # 任务2调整字体和字号 font_face: Microsoft YaHei # 候选词字体建议使用系统已安装的清晰字体。 font_point: 16 # 候选词字号单位是“点”。13-18 是较舒适的阅读范围。 label_font_point: 14 # 编号1,2,3...的字号可略小于候选词。 # 任务3调整颜色方案示例为浅色主题 color_scheme: my_light_theme # 指定一个颜色方案名 # 然后定义这个方案 my_light_theme: name: 我的浅色主题 author: Your Name back_color: 0xFFFFFF # 背景色白色 border_color: 0xCCCCCC # 边框色浅灰色 text_color: 0x333333 # 候选词颜色深灰色 hilited_text_color: 0xFFFFFF # 高亮候选词选中的文字颜色 hilited_back_color: 0x4285F4 # 高亮候选词背景色谷歌蓝 hilited_candidate_text_color: 0xFFFFFF # 高亮候选词文字颜色同上可合并 hilited_candidate_back_color: 0x4285F4 # 高亮候选词背景色同上可合并 candidate_text_color: 0x333333 # 未选中的候选词颜色 comment_text_color: 0x999999 # 注释文字颜色如词频、编码提示实操心得与注意事项horizontal与page_sizehorizontal: true横向是最符合现代输入习惯的。page_size必须小于等于max_candidates。当你设置page_size: 9时按空格或数字键1-9可以直接选择对应位置的词非常高效。字体选择务必使用系统内已安装的字体名。在 Windows 上Microsoft YaHei微软雅黑是安全且清晰的选择。macOS 用户可尝试PingFang SC。避免使用生僻字体否则可能回退到不美观的默认字体。颜色自定义颜色值采用0xRRGGBB格式的十六进制。你可以使用任何取色工具获取你喜欢的颜色值。定义多个color_scheme后可以在小狼毫的状态栏菜单中快速切换。修改后生效保存weasel.custom.yaml后需要重新部署Rime 才能生效。具体操作为右键点击任务栏的小狼毫图标 - 选择“重新部署”。这是所有配置修改生效的必要步骤后文不再赘述。2.2 优化中英文切换与标点符号行为中英文混合输入和标点符号的智能调整是提升效率的关键。这部分配置通常在switches和punctuator相关部分。# default.custom.yaml (或特定方案如 luna_pinyin.custom.yaml) patch: # 任务4调整中英文切换开关的默认状态 switches: - name: ascii_mode reset: 0 # 0 表示默认中文1 表示默认英文。改成1则开机即英文模式。 states: [ 中, 英 ] - name: full_shape reset: 0 # 0 默认半角1 默认全角。中文输入通常用半角。 states: [ 半角, 全角 ] - name: simplification reset: 1 # 0 繁体1 简体。根据需求设置。 states: [ 繁, 简 ] # 任务5自定义标点符号映射让中文下按/直接输出、 punctuator: import_preset: default full_shape: /: 、 half_shape: # 可以覆盖默认的英文标点行为例如 # \: [, ~] # 将反引号键映射为和~为什么这么改ascii_mode的reset值决定了输入法启动时的初始状态。对于程序员或需要频繁输入英文的用户设为1默认英文可以省去一次切换操作。标点符号的映射非常实用。例如在中文写作中顿号、的使用频率很高但键盘上没有直接对应的键。通过将/键在“全角”模式下映射为顿号就能实现一键输入这比翻页查找方便得多。import_preset: default表示继承默认的标点映射我们只在它的基础上进行增量修改安全且清晰。2.3 调整候选框位置与内嵌编辑模式对于大屏幕或双屏用户候选框的默认跟随光标位置可能不理想。小狼毫支持“内嵌编辑模式”让候选词直接显示在光标位置类似于 macOS 原生输入法。# weasel.custom.yaml patch: style: # 任务6启用内嵌编辑模式行内模式 inline_preedit: true # 将预编辑文本即你输入的拼音显示在光标处 # 任务7固定候选窗位置可选与内嵌模式通常二选一 # layout: # x: 100 # 候选窗左上角相对于屏幕的X坐标 # y: 500 # Y坐标 # width: 400 # 候选窗宽度 # height: 30 # 高度通常自动计算注意事项inline_preedit是一个备受喜爱的功能它让输入过程更加“沉浸”视线无需在光标和屏幕角落的候选框之间来回移动。但某些旧版应用程序可能兼容性不佳如果遇到显示问题可以关闭此功能。固定位置 (layout) 适用于有特殊排版需求的用户比如希望候选框始终显示在屏幕右下角。但大多数情况下跟随光标或使用内嵌模式是更自然的选择。3. 核心词库与输入习惯定制调好了界面接下来就是输入法的“灵魂”——词库和组词逻辑。Rime 的强大之处在于它允许你对词库进行精细化的控制。3.1 管理自定义用户词库用户词库 (用户文件夹/build/xxx.userdb.txt) 记录了你的个人词汇和词频。但有时我们需要批量添加或维护一些固定短语。# 例如为朙月拼音方案 (luna_pinyin) 添加自定义短语 # luna_pinyin.custom.yaml patch: translator: dictionary: luna_pinyin # 任务8添加自定义短语快捷输入 engine/translators: - punct_translator - reverse_lookup_translator - script_translator - table_translatorcustom_phrase # 引入自定义短语表 - lua_translatordate_translator - lua_translatortime_translator custom_phrase: dictionary: user_dict: custom_phrase db_class: stabledb enable_completion: false enable_sentence: false initial_quality: 1 # 定义短语表内容 phrases: - sjc|时间戳|1 - xmd|小明|1 - gmail|gmailgmail.com|1 - sfz|123456789012345678|1 # 谨慎添加敏感信息格式解析与实操要点格式缩写|短语|权重。sjc是输入码时间戳是输出的短语1是权重数字越大排序越靠前。位置这部分配置通常放在对应输入方案的.custom.yaml文件里如luna_pinyin.custom.yaml。确保engine/translators列表中包含了table_translatorcustom_phrase。用途非常适合输入邮箱、地址、身份证号极度不推荐此处仅为格式示例、常用技术术语、公司名称等长串固定内容。这比任何“云联想”都精准和私密。权重如果多个自定义短语共享同一个简码权重高的优先显示。你可以为最常用的释义设置更高的权重如2或3。3.2 调整词频与学习行为Rime 会学习你的用词习惯并提升常用词的优先级。但有时它的“学习”结果并不理想或者你想手动干预。# default.custom.yaml patch: # 任务9调整词频学习相关参数 engine/filters: - simplifier - uniquifier - lua_filterreduce_english_filter - charset_filtergbk # 过滤非GBK字符可根据需要改为 charset_filterutf8 # 在 translator 层级或具体方案下调整 translator: enable_user_dict: true # 是否启用用户词典学习 enable_completion: true # 是否启用编码补全输入部分拼音后提示 # 词频调整参数示例并非所有方案都支持所有参数 # preedit_format: # - xform/([nl])v/$1ü/ # 将 nv, lv 转换为 nü, lü深度解析enable_user_dict: 这是核心开关。如果关闭Rime 将不会记录你的选词历史也就没有“越用越顺手”的效果。除非有特殊隐私需求否则建议保持开启。filters过滤器过滤器在翻译器translator之后工作用于对候选列表进行后期处理。例如simplifier: 繁简转换。uniquifier: 去重合并完全相同的候选词。charset_filter: 字符集过滤。gbk表示只输出 GBK 编码内的字符这在一些旧版游戏中可以避免出现问号。日常使用建议用utf8或直接移除以获得最全的字符支持。词频的底层算法较复杂通常不建议新手直接修改translator内部的prism相关参数。更常见的做法是直接删除用户词库文件来重置学习记录。前往用户文件夹/build/删除对应的xxx.userdb.txt和xxx.userdb.kct文件然后重新部署。这是一个“终极”重置手段。3.3 挂载与切换多输入方案小狼毫可以同时安装多个输入方案如朙月拼音、五笔、仓颉、双拼等。我们需要管理它们的切换。# default.custom.yaml patch: schema_list: - schema: luna_pinyin # 朙月拼音全拼 - schema: luna_pinyin_simp # 朙月拼音简体 - schema: terra_pinyin # 地球拼音带音调 - schema: double_pinyin_flypy # 小鹤双拼 - schema: wubi86 # 五笔86 - schema: cangjie5 # 仓颉五代操作指南与避坑添加方案在schema_list中按你喜欢的顺序列出方案标识符。这些方案必须已通过“输入法设定”窗口安装。切换方案默认快捷键是Ctrl反引号键位于Tab键上方或F4。你可以在weasel.custom.yaml中修改快捷键# weasel.custom.yaml patch: ascii_composer/good_old_caps_lock: true # 启用 CapsLock 切换中英文 ascii_composer/switch_key: Caps_Lock: commit_code # 按 CapsLock 直接输入并切换中英文 Shift_L: commit_code # 左Shift同上 Shift_R: commit_code # 右Shift同上 Control_L: noop # 左Ctrl无操作 Control_R: noop # 右Ctrl无操作常见问题如果添加了方案但在列表里看不到请检查方案名是否拼写正确。是否已通过“输入法设定”成功安装该方案。重新部署后需要重启正在使用的应用程序如浏览器、编辑器新的方案列表才会生效。4. 高级任务与性能调优完成基础调校后我们可以关注一些能进一步提升体验或解决特定痛点的高级任务。4.1 禁用英文输入与云联想Rime 的英文输入ascii_mode是内置的但它的联想功能可能不如专业英文输入法且有时会造成干扰。同样部分方案可能开启了基于词库的“云联想”风格补全可能拖慢速度。# 在 default.custom.yaml 或具体方案中 patch: # 任务10精简或禁用英文词库 # 方法一完全关闭英文输入法的联想只保留基本输入 # 需要找到对应英文方案的配置如 english但通常我们直接管理开关更方便。 # 方法二调整开关默认值见2.2节让启动时就是中文状态。 # 任务11关闭不必要的补全和句子模式以提升响应速度 translator: enable_completion: false # 关闭编码补全输入zhuang不再提示可能组合 enable_sentence: false # 关闭句子模式不尝试将多个词连成句子候选 # 关闭后输入将更“纯粹”完全依赖词库和用户历史响应速度通常更快。 # 在具体方案中可能还有 # luna_pinyin.custom.yaml # patch: # translator/enable_user_dict: true # 保持用户词库开启 # translator/enable_completion: false # 关闭该方案的补全为什么关闭enable_sentence句子模式会尝试将你连续输入的多个拼音组合成一个长句候选。这个计算过程相对复杂在低性能设备上可能带来可感知的延迟。对于追求“脆快”输入感的用户关闭此功能能获得更即时的反馈。你仍然可以通过手动选词来组成句子。4.2 备份与迁移你的个性化配置你的所有心血都在用户文件夹通常位于%APPDATA%\Rime或~/Library/Rime里。定期备份至关重要。手动备份最佳实践核心配置备份整个用户文件夹。这是最彻底的方式。选择性备份只备份.custom.yaml文件和build/xxx.userdb.txt文件。前者是你的设置后者是你的词频记忆。版本管理如果你使用 Git可以将用户文件夹初始化为一个仓库每次重大修改后提交。这样不仅能备份还能追溯更改历史。cd ~/Library/Rime # 或你的用户文件夹路径 git init git add . git commit -m 初始配置 # 以后修改后 git add . git commit -m 修改了界面颜色和候选词数迁移到新电脑将备份的用户文件夹内容覆盖到新电脑的对应位置。在新电脑上安装相同版本的小狼毫。执行【重新部署】。你的输入习惯和界面设置就完全“复活”了。4.3 诊断与解决常见配置冲突配置出错是常态。小狼毫提供了清晰的日志来帮助你排查。问题排查流程症状重新部署失败提示“错误”、“invalid patch”等或部署成功但输入法行为异常。查看日志在“用户文件夹”下找到rime.log文件。用文本编辑器打开直接滚动到文件末尾从最新的错误信息看起。解读错误最常见的错误是 YAML 格式错误。缩进YAML 依赖严格的空格缩进通常2个空格。切勿使用 Tab 键。冒号键值对中的冒号:后面必须跟一个空格如font_point: 16。连字符列表项以-开头后面也要跟一个空格。字符串特殊字符或包含冒号、空格的字符串最好用引号括起来。隔离测试如果日志指向某个custom.yaml文件但错误信息不明确可以采用“二分法”暂时将这个文件移出用户文件夹。重新部署。如果成功说明问题就在这个文件里。将该文件内容一半一半地注释掉用#逐步缩小范围直到找到出错的那几行。一个典型冲突案例你在default.custom.yaml和luna_pinyin.custom.yaml里都尝试修改translator/enable_completion。由于加载顺序和补丁合并规则最终结果可能不可预期。最佳实践是全局性的设置如界面style放在weasel.custom.yaml输入法引擎基础行为放在default.custom.yaml某个特定输入方案的专属设置放在其对应的xxx.custom.yaml里。遵循这个原则能极大减少冲突。5. 专属工作流定制案例程序员与写作者场景理论说再多不如看两个实际场景。让我们针对程序员和中文写作者这两个典型群体看看如何组合运用上述任务打造专属输入环境。5.1 程序员高效编码配置套餐核心需求中英文无缝切换、快速输入标点符号、自定义代码片段、界面简洁不挡代码。配置方案# weasel.custom.yaml - 界面部分 patch: style: horizontal: true max_candidates: 5 # 编码时候选词不需太多5个足够 page_size: 5 font_face: Consolas # 使用等宽编程字体与编辑器统一 font_point: 14 inline_preedit: true # 行内模式视线不离光标 color_scheme: dark_coding # 深色主题护眼 dark_coding: name: 深色编码 back_color: 0x1E1E1E # VS Code 深灰背景 text_color: 0xD4D4D4 # 浅灰文字 hilited_back_color: 0x007ACC # 蓝色高亮 hilited_text_color: 0xFFFFFF # default.custom.yaml - 行为部分 patch: switches: - name: ascii_mode reset: 1 # 默认英文模式打开编辑器直接敲代码 states: [ 中, 英 ] # 调整切换快捷键将Ctrl保留给终端/编辑器常用功能改用其他键 # ascii_composer/switch_key: ... (可根据习惯调整) # luna_pinyin.custom.yaml - 词库部分 patch: custom_phrase: dictionary: user_dict: custom_phrase db_class: stabledb enable_completion: false # 关闭补全减少干扰 phrases: - main|public static void main(String[] args) {}|1 - sysout|System.out.println();|1 - df|DateFormat df new SimpleDateFormat(\yyyy-MM-dd HH:mm:ss\);|1 - log|logger.info(\\);|1 # 更多代码片段... translator: enable_sentence: false # 关闭句子模式提升响应效果打开 IDE 时输入法默认是英文。需要中文注释时按一下切换键如 Shift。输入sysout直接得到System.out.println();且光标自动落在括号内。深色候选框与编辑器主题融为一体。5.2 中文写作者流畅书写配置套餐核心需求大词库、流畅的整句输入、便捷的标点、舒适的阅读界面。配置方案# weasel.custom.yaml patch: style: horizontal: true max_candidates: 9 # 写作时需要更多候选 page_size: 9 font_face: Microsoft YaHei UI Light font_point: 18 # 字号稍大保护视力 color_scheme: writer_light writer_light: name: 作家浅色 back_color: 0xF9F7F1 # 羊皮纸色背景 border_color: 0xE0D8C8 text_color: 0x5A5A5A # 深灰色文字 hilited_back_color: 0x7B9C6B # 柔和的绿色高亮 hilited_text_color: 0xFFFFFF # default.custom.yaml patch: punctuator: import_preset: default full_shape: /: 、 # 顿号 [: 【 # 中文方头括号 ]: 】 : 《 : 》 half_shape: # 保持英文标点不变 # 可以挂载更大的词库方案如 luna_pinyin.extended # luna_pinyin.custom.yaml patch: translator: enable_completion: true # 开启补全辅助长词输入 enable_sentence: true # 开启句子模式提高长句输入效率 custom_phrase: phrases: - zz|庄子|1 - sk|司马迁|1 - ——|——|1 # 快速输入破折号 - ……|……|1 # 快速输入省略号效果在写作软件中获得一个宽大、柔和、护眼的候选框。输入/直接得到顿号输入zz可快速选择“庄子”。句子模式会智能推荐连贯的短语组合让长篇书写更加行云流水。经过以上从界面到词库从基础到高级再到具体场景的任务式拆解你应该已经能够像搭积木一样自由地塑造你的小狼毫输入法了。记住核心心法一次只完成一个明确的小任务修改后立即“重新部署”测试效果并妥善备份你的用户文件夹。这套系统的魅力在于它永远处于“够用就好”和“还有潜力可挖”的平衡点上随着你需求的进化而一同成长。
