| name | rime-custom |
| description | Rime 输入法配置定制助手。支持 custom.yaml 覆写、Emoji/OpenCC、模糊拼音、Lua 扩展、多设备同步。覆盖雾凇/白霜/薄荷/万象方案。何时用：用户需要定制输入法配置、修改候选词数量、启用模糊拼音、配置Emoji、添加Lua扩展、导入词库、多设备同步时。触发词：Rime配置、小狼毫、鼠须管、custom.yaml、模糊拼音、辅助码、候选词、词库导入、Rime定制、输入法配置。 |
Rime 输入法配置定制助手
帮助用户定制 Rime 输入法配置，通过 custom.yaml 覆写实现个性化设置，不修改原始方案文件，升级时保留配置。
TL;DR 快速入口
⚡ 新手：首次配置？→ Step 1 确定方案 → Step 3 直接生成配置 → Step 4 部署
⚡ 常见需求：
完整工作流: Step 1确定方案 → Step 2确认目录 → Step 3生成配置 → Step 4部署生效
快速决策树
用户需求 → 快速定位
├── 首次配置/新安装
│ ├── 不确定方案 → Step 1 + 主流方案概览对比表
│ ├── 知道方案 → Step 2确认目录 → Step 3生成配置
│
├── 修改现有配置
│ ├── 基础设置 → 查阅对应章节（候选词/外观/快捷键）
│ ├── 功能配置 → 查阅对应章节（模糊音/Emoji/Lua）
│ └── 高级定制 → 先读 patch-guide.md 理解覆写语法
│
├── 问题排查
│ ├── 部署失败 → 调试与问题排查 → YAML语法检查
│ ├── 配置不生效 → 检查文件名是否匹配方案名
│ └── 其他错误 → 查看日志 + faq.md
│
└── 方案选择建议
├── 日常简体输入 → 雾凇 (词库丰富+Emoji)
├── 极简纯净风格 → 白霜 (墨奇辅码)
├── 新手入门 → 薄荷 (配置简单)
├── 繁体/高级定制 → 万象 (7种辅码+语法模型)
MCP 工具（优先使用）
当可用时，优先使用以下 MCP 工具获取信息：
| 工具 | 功能 | 使用场景 |
|---|
query_oh-my-rime | 语义搜索薄荷输入法知识库 | 用户提问、配置查询、方案对比 |
get_download_links | 获取客户端和配置包下载链接 | 安装引导、客户端选择 |
get_schema_list | 获取支持的输入方案列表 | 方案选择、推荐合适的输入方案 |
get_author_info | 获取作者信息 | 方案介绍、了解方案背景 |
MCP 工具调用示例
# 用户询问配置问题时
用户："怎么配置模糊拼音？"
→ 调用 query_oh-my-rime({"query": "模糊拼音配置方法"})
→ 返回知识库中的配置说明 + Skill 中的代码示例
# 用户需要安装时
用户："帮我下载鼠须管"
→ 调用 get_download_links({"platform": "macOS"})
→ 返回下载链接 + 安装指引
# 用户选择方案时
用户："哪个方案适合我？"
→ 调用 get_schema_list()
→ 返回方案列表 + Skill 中的对比表
参考文档体系
核心知识 (core/)
客户端集成 (core/)
定制指南 (customization/)
方案详解 (schemes/)
原始抓取 (scraped/)
31个原始文档 (~800KB)，包含上述所有内容的未整理版本。
📖 使用策略：优先查 rime-knowledge-base.md 获取摘要，需要深入时查阅分类目录。AI编写配置工具时，应先读 customization/patch-guide.md 理解Patch语法，查阅 customization/recipes.md 获取配置模板。
主流方案概览
| 方案 | 特点 | 配置文件 | 适用场景 |
|---|
| 雾凇 (rime-ice) | 简体拼音、词库丰富(100万+)、Emoji、拆字反查 | rime_ice.schema.yaml | 日常输入、简体用户 |
| 白霜 (rime-frost) | 词频优化(745M语料)、纯净、墨奇辅助码 | rime_frost.schema.yaml | 极简风格、辅助码爱好者 |
| 薄荷 (rime_mint) | 简体拼音、新手友好、MCP知识库 | rime_mint.schema.yaml | 新手入门 |
| 万象 (wanxiang) | 繁简混输、语法模型、7种辅助码 | wanxiang.schema.yaml | 繁体用户、高级定制 |
🔍 选择建议：日常用雾凇/白霜，繁体用万象，新手用薄荷。
配置工作流 ⚠️
🛑 入口检查点（需求确认）：开始配置前，先了解用户需求：
- "您是首次配置还是修改现有配置？"
- "您需要配置什么功能？（候选词数量、模糊拼音、Emoji、Lua扩展等）"
- 根据需求快速定位：
- 基础设置（候选词/外观）→ Step 3 直接配置
- 功能配置（模糊音/Emoji）→ 查阅对应章节
- 高级扩展（Lua/词库）→ 先确认方案兼容性
Step 1: 确定方案 ⚠️
重要规则：先查看配置目录中实际的 schema_id 和现有 *.schema.yaml 文件名，再决定对应的 *.custom.yaml 文件名。不要只按方案中文名猜测文件名，不同衍生版本可能有不同的命名。
输入：用户描述需求或提及方案名
输出：确定方案类型，对应 custom.yaml 文件名
询问用户使用的输入方案：
⚠️ 核心规则：各方案都有多种变体（双拼、五笔、T9等）。先查看配置目录实际的 *.schema.yaml 文件名，再决定对应的 *.custom.yaml 文件名。
主要方案及其常见变体：
| 用户提及 | 方案系列 | 常见变体及 custom.yaml 文件 |
|---|
| "雾凇/冰/雪" | rime-ice | rime_ice.custom.yaml (全拼) |
| "白霜/霜/纯净" | rime-frost | rime_frost.custom.yaml (全拼) |
| "薄荷/Mint" | rime_mint | rime_mint.custom.yaml (全拼)、rime_mint_flypy.custom.yaml (双拼)、double_pinyin_*.custom.yaml (各双拼变体) |
| "万象" | wanxiang | wanxiang.custom.yaml (标准版)、wanxiang_pro.custom.yaml (Pro版)、wanxiang_*.custom.yaml (其他变体) |
| "朙月" | luna_pinyin | luna_pinyin.custom.yaml |
| "双拼" | double_pinyin | 根据具体双拼类型：double_pinyin_flypy.custom.yaml (小鹤)、double_pinyin_mspy.custom.yaml (微软) 等 |
| "五笔" | wubi | wubi86_jidian.custom.yaml (86版)、wubi98_mint.custom.yaml (98版) |
| "九宫格/T9" | t9 | t9.custom.yaml 或 wanxiang_t9.custom.yaml |
快速识别规则：
- 文件名格式：
{schema_id}.custom.yaml
- schema_id 通常与
*.schema.yaml 文件名前缀一致
- 如有疑问，先列出目录中的 schema 文件再确定
边界情况处理：
- 用户提及的方案名不在已知列表 → 先查看配置目录实际文件，确认后再配置
- 配置目录没有
*.schema.yaml 文件 → 可能未安装任何方案，引导安装
- 用户不确定但有已配置文件 → 读取现有
*.custom.yaml 文件名反推方案名
方案配置差异详解 ⚠️
不同方案的文件结构、配置方式、功能支持各不相同，修改前务必确认。
雾凇拼音 (rime-ice)
雾凇是系列方案，包含多种输入方式：
雾凇系列方案变体：
| 方案变体 | Schema文件 | Custom文件 | 特点 |
|---|
| 全拼输入 | rime_ice.schema.yaml | rime_ice.custom.yaml | 默认方案，词库丰富 |
| 双拼输入 | rime_ice_double.schema.yaml | rime_ice_double.custom.yaml | 双拼变体（部分发行版） |
⚠️ 不同雾凇发行版可能包含不同变体，请先查看实际文件。
主要文件：
| 文件类型 | 文件名 | 说明 |
|---|
| Schema主文件 | rime_ice.schema.yaml | 主方案配置，勿直接修改 |
| Custom覆写 | rime_ice.custom.yaml | 用户定制配置 |
| 词库文件 | rime_ice.dict.yaml | 主词库（100万+词条） |
| 扩展词库 | rime_ice.ext.dict.yaml | 扩展词条 |
| Emoji映射 | opencc/emoji.json | Emoji自动映射 |
特有功能配置：
- 拆字反查：
uU + 拼音（方案内置，无需配置）
- 以词定字：配置
engine/translators 添加 select_words
- 特殊符号：
v + 缩写（全拼）/ V + 缩写（双拼）
配置示例：
patch:
'engine/translators/@next': select_words
'translator/dictionary': rime_ice.ext
白霜拼音 (rime-frost)
白霜是系列方案，包含全拼和双拼变体。
→ 详细变体列表、文件结构、配置示例：查阅 references/schemes-variants.md
快速识别：
| 常用变体 | Custom文件 | 特点 |
|---|
| 全拼 | rime_frost.custom.yaml | 默认方案，词频优化 |
| 双拼 | rime_frost_double_pinyin*.custom.yaml | 多种双拼变体 |
特有功能：墨奇辅助码（`键开启）、符号扩展、日期时间快捷输入（rq/sj/xq）。
万象拼音 (wanxiang)
万象是系列方案，包含多种变体（标准版、Pro增强版、英文、混合编码、反查、T9等）。
⚠️ 重要：万象通过 / 指令动态切换双拼/全拼模式，不同变体有不同 schema 文件。
→ 详细变体列表、对比表、配置示例：查阅 references/schemes-variants.md
快速识别：
| 常用变体 | Custom文件 | 特点 |
|---|
| 标准版 | wanxiang.custom.yaml | 全拼/双拼通用，自动调频 |
| Pro版 | wanxiang_pro.custom.yaml | 仅双拼，7种辅助码 |
特有功能：语法模型（grammar.bin）、声调辅助（7890代表1234声）、方案切换指令。
薄荷输入法 (rime_mint)
注意：此处以 Mintimate/oh-my-rime 官方 upstream 当前命名（rime_mint.schema.yaml）为准。
薄荷是系列方案，包含多种输入方式（全拼、小鹤双拼、通用双拼系列、地球拼音、T9、五笔等）。
→ 详细变体列表、配置示例：查阅 references/schemes-variants.md
快速识别：
| 常用变体 | Custom文件 | 特点 |
|---|
| 全拼 | rime_mint.custom.yaml | 默认方案，新手友好 |
| 小鹤双拼 | rime_mint_flypy.custom.yaml | 双拼+辅码支持 |
特点：新手友好、支持 MCP 知识库查询、词库使用万象拼音词库（2025-07后）。
朙月拼音 (luna_pinyin)
| 文件类型 | 文件名 | 说明 |
|---|
| Schema主文件 | luna_pinyin.schema.yaml | 官方默认方案 |
| Custom覆写 | luna_pinyin.custom.yaml | 用户定制配置 |
| 词库文件 | luna_pinyin.dict.yaml | 繁体词库 |
| 自定义短语 | custom_phrase.txt | 用户短语（Tab分隔） |
特有功能配置：
- 繁简转换：通过
simplifier + OpenCC 配置
- 自定义短语：创建
custom_phrase.txt 文件
配置示例：
patch:
switches/@next:
name: zh_simp
reset: 1
states: ["漢字", "汉字"]
'simplifier/opencc_config': t2s.json
双拼方案
| 方案 | Schema文件 | 特点 |
|---|
| 自然码 | double_pinyin.schema.yaml | 经典双拼 |
| 小鹤双拼 | double_pinyin_flypy.schema.yaml | 常用双拼 |
| 微软双拼 | double_pinyin_mspy.schema.yaml | Windows内置 |
配置差异：
- 双拼方案共享朙月拼音词库
- 通过
speller/algebra 定义双拼映射
- 模糊音配置与全拼不同（作用于双拼编码）
方案配置冲突处理 ⚠️
🛑 检查点（冲突确认）：涉及多方案或方案切换时，先确认：
- "您是要切换方案还是在现有方案上配置？"
- 切换方案 → 提醒可能需要重新配置 custom.yaml
- 配置现有方案 → 确认文件名匹配方案名
⚠️ 多方案共存时的注意事项：
-
custom.yaml 文件名必须匹配方案名
- 雾凇用
rime_ice.custom.yaml，不是 default.custom.yaml
- 白霜用
rime_frost.custom.yaml
- 错误文件名会导致配置不生效
-
default.custom.yaml 仅用于全局设置
patch:
schema_list:
- schema: rime_ice
- schema: luna_pinyin
- schema: double_pinyin
-
方案切换需重新部署
- 修改任何 custom.yaml 后必须「重新部署」
- 切换方案指令（万象）也需要部署生效
-
词库文件不可混用
- 雾凇词库与朙月词库编码格式不同
- 白霜词库与万象词库辅码格式不同
- 导入词库需确认与当前方案兼容
Step 2: 确认配置目录
输入：用户操作系统
输出：配置目录路径
| 平台 | 客户端 | 配置目录 |
|---|
| Windows | 小狼毫 | %APPDATA%\Rime\ |
| macOS | 鼠须管 | ~/Library/Rime/ |
| Linux (IBus) | 中州韵 | ~/.config/ibus/rime/ |
| Linux (Fcitx5) | 中州韵 | ~/.local/share/fcitx5/rime/ |
| Android | 同文/fcitx5 | /rime 或 .../data/rime |
| iOS | 仓输入法 | 应用内文件管理 |
边界情况处理：
- 用户不确定平台 → 先问"您用的是 Windows、macOS 还是 Linux？"
- 用户找不到配置目录 → 提供快速查找方法：
- Windows: 在资源管理器地址栏直接输入
%APPDATA%\Rime
- macOS: 终端执行
open ~/Library/Rime
- Linux:
ls ~/.config/ibus/rime/ 或 ls ~/.local/share/fcitx5/rime/
- 目录不存在 → 可能未安装客户端，引导安装后再配置
Step 3: 创建/修改 custom.yaml ⚠️
输入：方案名、用户需求
输出：custom.yaml 配置内容
🛑 检查点（备份确认）：修改现有配置前，先询问用户：
- "您是否已有 custom.yaml 文件？如有，建议先备份。"
- "这是首次配置还是修改现有配置？"
- 首次配置 → 直接生成配置文件
- 修改现有 → 先读取现有配置，确认修改位置
patch:
"menu/page_size": 9
🛑 检查点（配置预览）：复杂配置前，先向用户展示完整配置预览，确认："这个配置符合您的需求吗？修改后需要重新部署才能生效。"
Step 4: 部署生效 ⚠️
输入：配置文件已修改
输出：部署成功确认
🛑 检查点（部署确认）：部署前确认：
- "配置文件已保存，现在可以部署。是否继续？"
- 提示用户：部署可能需要几秒钟，期间输入法不可用
- 如有多个方案切换，提醒用户"部署后会切换到默认方案"
修改后需要重新部署：
- 右键托盘图标
- 选择「重新部署」或「部署」
- 等待编译完成
异常处理：
- 部署失败 → 检查 YAML 语法（空格缩进，不用 Tab）
- 候选未变化 → 确认 custom.yaml 在正确目录
- 日志报错 → 查看日志定位问题：
- Windows:
%TEMP%\rime.*.log
- macOS:
$TMPDIR/rime.squirrel.*
- Linux:
/tmp/rime.ibus.*
配置覆写和定制
custom.yaml 基础结构
patch:
"key/path": value
覆写语法
patch:
"menu/page_size": 9
patch:
"engine/translators/@next": emoji_translator
patch:
"engine/filters/@before 0": simplifier
patch:
"engine/translators/@before 0": null
patch:
"speller/algebra":
- derive/^([zcs])h/$1/
自定义默认激活方案
设置默认方案
patch:
schema_list:
- schema: rime_ice
- schema: luna_pinyin
- schema: double_pinyin
方案切换快捷键
patch:
"switcher/hotkeys":
- "Control+Shift+1"
- "Control+Shift+2"
Emoji 配置 (OpenCC)
重要：Emoji 功能通过 engine/filters 实现，添加方式取决于方案已有的 filter 配置。常见形式为 simplifier@emoji 或 simplifier@emoji_suggestion。请先查看方案原 *.schema.yaml 中的 engine/filters 配置，再决定 patch 写法。
方式一：在已有 simplifier filter 上添加 Emoji
如果方案已有 simplifier filter（如雾凇、白霜），可直接追加 Emoji：
patch:
'engine/filters/@next': simplifier@emoji
'engine/filters/@before 0': simplifier@emoji_suggestion
'simplifier@emoji/opencc_config': emoji.json
'simplifier@emoji/tips': all
方式二：添加新的 Emoji filter
如果方案没有 Emoji filter，需完整配置：
patch:
'engine/filters/@next': simplifier@emoji
simplifier@emoji:
opencc_config: emoji.json
option_name: emoji
tips: all
繁简转换配置
通过 OpenCC 实现繁简转换功能：
patch:
switches/@next:
name: zh_simp
reset: 1
states: ["漢字", "汉字"]
'engine/filters/@next': simplifier
'simplifier/opencc_config': s2t.json
常用 OpenCC 配置文件
| 配置文件 | 功能 |
|---|
s2t.json | 简体 → 繁体 |
t2s.json | 繁体 → 简体 |
s2tw.json | 简体 → 台湾繁体 |
t2tw.json | 繁体 → 台湾繁体 |
emoji.json | Emoji 映射 |
模糊拼音设置
常用模糊音配置
patch:
'speller/algebra':
- erase/^xx$/
- abbrev/^([a-z]).+$/$1/
- abbrev/^([zcs]h).+$/$1/
- derive/^([zcs])h/$1/
- derive/([zcs])h$/$1/
- derive/([aei])n$/$1ng/
- derive/([aei])ng$/$1n/
- derive/in$/ing/
- derive/ing$/in/
- derive/an$/ang/
- derive/ang$/an/
- derive/([iu])an$/$1ian/
- derive/([iu])ang$/$1an/
- derive/l/n/
- derive/n/l/
- derive/f/h/
- derive/h/f/
- derive/([iu])v$/$1u/
- derive/eng$/en/
- derive/en$/eng/
模糊音开关（方案支持时）
patch:
switches/@next:
name: fuzzy_correction
reset: 1
states: ["精准", "模糊"]
设置语言模型
推荐：万象、雾凇、白霜、薄荷等现代方案通过 grammar 配置实现语法模型支持，这是当前主流方式。
现代主流配置（推荐）
patch:
grammar:
language: grammar.bin
grammar/collocation_max_length: 4
grammar/collocation_min_length: 2
translator/contextual_suggestions: true
translator/max_homophones: 5
translator/max_homographs: 5
旧式 grammar_translator 配置（特定方案可用）
⚠️ 注意：以下 grammar_translator 配置是旧式写法，不是当前万象/雾凇/白霜/薄荷的主流 patch 方式。仅适用于特定方案或旧版本，新用户建议使用上述 grammar/language 配置。
patch:
'engine/translators/@next': grammar_translator
grammar_translator:
type: grammar
grammar:
model: grammar.bin
词库扩展
patch:
'translator/dictionary': rime_ice.ext
'translator/dictionary': custom_dict
创建自定义词库
在配置目录创建 custom_dict.dict.yaml：
---
name: custom_dict
version: "1.0"
sort: by_weight
---
你好 ni hao 100
世界 shi jie 100
符号输入配置
快捷符号映射
patch:
punctuator:
full_shape:
"," : ["，", "、"]
"." : ["。", "．"]
"?" : ["？", "？"]
";" : ["；", "；"]
":" : ["：", "："]
"!" : ["！", "！"]
half_shape:
"," : ["，", "、"]
"." : ["。", "."]
特殊符号输入
patch:
'recognizer/patterns/punct': "^/[a-z]*$"
'punctuator/symbols':
"/star": ["★", "☆", "✦", "✧"]
"/heart": ["♥", "♡", "❤", "❥"]
"/arrow": ["→", "←", "↑", "↓", "↔"]
"/math": ["+", "-", "×", "÷", "="]
"/check": ["✓", "✔", "✕", "✖"]
Lua 功能扩展 ⚠️
🛑 检查点（Lua调试提醒）：启用Lua扩展前，确认：
- "Lua脚本出错会导致输入法崩溃，建议先在测试环境验证。"
- "Lua文件修改后也需要重新部署才能生效。"
- 提供调试方法：查看日志中的Lua错误信息
lua_filter（候选过滤）
在配置目录创建 rime.lua：
function filter_candidate_number(input, env)
for cand in input:iter() do
cand.text = cand.text .. " [" .. cand.preedit .. "]"
yield(cand)
end
end
function time_filter(input, env)
for cand in input:iter() do
if cand.text == "time" then
cand.text = os.date("%H:%M:%S")
end
yield(cand)
end
end
在 custom.yaml 中启用：
patch:
'engine/filters/@next': lua_filter@filter_candidate_number
lua_processor（按键处理）
function date_processor(key, env)
if key:repr() == "Control+d" then
local ctx = env.engine.context
ctx.input = os.date("%Y-%m-%d")
return 1
end
return 2
end
在 custom.yaml 中启用：
patch:
'engine/processors/@next': lua_processor@date_processor
lua_translator（翻译器）
function time_translator(input, seg, env)
if input == "time" then
yield(Candidate("time", seg.start, seg._end, os.date("%H:%M:%S"), "时间"))
end
if input == "date" then
yield(Candidate("date", seg.start, seg._end, os.date("%Y-%m-%d"), "日期"))
end
end
在 custom.yaml 中启用：
patch:
'engine/translators/@next': lua_translator@time_translator
Lua 进阶功能（万象特色）
万象拼音通过 Lua 实现了多项创新功能，可作为高级定制参考：
| 功能 | 快捷键 | 说明 |
|---|
| 手动排序 | Ctrl+J/K/L/P | 调整候选顺序，数据存于 sequence.userdb |
| 输入统计 | /ztj /ytj /ntj /rtj /tj | 实时统计输入数据 |
| 翻译模式 | Ctrl+E | 中英文互译（需词表支持） |
| 声调显示 | Ctrl+S | 输入码动态显示全拼+音调 |
| 模式切换 | Shift+Space | 中文/英文/混合模式切换 |
手动排序示例：
function sequence_processor(key, env)
local ctx = env.engine.context
if key:repr() == "Control+j" then
local selected = ctx:get_selected_candidate()
return 1
end
return 2
end
Tips扩展提示：
function tips_translator(input, seg, env)
local tips_db = env.engine.user_db:get("tips")
local tip = tips_db:lookup(input)
if tip then
yield(Candidate("tips", seg.start, seg._end, tip, "提示"))
end
end
快符Lua（字母+/快速上屏）：
patch:
'engine/translators/@next': lua_translator@quick_symbol
第三方词库导入 ⚠️
🛑 检查点（词库兼容性）：导入词库前，确认：
- "词库文件编码必须是UTF-8(no BOM)，格式需与方案匹配。"
- "不同方案的词库格式不同，雾凇词库不能直接用于朙月方案。"
- "导入前建议先备份现有词库。"
- 询问用户："您要导入的词库是哪个方案的？是否确认格式兼容？"
词库文件格式
Rime 词库文件格式（.dict.yaml）：
---
name: 词库名
version: "版本号"
sort: by_weight
columns:
- text
- code
- weight
import_tables:
- sub_dict_name
---
你好 ni hao 100
世界 shi jie 50
导入词库步骤
方法一：扩展词库（推荐）
---
name: rime_ice
import_tables:
- rime_ice.ext
- my_custom_dict
---
方法二：完全替换词库
将新词库命名为 luna_pinyin.dict.yaml（或其他方案名），放入用户文件夹，重新部署即可完全替换。
⚠️ 替换会覆盖原词库，谨慎操作。
方法三：导入到用户词典
rime_dict_manager --import luna_pinyin my_dict.txt
词库格式转换要点
| 检查项 | 要求 | 转换方法 |
|---|
| 编码格式 | UTF-8 (no BOM) | :set fenc=utf8 nobomb (Vim) |
| 行分隔 | 制表符 (Tab) | 正则替换或脚本转换 |
| 字形一致 | 繁/简与源词库一致 | OpenCC 转换 |
| 编码形式 | 标准形式（非简拼） | 拼写运算生成 |
Vim 转换命令：
:set fenc=utf8 nobomb ff=unix
自定义短语 (custom_phrase.txt)
# 格式：词条<Tab>编码<Tab>权重（可选）
的 d # 非完整编码，可参与造词
邮箱 vmail # 完整编码，置顶显示
# ⚠️ 完整编码会阻止造词，建议使用非完整编码
调试与问题排查 ⚠️
🛑 检查点（问题诊断）：遇到问题时，先确认：
- "您是在哪个步骤遇到问题？部署前/部署时/部署后？"
- "是否有错误提示或日志信息？"
日志位置
| 平台 | 日志路径 |
|---|
| Windows | %TEMP%\rime.weasel.*.log |
| macOS | $TMPDIR/rime.squirrel.*.log |
| Linux | /tmp/rime.ibus.*.log 或 /tmp/rime.fcitx.*.log |
部署失败处理流程
Step 1: 检查 YAML 语法
python3 -c "import yaml; yaml.safe_load(open('rime_ice.custom.yaml'))"
Step 2: 检查文件名匹配
常见错误：文件名不匹配方案名
- 雾凇用 rime_ice.custom.yaml，不是 custom.yaml
- 白霜用 rime_frost.custom.yaml
- 检查文件是否在正确目录
Step 3: 查看日志错误
日志关键字：
- ERROR: 严重错误，必须修复
- WARNING: 警告，可能影响功能
- 搜索关键词：custom.yaml 文件名
Windows: 用 %TEMP% 打开临时文件夹，搜索 rime.weasel
macOS: 终端执行 open $TMPDIR 查看日志
Linux: cat /tmp/rime.ibus.*.log | grep ERROR
Step 4: 回滚配置
如果无法修复，回滚到备份版本：
1. 删除/移除问题配置文件
2. 恢复备份文件（如有）
3. 或删除 custom.yaml 恢复默认
4. 重新部署确认基础功能正常
常见错误诊断表
| 错误现象 | 可能原因 | 解决方案 |
|---|
| 部署失败 | YAML 语法错误 | 检查缩进（用空格，不用Tab） |
| 候选未变化 | custom.yaml 文件名错误 | 确认文件名匹配方案名 |
| 配置不生效 | 未重新部署 | 右键托盘 → 重新部署 |
| 词库不加载 | 编码格式错误 | 转换为 UTF-8 (no BOM) |
| 候选闪退 | Lua 脚本错误 | 检查 rime.lua 语法 |
| 内存占用高 | 词库过大 | 禁用不必要的词库 |
YAML 语法检查
python3 -c "import yaml; yaml.safe_load(open('rime_ice.custom.yaml'))"
部署调试技巧
- 逐步验证：先部署最小配置，确认生效后逐步添加
- 日志分析：查看日志中的
ERROR 和 WARNING 行
- 隔离测试：删除疑似问题配置，确认是否该配置导致
- 版本回退：保留配置备份，出问题时快速恢复
首次配置完整流程
场景：新安装用户首次配置
Step 1: 确认方案（如不知道，先查看配置目录文件名）
Step 2: 确认配置目录（根据平台）
Step 3: 创建最小配置（先测试基础功能）
┌─────────────────────────────────┐
│ patch: │
│ "menu/page_size": 5 │ ← 最小配置测试
└─────────────────────────────────┘
Step 4: 部署测试
- 部署成功 → 基础功能正常，可继续添加配置
- 部署失败 → 检查 YAML 语法和文件名
Step 5: 逐步添加功能（模糊音、Emoji等）
迁移场景：从其他输入法迁移
| 来源 | 建议方案 | 迁移要点 |
|---|
| 搜狗拼音 | 雾凇 | 词库格式不同，需转换后导入 |
| 百度拼音 | 雾凇 | 同上 |
| 微软拼音 | 雾凇/白霜 | Windows双拼可用万象切换 |
| 手心输入法 | 雾凇 | 同搜狗 |
⚠️ 迁移提醒：
- 其他输入法词库不能直接导入，需转换格式
- 用户词频/习惯无法迁移，需重新积累
- 推荐使用官方词库或雾凇扩展词库
配置备份建议
tar -czf rime_backup_$(date +%Y%m%d).tar.gz \
*.custom.yaml *.dict.yaml rime.lua custom_phrase.txt
cd ~/Library/Rime
git init
git add *.custom.yaml *.dict.yaml rime.lua
git commit -m "backup"
辅助码系统（万象/白霜）
万象拼音和白霜拼音支持辅助码，通过部首或字形快速筛选候选。
墨奇辅助码（白霜）
触发方式：按 `（Tab上方的键）开启辅助码模式
patch:
使用示例：
- 输入
ni → 候选"你、尼、拟..."
- 按
` 再按 r（人字旁）→ 精选带"人"的字
- 按
`re → 更精准筛选
万象辅助码（PRO版）
万象支持 7 种辅助码：墨奇码、鹤形、自然码、虎码、五笔、汉心、首右
直接辅助码（双拼+辅码）：
- 示例：
vfj = vf(镇的双拼) + j(金字旁声母)
- 聚拢：末尾加
/ 强制单字优先，如 vfj/
间接辅助码（拼音/辅码）：
- 示例：
ni/re = "你"字拼音 + 辅码
- 不干扰整句切分
声调辅助（万象特色）：
7890 代表 1234 声- 示例：
ni9 → 第一声，ni0 → 第四声
patch:
wanxiang_lookup:
tags: [abc]
key: "`"
lookup: [wanxiang_reverse]
data_source: [aux, db]
辅码切换指令（万象）
在输入状态输入 / 指令切换方案：
/flypy → 小鹤双拼
/mspy → 微软双拼
/zrm → 自然码
/sogou → 搜狗双拼
/pinyin → 全拼
切换后需重新部署生效。
语法模型（万象）
万象支持 kenlm 语法模型，提升整句预测准确度。
安装方法
- 下载语法模型文件（
grammar.bin）
- 放置于 Rime 用户文件夹根目录
- 无需额外配置，自动加载
Android 注意事项：
- Fcitx5 数据在系统
/data 目录
- 使用输入法自带"导入文件"功能
- 直接复制可能导致权限错误
快速功能速查
| 需求 | 方案 | 触发方式 |
|---|
| Emoji | 雾凇/万象 | 自动或 emoji_suggestion |
| 拆字反查 | 雾凇 | uU + 拼音 |
| 辅助码 | 白霜/万象 | ` + 辅码 |
| Unicode | 全方案 | U + 码位（如 U62fc=拼） |
| 数字大写 | 全方案 | R + 数字 |
| 农历 | 雾凇/万象 | N + 8位数字 |
| 计算器 | 雾凇 | cC + 算式 / 万象 V + 算式 |
| 特殊符号 | 雾凇 | v + 缩写 / 万象 /sx |
| 日期时间 | 白霜 | rq sj xq / 万象 /rq /sj |
| 方案切换 | 万象 | /flypy /mspy 等 |
输入法快捷键
常用快捷键配置
patch:
"key_binder/bindings":
- {accept: "0", send: "0", when: has_menu}
- {accept: "1", send: "1", when: has_menu}
- {accept: "2", send: "2", when: has_menu}
- {accept: "Page_Up", send: "Page_Up", when: composing}
- {accept: "Page_Down", send: "Page_Down", when: composing}
- {accept: "-", send: "Page_Up", when: has_menu}
- {accept: "=", send: "Page_Down", when: has_menu}
- {accept: "Tab", send: "Page_Down", when: has_menu}
- {accept: "Shift+Tab", send: "Page_Up", when: has_menu}
- {accept: "Return", send: "Return", when: has_menu}
- {accept: "Escape", send: "Escape", when: composing}
- {accept: "BackSpace", send: "BackSpace", when: composing}
- {accept: "Control+Shift+1", toggle: zh_simp, when: always}
- {accept: "Control+Shift+2", toggle: ascii_mode, when: always}
功能开关快捷键
patch:
"key_binder/bindings":
- {accept: "Control+Shift+1", toggle: zh_simp, when: always}
- {accept: "Shift_L", toggle: ascii_mode, when: always}
- {accept: "Shift_R", toggle: ascii_mode, when: always}
- {accept: "Control+Shift+3", toggle: full_shape, when: always}
输入个性定制
外观主题
patch:
"style/color_scheme": native
"style/horizontal": true
"style/font_face": "Microsoft YaHei"
"style/font_point": 14
"style/inline_preedit": true
"style/display_tray_icon": true
常用主题（鼠须管）
| 主题名 | 说明 |
|---|
native | 系统原生风格 |
aqua | 水蓝色 |
ink | 墨色 |
dark | 深色模式 |
light | 亮色模式 |
候选词数量和布局
patch:
"menu/page_size": 9
"menu/alternative_select_keys": "1234567890"
多设备同步
同步机制
Rime 使用 Git 仓库同步配置和词库。
配置同步
在配置目录创建 sync.conf（或 user.yaml 中的 sync 配置）：
sync:
user_id: "your_device_name"
repository: "your_git_repo"
同步命令
右键托盘 → 同步用户数据
偏好设置 → 同步
rime_dict_manager --sync
同步内容
| 内容 | 说明 |
|---|
user.yaml | 用户配置 |
*.custom.yaml | 定制配置 |
*.userdb.kct* | 用户词库 |
build/*.reverse.bin | 反查词典 |
同步工作流
patch:
"translator/enable_user_dict": true
部署流程
修改任何配置后都需要重新部署：
- Windows（小狼毫）：右键托盘 → 重新部署
- macOS（鼠须管）：偏好设置 → 部署
- Linux（中州韵）：重启 IBus/Fcitx5 或运行
rime_deployer --build
部署日志
如遇问题，查看日志：
- Windows:
%TEMP%\rime.*.log
- macOS:
$TMPDIR/rime.*.log
- Linux:
/tmp/rime.*.log
快速配置模板
雾凇基础定制
patch:
"menu/page_size": 9
"style/horizontal": true
switches/@next:
name: zh_simp
reset: 1
states: ["漢字", "汉字"]
'speller/algebra/@before 0':
- derive/^([zcs])h/$1/
- derive/([aei])n$/$1ng/
'engine/filters/@next': simplifier@emoji
'simplifier@emoji/opencc_config': emoji.json
薄荷基础定制
patch:
"menu/page_size": 7
"style/color_scheme": native
"key_binder/bindings":
- {accept: "Tab", send: "Page_Down", when: has_menu}
- {accept: "Shift_L", toggle: ascii_mode, when: always}
参考资料
更多配置细节可通过 MCP 工具 query_oh-my-rime 查询薄荷输入法知识库，或查阅 references/rime-knowledge-base.md。
能力边界说明
本 skill 的能力范围：
✅ 能够做的
- 生成/修改
custom.yaml 配置文件模板
- 解释 Rime 配置原理和 Patch 语法
- 提供各方案的配置差异和特有功能说明
- 指导部署流程和调试排查
❌ 不能做的
- 编写独立脚本（Python/Shell 等）自动生成配置
- 直接修改方案源码（schema.yaml）
- 提供客户端安装包下载（可提供下载链接）
- 词库转换/导入的完整工具（可指导方法）
如需脚本级自动化，请使用其他专门工具，或手动参考本 skill 提供的配置模板编写。
使用提示：如果您的需求涉及"写一个脚本"、"生成代码文件"等，请明确告知，skill 会提供配置模板而非脚本。
