Rime输入法跨平台配置与同步教程：以雾凇拼音方案为例

1. 引言

Rime（中州韵输入法引擎）是一个开源的、高度可定制化的输入法框架。其核心设计理念是将输入法算法与前端界面分离，从而实现在不同操作系统（Windows、macOS、Linux、Android）上提供一致的输入体验。雾凇拼音（rime-ice）是基于Rime框架的一个功能丰富的拼音输入方案，它提供了大量优化和开箱即用的功能。

本教程的目标是详细阐述如何在PC端（以Windows平台的小狼毫为例）和Android端（以fcitx5-android为例）部署雾凇拼音输入方案，并建立一个基于私有Git仓库的多端配置与用户词典同步系统。本文档旨在提供一个可按步骤精确复现的配置指南。

2. PC端配置：小狼毫（Weasel）

本章节将指导您在Windows系统下的小狼毫前端中，通过Git模式安装并启用雾凇拼音方案。

2.1. 定位用户配置目录

在进行任何配置之前，必须首先定位到Rime的用户配置目录。此目录是存放所有个性化配置、输入方案和用户词典的地方。

graph TD
    A[开始菜单] --> B[找到“小狼毫输入法”程序组];
    B --> C[点击“用户文件夹”快捷方式];
    C --> D[系统文件资源管理器打开目标目录];
    D --> E[目录定位完成];

1. 从Windows“开始”菜单中找到“小狼毫输入法”程序组。
2. 点击其中的【用户文件夹】快捷方式。
3. 系统将自动打开一个路径类似于 C:\Users\YourUsername\AppData\Roaming\Rime 的文件夹。此即为用户配置目录，后续所有操作均基于此目录。

2.2. 使用Git安装雾凇拼音

雾凇拼音方案推荐使用Git进行安装，以便于后续的版本管理和更新。

1. 环境准备：确保您的系统中已安装 Git。

2. 备份（可选但建议）：在进行操作前，建议将用户配置目录中的所有现有文件进行备份。

3. 执行Git Clone：

   • 打开小狼毫用户配置目录。
   • 清空该目录下的所有默认文件和文件夹。
   • 在此目录的地址栏输入 cmd 或 powershell 并按回车，以在此路径下快速打开命令行终端。
   • 执行以下命令，将雾凇拼音的官方配置仓库克隆到当前目录。--depth 1 参数用于执行浅克隆，可显著减少下载体积。注意命令最后的 . 代表克隆到当前目录。

   git clone https://github.com/iDvel/rime-ice.git . --depth 1
   

4. 部署：

   • 右键点击任务栏中的小狼毫图标，或从开始菜单中找到【重新部署】选项并点击。
   • 部署过程会根据新的配置文件生成所需的数据，可能需要一些时间。
   • 部署完成后，右键点击小狼毫图标，进入“输入法设定”，即可看到“雾凇拼音”等新方案，勾选并应用后即可开始使用。

3. 构建多端同步系统

为了在PC和移动设备间同步您的输入习惯（包括用户词典、自定义短语等），我们将利用一个私有的Git仓库作为同步中枢。

3.1. 创建私有配置仓库

直接使用公共仓库进行同步会泄露您的个人输入数据。因此，我们需要创建一个私有副本。

graph TD
    A[在GitHub上Fork官方仓库] --> B[访问GitHub导入功能页面];
    B --> C[使用Fork的仓库URL作为源];
    C --> D[设置新仓库名称并选择“Private”];
    D --> E[开始导入];
    E --> F[私有仓库创建成功];

1. Fork官方仓库：访问雾凇拼音的GitHub主页 https://github.com/iDvel/rime-ice.git，点击右上角的“Fork”按钮，将该仓库复刻到您自己的GitHub账户下。
2. 创建私有仓库：
   • 直接将Fork的仓库转为私有需要付费。我们采用导入的方式创建一个新的私有仓库。
   • 访问GitHub的仓库导入页面：https://github.com/new/import。
   • 在“Your old repository’s clone URL”处，填入您刚刚Fork的仓库地址（例如 https://github.com/YourUsername/rime-ice.git）。
   • 为新仓库命名（例如 my-rime-config）。
   • 关键步骤：选择“Private”选项。
   • 点击“Begin import”。导入完成后，您就拥有了一个包含所有雾凇拼音配置的私有仓库。

