소스 검색

docs(i18n): sync session durability translation

Tianyi Cui 2 달 전
부모
커밋
c701fad75d
2개의 변경된 파일과 3개의 추가작업 그리고 3개의 파일을 삭제
  1. 2 2
      docs/core-data-structures/session.i18n.yaml
  2. 1 1
      docs/core-data-structures/session.zh.md

+ 2 - 2
docs/core-data-structures/session.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write
-session.md: d3c6ab65df29ef0df504a0a01219e36ebad8e8fd
-session.zh.md: 7d5e03f6b8d74e7b2dc0097acb1f5f78f6d3af6e
+session.md: d6bdc4bfc523cdeb8036fd32b6b60e90ec51f678
+session.zh.md: ad9ed471185350603976d4baffa9e56bf09c831a

+ 1 - 1
docs/core-data-structures/session.zh.md

@@ -530,6 +530,6 @@ interface TurnEndReasonMap {
 
 ## 持久性契约
 
-持久化后端依赖的契约如下:持久日志原样保存每个事件,**包括** `assistant/chunk`;`seq` 必须连续,因此不能从规范日志中过滤分片。所有 `event.data` 都必须可序列化为 JSON;`Session.append` 会从源头强制这一要求(遇到不可序列化数据时抛出),因此错误事件绝不会进入日志,`session.events` 始终与后端可持久化的内容一致。新增携带不可序列化数据的事件类型,或破坏会话不变式配套插件所检查的轮次/步骤嵌套,会构成磁盘格式的破坏性变更。
+持久化后端依赖的契约如下:持久日志无损保存每个事件,**包括** `assistant/chunk`;`seq` 必须连续,因此不能从规范日志中过滤分片。后端可以为事件批次选择自己的存储编码,只要 `load` 返回与追加时完全一致的事件即可(JSONL 后端可选启用的打包分片行就是此类编码;见 [persistence.md](persistence.md))。所有 `event.data` 都必须可序列化为 JSON;`Session.append` 会从源头强制这一要求(遇到不可序列化数据时抛出),因此错误事件绝不会进入日志,`session.events` 始终与后端可持久化的内容一致。新增携带不可序列化数据的事件类型,或破坏会话不变式配套插件所检查的轮次/步骤嵌套,会构成磁盘格式的破坏性变更。
 
 消费此契约的后端见 [persistence.md](persistence.md)。