zizi 0260bcd8e2 设计文档:SoT 同步与生成物重出
- 新版设计各域 SoT 按本轮实现同步:总体架构、模块设计、接口契约、数据模型、功能规格、文件设计与决策记录。
- 接口契约生成物重新导出(openapi 与前端客户端随契约一致)。
- 实现回顾与专项检查台账保留历史结论;本轮收尾发现另见 .agents.local 下的收尾报告与审查处置。
2026-09-18 01:15:18 +08:00

5.0 KiB
Raw Blame History

优化执行合同

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及迁移隔离等完整结果。

新机制迁完消费者后清除被替代路径、无用途配置与测试;历史目标文件镜像冻结为追溯,不再要求随当前文件移动逐项同步。旧任务、凭据、草稿、授权和回执不静默重绑或重写。数据已产生后采用前向修复或只读维护,不用源码回退许诺任意旧程序写兼容。