feat(linux): fcitx5 候选框听写状态提示 + AppImage 插件自动安装 + 热键启动容错

[aeoform]

User description

概述

Linux 上通过 fcitx5 输入法候选框下方显示听写状态文字，替代 macOS/Windows 的胶囊窗口。同时修复 AppImage 不含 fcitx5 插件、热键启动时序等问题。

改动

fcitx5 插件 (openless.cpp)

• 新增 SetAuxDown/ClearAuxDown DBus 接口
• 6 种状态提示：🎤 收音中 → 🔄 识别中 → ✨ 润色中 → ✅ 已插入 / — 已取消 / ❌ 出错
• InputContextFocusIn 监听：切窗口自动跟随焦点
• 优先当前焦点 IC，失焦 IC 降级兜底
• flushUI 先排空旧事件再设 auxDown，防止按键竞态覆盖

热键启动容错 (linux_fcitx.rs)

• start_dictation_signal_listener 启动时等待 fcitx5 最多 30s
• 监听 NameOwnerChanged，fcitx5 重启后自动重新同步快捷键

AppImage 插件自动安装

• CI 将 libopenless.so 打入 AppImage 资源
• 启动时检测插件缺失 → 自动安装到 ~/.local/lib/fcitx5/ 和 ~/.local/share/fcitx5/addon/
• deb/rpm 仍通过 files 映射安装到系统路径

其他

• Linux 胶囊窗口不显示，状态完全走 fcitx5 输入面板
• coordinator.rs / dictation.rs 移除冗余调用，统一文案

测试

• fcitx5 候选框下方显示听写状态
• 切换窗口状态跟随焦点
• fcitx5 后启动时热键自动补同步
• AppImage 首次启动自动安装插件到 ~/.local/

🤖 Generated with Claude Code

---

PR Type

Bug fix, Enhancement, Tests

---

Description

• Show Linux status in fcitx5

  • Render dictation state via auxDown
  • Follow focus changes across windows

• Auto-install bundled AppImage plugin

  • Copy plugin into ~/.local/
  • Avoid overwriting system installs

• Resync hotkeys after fcitx5 restarts

  • Wait for fcitx5 startup
  • Watch NameOwnerChanged events

• Fix duplicate DashScope transcripts

  • Track finals by sentence_id
  • Ignore interim end_time: 0

---

Diagram Walkthrough

flowchart LR
  ASR["DashScope realtime ASR"] -- "dedupe interim/final segments" --> Transcript["Clean final transcript"]
  AppImage["Linux AppImage bundle"] -- "auto-install plugin on startup" --> Local["~/.local/fcitx5 plugin files"]
  Coordinator["Linux coordinator"] -- "send auxDown status" --> Fcitx["fcitx5 plugin"]
  Fcitx -- "hotkey events and focus sync" --> Coordinator

Loading

File Walkthrough

	Relevant files
Bug fix	1 files bailian.rs Deduplicate final ASR segments by sentence                              +19/-5
Enhancement	3 files coordinator.rs Route Linux status and hotkey syncing                                        +98/-8    linux_fcitx.rs Add auxDown API and restart resync                                              +204/-1  openless.cpp Add status text and focus handling                                              +83/-8
Documentation	1 files dictation.rs Remove redundant Linux polish status note                                +3/-0
Configuration changes	2 files lib.rs Install fcitx5 plugin during startup                                          +5/-0      release-tauri.yml Bundle Linux plugin resource in AppImage                                  +4/-3

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 1b0e41c)

Here are some key observations to aid the review process:

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Plugin Overwrite Startup now always copies the bundled plugin into ~/.local/lib/fcitx5/ and rewrites the addon config whenever the resource exists. That means an existing user-installed copy in ~/.local gets replaced on every launch, which can downgrade or clobber a newer/local build instead of only installing when the plugin is missing. if let Err(e) = std::fs::create_dir_all(&lib_dir) { log::warn!("[fcitx-install] Failed to create {:?}: {e}", lib_dir); return; } if let Err(e) = std::fs::create_dir_all(&addon_dir) { log::warn!("[fcitx-install] Failed to create {:?}: {e}", addon_dir); return; } let so_dest = lib_dir.join("libopenless.so"); if let Err(e) = std::fs::copy(&so_src, &so_dest) { log::warn!("[fcitx-install] Failed to copy plugin .so: {e}"); return; } log::info!("[fcitx-install] Installed plugin .so to {:?}", so_dest); let config_content = format!( concat!( "[Addon]\n", "Name=OpenLess\n", "Name[zh_CN]=OpenLess 听写辅助\n", "Comment=OpenLess dictation commit helper\n", "Comment[zh_CN]=供 OpenLess 听写提交文字的 DBus 接口及快捷键监听\n", "Category=Module\n", "Type=SharedLibrary\n", "Library={}\n", "Version=1.0.0\n", "OnDemand=False\n", "Configurable=False\n", "\n", "[Addon/Dependencies]\n", "0=core\n", "1=dbus\n", ), so_dest.display() ); let conf_dest = addon_dir.join("openless.conf"); if let Err(e) = std::fs::write(&conf_dest, &config_content) { Aux Race Each capsule state change spawns a detached thread to call set_aux_down or clear_aux_down, but there is no ordering/cancellation between those calls. On quick state transitions, an older send can arrive after a later clear or update and reintroduce stale text in fcitx5, for example showing 🎤 收音中... after dictation has already ended. // 把 DBus I/O 移到独立线程：emit_capsule 会被音频回调线程 // (cpal) 调用，同步阻塞可能导致录音卡顿或可闻杂音。 let text = t.to_string(); std::thread::spawn(move || { if let Err(e) = crate::linux_fcitx::set_aux_down(&text) { log::warn!("[capsule] set_aux_down failed: {e}"); } }); // 首次设置（从 None 转为有值）时，fcitx5 可能还在处理触发 // 快捷键的按键事件（press/release），这些事件可能覆盖 auxDown。 // 延迟 300ms 重设一次确保状态不被竞态覆盖。 // 重设前检查 LAST_AUX：如果状态已经变了则跳过，避免旧文字覆盖新状态。 if was_none { let text = t.to_string(); std::thread::spawn(move || { std::thread::sleep(std::time::Duration::from_millis(300)); let current = LAST_AUX.lock().unwrap().clone(); if current.as_deref() != Some(&text) { log::info!("[capsule] set_aux_down retry skipped: state changed to {current:?}"); return; } log::info!("[capsule] set_aux_down retry: {text}"); if let Err(e) = crate::linux_fcitx::set_aux_down(&text) { log::warn!("[capsule] set_aux_down retry failed: {e}"); } }); } } None => { log::info!("[capsule] clear_aux_down"); // 同样从音频线程挪走，避免阻塞。 std::thread::spawn(|| { if let Err(e) = crate::linux_fcitx::clear_aux_down() { log::warn!("[capsule] clear_aux_down failed: {e}"); } });

[github-actions]

Persistent review updated to latest commit 7635df5

[github-actions]

Persistent review updated to latest commit 7403597

[github-actions]

Persistent review updated to latest commit c4cb3c9

[github-actions]

Persistent review updated to latest commit 163327e

[github-actions]

Persistent review updated to latest commit 163327e

[github-actions]

Persistent review updated to latest commit 77455cf

[github-actions]

Persistent review updated to latest commit 1b0e41c

[aeoform]

在测试里我没发现相关问题