1

docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md

@@ -0,0 +1,148 @@
+# Agent 结果页旧链降级与预览冻结方案（阶段三）
+
+更新时间：`2026-04-20`
+
+## 1. 阶段三目标
+
+阶段一已经把结果页编辑同步回 Agent session 主链。
+
+阶段二已经把平台“创作”入口统一到 `custom-world/works` 聚合列表，并收紧了 Agent 结果页里的新增入口。
+
+阶段三不继续扩功能，而是继续做两件事：
+
+1. 让旧 pipeline 在主入口里进一步降级，不再和 Agent 主链抢“草稿”职责
+2. 让 Agent 来源结果页进一步冻结为“预览/收口层”，不再继续承担 legacy profile 直改编辑器职责
+
+一句话目标：
+
+**把还在和 Agent 主链并行的旧职责继续降级，避免系统自己和自己打架。**
+
+---
+
+## 2. 当前剩余问题
+
+虽然阶段一、二已经把主链收紧了不少，但当前还保留两个明显的并行口：
+
+### 2.1 创作中心里旧 library 草稿仍可能继续冒充主草稿
+
+当前 `listCustomWorldWorkSummaries()` 会把 runtime library 里的所有 profile 都折成 `published_profile` 类型返回。
+
+这意味着：
+
+1. `visibility = 'draft'` 的 library 草稿仍会继续出现在创作中心
+2. 创作中心里同时存在：
+   - Agent session 草稿
+   - library 草稿
+   - 已发布作品
+3. 用户看到的“草稿”概念仍然可能混成两套
+
+阶段三需要明确：
+
+**创作中心主入口只认 Agent session 草稿 和 已发布作品，不再继续把 library draft 当主草稿展示。**
+
+---
+
+### 2.2 Agent 结果页仍能继续打开旧 legacy 编辑器
+
+当前 Agent 来源结果页虽然已经不再暴露“新增角色/新增地点”入口，但仍然保留下面这些旧编辑链：
+
+1. 点击世界概述/基本设定仍能打开 legacy world editor
+2. 点击角色、场景、封面仍能继续进入旧 profile 编辑弹窗
+3. 这些编辑器本质上仍然是在改 legacy `CustomWorldProfile`
+
+这会带来两个问题：
+
+1. Agent 结果页继续像一套“旧编辑器”
+2. “去 Agent 调整设定”和“结果页直接改 legacy profile”两条路仍然并行存在
+
+阶段三需要明确：
+
+**Agent 来源结果页继续保留浏览、自动保存、返回创作、进入世界，但不再继续承担 legacy profile 深编辑职责。**
+
+---
+
+## 3. 阶段三落地规则
+
+## 3.1 创作中心只展示两类主入口内容
+
+`custom-world/works` 在阶段三只保留下面两类条目：
+
+1. `agent_session`
+   - 统一视为草稿
+   - 点击后恢复 Agent 工作区
+2. `published_profile`
+   - 统一视为已发布作品
+   - 点击后进入现有作品详情
+
+明确不再把下面这类内容继续塞进创作中心主入口：
+
+1. library 中 `visibility = 'draft'` 的兼容草稿
+
+这些兼容草稿仍然保留在作品库/详情链路里，不在本阶段物理删除，但不再继续占创作中心“草稿主入口”。
+
+---
+
+## 3.2 Agent 来源结果页冻结为预览态
+
+当 `customWorldResultViewSource === 'agent-draft'` 时，结果页阶段三继续保留：
+
+1. 浏览世界信息
+2. 浏览角色、地点、场景结构
+3. 自动保存
+4. 返回 Agent 工作区
+5. 进入世界
+
+同时阶段三进一步收紧：
+
+1. 不再打开世界/角色/场景/封面的 legacy 编辑弹窗
+2. 不再提供删除角色、删除场景等旧 profile 直改入口
+3. Agent 来源结果页上的对象卡统一作为“查看详情”预览卡使用
+
+已保存作品的结果页编辑能力继续保留，不在本阶段收缩，避免破坏已有作品库编辑体验。
+
+---
+
+## 3.3 结果页同步动作只在真的发生差异时执行
+
+阶段一补的 `sync_result_profile` 仍然保留，但阶段三补一个行为约束：
+
+1. 如果当前 Agent 结果页 profile 和最新 session 重编译结果签名一致
+2. 那么返回创作、进入世界、自动保存前不再重复触发一次 `sync_result_profile`
+
+目的不是省接口，而是明确：
+
+**结果页同步是“有改动才回写”的主链动作，不是每次离开页面都机械重放。**
+
+---
+
+## 4. 阶段三明确不做什么
+
+这次阶段三明确不做：
+
+1. 不物理删除旧 `custom-world/sessions` 相关服务与兼容代码
+2. 不打通 `publish_world`
+3. 不把前端 `buildCustomWorldProfileFromAgentDraft()` 兼容编译层移除
+4. 不删除 `draftProfile.legacyResultProfile`
+5. 不收缩已保存作品的 legacy 编辑器能力
+
+阶段三只做主入口降级与 Agent 结果页职责冻结，不做更大的模型替换。
+
+---
+
+## 5. 验收标准
+
+阶段三完成后应满足：
+
+1. 创作中心不再把 library draft 兼容作品继续显示为“草稿主入口”
+2. 创作中心里只保留 Agent 草稿和已发布作品两类主入口内容
+3. Agent 来源结果页不再能继续打开 legacy 世界/角色/场景编辑弹窗
+4. 已保存作品结果页编辑能力不受影响
+5. Agent 结果页在未发生改动时，返回创作/进入世界/自动保存不会重复触发无意义的 `sync_result_profile`
+
+---
+
+## 6. 一句话结论
+
+阶段三不是删除兼容层，而是把它们继续降级到不会抢主流程职责的位置上：
+
+**创作中心只认 Agent 草稿和已发布作品，Agent 结果页只负责预览与收口，不再继续充当旧编辑器。**