* feat(linux): Server 接本地整句模型重排 - 照 Windows Server 的 dispatch/rescore 平移:后台加载、停键 80 ms 防抖、20 ms 收结果、2 s 兜底,只换整句候选 - 模型在后台接上时用户正在组句,补查一次攒下整句路径再起防抖,这一轮不错过重排 - 主循环改按 next_tick 的绝对到点时间等消息,防抖与轮询才到得了点;Poll 先 tick 再回帧 - 前文用本会话历史,不读应用光标前文;[model] 只在启动时读,Linux 没有配置热加载 * feat(linux): Poll 回帧内容没变时沿用展示身份 - 插件组句期间每 80 ms Poll 一次取重排结果;若每次都推进版本号,插件就得每拍重画、每拍回报曝光,面板闪且词汇统计被刷高 - 会话记下上次发出的帧,Poll 回的帧与之相同就当没有新展示:身份不变、不清曝光记录;重排换了顺序才推进 - KeyResult 的行为不变,每次按键仍是新的展示 * feat(linux): 插件组句期间轮询取本地整句模型的重排结果 - 插件是一问一答,Server 推不了;照 Windows DLL 挂一个 80 ms 定时器,组句期间发已有的 Poll 消息 - 只在 revision 推进时重画并回报;同版本什么都不做,面板不闪、曝光不重复记 - 帧为空、Reset、失焦、停用、断线时停表;定时器建一次反复用 - 回归:mock 全模式应答 Poll,rescore 模式第一条回换序帧,断言重画一次、回报一次 * build(linux): 安装清单加本地整句模型文件 - files.py 只装 data/generated,data-fetch.sh 取回的 data/model/model.qjm 没进清单,装完 Server 找不到模型 - 非样例安装把它按 data.lock 的校验值装到 resources/data/model/,缺文件提示先跑 data-fetch.sh - 用户文档:Linux 页去掉「暂不提供神经模型」,本地整句模型页补 Linux 的开关与自有模型路径 --------- Co-authored-by: Li <clwillsoncl@gmail.com>
4.2 KiB
title, order, description
| title | order | description |
|---|---|---|
| Linux | 6 | 在 Linux 上安装青简,使用 Fcitx5 默认候选面板。 |
青简 Linux 目前提供源码安装,使用 Fcitx5 默认候选面板。已验证 Ubuntu 26.04 的 GNOME 桌面(Wayland)上 Fcitx5 5.1.19 的 GTK4、Qt6 应用与 Firefox; 其他桌面、其他发行版和旧版应用尚未完成验证。当前支持本地候选、学习和本地整句模型重排,暂不提供云联想、设置窗口或自动启动。
安装和首次输入
先安装 Rust 1.96、CMake、C++20 编译器、pkg-config、Fcitx5、其 GTK / Qt 输入支持,以及 OpenSSL、Fcitx5 Core/Config/Utils 与 nlohmann-json 的开发包。 Debian / Ubuntu 上是:
sudo apt install cmake g++ pkg-config python3 libssl-dev \
libfcitx5core-dev libfcitx5utils-dev libfcitx5config-dev nlohmann-json3-dev \
fcitx5 fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt6 fcitx5-config-qt
缺了哪一项,安装脚本开头会直接列出来。
按发行版指引启用 Fcitx5;X11 应用通常需要 GTK_IM_MODULE=fcitx、QT_IM_MODULE=fcitx、XMODIFIERS=@im=fcitx,环境变化后重新登录。
在源码目录执行:
# 下载并校验正式词库与本地整句模型
tools/release/data-fetch.sh
apps/linux/scripts/install.sh
# 手动启动,保持此终端运行
~/.local/bin/qingjian-linux-server
也可用 apps/linux/scripts/install.sh --sample --debug 快速体验少量样例词(例如「你好」),不下载正式词库。
默认安装到 ~/.local;--prefix /绝对用户目录 可更改安装位置。请用相同用户安装、运行,不要使用 sudo。
重启 Fcitx5,打开 Fcitx5 配置工具,取消「仅显示当前语言」,添加「青简」。切换到青简后输入 nihao,空格选中「你好」。
单击 Shift 切换中英;按键规则见 按键与快捷键。关闭手动启动的终端会结束青简服务;下次登录后需再次启动。
配置、隐私和数据
首次运行生成 ~/.config/qingjian/config.toml,修改后重启青简服务。
[general] preedit 可设为 both(行内和候选窗口)、inline(只在行内)、window(只在候选窗口);应用不支持行内显示时使用候选窗口。
每页候选数、翻页键、学习、日志和辅助语言使用同一配置文件。learning_language = "off" 关闭中文候选的辅助语言释义与生词标记。系统面板外观由 Fcitx5 设置控制。
随包的本地整句模型在你停顿后给整句候选重新排序,[model] enabled = false 可关闭;自己的 .qjm 放 ~/.local/share/qingjian/model/ 优先使用,见 本地整句模型。
[general] shift_letter = "compose" 让 Shift 大写字母参与中文组句,默认 "passthrough" 保持临时英文输入。
scheme = "zhuyin" 启用大千注音;双拼下 Shift + V / Shift + U 可进入表达式 / 码点输入。
数字没有对应候选时继续输入,英文直输内容以空格结束时保留空格;英文候选开启后可用数字、翻页键、空格或 Tab 选词。
具体规则见 按键与快捷键。
Fcitx5 识别为敏感输入时,可以组句但不会保存输入文本或学习;识别为密码框或禁用输入法的输入框时直接交还应用。
保护依赖应用和其输入支持正确传递标记;本机已验证 Qt6 的敏感标记,GTK4 的动态 PRIVATE 提示尚未传递为敏感输入标记。
普通输入的学习与日志遵循配置。学习数据保存在 ~/.local/share/qingjian,运行日志保存在 ~/.local/state/qingjian/logs。
设置了 XDG_CONFIG_HOME、XDG_DATA_HOME、XDG_STATE_HOME 时分别使用对应目录下的 qingjian。
更新和卸载
结束手动启动的青简服务,重复执行安装命令,然后重启 Fcitx5 和青简。安装会检查文件归属;目标文件被手动修改时会提示保留,请先备份处理。
apps/linux/scripts/uninstall.sh
# 自定义安装位置时:
apps/linux/scripts/uninstall.sh --prefix /安装时的绝对目录
卸载后手动结束青简服务并重启 Fcitx5。卸载保留配置、个人词库、学习数据、已修改的安装文件和其他输入法。