跳转至

安装与卸载

文档首页 · 发行版支持 · 使用与配置

系统要求

  • 支持 IBus 的 Linux 发行版
  • IBus 1.5.22+
  • 可用的 ALSA 输入设备

完整的已验证版本、安装方式和兼容边界见发行版支持范围。简要来说： Ubuntu 20.04–26.04，以及 Debian 11 Bullseye、12 Bookworm、13 Trixie 提供原生 .deb； Fedora 43/44 与 openSUSE Tumbleweed 提供原生 .rpm；这些包均原生覆盖 x86_64/amd64 和 aarch64/arm64。Arch Linux 通过相同的 IBus 协议测试，可使用 Nix Flake 或源码安装。

请选择与目标发行版和版本一致的 .deb 或 .rpm，避免 glibc 和 ALSA ABI 不匹配。 所有安装方式都只包含 Rust IBus 引擎，不再区分 GTK 设置版和无界面版。Rust、编译器和 开发库只在自行构建时需要，安装预构建包不需要 Rust 工具链。

安装原生 .deb

从 GitHub Releases 下载与发行版、版本 及 CPU 架构一致的包。Debian 文件名会同时标明版本和代号，例如 debian-12-bookworm；x86_64 机器选择 amd64.deb，64 位 ARM 机器选择 arm64.deb：

sudo apt install ./typeless-ibus_*.deb

构建 .deb 包

sudo apt update
sudo apt install -y build-essential pkg-config libasound2-dev libopus-dev ibus

git clone https://github.com/day253/typeless-ibus.git
cd typeless-ibus
cargo build --release --locked
cargo install cargo-deb --version 3.7.0 --locked
cargo deb --no-build
sudo apt install ./target/debian/typeless-ibus_*.deb

安装完成后注销并重新登录，或重新启动 IBus。随后在桌面环境的输入源设置中添加 typeless-ibus；GNOME 用户可打开“设置 → 键盘 → 输入源”。

安装原生 .rpm

从 GitHub Releases 下载与发行版版本和 CPU 架构一致的 RPM。x86_64 机器选择 .x86_64.rpm，64 位 ARM 机器选择 .aarch64.rpm。Fedora 不能混用不同版本的构建，openSUSE 也应使用 Tumbleweed 构建：

# Fedora 43/44
sudo dnf install ./typeless-ibus-*."$(uname -m)".rpm

# openSUSE Tumbleweed
sudo zypper install ./typeless-ibus-*."$(uname -m)".rpm

RPM 安装后同样需要重新登录或重启 IBus，再从桌面输入源设置中添加 typeless-ibus。

构建原生 .rpm

Fedora：

sudo dnf install cargo rust gcc gcc-c++ make cmake pkgconf-pkg-config \
  alsa-lib-devel opus-devel ibus rpm-build redhat-rpm-config

openSUSE：

sudo zypper install cargo rust gcc gcc-c++ make cmake pkg-config \
  alsa-devel libopus-devel ibus rpm-build

克隆项目后执行：

./packaging/build-rpm.sh

脚本先生成带 vendored Cargo 依赖的源码归档，再由 rpmbuild 离线编译并运行测试。 二进制 RPM 位于 target/rpm/RPMS/，SRPM 位于 target/rpm/SRPMS/；输出架构跟随当前 原生构建机器。

Arch Linux 从源码安装

Arch Linux：

sudo pacman -S --needed base-devel pkgconf alsa-lib opus ibus

安装 Rust stable 后克隆项目并执行：

cargo build --release --locked
./packaging/install-user.sh

该安装方式只写入当前用户的 ~/.local，不需要维护 PKGBUILD。

Nix Flake

Nix 包原生支持 x86_64-linux 和 aarch64-linux：

nix profile install github:day253/typeless-ibus

安装后重新登录，让图形会话刷新 $XDG_DATA_DIRS 和 IBus 组件缓存，然后添加 typeless-ibus 输入源。Nix 会封装 Rust 引擎所需的用户空间库，但桌面会话仍需要 发行版提供 IBus 1.5.22 或更高版本。

该方式适用于 Fedora、openSUSE、Arch Linux、NixOS 及其他能够运行 Nix 且由桌面会话 提供 IBus 的发行版。

用户级安装

没有 sudo 权限时，可以安装到当前用户：

cargo build --release --locked
./packaging/install-user.sh

安装脚本会把引擎和组件放到 ~/.local，并为 GNOME 的用户级 IBus 服务增加组件搜索 路径。它不会改动现有输入源列表，也不会在应用列表中创建独立启动器。

用户级卸载：

./packaging/uninstall-user.sh

卸载程序不会删除用户的配置文件和 ASR 凭据。

程序路径

  • 系统包：/usr/libexec/typeless-ibus-engine
  • 用户级安装：~/.local/libexec/typeless-ibus-engine

返回文档索引