# Agent 对话框与结果页精修职责边界修正

更新时间：`2026-04-21`

## 1. 结论

本次修正把“Agent 对话框”和“结果页精修”重新拆清楚：

1. `CustomWorldAgentWorkspace` 只负责八锚点信息收集、八锚点进度展示、八锚点完成后的“整理世界底稿”动作。
2. “精修”不是 Agent 对话框里的概念，不再通过 Agent 建议动作进入角色、地点、世界总卡的局部修整。
3. 已经生成底稿的草稿，从创作中心点击后进入结果页继续完善。
4. 尚未生成底稿的草稿，从创作中心点击后才恢复 Agent 对话框继续补齐八锚点。
5. 结果页负责成稿后的编辑、补全、进入世界前确认和自动保存，并通过 `sync_result_profile` 回写到当前 Agent session。

一句话：

**Agent 收八锚点，结果页做精修。**

---

## 2. 为什么要修正

旧实现把 `object_refining` 草稿卡片显示成“继续精修”，但点击后直接恢复 Agent 工作区。

这个行为会让用户产生两个误解：

1. 以为精修是 Agent 对话框里的下一阶段。
2. 以为 Agent 对话框不仅负责收集八锚点，还负责后续对象级编辑。

这和当前产品边界不一致。Agent 对话框应该保持轻量，只用于拿到足够稳定的八锚点输入；对象、场景、封面、世界档案的修整都应该在结果页完成。

---

## 3. 当前落地规则

### 3.1 创作中心草稿点击分流

`custom-world/works` 返回 `agent_session` 草稿后，前端按草稿是否已有底稿内容分流：

1. `playableNpcCount <= 0 && landmarkCount <= 0`
   - 视为八锚点仍未整理成底稿。
   - 点击进入 `agent-workspace`。
2. `playableNpcCount > 0 || landmarkCount > 0`
   - 视为已有可编辑底稿。
   - 点击读取对应 Agent session，编译为 `CustomWorldProfile`，进入 `custom-world-result`。

### 3.2 Agent 对话框动作边界

Agent 会话建议动作只保留：

1. 总结当前设定 / 总结当前世界底稿。
2. 八锚点准备完成后的“整理一版世界底稿”。

不再在 Agent 会话快照里继续生成或兼容展示：

1. `refine_focus_target`
2. “精修角色”
3. “继续补地点”
4. “先看世界总卡”

旧 session 快照如果仍带有 `refine_focus_target`，服务端兼容层会过滤掉，避免旧数据把精修入口重新塞回 Agent 对话框。

### 3.3 结果页精修边界

Agent 来源结果页不再是冻结预览态。

当前允许在结果页继续进行成稿精修，包括：

1. 编辑世界信息。
2. 编辑角色、场景、封面等对象档案。
3. 删除或调整已有对象。
4. 自动保存到作品草稿。
5. 进入世界前通过 `sync_result_profile` 写回 Agent session。

为了保持主链简洁，Agent 来源结果页仍不重新打开“通过 Agent 对话精修对象”的入口。

---

## 4. 对历史文档口径的覆盖

这份文档覆盖 [AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md) 中“Agent 来源结果页冻结为预览态”的阶段性口径。

新的主口径是：

1. Agent 来源结果页可以编辑，因为精修本来就应该发生在结果页。
2. 需要收紧的是 Agent 对话框，不是结果页。
3. 结果页编辑后仍必须同步回 Agent session，保持进入世界前的数据真相源一致。

---

## 5. 验收标准

本次修正完成后应满足：

1. 创作中心已有底稿草稿按钮文案为“继续完善”，点击进入结果页。
2. 创作中心未成稿草稿按钮仍为“继续创作”，点击进入 Agent 对话框。
3. Agent 对话框不出现“精修角色 / 补地点 / 看世界总卡”类对象精修入口。
4. Agent 来源结果页可以打开编辑弹窗进行精修。
5. 返回创作从结果页回到创作中心，不回到 Agent 对话框。