Integrate the reviewed 2.0 PRs and local fixes from 03136853. Preserve the verified subtitle behavior and model/runtime corrections. Keep the numeric Beta tag compatible with released clients while exposing the date as application build metadata. Co-authored-by: DepengWang <2818245+DepengWang@users.noreply.github.com> Co-authored-by: HKLHaoBin <we3q@qq.com> Co-authored-by: Nahida <1139500183@qq.com> Co-authored-by: TRIP <1933142963@qq.com> Co-authored-by: chyuwei <weichangyuwcy@gmail.com> Co-authored-by: leonoxo <leonoxo@gmail.com> Co-authored-by: tayir <arnoldincredible@126.com>
Linux 接入交接总览
状态:canonical;更新:2026-09-11。当前基线 867a0d8ce746c64cadc1be68fead98d9838b9f15,实现分支 Linux-egui。
当前实现、构建和安装说明以 08 Linux-egui 2.0 交付记录 为准,L01–L12 的实现/自动检查/人工验收分别见 02 状态表。03–07 保留原始交接合同,里面的 2026-09-07 缺口描述是历史基线,不能代表本分支现状。
1. 责任与范围
Linux Host Adapter 的剩余实现、全局热键、窗口/托盘/权限/更新等宿主效果、egui 界面与 Linux 产品验收由 egui 团队承接;共享业务全部在 openless-core,发现业务接口缺项时回报 Core 负责人,不在 UI/Host 复制规则。Linux 产品完成度不阻塞 Windows/macOS 交付(见范围)。
2. 已有起点(直接复用,不另建第二套后端)
- 组装:
linux-egui/src/backend.rs—LinuxBackendBuilder::from_shared_providers(BackendConfig)+with_*注入(recorder/polisher/inserter/credential store/host actions/settings runtime/local ASR runtime/polish failure policy)。 - Host 门面:
lib.rsLinuxHost—snapshot/subscribe/save_settings/update_settings_strict/drain_events/backend()。 - 已实现模块:
audio.rs(CPAL 录制)、credentials.rs(Secret Service)、fcitx5.rs(输入/选区)、hotkeys.rs(fcitx5 热键监听)、selection.rs、qa.rs、coding_agent.rs、marketplace.rs、remote_input.rs、settings.rs、single_instance.rs、capabilities.rs、resources.rs、runtime.rs、ui_state.rs。 - 页面:
ui/frontend/view_model.rs八个主页面,ui/settings.rs七类设置;host_*.rs负责页面异步操作和窗口生命周期,main.rs负责共享会话及事件归并。 - 打包:
release-linux-egui.yml(deb/rpm/AppImage,独立 manifest)。
3. 阅读顺序
- 01 Core 合同:可调用的 Core 面与合同文件。
- 02 缺口登记:L01–L12 现状、责任与关闭标准(推进主表)。
- 03 热键与窗口、05 原生宿主与数据:接线缺口细节。
- 04 页面与领域:原领域合同;当前页面映射见 08。
- 06 事件与会话:订阅、重放、取消语义。
- 07 验收:两个完成门与证据要求。
- 08 实施与交付:锁定基准、实际源码映射、构建证据、产物、安装与 GNOME/KDE 人工矩阵。
接口细节见后端契约;长接口与历史实现参考保留在契约文档。