Files
qingjian/docs/user/platforms/linux.md
T
andnnl de00d87f23 feat(linux): 接入五笔方案并直接打开青简设置 (#919)
Linux Server 复用共用的 SchemeSlot 装配拼音、双拼、五笔与混输,Fcitx5、Fcitx4、IBus 不各写一份码表逻辑。
支持满码唯一自动上屏、顶字上屏,方案、码表与导入的形码词库可热更新;设置页把 Linux 的方案与自动组词标为支持。
Fcitx5 的配置图标直接打开同安装前缀的青简设置。
2026-11-13 18:27:14 +08:00

12 KiB
Raw Blame History

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 包」一节。
  • 较新的发行版(Debian 13、Ubuntu 25.04、Fedora 42、Arch 及以后)也可以用 AppImage:一个文件、不用管理员权限,随登录自动启动,见下文「AppImage」一节。
  • 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,设置与学习数据保留。

AppImage

一个文件就是整个青简,不用编译,也不用管理员权限,适合 Debian 13、Ubuntu 25.04 及以后、Fedora 42 及以后、Arch 这类较新的系统。 要求系统的 Fcitx5 是 5.1.8 或更新(Ubuntu 24.04 自带的 5.1.7 不够,请用源码安装)。先用系统的包管理器装好 Fcitx5 与 GTK / Qt 输入支持,例如 Debian / Ubuntu:

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

从下载页下载 Qingjian-<版本>-x86_64.AppImage,放到一个固定的位置(比如 ~/Applications),然后:

chmod +x ~/Applications/Qingjian-*.AppImage
~/Applications/Qingjian-*.AppImage install

也可以在文件管理器里给它加上执行权限后双击,第一次会自动完成安装并打开青简设置。 安装会把青简接进 Fcitx5、设成登录后自动启动,并在应用菜单里加上「青简设置」;青简服务当场就会启动,不用重新登录。 之后重启 Fcitx5(fcitx5 -r),在 Fcitx5 配置工具里取消「仅显示当前语言」,添加「青简」。

  • 挪动或改名 AppImage 文件后,再运行一次 install:自动启动与菜单项记的是它原来的位置。
  • 更新:用新版本的文件替换旧文件(保持同一个路径和文件名最省事),注销重新登录或运行一次 install,然后重启 Fcitx5。
  • 卸载:运行 Qingjian-*.AppImage uninstall,再重启 Fcitx5;之后可以删掉这个文件。配置、个人词库和学习数据会保留。
  • 已经用源码安装或预编译包装过青简的,先卸载那一份再装 AppImage;两份同时装会互相顶替,安装时会提示。
  • 系统缺少 FUSE、提示无法挂载时,先运行 export APPIMAGE_EXTRACT_AND_RUN=1 再执行上面的命令。

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 只认密码框标记,其他私密输入框认不出;不想留下记录时,可关掉学习与输入日志,见 直接编辑配置文件。
  • 暂不支持:辅码与字根提示、符号面板、额外翻页键与高亮移动键、标点快捷键、中西文自动空格、拼音带声调。

五笔与自制方案

从应用菜单打开「青简设置」,或运行 ~/.local/bin/qingjian-settings。Fcitx5 用户也可以在 Fcitx5 配置工具中选中「青简」,点击配置图标直接打开青简设置。在「输入 → 形码」选择「五笔(86)」;只用五笔时把「拼音」设为「关」,保留拼音则是五笔拼音混输。无需重启服务。

较旧的 Fcitx5 配置工具(例如 Ubuntu 24.04 附带的 fcitx5-config-qt 5.1.4)会先显示一个带配置按钮的窗口,需再点一次才能打开青简设置。升级到支持直接启动外部设置的新版本配置工具后,才会跳过这层窗口;只重启 Fcitx5 不会改变该行为。

支持满码唯一自动上屏、顶字、导入五笔词库和自制双拼 / 形码方案。切换方案会取消未上屏编码;Linux 尚不支持字根图与辅码。详见 五笔与混输。旧安装若缺少五笔方案,需重新运行更新后的安装脚本补齐资源。

更新与卸载

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

卸载:

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

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