qingjian/docs/user/platforms/linux.md

title, order, description

title	order	description
Linux	2	在 Linux（以及 FreeBSD）上安装青简：Fcitx5 预编译包、Fcitx5 / IBus 与 Fcitx4 源码安装、首次输入、更新与卸载，以及与电脑版的不同之处。

青简 Linux 版作为 Fcitx5、IBus 或 Fcitx4 的一个输入法运行，候选使用输入法框架自己的候选面板。目前需要在终端中安装；源码安装可以让青简的后台服务随登录自动启动，预编译包要每次登录后手动启动。

• Debian、Ubuntu、Fedora 可以装 deb / rpm 包，随登录自动启动，见下文「deb / rpm 包」一节。
• Fcitx5 提供 Ubuntu 26.04 预编译包，其他发行版用源码安装。已验证 Ubuntu 26.04 的 GNOME 桌面（Wayland）上 GTK4、Qt6 应用与 Firefox。
• IBus（GNOME 自带的输入法框架）用源码安装，不用换框架。已验证按键、候选与上屏，各类应用里的表现尚未逐个验证。
• Fcitx4 提供 Ubuntu 22.04 源码安装，已验证 GTK3 文本框输入。
• FreeBSD 15.1 上用 Fcitx5 源码安装验证过 XFCE 与 KDE Plasma 的 X11 会话，以及 sway 下的 Wayland 应用。

支持本机候选、学习、本地整句模型与可选的 AI 服务，附带青简设置程序（应用菜单的「青简设置」，与 config.toml 是同一份配置，改完约一秒内生效，只有拼音显示位置与输入日志要重启服务）。与 macOS / Windows 的差别见 平台差异。

Fcitx5 预编译包（Ubuntu 26.04）

预编译包在 Ubuntu 26.04（x86_64）上构建，与系统的 Fcitx5 版本绑定；其他发行版请用下一节的源码安装。先装好 Fcitx5 与应用的输入支持：

sudo apt install python3 fcitx5 fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt6 fcitx5-config-qt

从下载页下载名字以 linux-x86_64.tar.gz 结尾的包，解压后在解出的目录里执行：

./install.sh

# 启动青简，保持此终端开着
~/.local/bin/qingjian-linux-server

之后按下文首次输入添加输入法。

deb / rpm 包（Debian、Ubuntu、Fedora）

GitHub Release 上另有 deb 与 rpm 包，每种两个：qingjian 是青简本体（后台服务、IBus 前端与词库），qingjian-fcitx5 是 Fcitx5 插件。用 IBus 只装前一个，用 Fcitx5 两个都装。装好后青简随登录自动启动，不用开终端。

# Debian / Ubuntu
sudo apt install ./qingjian_<版本>_amd64.deb ./qingjian-fcitx5_<版本>_amd64.deb

# Fedora 42 及以后
sudo dnf install ./qingjian-<版本>-1.fc42.x86_64.rpm ./qingjian-fcitx5-<版本>-1.fc42.x86_64.rpm

• qingjian 在 Debian 12、Ubuntu 22.04 及以后都能装；qingjian-fcitx5 要较新的 Fcitx5，只有 Debian 13、Ubuntu 25.04、Fedora 42 及以后装得上，更早的系统请用 IBus 或源码安装。
• IBus 装完要重新登录一次才看得到青简。
• 卸载：sudo apt remove qingjian qingjian-fcitx5 或 sudo dnf remove qingjian qingjian-fcitx5，设置与学习数据保留。

Fcitx5 与 IBus 源码安装

先安装 Rust 1.96 或更新版本，再按你用的框架装编译所需的软件包。用 Fcitx5 时，Debian / Ubuntu 上是：

sudo apt install cmake g++ pkg-config python3 libssl-dev \
  libfcitx5core-dev libfcitx5utils-dev libfcitx5config-dev nlohmann-json3-dev \
  fonts-noto-core fonts-noto-cjk fonts-noto-color-emoji \
  fcitx5 fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt6 fcitx5-config-qt

用 IBus 时不需要编译器与 Fcitx5 的开发包：

sudo apt install pkg-config python3 libssl-dev ibus \
  fonts-noto-core fonts-noto-cjk fonts-noto-color-emoji

三个字体包不能省：没有 fonts-noto-core 设置程序打不开，缺了另外两个界面上的中文与表情显示不出来。缺了哪一项，安装脚本开头会列出来。

FreeBSD 上是：

pkg install bash cmake pkgconf python3 rustup-init nlohmann-json \
  fcitx5 fcitx5-gtk3 fcitx5-qt6 fcitx5-configtool
rustup-init   # 安装 Rust

按发行版的说明启用 Fcitx5；X11 应用通常需要设置 GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS（Fcitx5 填 fcitx / @im=fcitx，IBus 填 ibus / @im=ibus），改完重新登录。

在源码目录执行：

# 下载并校验正式词库与本地整句模型
tools/release/data-fetch.sh
apps/linux/scripts/install.sh --enable-service

