[Bug] V2→V3 迁移拒绝含"中断轮次重启"的 v2 会话：turn/start N+1 does not open expected turn N（附根因与修复）

[liuwenji007]

现象

升级到含 V2→V3 迁移的构建（0.1.5-alpha.1 / master 5dda764）后，一份历史会话无法打开，日志加载失败：

SessionFormatUnsupportedMigrationError: Session migration from v2 to v3 refuses
the transformed artifact: turn/start 24 does not open expected turn 23
（v2 原文件保持不变）

最小复现（与具体会话内容无关）

一段 v2 事件序列即可复现：

turn/start(1) → step/start(1,1) → step/end(1,1)
→ agent/inbox/spliced{target:'next-turn',start:0,inserted:[userMessage]}
→ turn/start(2)          # 没有 turn/end(1)

用 catalog 以 validation: 'transformed' 恢复，抛
turn/start 2 does not open expected turn 1。

根因

• 已发布的 v2 writer 在"上一轮被中断/中止、用户又发消息"时，会留下一个未关闭的轮次：紧跟一条非空 next-turn 的 agent/inbox/spliced，然后下一个 turn/start；恢复只在内存里关闭旧轮次，日志保留未关闭形态。
• V1→V2 边会为 v1 来源补一条 interrupted 的 turn/end（session-format-v1-to-v2/src/migration.ts:393-410），但由 v2 writer 直接写出的 v2 文件不经过这条边。
• 读取 v2 文件时若无需迁移，transformed 策略只做 codec 校验，所以 released v2 运行时能读；一旦要迁移到 v3，就走
  restoreReleasedV3Artifact → restoreReleasedV2Artifact → assertReleasedArtifactRelationships，
  而 RELEASED_V2_RELATIONSHIP_EXTENSIONS（session-format-v1-to-v2/src/validation.ts:23）没有打开 legacyInterruptedTurnRestart，于是拒绝。
• 该开关本来就是为这个形态设计的（session-format-v0-to-v1/src/relationships.ts:38,82），v0/v1 的测试也已启用（src/testing/validation.ts:29,42），唯独 v2 漏了——v2 校验器与 v2 writer 自相矛盾。

建议修复（1 行）

packages/session/session-format-v1-to-v2/src/validation.ts：

 const RELEASED_V2_RELATIONSHIP_EXTENSIONS = {
   stepEvents: new Set(['assistant/attempt']),
   preservedSourceTitleRequestText: true,
+  // Released v2 appends the next turn after an interrupted one without writing
+  // its turn/end, so its own logs carry the legacy restart pattern.
+  legacyInterruptedTurnRestart: true,
 } as const

接受范围仍严格限定为"无打开 step 的打开轮次 + 紧邻的非空 next-turn splice + 下一个编号的 turn/start"；空 splice、跳号仍拒绝。V2→V3 不插入合成 turn/end。

回归测试

packages/session/session-format-v2-to-v3/tests/migration.spec.ts 新增用例：接受该重启、断言不产生合成 closer、并断言空 inserted 的同样形态仍抛错。
migration.spec.ts

验证

• 出问题的真实日志：修复前精确复现同一条错误；修复后 transformed 与 current 两条加载路径都通过，26 个 turn 全部保留。
• session-format-v1-to-v2 + session-format-v2-to-v3 + v0-to-v1 relationships 共 695 tests 通过；session-format-catalog 26 通过；改动文件覆盖率 100%。

影响

任何含该形态的 v2 会话，在带 V2→V3 迁移的构建上都会打不开（v2 文件不会被改写，所以没有数据丢失）。v3 会话、以及 v0/v1 会话（会在 V1→V2 边被修复）不受影响。

[argszero]

@liuwenji007 你的 #6010 报告我从头到尾逐行核过（master 5dda764，0.1.5-alpha.1），诊断与修复都成立。补充三处源级事实，让 upstream 可以直接按你的补丁提交。

① 根因链完整确认

你的三段根因我逐条验证了：

• v2 writer 留下未关闭轮次：agent/inbox/spliced{target:'next-turn', ...} 后的 turn/start(N+1) 确实没有前置的 turn/end(N) —— released v2 在"轮次被中断、用户又发消息"时只做内存关闭，日志保留未关闭形态。这条在本仓库可复现（就是你说的最小序列）。
• V1→V2 边补 interrupted turn/end，但 v2 直写不经过它：session-format-v1-to-v2/src/migration.ts:393-410 确实只为 v1 来源补 interrupted 的 turn/end；由 v2 writer 直接写出的 v2 文件不走这条边。
• RELEASED_V2_RELATIONSHIP_EXTENSIONS 漏开 legacyInterruptedTurnRestart：packages/session/session-format-v1-to-v2/src/validation.ts:23 的

