2.0 稳定化
2.0.0 是未来的稳定版本,不能成为未完成 1.x 承诺的收纳箱。只有延期能力已经交付或从
产品契约中明确移除,2.0 才应开始。
有顺序的开发计划
Section titled “有顺序的开发计划”| 顺序 | 工作 | 退出条件 |
|---|---|---|
| 0 | 关闭或缩减 1.x 缺口 | 真机、codec 回退、长会话、字幕、分析、WebGPU 都有明确的“交付/延期”决定 |
| 1 | 定义 Project v2 与迁移 | 在 v2 authoring API 之前先具备不可变 Schema ID、兼容 fixture、确定性 v1→v2 迁移和版本化损失报告 |
| 2 | 定义 Render IR v2 桥接 | Project 继续作为持久编辑模型,Render IR 继续作为执行模型;两者的版本化编译边界有 golden 语义测试 |
| 3 | 整理包边界 | 所有权、依赖方向、exports 和弃用策略有文档,并通过真实包消费者测试 |
| 4 | 验证框架与宿主集成 | 参考集成证明包边界与生命周期 API 能在仓库测试之外工作 |
| 5 | 冻结公共 API | 只有 Schema、IR、包边界和集成都被实际验证后才冻结 API snapshot |
| 6 | 全量认证并稳定发布 | 对同一源清单完成设备矩阵、golden、soak、安全、包复现和迁移 replay |
不可妥协的设计规则
Section titled “不可妥协的设计规则”- Project 与 Render IR 不合并成同一个对象模型:前者持久且可编辑,后者不可变、规范化且面向执行。
- 每个 Schema 修订都使用新的不可变 URI 与版本;已经发布的身份绝不原地修改。
- 先迁移,后移除;无法支持的内容失败关闭,并产生机器可读的损失报告。
- API 冻结必须晚于真实消费者集成,不能早于它。
- 只有完整绑定证据集和独立 blocker review 通过后,
latest才能移动到 2.0。