rime‑wanxiang‑updater 是使用 Go 语言开发,面向万象拼音( rime‑wanxiang )的专用终端 TUI 更新部署工具。解决万象方案、词库、长句语法模型手动下载、解压、部署繁琐的痛点,提供交互式键盘驱动终端界面, Windows 、 macOS 、 Linux 全平台原生支持。

后续该项目演进为通用多方案工具 snout, snout 除万象之外还支持雾凇、白霜、薄荷等更多 Rime 方案,而本仓库 rime‑wanxiang‑updater 专注万象拼音生态。

工具自动探测本机 Rime 用户目录,支持镜像加速、网络代理、断点续传、文件哈希校验;不仅可以更新方案包、词库、 LTS 语法模型,还支持管理小狼毫 / 鼠须管 / Fcitx5 输入法主题,更新完成一键触发 Rime 重新部署,普通用户不用手动操作 yaml 与压缩包。

核心功能

1. 万象组件分项更新

  • 一键全部更新:自动检测方案、词库、语法模型版本,批量下载部署;
  • 分项独立更新:按需单独更新完整方案包、词库、万象 LTS 长句模型,不用完整重下整套资源;
  • 首次运行向导:引导选择标准版 / 增强 Pro 版、选择辅助码类型,自动生成基础配置。

2. 网络下载增强能力

  • 支持 SOCKS5 / HTTP 代理,适配内网、翻墙环境;
  • CNB 国内镜像源,提升国内 GitHub 资源下载速度;
  • HTTP 断点续传,中断之后继续下载,节省网络流量;
  • SHA256 哈希校验,校验下载文件完整性,避免损坏压缩包;
  • 指数退避重试策略,网络抖动自动重试请求。

3. TUI 交互式终端界面

基于 BubbleTea+Lipgloss 构建键盘操作终端 UI ,支持中英双语界面:

  • 方向键、 Vim 风格j/k、数字键导航菜单, Enter 确认,Q/Esc返回退出;
  • 进度条展示下载进度;
  • 程序自身界面主题可以切换。

4. Rime 主题一键管理

平台支持能力
Windows 小狼毫写入weasel.custom.yaml主题补丁
macOS 鼠须管写入squirrel.custom.yaml主题补丁
Linux Fcitx5安装切换 fcitx5 完整皮肤

支持多选预设主题,设置浅色 / 深色默认主题,工具内部直接执行重新部署,无需手动编辑配置文件。

5. 高级配置能力

  • 自定义代理、镜像开关;
  • 更新前后执行自定义 Hook 脚本;
  • 设置排除文件名单,保护个人自定义文件不被覆盖;
  • JSON 格式持久化配置文件,保存你的版本选择、路径、网络设置。

安装方式

1. 包管理器安装(推荐)

  • Arch Linux(AUR)
yay -S rime‑wanxiang‑updater
  • Windows Chocolatey
choco install rime‑wanxiang‑updater
  • macOS Homebrew
brew tap tinypkg/tap
brew install rime‑wanxiang‑updater

2. 下载预编译二进制

前往项目 Releases 页面,下载对应系统架构可执行文件:

  • Windows :rime‑wanxiang‑updater‑windows‑amd64.exe
  • macOS Apple Silicon :rime‑wanxiang‑updater‑darwin‑arm64
  • macOS Intel :rime‑wanxiang‑updater‑darwin‑amd64
  • Linux :rime‑wanxiang‑updater‑linux‑amd64

3. 源码编译

Go ≥1.21 环境:

git clone https://github.com/ca‑x/rime‑wanxiang‑updater
cd rime‑wanxiang‑updater
go build -o rime‑wanxiang‑updater ./cmd/rime‑wanxiang‑updater

基础使用

  1. 直接运行二进制程序,启动交互式 TUI 菜单;
# macOS / Linux
./rime‑wanxiang‑updater
# Windows
.\rime‑wanxiang‑updater.exe
  1. 首次启动弹出初始化向导,选择万象版本、辅助码类型;
  2. 在主菜单选择:一键全部更新 / 分项更新 / 主题设置 / 参数配置;
  3. 更新完毕工具内直接调用 Rime 重新部署,配置立即生效。

配置文件存放路径

  • Windows :%APPDATA%\rime‑updater\config.json
  • macOS :~/Library/Application Support/rime‑updater/config.json
  • Linux :~/.config/rime‑updater/config.json