0260bcd8e2
- 新版设计各域 SoT 按本轮实现同步：总体架构、模块设计、接口契约、数据模型、功能规格、文件设计与决策记录。 - 接口契约生成物重新导出（openapi 与前端客户端随契约一致）。 - 实现回顾与专项检查台账保留历史结论；本轮收尾发现另见 .agents.local 下的收尾报告与审查处置。
40 lines
5.0 KiB
Markdown
40 lines
5.0 KiB
Markdown
<!-- 导航元信息: {"内容描述": "已裁定范围与跨包接口、归属、验证及退出条件", "使用场景": "实施全仓优化时", "使用要求": "设计裁决不代表实现已验收"} -->
|
||
# 优化执行合同
|
||
|
||
2026-09-17 用户裁决后开始实施。本文固定跨包合同和范围，不代表功能已通过验收；各能力的当前行为仍由所属模块说明、源码与测试证明。O00～O13按各自完整结果交付，O14验证跨包接缝；未通过独立四维审查的L3批次不登记完成。
|
||
|
||
## 已裁定范围
|
||
|
||
- 独立两名初评及第三仲裁保留。用户候选为 `glm5.3flash`、`minimaxm3`、`qwen3.8flash`，精确API身份与独立性尚待核验，不直接替换角色策略白名单。
|
||
- 方法按用途评价，目标收益与保护维度分开；既有样本底线保留，未经标定的目标政策保持draft。
|
||
- 在线升级既有结构对象单独立项，本期只处理在用版本、绑定与投影。
|
||
- 云OSS备份单列后续，本期只处理raw工作文件及发布缓存生命周期；不新建本地或内网备份策略，也不自动迁移或删除现存备份。
|
||
- 旧知识缺可靠作品、用途或授权映射时隔离；不伪造源表列，不把空输入核对称为成功迁移。
|
||
- 工程采用源派生索引、分层验证、共享迁移底座与隔离测试库、有界连接。实施不授予Git暂存提交、真实数据迁移、生产切换或外部模型调用权限。
|
||
|
||
## 跨包合同
|
||
|
||
|
||
这些合同由O00的集成维护者形成一份简短执行决定，后续源码和测试只消费这一决定，不各自建立平行规则。
|
||
|
||
|合同|明确选择|负责人/消费者|
|
||
|---|---|---|
|
||
|C1 调用事实与任务执行|调用可在任务取消后补费用/证据；结算入口不发模型请求、不改变任务终态。执行最终游标与账目accounting_revision分开，终态关闭执行SSE后费用可按回执/显式刷新读回。配置草案探针只获零工具、限额度的验证能力，复用正常调用治理核心|S02；配置管理、HTTP/CLI、恢复UI|
|
||
|C2 多种身份的职责|构建身份=安装完整性与追溯；效果依赖指纹=资格适用性；来源授权版本=未来读取权限；业务revision=内容变化。不能一个全局hash兼任全部失效条件|发布、B10、B03、S01共同签定，各自单一owner|
|
||
|C3 资源提供接缝|生产启动只接受实际包资源；隔离测试显式注入小包/源资源。测试身份不成为正式发布资格，缺生产资源不隐式fallback。提供器接口先冻结，O04和O06不互相等待实现|发布资源维护者；启动、测试与运行资源|
|
||
|C4 读取合同|摘要只含身份/状态/版本/必要大小；详情才取正文/diff。游标绑定稳定排序、过滤与作用域；当前授权逐阶段复核。整体结构/字节损坏blocked，单项不可消费明确partial/排除；常规方法写入经同事务派生参与者自动维护索引，不以全局catalog_revision变化阻塞无关搜索，不伪装完整结果|各数据owner；B09、B05/B08、Web|
|
||
|C5 测试与验收来源|Python case_id写在源marker/参数行；前端稳定ID写在既有test声明或明确元信息。当前位置从收集派生；人工语义逐字段保全，不自动编造then。旧ID与结果仍可查|测试身份唯一维护者；工具/CI|
|
||
|C6 数据回收|保留/过期/撤权/物理删除分开；回收计划绑定对象ID、版本、哈希、策略版本与受保护引用集合，执行前再核对；未知对象和未解决迁移状态不盲删|各资产owner，维护命令统一呈现|
|
||
|C7 接口与数据库演进|新读接口增量接入、同一发布内迁客户端；需要兼容旧标签页/待确认命令时提供有期限的明确桥。新DDL由唯一集成者编号；旧45条字节冻结；有新数据状态后不能承诺任意旧程序写兼容|集成维护者；接口生成、DB迁移、各域|
|
||
|
||
|
||
## 共享文件归属
|
||
|
||
工程发布维护者独占Makefile、CI、pyproject、资源登记与生成器、测试身份发现及顶层fixture；运行维护者独占启动与连接provider；前端维护者独占候选审阅与编辑缓冲；数据库集成者分配新DDL编号，原45个SQL字节冻结。各线在可核验相同基线的隔离工作树修改，总集成者三方承接差异。
|
||
|
||
## 证据与退出
|
||
|
||
开发期只验受影响行为；批次稳定后集中门禁和独立四维审查。离线替身、隔离PG、安装包、浏览器、真实模型及恢复证据分别记录，任何一种均不冒充另一种。整体验收必须覆盖调用取消补账、分支缓冲、撤权与有界读取、默认评测可满足性、无包开发测试、真实wheel及迁移隔离等完整结果。
|
||
|
||
新机制迁完消费者后清除被替代路径、无用途配置与测试；历史目标文件镜像冻结为追溯，不再要求随当前文件移动逐项同步。旧任务、凭据、草稿、授权和回执不静默重绑或重写。数据已产生后采用前向修复或只读维护，不用源码回退许诺任意旧程序写兼容。
|