为 rime 输入法核心库 librime (的部分功能) 实现 LSP 协议, 从而通过编辑器的代码补全功能输入汉字.
项目还处在早期阶段
目标是提供 rime + LSP 的通用解决方案, 在不同编辑器内实现与其他 rime 前端类似的输入体验。
主要使用场景是解决 vim 编辑模式下的输入法冲突以及输入法支持不完善的编辑器。
- 用 rime 能输入的东西按理说都能输入 ( 汉字, 标点, emoji ...)
- 支持按数字选择补全项
- 支持候选词翻页
- 多种触发方式
- 默认开启, 随时补全, 用快捷键控制关闭 (写大量汉字)
- 平时关闭, 检测到配置的特殊字符或光标前有非英文字符时触发补全 (写少量汉字)
- 可以按配置其他 rime 输入法的方式去配置 (只有能影响候选项的配置是有用的)
- 可以同步系统中已有 rime 输入法的词频
- 可以通过 TCP 远程使用 (无任何加密,谨慎使用) (since v0.1.3)
demo.mp4
Warning 第一次启动时 rime 需要做大量工作, 可能会很慢
- 下载 Release 或自己从源码编译
- 将编译好的二进制文件放在喜欢的目录下
- 配置 LSP 客戶端, 例如:
- 像配置其他 Rime 输入法一样在 rime-ls 的用户目录进行配置
- 輸入拼音, 就可以看到补全提示
- 可以通过修改 rime-ls 的配置项控制补全行为
- 配置 Rust 环境, 安装额外依赖
clang
和librime-dev
- 编译
librime >= 1.6
=>cargo build --release
librime < 1.6
=>cargo build --release --features=no_log_dir
可以通过我在 AUR 上打的包 rime-ls 编译安装
手动从源码编译与上面类似,其他 linux 发行版也差不多
- 配置 Rust 环境, 安装额外依赖
clang
和librime
- 通过 librime 的 Release 下载 windows 版本,例如
rime-xxxx-Windows-msvc-x64.7z
,解压至某个目录 - 设置环境变量以便编译时找到 librime 的相关文件,在 powershell 下可以:
$env:LIBRIME_LIB_DIR="C:\解压出来的目录\dist\lib" # 找库文件 $env:LIBRIME_INCLUDE_DIR="C:\解压出来的目录\dist\include" # 找头文件 $env:LIB="C:\解压出来的目录\dist\lib" # 链接时找 lib 文件
- 编译
cargo build --release
-
安装 鼠须管输入法
-
安装 librime 从此项目中的 Release 下载最新的 MacOS 相关的压缩包,解压缩后将 include 文件夹以及 lib 文件夹下的内容分别复制到
/usr/local/include
和/usr/local/lib
; -
设置环境变量以便编译时找到 librime 的相关文件(参考相关issue)
# 用于编译 export LIBRIME_LIB_DIR= /usr/local/lib export LIBRIME_INCLUDE_DIR= /usr/local/include # 用于运行 export DYLD_LIBRARY_PATH=/usr/local/lib # 最好放在~/.zshrc中,记得修改~/.zshrc 后,source ~/.zshrc
lib 库文件后面调用的时候应该还需要到 MacOS 的“安全性与隐私”中进行授权,所以建议调用解压后 bin 文件下的可执行文件来提前触发授权。
-
编译,参考 Ubuntu
-
配置,
shared_data_dir
应该设置为/Library/Input Methods/Squirrel.app/Contents/SharedSupport
Warning 不推荐与系统中的已有 rime 输入法共用一个用户目录, 免得出什么问题
使用前备份自己的数据, 避免因作者对 rime API 理解不到位可能造成的数据损失
可以通过 rime 的 sync 功能将系统中已安装的 rime 输入法的词库同步过来。
如需同步词库, 可以在 rime-ls 自己的用户目录下的 installation.yaml
添加sync_dir: "/<existing user data dir>/sync"
配置项。
通过 LSP 的 workspace/executeCommand
手動調用 rime-ls.sync_user_data
的命令进行同步 (since v0.1.2)
-
为什么默认补全繁体中文?怎么修改候选个数?
答:这部分由 Rime 负责,参考 Rime 的帮助文档。推荐对 Rime 有初步了解后再使用本软件。
-
某个编辑器不能用/不好用
答:由于 LSP 客户端在补全上的实现都很不一致(影响用户体验的差异主要有:怎样寻找单词边界、怎样过滤候选项), 不能保证每个编辑器都有很好的使用体验。
欢迎为本项目贡献代码,你可以:
- 发现并修改代码里的 bug
- 为某个编辑器实现相关插件
- 提供某个编辑器的更好用的用户配置
- 帮助实现 CI/CD
- 實現更多 librime 的功能
- 按数字键选择候选项
- 与 rime API 同步翻页
- 与 rime API 同步提交
- 输入标点符号
- 输入方案选择
- 实现更友好的触发条件
-
计划实现光标前面有汉字就开启, 但发现不同编辑器行为不一致, 搁置多加了一次正则匹配解决了, 不知道性能如何
-
- 读 LSP 文档, 继续提升补全的使用体验
- 參數可配置 (用户目录, 触发条件, 候选数量)
-
實現一個更好的 librime 的 rust wrapper 庫目前功能比较固定,没必要了 - 測試其他 LSP clients
- 测试不同操作系统和 librime 版本
- 测试与不同 rime 配置的兼容性
- 配置 GitHub CI,编译各个平台的 Release
- 各种编辑器插件 (help wanted)
-
補全的觸發條件很奇怪,現在我是手動觸發補全寫的這些字解决, 要设置 is_incomplete 来连续补全 -
還沒完成開始這個項目的最初目的, 即直接復用 rime 配置维护一份独立的用户目录,与外部输入法互相同步词频 -
沒有完全實現 rime 功能, 只是读取了候选项, 沒有把选到的字真正提交v0.2.0 基本解决 - 第一次嘗試從 Rust 調用 C 接口,寫的非常不專業且 unsafe
-
同时开启多个共用同一个用户目录的程序时,会因为用户数据库的锁导致不工作是预期行为,避免这么干
受到以下項目啓發