54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# Book 快照
|
||
|
||
用户手动保存、多档位；与自动续作 `session.json` 分离。
|
||
|
||
## 两种 kind（更新语义）
|
||
|
||
| kind | 名称 | 何时存 | 存什么 |
|
||
|------|------|--------|--------|
|
||
| **`instance`** | 设计完成 / 资产截面 | design 完成或从 play 剥离设定 | **CardAsset 级** tag（角色卡.确认稿、世界蓝图…）；**不含**轮次、事件流 |
|
||
| **`run`** | 游玩存档 | play 任意时刻 | instance 层 + `运行.*`、轮次、变量、对话 |
|
||
|
||
```text
|
||
CardBook design 完成 → 可存 instance（导出角色卡 / 世界设定）
|
||
PlayBook 进行中 → 可存 run（第 N 轮续玩）
|
||
```
|
||
|
||
**instance** 不再表示「14 步 pipeline 填完」，而是 **agent declare ready 时的可复用资产截面**。详见 `book-storage.md`。
|
||
|
||
## 与三种存储需求
|
||
|
||
| 需求 | 用什么 |
|
||
|------|--------|
|
||
| 创建角色卡**过程** | CardBook `designTrace` + messages（快照不替代，须 Book 级） |
|
||
| 创建好的**卡** | CardAsset 或 `instance` 快照 |
|
||
| 游玩**过程** | PlayBook `playTrace` + `run` 快照 |
|
||
|
||
## 与自动续作
|
||
|
||
| | `session.json` | `run-snapshots/` |
|
||
|--|----------------|------------------|
|
||
| 触发 | 自动 | 用户手动 |
|
||
| 数量 | 每 Book 1 份 | 多档、可命名 |
|
||
| 打开作品 | 默认恢复 | 选档 **加载** |
|
||
|
||
## API
|
||
|
||
```text
|
||
GET /api/books/:bookId/saves
|
||
POST /api/books/:bookId/saves { label, kind: "instance"|"run", note?, sessionId? }
|
||
POST /api/books/:bookId/saves/:id/load
|
||
DELETE /api/books/:bookId/saves/:id
|
||
```
|
||
|
||
## 实现
|
||
|
||
```text
|
||
src/types/run-snapshot.ts
|
||
src/book/run-snapshot-store.ts
|
||
src/book/snapshot-filters.ts instance 时剥离 运行.* 等
|
||
src/server/session-manager.ts
|
||
```
|
||
|
||
存储：`books/{bookId}/run-snapshots/{id}.json`
|