Files
Genarrative/docs/technical/AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md
kdletters cbc27bad4a
Some checks failed
CI / verify (push) Has been cancelled
init with react+axum+spacetimedb
2026-04-26 18:06:23 +08:00

3.8 KiB
Raw Blame History

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 来源结果页冻结为预览态”的阶段性口径。

新的主口径是:

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

5. 验收标准

本次修正完成后应满足:

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