Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(i18n): sync session durability translation

Browse Source
This commit is contained in:
Tianyi Cui
2026-07-22 23:02:10 +08:00
parent f24664e1d4
commit c701fad75d
2 changed files with 3 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/core-data-structures/session.i18n.yaml
View File

@@ -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

2
docs/core-data-structures/session.zh.md
View File

@@ -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)。