运行版本清单

记录一次执行所依赖的模型、规则、工具与数据版本。

运行版本清单把一次结果关联到实际执行条件。只记录model ID或prompt名称不足以重现Agent，因为SDK、工具、检索、memory政策和验证器都可能变化。清单是追踪与发布合同，不是保证模型随机输出逐字相同的承诺。

发布时固定的配置包括provider、模型ID或snapshot、推理和采样设置、prompt模块hash、runtime commit、工具schema、workflow、memory政策、检索器配置、verifier与sandbox镜像。动态数据另按Run记录corpus/index generation、source_version、as_of和授权代次；不能为了冻结发布而冻结ACL或继续使用已撤回资料。

输入记录可保存受限快照和内容引用，不需把敏感全文复制进每条日志。产物回溯时应能定位当时实际渲染的prompt、用过的证据、计算工具版本和审批参数。若外部源无法完整留存，明确可复现范围及读取日期，不能把当前页面内容冒充当时证据。

清单还应记录限制：供应商别名不可固定、某原生工具没有版本号、数据接口会追溯修订。对这些变化设哨兵和异常调查，而不是填一个看似精确但不存在的版本。缓存、路由与fallback也会影响执行，应纳入实际Run轨迹。

升级与回滚必须考虑兼容性。旧runtime可能读不了新checkpoint，新工具可能改变字段含义，模型opaque context也可能不可迁移。应决定让在途任务沿旧版本结束，还是提供显式迁移；不能只把deployment指针改回去就声称所有状态已恢复。

一个好的清单使审查者可以回答：这个结论基于哪份资料，哪个计算或模型生成，按哪条规则批准，验证过什么。它并不要求展示私有思维链，而是保留可供外部检查的输入与效果。

清单应由系统在运行时生成，避免事后靠人工回忆填写。用户修订目标或权限改变时，追加新的状态边界而非覆盖原记录；这样才能区分历史事实与当前有效条件。

实践重点：配置随发布固定；corpus/index generation、as_of与ACL按Run记录和重验。

验证抓手：从trace还原模型参数、prompt、工具和证据版本。

常见误区：把动态授权冻结，或只记模板名无法定位真实输入。

Codex：turn与step循环源码；OpenCode：session_v2与消息表源码。