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