docs: rescan rebased documentation hierarchy

This commit is contained in:
Turtle
2026-08-05 12:46:38 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions

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 packages/session-persistence/README.md
README.md: ac4e0a8310152b9d2ba5daae61fbbf1eb0ed54ec
README.zh.md: 0903bbc55b06702f748f80643666bf6c4086a633
README.md: 060f757b3568318b0be4b01b3a10d019d28eac3b
README.zh.md: 67022565f7dabcbbccee30d5ce60fa559088ca39

View File

@@ -2,13 +2,13 @@
[English](README.md) | 中文
持久会话的持久化 seam 及其存储后端。接口包负责抽象 `SessionPersistence` 服务和共享写入协调器;后端是注册到 `ctx.sessionPersistence` 的具体实现。全部都是**产品**包
本家族定义持久会话数据的持久化机制、语义检查点策略以及随产品交付的存储后端
| 包 | 职责 | ctx 键 |
|---|---|---|
| `session-persistence/` | 持久化 seam + 共享写入协调 | `ctx.sessionPersistence` |
| `session-checkpoint-policy/` | agent智能体请求和工具执行的语义持久性屏障 | 包装 `ctx.llm` / `ctx.tools`,监听 agent 事件) |
| `session-persistence-jsonl/` | JSONL 伴随文件持久化后端 | 注册到 `ctx.sessionPersistence` |
| `session-persistence-sqlite/` | SQLite 持久化后端 | 注册到 `ctx.sessionPersistence` |
| [`session-persistence/`](session-persistence/README.md) | 定义持久化服务和共享写入协调机制 | `ctx.sessionPersistence` |
| [`session-checkpoint-policy/`](session-checkpoint-policy/README.md) | 应用语义持久性检查点 | 包装 `ctx.llm` `ctx.tools` |
| [`session-persistence-jsonl/`](session-persistence-jsonl/README.md) | 将会话持久化到 JSONL 文件 | 注册到 `ctx.sessionPersistence` |
| [`session-persistence-sqlite/`](session-persistence-sqlite/README.md) | 将会话持久化到 SQLite | 注册到 `ctx.sessionPersistence` |
接口位于 `session-persistence/session-persistence/`;后端是同级包。新存储后端归入此处,并注册到 `ctx.sessionPersistence`。详见[会话持久化](../../.agents/notes/implemented/architecture/2026-06-14-session-persistence.md)。
[会话持久化决策](../../.agents/notes/implemented/architecture/2026-06-14-session-persistence.md)记录了该家族的设计