升级前
记录当前源码 revision 或分发版本、锁文件、SDK 版本、迁移清单和部署配置。本地构建不自动成为具名公开发布版本,不要自行发明 release 名称。 完成或取消活动 Run,关闭 Session 并确认云清理。保留待调查操作记录;若仍有未知结果,先对账。在离线状态创建完整匹配备份,并确认有旧代码可用于恢复。 不要指望新 worker 兼容任何历史 invocation。涉及凭据边界、Runtime 协议或 Harness 行为的变更,可能需要创建新 Session;先阅读相应迁移说明。执行升级
在保留旧分发的独立目标中准备新代码,安装其锁定依赖。local 受管理启动会运行迁移:npm run db:migrate,再启动对应服务;hosted 身份与密钥仍按部署要求提供。不要在新旧服务同时管理同一部署的情况下凭经验切换版本。
迁移在数据库事务和 advisory lock 下执行。已应用迁移的 checksum 改变会被拒绝;数据库包含当前代码未知的迁移时返回 database_schema_newer_than_code。不要通过删除迁移记录或编辑旧 SQL 来让检查通过。
升级后检查
- 服务身份、数据库与密钥匹配,管理和凭据入口可用。
- 历史 Session 初始化、Run、事件和产物仍可读取。
- 新 Session 使用预期 Harness / 模型 / Provider 组合完成任务。
- 两个 SDK 对受影响契约分别检查,涉及完整旅程变更时分别实云验证。
- 私有预览、授权 / 审批和清理按此次变更范围复查。
保存精确的升级版本对
记录源、目标发行包内容指纹,可用时保存各自release.json 元数据、锁文件哈希、已应用迁移名称/checksum、SDK 包版本及备份 manifest。内容指纹不是 Git revision 或签名发布。保留旧发行包本身,目录名不能重建它。
11 月 18 日本地发行包演练记录了恢复数据库在较新编译发行包上启动、历史内容与解密保留,以及后续独立云任务。它不定义通用的正式版本升级矩阵。在实际运行的源/目标构建对与验证结果建立关联前,将其作为有范围的流程实例,并保存自己升级的版本对。
本次演练保留的构建清单可识别以下未发布构建指纹:
恢复工作区后的 Python 与 TypeScript 记录均通过产物验证并确认清理。云任务发生在最终构建之前,其中 TypeScript 旅程于 13:04:39 UTC 开始,因此不能将这些任务标成
beta-delivery 的执行结果。矩阵没有绑定当时服务进程的精确构建指纹。这是一条已验证的安装、恢复与升级流程实例,其中恢复的 27 张表行数与哈希一致,不是独立认证的最终构建版本对。下一次升级应将实际运行的源/目标指纹与新任务结果共同记录,再声称该精确版本对通过。