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 为锚）。 原过程中的计划叙述、截图与历史收口记录不再保留。
3.1 KiB
3.1 KiB
Linux egui 后端接口契约（2.0.0）
状态：canonical（2026-09-07 以源码为准重写）；更新：2026-09-07。范围以2.0 需求为准；本文是长接口与实现参考，交接材料以交接目录为准。
1. 合同文件
openless-all/app/contract/backend-2.0.json（contractVersion 2.0.0）顶层键：
| 键 | 内容 |
|---|---|
startupSnapshot |
启动快照结构与版本校验规则；UI 必须先消费快照再渲染 |
backendEvent |
语义事件清单、顺序与重放规则 |
lessComputerVoice |
Less Computer 语音事件面 |
androidJni |
Android JNI 合同（src-tauri android 桥接共用） |
linuxFacade |
Linux 专用 facade 面（LinuxHost 公开方法对应） |
enums |
共享枚举（provider 类型、状态、错误等） |
2. Linux 侧公开签名（源码为准）
linux-egui/src/lib.rs：pub struct LinuxHost；LinuxHost::new(Arc<OpenLessBackend>)、with_settings_runtime、backend()、subscribe() -> EventSubscription、snapshot() -> BackendSnapshot、save_settings(...)、update_settings_strict(...)、drain_events(...)、feed_less_computer_pcm(&[u8])。linux-egui/src/backend.rs：LinuxBackendRuntime；LinuxBackendBuilder::from_shared_providers(BackendConfig)+with_task_spawner / with_recorder / with_auxiliary_polisher / with_text_inserter / with_credential_store / with_services / with_host_actions / with_settings_runtime / with_local_asr_runtime / with_polish_failure_policy→build() -> LinuxBackendRuntime。- 事件消费：
drain_events（lib.rs）批量取走 Core 语义事件；订阅经EventSubscription。
3. 注入接口（crates/openless-core/src/ports.rs）
AudioRecorder、TextPolisher、TextInserter、CredentialStore、SettingsRuntime、TaskSpawner、EditObservationSink/EditObservationAdapter（默认 NoopEditObservationAdapter）、LinuxHostActions。缺省实现表示"未接线"，不是"不支持"。
4. 与桌面共享
- 云 ASR/LLM/Omni/Auxiliary 实现两端共用（Core
asr/、provider_*、omni、llm_gemini）；平台 Host 只注入原生录音、凭据、窗口、进程、焦点与插入 Adapter。 - 旧 React command/event 名称只保留在 Tauri 兼容 Adapter；Linux 与 Core 同进程，经类型化 Rust Interface 调用。
- provider 公开目录：Core
provider_rules::provider_descriptors→ 生成src/lib/ipc/provider-descriptors.generated.json（cargo run --locked -p openless-core --example export_provider_descriptors）。