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
基础使用
- 直接运行二进制程序,启动交互式 TUI 菜单;
# macOS / Linux
./rime‑wanxiang‑updater
# Windows
.\rime‑wanxiang‑updater.exe
- 首次启动弹出初始化向导,选择万象版本、辅助码类型;
- 在主菜单选择:一键全部更新 / 分项更新 / 主题设置 / 参数配置;
- 更新完毕工具内直接调用 Rime 重新部署,配置立即生效。
配置文件存放路径
- Windows :
%APPDATA%\rime‑updater\config.json- macOS :
~/Library/Application Support/rime‑updater/config.json- Linux :
~/.config/rime‑updater/config.json
