Files
openless/docs/linux-egui-handoff
Chris233 fc38edd1a3 refactor: consolidate Core 2.0 and restore cross-platform behavior (#1019)
* refactor: split Linux egui host from shared backend

* fix: keep CI contracts portable across runners

* fix(ci): preserve CRLF while removing qwen dependency

* fix(ci): regenerate target lockfile and install ripgrep

* fix(ci): gate desktop-only selection voice module

* ci: limit native build parallelism on cross-platform runners

* fix(host): expose blocking task seam to coordinator

* fix(settings): avoid macOS default hotkey collision

* docs: record cross-platform CI evidence

* ci: expose Linux validation package artifact

* ci: grant reusable Linux package permissions

* refactor: remove legacy coordinator dictation facade

* ci: skip unsupported MSI prerelease builds

* ci: install minisign only for signed Linux releases

* fix: keep test-only coordinator session helper

* refactor: move style preview diagnostics into core

* fix: import shared preferences type from core

* refactor: centralize enabled vocabulary projection

* ci: install ripgrep for Linux package gates

* test: make source contract line-ending agnostic

* fix: keep Linux desktop entry standards compliant

* docs: expose core style diagnostics contract

* ci: resolve Linux package version in app directory

* refactor: centralize ASR vocabulary priority

* fix: use shared vocabulary note constant

* refactor: keep vocabulary priority inside core

* test: retain starting-stop queue coverage

* ci: scope Linux updater URL to the current repository

* docs: close implementation and artifact evidence

* docs: record final CI artifact evidence

* fix(android): align updater plugin versions

* fix(android): pin updater crate exactly

* refactor(core): remove unused type anchor

* docs: record final artifact runs

* fix(remote-input): preserve beta status fields

* fix(tauri): finish beta host merge

* fix(asr): pass scoped operation to native qwen adapter

* fix(macos): bundle mlx metallib as a resource

* test(remote-input): update status wire contract

* feat: share Less Computer voice flow with Linux

* refactor(core): centralize host-independent runtime policy

* refactor(core): complete 2.0 backend consolidation

* fix(ci): prepare Sherpa after cache restore

* fix(macos): route native model paths through Core store

* fix(macos): use ModelStore catalog API

* fix(ci): serialize macOS native test build

* test(ci): preserve macOS cargo diagnostics

* fix(macos): release input source lock before await

* test(core): replace legacy hotkey injection gate

* test(core): move Codex sandbox contract into Core

* fix(core): close final runtime policy gaps

* fix(windows): terminate coding agent process trees

* fix(core): complete local model migration

* fix(credentials): align Core LLM model account

* fix(core): restore 1.x parity across shared backend

* fix(android): complete shared backend stubs

* fix: close cross-platform migration review gaps

* fix: complete migration lifecycles and platform compatibility

* docs: define desktop 2.0 acceptance and Linux handoff

* fix: close desktop parity and session lifecycle gaps

* fix: finish voice lifecycle and desktop feedback parity

* fix: close desktop cancellation and feedback race gaps

* fix: honor proxy settings and reject stale session effects

* fix: dispatch native cleanup on host runtimes and order events

* fix: keep optional recording effects best effort

* fix: close desktop agent model and QA lifecycle gaps

* fix: preserve desktop raw voice and QA turn ownership

* fix: finalize desktop dictation and QA feedback
2026-09-06 18:39:46 +08:00
..

Linux egui 接入交接

更新:2026-09-06;接口以本目录所在提交的代码为准。初始缺口盘点基于2b315572,后续资源生命周期与VoiceState合同更新见01/06。需求依据:2.0范围。

本批2.0完整交付Windows/macOS。Linux交付共享Core及接入资料;egui团队负责余下Linux Host、UI、集成和Linux发布验收。 已有linux-egui代码和包构建是可复用起点,不等于Linux产品已完成。

阅读顺序

文档 回答什么问题
01 Core接入合同 从哪里接、哪些规则归Core、生命周期和秘密边界
02 缺口与实施顺序 当前Linux还缺什么、由谁做、依赖顺序和关闭标准
03 全局热键与窗口 三类1.x X11热键缺口及原生注册、恢复和窗口效果
04 页面与领域操作 已有页面能做什么、哪些Core能力尚缺操作入口
05 原生宿主与数据 音频/插入/凭据/模型/进程/托盘/更新的接入与验证
06 事件与会话 sequence、重放、Unicode增量、QA/Agent和取消时序
07 验收与证据 自动命令、设备矩阵、Linux发布条件和回报模板

工作规则

  • 先复用现有Core和Linux Adapter;不复制Tauri业务、不让UI读取秘密或私有Coordinator状态。
  • Linux系统功能由团队实现Host Adapter,egui框架只提供UI能力,不会自动注册全局热键或管理系统服务。
  • Core接口不足:带最小复现、所需业务语义和期望事件回报Core负责人;不要在UI临时补另一套规则。
  • 文档中的“已有”仅表示本快照有相应代码/合同;设备与发布证据单独确认。
  • 任务关闭时更新缺口登记及对应小文档,附准确commit、测试和设备结果。

入口文件

旧的长接口文档与阶段计划保留历史参考;范围冲突以新需求和本目录为准。