Files
openless/docs/linux-egui-handoff
16c3f841b5 chore(release): prepare 2.0.0-Beta.2 build 20260924
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>
2026-09-24 17:28:24 +08:00
..

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.rs LinuxHost — 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. 阅读顺序

  1. 01 Core 合同:可调用的 Core 面与合同文件。
  2. 02 缺口登记:L01–L12 现状、责任与关闭标准(推进主表)。
  3. 03 热键与窗口、05 原生宿主与数据:接线缺口细节。
  4. 04 页面与领域:原领域合同;当前页面映射见 08。
  5. 06 事件与会话:订阅、重放、取消语义。
  6. 07 验收:两个完成门与证据要求。
  7. 08 实施与交付:锁定基准、实际源码映射、构建证据、产物、安装与 GNOME/KDE 人工矩阵。

接口细节见后端契约;长接口与历史实现参考保留在契约文档。