1

docs/technical/AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md

@@ -0,0 +1,99 @@
+# 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 对话框。