Skip to content

Runtime-v2.12.0

Choose a tag to compare

@zerone-agent zerone-agent released this 03 Nov 11:30
· 5 commits to main since this release
e7adb04

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 侧编排而非 SDK importLegacyArchive——后者对 readdir 失败静默返回全零报告,无法区分「源不可读」与「无事可导」)
    • 文档:docs/configuration.md「Session storage → v3 → v4 migration」补用法、幂等/失败语义与退出码契约

🔧 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