description: "回溯 dsh-v0.1.5-alpha.1 的已声明 Session 持久化类型及相邻版本变化。" kind: persistence-release
持久化版本回溯: dsh-v0.1.5-alpha.1
English | 中文
概述
写入格式从 2 升至 3：新增 system/message，EpochHeader 删除 system。SurfaceOp 替换操作的字段从 start/end 改为 startSeq/endSeq，tool/code-dispatch 事件键改为 tool/ptc-dispatch 事件键。
目录
发行来源
这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见归档说明。
| 项目 | 记录值 |
|---|---|
| 源码 tag | dsh-v0.1.5-alpha.1 |
| 源码日期 | 2026-09-08T15:25:45.000Z |
| 发行记录 | 有 release 对象。 |
| 前一版本 | dsh-v0.1.3-alpha.2 |
| Session 写入版本 | 3 |
| 完整重建清单 | 57 个根类型 / 443 种类型 |
| 本条快照 | dsh-v0.1.5-alpha.1.schema.json |
写入版本常量在该 tag 中的源码证据：
packages/core/session/src/types.ts:export const SESSION_FORMAT_VERSION = 3
声明
schemaVersion: 1
tag: dsh-v0.1.5-alpha.1
previous: dsh-v0.1.3-alpha.2
sessionFormatVersion: 3
changes:
- root: SessionEventEnvelope
before: 04184edc061905410cc7e3db8d5c7cf393d739c89eb523ba8bad3831fb23ba95
after: 5776e5553ff2dfe3f5bc202dbb1e7c9f93e35a531aebb7764c23b2b6153b2ccc
- root: SessionHeader
before: 15918d785bdccedf0dba204622c75591bfb833bbf107ae0894bbc44cfbd73c1d
after: 2a8b114637e66faab5fae1c6e2fba65320db6224c80f5f36c5bf32f937154d03
- root: event:assistant/message
before: 83f26c7a856f772e6ffd9a5a144e5aaccf771ac54cef41948f99eed99e1a25a7
after: a58ca1bed502d425a8b65cac02f59717498cd296de9513c6f81b83b791c20e9b
- root: event:request/context
before: f6b733e38d46dde3f8ab1ade2be3362abb6642eb97982a98ee64a57ff60d0c28
after: 37cbc9cf06d494cfe5c67f078af1605eacb8e4c2c853e9e26455b73de0ee7ccf
- root: event:request/header
before: 1de6c9c8764045ea9a1357bae6ccbbd57c19f6f337f8f25697c919c7cc9abf16
after: 8ea13bcd983eab596dbfd41c5c2b62a0b318b71cd2a987a6fd752c6ced7e4489
- root: event:system/message
before: null
after: 0ae7ccdc1cc5d9d43772ebd5c7357ff509011c3a6ba188d9c274d33df2542c42
- root: event:tool/code-dispatch
before: f8dc5624cd0c942a069063ae0d90a61d821b4fddd1d967dcded91cf17933e708
after: null
- root: event:tool/code-dispatch-start
before: 9eb21c10fc675e1fa4184e5eecc9697aa87054ffd836d49428174897f0e64b62
after: null
- root: event:tool/ptc-dispatch
before: null
after: da807583a19f4ebe2bc9115c9686016e1521e405bdfaced296ae652b91e8e5f6
- root: event:tool/ptc-dispatch-start
before: null
after: ec38b5949af8eacaf00df002f4acbe344f934f8a061e9cdc65a52a48e5f6dd93
- root: event:tool/result
before: eacefd48000720582725ccfc6ff7a0ac02755a1a3c57a8f9754125f99aab6c1b
after: cc3e270ab982cbafff602b753647b6f056decb7fe4fd523afd2f157a65c3d622
- root: event:user/message
before: a57a77f18de7b37b724293830a57064696895d69f2afcd2c0264f41cd13ba980
after: 2e49ede7fb3a592cce8919ebe982f6ca1c1f67abe4def359ffc028c85e6d1ad8
结构变化
检测到 12 个根类型变化、25 项结构差异。下表的最低要求按当前规则计算，只用于比较；不表示旧版本曾遵守这些规则，也不证明迁移或运行时兼容性。
| 路径 | 变化 | 当前最低要求 |
|---|---|---|
SessionEventEnvelope |
union-variants-changed |
version-bump |
SessionHeader.version |
type-changed |
version-bump |
event:assistant/message.sourceEventSeqs |
property-removed |
version-bump |
event:assistant/message.surfaceOp |
property-made-required |
version-bump |
event:assistant/message.surfaceOp.end |
property-removed |
version-bump |
event:assistant/message.surfaceOp.start |
property-removed |
version-bump |
event:assistant/message.surfaceOp.endSeq |
required-property-added |
version-bump |
event:assistant/message.surfaceOp.startSeq |
required-property-added |
version-bump |
event:request/context.data.systemPromptUpdate |
optional-property-added |
same-version |
event:request/header.data.header.system |
property-removed |
version-bump |
event:system/message |
root-added |
version-bump |
event:tool/code-dispatch |
root-removed |
version-bump |
event:tool/code-dispatch-start |
root-removed |
version-bump |
event:tool/ptc-dispatch |
root-added |
same-version |
event:tool/ptc-dispatch-start |
root-added |
same-version |
event:tool/result.surfaceOp |
property-made-required |
version-bump |
event:tool/result.surfaceOp.end |
property-removed |
version-bump |
event:tool/result.surfaceOp.start |
property-removed |
version-bump |
event:tool/result.surfaceOp.endSeq |
required-property-added |
version-bump |
event:tool/result.surfaceOp.startSeq |
required-property-added |
version-bump |
event:user/message.surfaceOp |
property-made-required |
version-bump |
event:user/message.surfaceOp.end |
property-removed |
version-bump |
event:user/message.surfaceOp.start |
property-removed |
version-bump |
event:user/message.surfaceOp.endSeq |
required-property-added |
version-bump |
event:user/message.surfaceOp.startSeq |
required-property-added |
version-bump |
校验
提取结果已通过规范图、根摘要和全部可达类型摘要校验；仅对历史 surface 事件允许源码原有的可选 surfaceOp。仓库内检查从前驱重建每个 tag，核对 before/after、快照覆盖和双语机器声明。
pnpm run verify-persistence-releases
开发备注
无。