Rime定制
🤖 摘要：本教程详解Rime候选窗视觉重塑方案。通过配置全局参数实现水平排列，结合多字体回退策略解决跨平台挂载，并提供YAML极简皮肤编写与绑定指南。附带环境校验、调试技巧及报错排查方法，助你打造清爽高效且兼容多系统的现代化输入界面。
这是一份为你补全的完整教程。内容基于 Rime ≥ 0.14 规范编写，涵盖配置逻辑、跨平台适配与可复制的代码块，可直接用于博客、Wiki 或开源项目文档。
📖 引言
Rime 默认界面偏向“终端极客风”，竖向排列、固定字号与系统默认字体容易带来视觉疲劳。本教程将通过 布局参数调优 → 字体回退挂载 → YAML 皮肤轻量化 三步，彻底重塑输入候选窗的视觉体验，兼顾清爽、高效与跨平台兼容性。
⚠️ 前置条件
- 已安装 Rime（Linux/macOS/Windows）
- 掌握配置文件路径：
- Linux (<code>fcitx5</code>): <code>~/.local/share/fcitx5/rime/</code>
- macOS: <code>~/Library/Rime/</code>
- Windows: <code>%APPDATA%\Rime\</code>
- 了解基础 YAML 缩进规则（必须使用空格，禁止 Tab）
🔧 一、全局外观调教：打破传统方块字布局
Rime 的外观由 <code>default.custom.yaml</code>（或对应方案的 <code>.custom.yaml</code>）中的 <code>patch:</code> 块控制。以下参数是“破方”核心：
# ~/.local/share/fcitx5/rime/default.custom.yaml
patch:
# ── 布局开关 ──
"style/horizontal": true # 候选词水平排列（现代感关键）
"inline_preedit": false # false=拼音显示在输入框；true=拼音嵌入光标处
# ── 候选窗参数 ──
"menu/page_size": 5 # 每页显示候选数（建议 5~7）
"menu/alternative_select_labels": ["1","2","3","4","5"] # 自定义序号标签
# ── 交互优化 ──
"show_notifications": false # 关闭部署/同步系统弹窗
"speller/auto_select": true # 单候选自动上屏（提升速度）📌 关键说明
- <code>horizontal: true</code> + <code>page_size: 5</code> 可彻底摆脱传统竖向“方块字”堆叠。
- <code>inline_preedit</code> 视个人习惯而定：开发者/码字者推荐 <code>false</code>（保留输入轨迹）；重度拼音用户可开 <code>true</code>。
- 所有修改需 重新部署（托盘菜单 → 重新部署 / 快捷键 <code>Ctrl+~</code> 或 <code>Super+~</code>）后生效。
🔤 二、高颜值字体挂载：跨平台字体回退策略
Rime 支持声明多字体，系统会按顺序查找已安装字体，实现自动回退。
1. 基础配置
patch:
# 候选字主字体
"style/font_face": "Noto Sans SC, Source Han Sans SC, PingFang SC"
# 序号/标签字体（推荐等宽字体对齐）
"style/label_font_face": "JetBrains Mono, Menlo, Consolas"
# 光标/指针字体（通常与主字体一致）
"style/pointing_font_face": "Noto Sans SC"
# 字号（单位：pt，macOS/Linux 推荐 14~16，Windows 推荐 12~14）
"style/font_size": 152. 跨平台字体校验
| OS | 验证命令 / 路径 | 注意项 |
|---|---|---|
| Windows | <code>Settings → Fonts</code> 或 <code>fc-list :lang=zh</code> | 需手动安装 <code>.ttf/.otf</code> |
| macOS | <code>~/Library/Fonts</code> / <code>Font Book</code> | 苹方/思源已预装，无需额外步骤 |
| Linux | <code>fc-list :lang=zh</code> | Debian/Arch 需安装 <code>fonts-noto-cjk</code> 等包 |
3. 字体加载失败排查
- 检查 YAML 缩进与引号：<code>font_face: "Font Name"</code>（含空格必须加引号）
- Linux 用户若字体不生效，运行 <code>fc-cache -fv</code> 刷新 fontconfig
- Windows 下部分系统字体需重启资源管理器或重新部署
🎨 三、极简皮肤自定义：从 YAML 到视觉轻量化
Rime 皮肤本质是 YAML，存放在 <code>skin/</code> 目录。现代 Rime 使用 <code>preset_color_schemes</code> 加载。
1. 创建极简皮肤文件
新建 <code>skin/minimal_light.yaml</code>：
# skin/minimal_light.yaml
name: minimal_light
author: YourName
description: "无边框、低对比、高留白"
color_scheme: light
style:
# 覆盖全局参数（可选）
horizontal: true
inline_preedit: false
# 视觉参数
border_width: 0 # 边框宽度（0=隐形）
corner_radius: 6 # 圆角半径（需系统 compositor 支持）
spacing: 4 # 候选词间距 / 行距
candidate_spacing: 8 # Windows/Linux X11 可能需要此参数
# ── 颜色定义（可选，默认使用系统主题） ──
preset_color_schemes:
light:
name: "极简白"
author: "YourName"
colors:
background: "@surface@,#fafafa,#f5f5f5"
text: "@text@,#333333,#222222"
highlight_text: "@accent@,#0066cc,#0052a3"
highlight_backdrop: "#e6f0ff"
shadow: "#0000001a"2. 绑定皮肤
在 <code>customization.yaml</code> 或方案配置中声明：
patch:
preset_color_schemes: /skin/minimal_light3. 颜色变量说明
Rime 皮肤支持 CSS-like 变量，优先级：系统主题 → Rime 默认 → 自定义。常用变量：
- <code>@surface@</code>：背景层
- <code>@text@</code>：普通文字
- <code>@accent@</code>：高亮/选中色
- <code>@shadow@</code>：投影/边框色
- 支持十六进制 + Alpha（如 <code>#0000001a</code>）
🐛 四、热重载、调试与常见坑位
| 问题现象 | 原因排查 | 解决方案 |
|---|---|---|
| 字体不生效 | fontconfig 未刷新 / YAML 引号缺失 | <code>fc-cache -fv</code>；确保带空格字体加 <code>""</code> |
| 圆角/透明失效 | X11 无 compositor / Windows GDI限制 | 换 Wayland / macOS 原生支持；或改用 <code>border_width: 1</code> |
| 皮肤不加载 | <code>preset_color_schemes</code> 路径错误 | 使用绝对路径 <code>/skin/xxx</code>，勿用相对路径 |
| 候选词错位/重叠 | <code>candidate_spacing</code> / <code>spacing</code> 冲突 | 统一使用 <code>spacing</code>，移除冗余参数 |
🔍 调试技巧
- 查看日志：<code>rime_log/</code> 目录下的 <code>*.log</code>
- 验证配置：终端运行 <code>rime –validate custom.yaml</code>
- 临时恢复：删除 <code>.custom.yaml</code> 与 <code>skin/</code>，重新部署默认配置
📦 结语 & 进阶方向
完成本调教后，你的 Rime 将具备：
✅ 水平候选流布局
✅ 跨平台字体自动回退
✅ 低视觉干扰的极简皮肤
下一步可探索：
- <code>ibus-rime</code> / <code>fcitx5-rime</code> 快捷键绑定
- 动态主题切换（<code>preset_color_schemes: /skin/minimal_dark</code>）
- 与 Waybar / Polybar / macOS MenuBar 集成显示状态
- 自定义标点/符号面板皮肤
📖 官方文档：https://github.com/rime/home/wiki/Configuration
🎨 皮肤收集：https://github.com/lotem/rime-skin-gallery
如需提供你的 系统环境 + 当前 <code>default.yaml</code> 片段，我可为你生成精准覆盖配置。
