Repository navigation
Runtime-v2.12.0
·
5 commits
to main
since this release
Runtime 2.12.0
新增 import-legacy-sessions CLI 命令(PR #93,Closes issue #88)——SDK v4 存储迁移(2.11.0)后遗留的 v3 会话档案,现在可以显式、幂等地一次性导入新 store。
✨ Features
zerone-agent import-legacy-sessions --from <dir> [--config <dir>] [--json]:- opt-in 一次性迁移:不做启动时自动迁移——受影响面为持久 HOME 的裸机部署(Docker 容器内 v3 档案随容器重建已丢);
--from显式给定源目录,规避 HOME 漂移(不猜测当前/历史 HOME) - 三态编排(SDK
importLegacySession,issue #131 P3):imported / already-exists-unknown / not-imported——目标已有 transcript 的会话自动跳过,幂等可重跑 - 失败语义:not-imported 项(档案缺失/畸形 JSON/metadata.id 不匹配/todos 阻断)零提交——修复档案后重跑即恢复;命令体 try/catch 收敛失败面,不污染入口错误
- 退出码契约(脚本化迁移可依赖,docs 已载):
0= 全部 imported/已存在;1= 存在 not-imported 或命令失败;2=--from缺失或非已存在目录 - 源预检 + 杂项过滤:
--from不存在/非目录 → USAGE(不与真实空目录混淆);.DS_Store等非目录条目不进报告、不翻转退出码 - v3 metadata 保真:
cwd/model等 v4 原生写入恒空的字段,经导入路径保留 - 编排细节:per-session
importLegacySession循环 +readdir withFileTypes(runtime 侧编排而非 SDKimportLegacyArchive——后者对 readdir 失败静默返回全零报告,无法区分「源不可读」与「无事可导」) - 文档:
docs/configuration.md「Session storage → v3 → v4 migration」补用法、幂等/失败语义与退出码契约
- opt-in 一次性迁移:不做启动时自动迁移——受影响面为持久 HOME 的裸机部署(Docker 容器内 v3 档案随容器重建已丢);
🔧 Changes
- 无公共 API 破坏:
runCli接受新子命令(纯增量);会话 REST/存储行为不变
📦 Package
- npm:
@zerone-agent/agent-runtime@2.12.0(latest 已核验) - Docker:
zeroneagent/agent-runtime:v2.12.0+:latest(Docker Hub + 华为 SWR 双 registry,digest 一致)
📊 Verification
- PR #93 两轮评审全过(首评 1 阻塞 + 2 重要 + 11 建议 → 全部闭环核验,二轮无遗留)
- 门禁:tsc exit 0 / build exit 0 / vitest 677 passed 0 failed(legacy-import 15 项钉用例)
- PR #93 / #94 CI 双绿;publish.yml publish + docker-push 双 success
- npm registry 权威元数据 latest=2.12.0 ✅;docker 双 registry digest 一致(
sha256:3c55d4ea…)✅
Full Changelog: runtime-v2.11.1...runtime-v2.12.0