建议按以下顺序阅读:
- 当前源码基线:当前分支源码、入口、删除项、限制和验证状态。
- 后端能力事实清单:区分已实现、环境可执行、真实验收、已接线和受限能力。
- 主链路契约 v1:桌面端到后台任务的最小稳定流程。
- Task Execution V1:统一执行器、生命周期、取消、重提和 Artifact 归属。
- 数据结构契约 v1:请求、任务、错误、执行配置和产物字段。
- Provider 与设置契约 v1:能力、设置、凭据和运行前检查。
- Provider / Model 轻量接入流程:新增引擎或模型时使用的最小检查清单。
- 多引擎支持现状:区分已接线、当前环境可执行和真实主链路验收。
- 运行环境隔离进度:记录隔离运行时的当前边界和剩余 TODO。
- 兼容与迁移说明:当前实现与目标契约的差异及迁移顺序。
契约描述目标边界,源码基线描述当前事实。两者存在差异时,不应猜测;先在兼容说明登记,再通过测试和源代码确认。
- 领域边界总览:输入、任务、Pipeline、Provider、文本资产和产物预览的责任划分。
ASR、TTS、LLM 等能力统一按 Provider 类别扩展,不再分别维护重复的跨层契约。
已完成计划、历史快照和旧设计已从工作树删除,需要追溯时查看 Git 历史。
设计草案用于讨论后续能力,不自动代表已经实现;草案中的 API 和字段必须以当前契约和源码为准。