3.2. 关联本地PC配置

现在，将您本地PC上的小狼毫用户目录与这个新的私有仓库关联起来。

1. 在之前操作的小狼毫用户配置目录中打开命令行终端。

2. 执行以下命令，将本地Git仓库的远程地址（origin）修改为您新创建的私有仓库地址。

   git remote set-url origin https://github.com/YourUsername/my-rime-config.git
   

3. 执行 git remote -v 命令，检查输出是否已正确指向您的私有仓库。

4. 将本地配置推送到远程私有仓库，完成初次同步。

   # 假设默认分支为 master，如果不是请替换为 main
   git push -u origin master
   

3.3. 同步工作流与更新

• 日常同步：

  • 在任何一台设备上使用输入法并产生新的用户词典后，进入该设备的用户配置目录，执行以下命令推送更改：

    git add .
    git commit -m "sync user data"
    git push
    

  • 在另一台设备开始使用前，先进入其用户配置目录，执行 git pull 拉取最新更改，然后重新部署Rime前端。

• 更新雾凇拼音：

  • 若要获取官方雾凇拼音的更新，需要先将官方仓库添加为一个名为 upstream 的远程源。

    git remote add upstream https://github.com/iDvel/rime-ice.git
    

  • 之后，通过以下命令获取更新并与您的配置合并。

    git fetch upstream
    git merge upstream/master # 或 upstream/main
    # 如果存在冲突, 手动解决后再次提交和推送
    

4. Android端配置：fcitx5-android

本章节将指导您在Android设备上配置Rime，并接入已建立的Git同步系统。

4.1. 准备工作与定位目录

1. 从Google Play、F-Droid等应用商店安装 fcitx5-android。
2. 进入Android系统的“语言和输入法”设置，启用 Fcitx5，并将其设置为当前默认输入法。
3. 打开Fcitx5应用，进入 Settings -> Add-ons，点击 Rime。界面上会显示Rime的用户数据路径，通常是 /storage/emulated/0/Android/data/org.fcitx.fcitx5.android/files/rime。记录此路径。

4.2. 拉取配置并部署

1. 获取配置：在Android设备上安装一个Git客户端（例如 Termux）。在Termux中，先安装git (pkg install git)，然后在一个临时目录中克隆您的私有配置仓库。

   # 在Termux中执行
   git clone https://github.com/YourUsername/my-rime-config.git
   ```2.  **复制文件**：将克隆下来的 `my-rime-config` 文件夹内的**所有内容**，复制到`4.1`步骤中定位到的 Fcitx5 的 Rime 用户数据路径下。
   *   **重要注意事项**：在复制过程中，如果目标目录已存在 `installation.yaml` 文件，请**不要**覆盖它。此文件由Rime前端生成，包含设备相关的标识。覆盖此文件可能导致问题。其他所有配置文件（`*.yaml`, `*.lua`, `opencc/`等）都应被覆盖。
   

2. 部署与启用：

   • 返回Fcitx5应用的 Add-ons -> Rime 界面，点击 Update 或 Deploy 按钮。
   • 部署完成后，调出Fcitx5键盘。
   • 关键步骤：如果键盘默认不是中文输入，请长按键盘左下角的“地球”图标（语言切换键），在弹出的菜单中应该能看到“中州韵”或“雾凇拼音”。选择它即可切换到Rime输入模式。如果菜单中没有，请确保上一步部署已成功完成。

3. 在Android端同步：与PC端一样，使用Termux等工具进入Rime用户数据目录，通过 git pull 和 git push 命令与您的私有仓库进行数据交换，并记得在拉取更新后于Fcitx5应用内重新部署。