sim
34cab16fce
保留目录骨架与文件名，内容全部以当前源码为依据重写：范围与版本锚点 （2.0.0-Beta.1 / crate 0.1.0 / com.openless.app）、架构分层与 Core 模块地图、 桌面验收清单（功能域→源码入口→证据）、Linux 交接 8 篇（沿用 L01-L12 登记体系， 锚点落到 settings.rs/audio.rs/ports.rs 等）、后端接口契约、Android 计划、 运营指南 5 篇（以 provider descriptor 与实际 CSP/.gitmodules 为锚）。 原过程中的计划叙述、截图与历史收口记录不再保留。
2.2 KiB
2.2 KiB
Linux 接入交接总览
状态：canonical（2026-09-07 以源码为准重写，基线 openless-linux-egui + Core 639c2fbf 后的 beta）；更新：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_state.rsPage枚举 10 页（Start/Dictation/Qa/Selection/Agent/Services/Models/Remote/History/Settings），主循环main.rs。 - 打包：
release-linux-egui.yml（deb/rpm/AppImage，独立 manifest）。
3. 阅读顺序
- 01 Core 合同：可调用的 Core 面与合同文件。
- 02 缺口登记：L01–L12 现状、责任与关闭标准（推进主表）。
- 03 热键与窗口、05 原生宿主与数据：接线缺口细节。
- 04 页面与领域：10 页现状与界面缺口。
- 06 事件与会话：订阅、重放、取消语义。
- 07 验收：两个完成门与证据要求。
接口细节见后端契约；长接口与历史实现参考保留在契约文档。