Linux Server 复用共用的 SchemeSlot 装配拼音、双拼、五笔与混输,Fcitx5、Fcitx4、IBus 不各写一份码表逻辑。 支持满码唯一自动上屏、顶字上屏,方案、码表与导入的形码词库可热更新;设置页把 Linux 的方案与自动组词标为支持。 Fcitx5 的配置图标直接打开同安装前缀的青简设置。
12 KiB
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:
- 重启 Fcitx,或注销后重新登录。
- 打开 Fcitx 配置工具,取消「仅显示当前语言」,添加「青简」。
用 IBus:
- 注销后重新登录一次。IBus 只在登录时读取输入法列表的位置,装完不重新登录看不到青简。
- 在系统「设置 → 键盘」里添加「青简」,或执行
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 包)时,重新登录后以源码安装的这份为准;想换回那一份,运行卸载脚本后再重新登录。