• 安装脚本看这台机器上装了哪个框架，把对应的那份装上，并打印这次装了哪几份。两个框架都装着也没关系，它们共用同一个青简服务；只想装一边就加 --frontend fcitx5 或 --frontend ibus。
• --enable-service 让青简服务随登录自动启动。不加的话，要手动启动并保持终端开着：~/.local/bin/qingjian-linux-server。
• 只想先试一下安装流程，可用 apps/linux/scripts/install.sh --sample --debug，不下载正式词库，只有少量样例词（例如「你好」）。
• 缺省安装到 ~/.local；--prefix /绝对路径 可改安装位置。
• 用自己的账户安装、运行，不要加 sudo。

Fcitx4 源码安装（Ubuntu 22.04）

已在使用 Fcitx4 时，Qt5 应用用 fcitx-frontend-qt5 即可。先安装 Rust 1.96 或更新版本，以及：

sudo apt install cmake g++ pkg-config python3 libssl-dev fcitx-libs-dev libx11-dev libxres-dev nlohmann-json3-dev \
  fonts-noto-core fonts-noto-cjk fonts-noto-color-emoji \
  fcitx fcitx-frontend-gtk3 fcitx-frontend-qt5 fcitx-config-gtk

在源码目录执行：

tools/release/data-fetch.sh
apps/linux/scripts/install.sh --fcitx4
~/.local/bin/qingjian-linux-server

最后一条命令需要保持终端开着。执行 fcitx -r 重启 Fcitx4，在配置工具中把「青简」加入输入法列表。 只想先试安装流程，可用 apps/linux/scripts/install.sh --fcitx4 --sample --debug。 切到青简时，托盘中的输入法图标显示青简标志。

首次输入

用 Fcitx：

1. 重启 Fcitx，或注销后重新登录。
2. 打开 Fcitx 配置工具，取消「仅显示当前语言」，添加「青简」。

用 IBus：

1. 注销后重新登录一次。IBus 只在登录时读取输入法列表的位置，装完不重新登录看不到青简。
2. 在系统「设置 → 键盘」里添加「青简」，或执行 ibus engine qingjian。

切换到青简后输入 nihao，按空格得到「你好」。单击 Shift 切换中英，按键见 按键速查。设置在应用菜单的「青简设置」里。 手动启动青简时，关闭那个终端会结束青简，下次登录后需再次执行 ~/.local/bin/qingjian-linux-server；装时加了 --enable-service 就不用管。

与电脑版不同之处

• 候选面板：使用 Fcitx / IBus 的候选面板，外观由框架的主题决定，青简的主题、字体、横排展开、键位提示不适用。面板上只显示第一条译词，带词性与日语注音。
• 中英模式：每个窗口各记一份，新窗口从中文开始，可设为从英文开始，见 中英文。Fcitx5 的左 Shift 热键需要关掉，见同一页。
• Tab：没在打字时交给应用；打拼音时接受整句补全，没有补全时下一页；英文候选里选高亮候选。
• 数字：当前页没有对应的候选时，数字接在拼音后面，hao6 回车原样输出。
• 英文直输：进入后数字和标点继续追加，以空格结束时保留空格（gpt-6 后按空格得到 gpt-6 ）。
• 整句补全显示在候选面板下方的提示行，按 Tab 接受。
• IBus 下打字中按应用的快捷键（带 Ctrl / Alt / Super 且青简不用的组合，如 Ctrl + F 打开搜索）：已敲的字母先原样上屏到当前输入框，再交给应用。打字中用鼠标点到别的输入框时，X11 应用里拼音留在原来的框；GNOME Wayland 上没上屏的拼音会丢掉，先按 Enter 或选词再换框。
• 私密输入：Fcitx5 识别为私密的输入框里可以打字，但不记录、不学习、不发送；密码框直接交还应用。这依赖应用正确标记，GTK4 应用的私密提示目前传不过来。Fcitx4 只认密码框标记，其他私密输入框认不出；不想留下记录时，可关掉学习与输入日志，见 直接编辑配置文件。
• 暂不支持：五笔与自制方案、辅码、符号面板、额外翻页键与高亮移动键、标点快捷键、中西文自动空格、拼音带声调。

更新与卸载

更新：关掉运行青简的终端，重新执行对应的安装命令（预编译包下载新包后再执行 ./install.sh），然后重启 Fcitx 并重新启动青简。 安装时会检查文件；你改过的安装文件会提示保留，请先备份。

卸载：

apps/linux/scripts/uninstall.sh
# 自定义过安装位置时：
apps/linux/scripts/uninstall.sh --prefix /安装时的绝对路径

预编译包用包里的 ./uninstall.sh。卸载会停掉随登录启动的青简服务；手动启动的要自己关掉那个终端。之后重启 Fcitx，用 IBus 的注销后重新登录一次。卸载保留设置、个人词库、学习数据与其他输入法。 系统里另外装过青简（比如旧版的 deb 包）时，重新登录后以源码安装的这份为准；想换回那一份，运行卸载脚本后再重新登录。