logo
1
1
Login
doc: 更新项目文档

oh-my-rime-cli

Rime 的 Oh-my-rime 配置自动更新与管理命令行工具,支持 Windows、Linux、macOS 多平台。

使用 Demo

功能简介

  • 一键下载和更新 Rime 主方案、模型、词库
  • 自动检测操作系统,智能选择配置目录
  • Windows 下支持注册表自动查找 Rime 用户目录
  • 交互式美观菜单(支持命令行版本和 GUI界面),支持多种输入法环境选择

依赖说明

  • Go 1.24 及以上
  • Windows 平台需支持 golang.org/x/sys/windows/registry

下载与安装

预编译版本下载

您可以在 Releases 页面下载预编译版本:

  • GUI 版本

    • macOS:下载 .dmg 文件
    • Windows:下载 .exe 安装包
  • CLI 版本

    • Windows:下载 oh-my-rime-cli-windows.exe
    • Linux:下载 oh-my-rime-cli-linux
    • macOS:下载 /oh-my-rime-cli-darwin

安全提示

⚠️ 重要提醒:由于项目未进行代码签名,Windows Defender 和其他杀毒软件可能会误报为病毒,比如 macOS 打开 DMG 报错:

macOS 上打开 DMG 报错

需要在安全性内允许打开,之后打开 App 可能还需要一次:

macOS 上打开 App 报错

这是 Go 编译程序的常见问题,请:

  • 确保从官方 GitHub Releases 页面下载
  • 在杀毒软件中添加信任/白名单
  • 或选择自行编译源码

使用方法

1. 编译

Windows

在 Windows 下直接编译:

# 推荐在 Windows 命令行下执行 cd oh-my-rime-cli go build -o oh-my-rime-cli.exe .

macOS/Linux

在 macOS 或 Linux 下编译:

cd oh-my-rime-cli go build -o oh-my-rime-cli .

交叉编译 Windows 版本

在 macOS/Linux 下编译 Windows 可执行文件:

GOOS=windows GOARCH=amd64 go build -o oh-my-rime-cli.exe .

2. 运行

双击或命令行运行编译后的程序,根据提示选择操作和配置目录。

部分逻辑

Windows 注册表支持

  • Windows 下会自动读取注册表 HKEY_CURRENT_USER\Software\Rime\WeaselRimeUserDir 字段
  • 若注册表不存在或读取失败,自动回退到 %APPDATA%\Rime 目录

贡献与许可

  • MIT License
  • 欢迎提交 issue 和 PR

支持