# 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 结果页只负责预览与收口，不再继续充当旧编辑器。**