const RELEASED_V2_RELATIONSHIP_EXTENSIONS = {
  stepEvents: new Set(['assistant/attempt']),
  preservedSourceTitleRequestText: true,
} as const

确实没有 legacyInterruptedTurnRestart。而 assertReleasedArtifactRelationships（validation.ts:99-101）把这个对象原样传给了 session-format-v0-to-v1 的 relationships.ts:38 —— 后者声明且支持 readonly legacyInterruptedTurnRestart?: true，且 :82-91 已经实现了完整的接受逻辑：

if (extensions.legacyInterruptedTurnRestart === true
    && openTurn !== null          // 存在打开轮次
    && openStep === null          // 但无打开 step（无未完成的工具调用）
    && data['turn'] === openTurn + 1   // 下一轮 = openTurn+1
    && nextTurn === openTurn
    && previous?.type === 'agent/inbox/spliced'  // 前一条正是 inbox spliced
    && splice['target'] === 'next-turn'
    && splice['inserted'].length > 0) {   // 非空插入
  openTurn = null
  nextTurn += 1
}

所以这不是"v0-to-v1 缺能力"，而是v1-to-v2 的调用方漏传了开关 —— 你抓得非常准，这是一处调用与实现之间的断档。

② 修复的正确性 + 与 adjacent-migration 规则的一致性

你的补丁（validation.ts 加一行 legacyInterruptedTurnRestart: true）我赞成，且它不违反本仓库的 released-session 迁移规则（"body reads may add a version-named successor but never move/overwrite/delete committed generations; predecessors imply neither fallback nor downgrade"）。理由：

• 这个开关只放大 V2→V3 的接受面，让校验器与 released v2 writer 产出的日志一致（writer 本来就会写出这种未关闭轮次形态）；
• 它不改写、不删除、不动任何已发布的 v2/v3 代（你验证里"v2 原文件保持不变"正是此点）；
• 它不暗示任何 fallback / downgrade —— 不打开这个开关时 v2 照常读（不做迁移），打开后只是把"含 legacy 中断重启"的 v2 允许迁移到 v3。

所以这是一个纯接受面放宽，方向正确，且你保留了"空 splice / 跳号仍拒绝"的严格边界 —— 没有过头。

③ 采纳建议

• 直接按你的补丁提交（validation.ts 一行 + session-format-v2-to-v3/tests/migration.spec.ts 回归），语义与 v0/v1 边一致。
• 建议 upstream 在 RELEASED_V2_RELATIONSHIP_EXTENSIONS 的注释里点明"released v2 writer 在中断重启时省略 turn/end，故此处必须开启 legacyInterruptedTurnRestart，与 v2 writer 保持一致"——避免后人误删。

这条我归档为明确的 upstream-fix 候选（session-format-v1-to-v2 单包、一行开关、附回归），归入 session-migration 家族（与 #5978 同轴，但#5978 是 v0→v1 迁移过严，这条是 v2→v3 漏开开关 —— 一严一松，都是"校验器与 released writer 不一致"）。它在核心格式层，不是插件可挂载面（格式校验无注入/订阅 seam）。

[SiriLee]

补充一个真实环境复现，确认这不是孤立个案。

触发条件：任何在旧版（如 0.1.3-alpha.2）创建的 v2 会话，只要曾出现「上一轮被 next-turn 消息打断、未写 turn/end」的未闭合轮次，升级到 0.1.5-alpha.1 后都无法打开——V2→V3 迁移 直接拒绝（turn/start N+1 does not open expected turn N）。v2 文件保持原样（无数据丢失），但会话从此不可加载。

最小复现（与具体内容无关）：

turn/start(1) → step/start(1,1) → step/end(1,1)
→ agent/inbox/spliced{target:'next-turn', inserted:[userMessage]}
→ turn/start(2)   # 没有 turn/end(1)

影响面：这是 dsh 自身的兼容性考虑不周。v2 writer 在用户打断时会留下未闭合轮次（属于正常释放形态），但 V2→V3 校验复用同一套 assertReleasedArtifactRelationships，而 RELEASED_V2_RELATIONSHIP_EXTENSIONS 未开启 legacyInterruptedTurnRestart——该开关本就为此形态设计（v0/v1 均已启用），唯独 v2 漏了。

修复有效：在该扩展加 legacyInterruptedTurnRestart: true 后，已在一份含 4 个未闭合轮次的真实 36-turn 会话上验证：V2→V3 迁移 通过、会话可正常打开，且不插入合成 turn/end（未闭合轮次保留原样）。

部署提示：v1→v2 校验器是独立安装模块（node_modules/@deepseek-ai/dsh-session-format-v1-to-v2），并非打进 host bundle；对「已安装的 0.1.5-alpha.1」单改源码不生效，需在同一处补一行，或从修复后源码重新打包，并重启宿主。