chore(linux): fcitx5 插件打包注入 + 清理 rdev 残留 + 声明系统依赖

[aeoform]

User description

变更

fcitx5 插件：运行时复制 → 打包时注入

• ensure_plugin_installed 精简为版本检查（比对 bundled 与系统安装的 .so 文件大小），不做任何文件 I/O
• 新增 scripts/inject-fcitx5-plugin.sh，支持 deb/rpm/AppImage，在打包后将 .so + .conf 注入系统 fcitx5 路径
• fcitx5 addon config 使用 Library=libopenless（CMake 生成），由 fcitx5 自行搜索库路径

清理 rdev 残留

• hotkey.rs：移除模块文档和 Linux adapter 中的 rdev 相关注释和日志
• permissions.rs：移除 rdev 引用
• unicode_keystroke.rs：移除 feedback_rdev_macos_trap.md 引用

声明 Linux 系统依赖

• tauri.linux.conf.json 为 deb/rpm 添加 depends（libasound2, libdbus-1-3, libssl3, webkit2gtk, libsoup3）和 recommends: fcitx5
• 安装包时会自动拉取缺失的运行时依赖

构建辅助

• package.json 添加 prebuild 脚本，自动复制 fcitx5 插件文件到 src-tauri/ 供 Tauri resources 打包
• .gitignore 忽略打包用的 .so 和 .conf 副本

🤖 Generated with Claude Code

---

PR Type

Enhancement, Bug fix

---

Description

• Move fcitx5 plugin installation to packaging

• Simplify Linux plugin checks to path validation

• Declare Linux runtime dependencies for bundles

• Remove stale rdev-related comments and references

---

Diagram Walkthrough

flowchart LR
  A["Packaging script"] -- "injects plugin files" --> B[".deb / .rpm bundles"]
  B -- "installs to system paths" --> C["fcitx5 addon + library"]
  D["Runtime checks"] -- "verify paths only" --> E["Linux startup logs"]
  F["Code comments"] -- "remove rdev references" --> G["Hotkey / permission docs"]

Loading

File Walkthrough

	Relevant files
Bug fix	hotkey.rs Remove Linux rdev hotkey references                                            openless-all/app/src-tauri/src/hotkey.rs Shortens platform docs by removing rdev caveats. Updates Linux adapter comments to describe fcitx5 only. Tweaks placeholder adapter wiring and startup log wording. +6/-9      linux_fcitx.rs Replace runtime plugin copying with checks                              openless-all/app/src-tauri/src/linux_fcitx.rs Removes the old HOME-based plugin copy routine. Replaces it with system-path existence checks only. Warns when the addon config or .so is missing. Keeps startup free of file I/O and mutations. +27/-74
Documentation	permissions.rs Clean up rdev permission comments                                                openless-all/app/src-tauri/src/permissions.rs Removes rdev from Windows permission documentation. Simplifies Linux accessibility notes to avoid adapter-specific wording. +2/-2      unicode_keystroke.rs Trim obsolete macOS trap references                                            openless-all/app/src-tauri/src/unicode_keystroke.rs Removes the feedback_rdev_macos_trap.md mention. Keeps the macOS threading warning focused on TSM/TIS behavior. +1/-2
Enhancement	inject-fcitx5-plugin.sh Add package-time fcitx5 injection script                                  openless-all/scripts/inject-fcitx5-plugin.sh Adds a shell script to inject plugin files into .deb and .rpm. Places libopenless.so and openless.conf into system fcitx5 paths. Detects Debian multiarch paths and RPM 64-bit library paths. Fails clearly when packaging tools are unavailable. +69/-0
Configuration changes	tauri.linux.conf.json Declare Linux bundle runtime dependencies                                openless-all/app/src-tauri/tauri.linux.conf.json Adds Debian package dependencies for audio, DBus, SSL, and WebKit. Adds RPM equivalents for the same runtime libraries. Marks fcitx5 as a recommended package for Linux bundles. +28/-0

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 28ef332)

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 2 🔵🔵⚪⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review AppImage Regression Removing the runtime copy logic leaves no fallback path for AppImage or other portable builds. The new check only verifies files already exist in system locations, and the injection script explicitly skips AppImage, so those builds will start without the fcitx5 plugin if they are still distributed. /// 检查 fcitx5 插件是否已安装到系统路径。 /// /// 所有 Linux 格式（deb/rpm/AppImage）的插件安装都在打包时完成 ///（`scripts/inject-fcitx5-plugin.sh`），此处仅确认文件存在。 /// 未安装时输出警告，不做任何文件 I/O。 #[cfg(target_os = "linux")] pub fn ensure_plugin_installed(_app: &tauri::AppHandle) { // fcitx5 在不同发行版的 lib 路径不同 let lib_dirs = [ "/usr/lib/x86_64-linux-gnu/fcitx5", // Debian multiarch "/usr/lib64/fcitx5", // RPM 64-bit "/usr/lib/fcitx5", // 通用回退 ]; let system_conf = std::path::Path::new("/usr/share/fcitx5/addon/openless.conf"); if !system_conf.exists() { log::warn!( "[fcitx] fcitx5 addon config not installed at {:?}. \ The OpenLess package may be incomplete.", system_conf ); return; } let found = lib_dirs.iter().any(|dir| { std::path::Path::new(dir).join("libopenless.so").exists() }); if !found { log::warn!( "[fcitx] fcitx5 plugin .so not found in any of {:?}. \ The OpenLess package may be incomplete.", lib_dirs ); } }

[github-actions]

Persistent review updated to latest commit 2bd733e

[github-actions]

Persistent review updated to latest commit 0e5f90b

[github-actions]

Persistent review updated to latest commit 71a3634

[github-actions]

Persistent review updated to latest commit f5bf1ff

[aeoform]

AppImage 不支持的原因

AppImage 是自包含便携格式，没有"安装"步骤。fcitx5 作为 host 系统输入法框架，从 AppImage 挂载点内部无法加载插件 .so——文件必须在 host 的真实文件系统路径上。因此 fcitx5
插件注入仅支持实际安装到系统的 deb/rpm。

[github-actions]

Persistent review updated to latest commit 28ef332

[aeoform]

如果插件出现错误，我觉得很可能是正常方式无法安装，应该让用户手动安装

[aeoform]

appimage老年是便携，但是现在必须安装插件，不符合appimage的初衷，fcitx插件现在有一些问题，我打算等这个pr合并后，明天晚上再改一下，现在如果openless返回错误，那么必须重启输入法才可以消除提示否则一直跟随焦点