jubeater
5e58194c6b
Linux 的云服务只差按需联想、用量统计、释义兜底三项，对齐 Windows。 顺带两处 bamboo-slip 修复：Wayland 会话直连剪贴板（连不上回退 X11）；秘密输入框聚焦时关输入法，免得密钥经云联想上报。 Closes #418
8.3 KiB
title, order, description
| title | order | description |
|---|---|---|
| Linux | 2 | 在 Linux（以及 FreeBSD）上安装青简：Fcitx5 预编译包、Fcitx5 / IBus 与 Fcitx4 源码安装、首次输入、更新与卸载，以及与电脑版的不同之处。 |
青简 Linux 版作为 Fcitx5、IBus 或 Fcitx4 的一个输入法运行，候选使用输入法框架自己的候选面板。目前需要在终端中安装；源码安装可以让青简的后台服务随登录自动启动，预编译包要每次登录后手动启动。
- 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
之后按下文首次输入添加输入法。
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 只认密码框标记，其他私密输入框认不出；不想留下记录时，可关掉学习与输入日志，见 直接编辑配置文件。
- 暂不支持：五笔与自制方案、辅码、符号面板、额外翻页键与高亮移动键、标点快捷键、中西文自动空格、拼音带声调。
更新与卸载
更新：关掉运行青简的终端，重新执行对应的安装命令（预编译包下载新包后再执行 ./install.sh），然后重启 Fcitx 并重新启动青简。
安装时会检查文件；你改过的安装文件会提示保留，请先备份。
卸载：
apps/linux/scripts/uninstall.sh
# 自定义过安装位置时：
apps/linux/scripts/uninstall.sh --prefix /安装时的绝对路径
预编译包用包里的 ./uninstall.sh。卸载会停掉随登录启动的青简服务；手动启动的要自己关掉那个终端。之后重启 Fcitx，用 IBus 的注销后重新登录一次。卸载保留设置、个人词库、学习数据与其他输入法。
系统里另外装过青简（比如旧版的 deb 包）时，重新登录后以源码安装的这份为准；想换回那一份，运行卸载脚本后再重新登录。