# 创作中心全草稿恢复 Agent 会话设计

日期：`2026-04-23`

## 1. 背景

当前创作中心已经承载多种“先聊天收束，再进入结果页”的创作链：

1. RPG / Custom World
2. Big Fish
3. Puzzle

但三条链当前恢复能力并不一致：

1. RPG 草稿已经能通过 `sessionId` 恢复 Agent 会话。
2. Puzzle 草稿已补到通过 `sourceSessionId` 恢复 Agent 会话。
3. Big Fish 仍停留在“有会话但没有创作中心草稿投影”的状态，用户退出登录后缺少重新进入草稿的入口。

这会导致“进入创作草稿继续聊”的体验只在部分品类成立，不满足创作中心统一入口的要求。

## 2. 目标

本轮统一收口到以下规则：

1. 只要是创作中心中的 `draft` 草稿，都必须能恢复对应 Agent 聊天历史。
2. 恢复能力只要求在“重新进入创作中心草稿”时成立，不扩展到用户级独立聊天历史列表。
3. 所有草稿卡片都遵循同一入口语义：
   - 尚无结果页草稿时，进入 Agent 工作区继续聊。
   - 已有结果页草稿时，直接进入结果页。
   - 从结果页返回后，仍能看到原聊天记录。

## 3. 统一边界

### 3.1 真相源

聊天历史、当前阶段、锚点、草稿真相始终在各自的 Agent session 表中：

1. RPG / Custom World：`custom_world_agent_session`
2. Big Fish：`big_fish_creation_session + big_fish_agent_message`
3. Puzzle：`puzzle_agent_session + puzzle_agent_message`

### 3.2 创作中心作品卡

创作中心作品卡只承担：

1. 展示草稿摘要。
2. 保存恢复用的稳定会话标识。
3. 作为重新进入创作链的入口。

它不是新的聊天真相，也不独立承载消息历史。

## 4. 统一恢复规则

### 4.1 草稿卡必须带会话索引

不同品类的草稿卡都必须能反查到会话：

1. RPG / Custom World：使用现有 `sessionId`
2. Big Fish：新增 `sourceSessionId`
3. Puzzle：使用现有 `sourceSessionId`

### 4.2 打开草稿时的分流

前端打开草稿卡时统一执行：

1. 先按会话 id 读取对应 session snapshot。
2. 若 session 已有结果页草稿：
   - RPG 进入 `custom-world-result`
   - Big Fish 进入 `big-fish-result`
   - Puzzle 进入 `puzzle-result`
3. 若 session 尚无结果页草稿：
   - RPG 进入 `agent-workspace`
   - Big Fish 进入 `big-fish-agent-workspace`
   - Puzzle 进入 `puzzle-agent-workspace`

### 4.3 失败回退

如果草稿卡缺少会话索引，或会话已不存在：

1. 刷新对应作品列表。
2. 停留在创作中心。
3. 通过现有错误 banner 提示，不新增规则说明 UI。

## 5. 分品类落地要求

### 5.1 RPG / Custom World

RPG 已具备恢复基础，本轮只把它纳入统一口径：

1. `draft + sessionId` 继续作为恢复前提。
2. 有结果页草稿时，主按钮保持 `继续完善`。
3. 没有结果页草稿时，主按钮保持 `继续创作`。

### 5.2 Puzzle

Puzzle 继续沿用本轮已落地的规则：

1. 编译结果页草稿时同步 upsert `draft` 作品投影。
2. 作品投影保留 `sourceSessionId`。
3. 草稿卡点击恢复 `puzzleSession`，优先进入结果页。

### 5.3 Big Fish

Big Fish 需要补齐缺口：

1. 为 `big_fish_creation_session` 增加 works 读模型输出，不新建第二套聊天存储。
2. 创作中心读取 Big Fish works 并合并展示。
3. 草稿卡固定带 `sourceSessionId = sessionId`。
4. `draft` 卡主按钮使用 `继续创作`。
5. `published` 卡主按钮使用 `查看详情`，体验入口仍直接进入运行态。
6. 在独立 Big Fish 详情页补齐前，`查看详情` 先复用结果页承载详情与返回聊天的入口，不额外新建页面。

## 6. Big Fish works 最小方案

### 6.1 不新增独立 Big Fish profile 表

本轮 Big Fish 只补“草稿恢复聊天”闭环，不强行新建完整发布作品仓储。

创作中心所需 Big Fish work summary 直接由 `big_fish_creation_session` 派生：

1. `draft_json` 存在时输出草稿标题、副标题、摘要。
2. `asset_slots` 提供封面图和资源完成度提示。
3. `stage == Published` 时视为 `published`。
4. 其他阶段统一视为 `draft`。

### 6.2 稳定 workId

Big Fish works 使用会话派生稳定 id：

1. `workId = big-fish-work-{sessionId}`
2. `sourceSessionId = sessionId`

这样同一份草稿不会在创作中心重复出现。

## 7. 验收

1. RPG、Big Fish、Puzzle 三类草稿都能在创作中心重新打开。
2. 退出登录后重新登录，进入同一份草稿仍能恢复对应聊天记录。
3. Big Fish 草稿首次编译出结果页后，会在创作中心出现草稿卡。
4. Big Fish / Puzzle 已有结果页草稿时，点击草稿卡直达结果页。
5. 从结果页返回各自 Agent 工作区后，历史消息不丢失。