1

docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md

@@ -0,0 +1,75 @@
+# Agent 结果页与平台入口收口方案（阶段二）
+
+更新时间：`2026-04-20`
+
+## 1. 阶段二目标
+
+阶段一已经把 Agent 结果页编辑快照同步回 session 主链。阶段二不继续扩大结果页编辑能力，而是把入口和职责继续收紧：
+
+1. 平台“创作”入口统一读取 `custom-world/works` 聚合列表
+2. Agent 草稿和已保存作品在同一个入口里展示
+3. 草稿点击后恢复 Agent session，已保存作品点击后进入作品详情
+4. Agent 结果页不再暴露“继续在结果页补世界结构”的新增入口
+
+一句话目标：
+
+**让用户从平台创作入口能稳定找回草稿和作品，同时让结果页更像收口预览，而不是另一套编辑器。**
+
+---
+
+## 2. 本阶段不做什么
+
+阶段二明确不做：
+
+1. 不物理删除旧 `custom-world/sessions` 链
+2. 不打通 `publish_world`
+3. 不重做结果页 UI
+4. 不删除已保存作品的继续编辑入口
+5. 不把结果页整体改成只读
+
+这些事项留给后续阶段继续拆。
+
+---
+
+## 3. 平台入口落地规则
+
+平台“创作”Tab 改为优先展示 `listCustomWorldWorks()` 的聚合结果：
+
+1. `agent_session` 类型展示为草稿，可点击恢复 Agent 工作区
+2. `published_profile` 类型展示为作品，可点击进入作品详情
+3. 聚合接口失败时保留现有作品库 `myEntries` 兜底
+4. 不新增平行页面，复用已有 `CustomWorldCreationHub`
+
+这样用户不再需要依赖隐藏 sessionId 或旧作品库入口才能找回创作。
+
+---
+
+## 4. 结果页职责收口规则
+
+Agent 来源结果页继续保留：
+
+1. 浏览世界、角色、场景
+2. 自动保存
+3. 返回 Agent 工作区
+4. 进入世界
+
+Agent 来源结果页本阶段收紧：
+
+1. 不再显示直接新增可扮演角色、场景角色、场景的入口
+2. 不再把“去 Agent 调整设定”设计成结果页内部继续补世界结构
+3. 如需继续调整，返回 Agent 工作区
+
+已保存作品的结果页仍保持现有编辑能力，避免破坏作品库已有体验。
+
+---
+
+## 5. 验收标准
+
+阶段二完成后应满足：
+
+1. 平台“创作”Tab 能看到 Agent 草稿和已保存作品的统一列表
+2. 点击 Agent 草稿能恢复对应 Agent 工作区
+3. 点击已保存作品能进入原有作品详情
+4. Agent 结果页不再显示直接新增角色/地点的入口
+5. 已保存作品的结果页编辑能力不受影响
+