Zime 是一款使用 Zig 语言从零开发、专为 Debian 13 + GNOME Wayland环境定制的 IBus 输入法前端,深度绑定 librime 中州韵引擎,默认搭载雾凇拼音 rime-ice 方案。

不同于 fcitx5 、通用 ibus-rime 等跨平台输入法框架, Zime 不追求全发行版、全桌面兼容,核心设计目标是GNOME Wayland 环境稳定可控、易调试、输入体验拉满,并独家集成完整离线本地语音听写模块,整套输入法、语音识别全部本机运算,无任何云端上传,兼顾打字与语音输入双重需求。

核心技术栈

  • 编译语言: Zig (轻量、高性能、内存安全)
  • 输入法框架: IBus ( GNOME 原生内置输入总线,深度适配 Wayland )
  • 文字内核: librime ,默认预装雾凇拼音 rime-ice
  • 语音底座: sherpa-onnx ,集成 SenseVoice/FireRed/Qwen3 等离线 ASR 模型
  • 系统适配:仅 Debian 系 GNOME Wayland 会话,不兼容 KDE 、 X11 、 fcitx5

核心模块

模块一:轻量化 IBus-Rime 文字前端

  1. 原生适配 GNOME Wayland 解决传统 ibus-rime 候选窗漂移、 Qt/GTK 软件输入卡顿、快捷键冲突等常见问题,完美适配 GNOME Mutter 合成器,系统设置输入源一键添加,无需手动配置环境变量。
  2. 极简按键逻辑
  • 单击 Shift :切换中英输入,不破坏组合快捷键;
  • Shift + 字母 / 符号等组合键完全保留系统原有功能,不会被输入法劫持;
  • 完整继承雾凇拼音全部能力:整句输入、模糊音、 Emoji 、日期 / 金额 Lua 脚本、简繁切换、中英混输。
  1. 目录分层管理 独立隔离 Rime 配置、运行日志、 IBus 组件文件:
  • 用户词库:~/.config/zime/rime
  • 运行日志:~/.cache/zime/rime-logs
  • IBus 注册文件:系统全局组件目录,安装脚本自动注册,重启桌面直接生效。
  1. 易调试架构 配套debug.zsh前台调试脚本,可实时打印 Rime 输入日志、 IBus 通讯信息,排查候选、编码、部署问题不用反复重启桌面。

模块二:全离线本地语音输入(项目独家亮点)

Zime 内置完整语音听写服务,全程本地 ONNX 推理,音频、文本绝不外传,支持多开源 ASR 模型自由切换:

支持 5 类离线语音模型

  1. SenseVoice (默认推荐):轻量高效,自动识别中英混合,自带标点,日常短句、办公聊天首选;
  2. FireRed-CTC :长文本识别更强,适合文章、会议记录;
  3. FireRed-AED :对比实验模型,普通用户不推荐;
  4. FunASR Nano :覆盖多语种、方言,多语言写作场景;
  5. Qwen3-ASR :高精度大模型,支持复杂长句,可搭配本地 Ollama 文本纠错。

使用方式

长按Alt键说话,松开自动识别并上屏; Alt 组合快捷键不受语音功能干扰,打字、听写无缝切换。

可选本地 LLM 纠错

安装语音时添加--with-correction参数,自动调用本机 Ollama 运行 Qwen4B 模型,识别文字自动润色纠错;模型超时 / 推理失败自动退回原始识别文本,不会卡顿输入。

语音服务管理

采用 systemd 用户常驻服务,提供状态自检脚本,一键启停、查看识别运行日志,模型文件缓存本地,重复安装无需重复下载。

安装流程

1. 前置系统依赖

sudo apt-get install libibus-1.0-dev librime-dev librime-plugin-lua librime-plugin-octagram librime-plugin-charcode pkg-config curl tar

2. 本地 Zig 环境一键部署

./scripts/install-zig-local.zsh
export PATH="$PWD/.zig/zig-x86_64-linux-0.16.0:$PATH"

3. 自动安装雾凇拼音词库

./scripts/install-rime-ice.zsh

4. 编译并注册 IBus 输入法

./scripts/install-user.zsh

5. GNOME 添加输入源

图形路径:设置 → 键盘 → 输入源 → 添加Zime Pinyin

命令行快速配置:

bash

gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'zime')]"

6. 安装离线语音(可选)

# 默认 SenseVoice
./scripts/install-voice.zsh
# 指定模型示例
./scripts/install-voice.zsh --model fire-red-ctc --language zh
# 带 LLM 纠错
./scripts/install-voice.zsh --model qwen3-asr --with-correction

7. 打包发布(分发使用)

./scripts/package-release.zsh --model fire-red-ctc

输出完整离线安装压缩包,解压运行install-bundle.zsh即可一键部署。

配套运维脚本

项目封装全套自动化脚本,降低编译、更新、排错成本:

  • build.zsh:重新编译 Zime 主程序;
  • debug.zsh:前台运行,实时打印输入调试日志;
  • uninstall.zsh --yes:一键卸载输入法、语音模型、所有配置;
  • zime-voice --self-test:语音模型自检,验证麦克风与识别服务;
  • install-*系列:分别安装 Zig 、词库、语音、完整组件;
  • sync/打包脚本:缓存模型,避免重复下载。