Files
Genarrative/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.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

14 KiB
Raw Blame History

当前 Agent 创作流程优化执行规划(大白话版)

更新时间:2026-04-21

先把话说死

这轮不再加新流程。

不再新增一套创作动线。 不再为了“更完整”继续把 PRD 里没落完的所有阶段、面板、动作全补出来。 不再把前端创作工具改成另一套长得不一样的新系统。

这轮只做一件事:

把现在这条你已经满意的前端创作流程,收紧、理顺、删重、补通,让它从“能跑”变成“稳、顺、好维护、不会自己打自己”。

这份规划就是基于 AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md 里已经确认的问题,重新收束出来的一版执行方案。

0.1 当前正式执行基线

2026-04-21 起,当前仓库里和这条创作主链直接对应的文件级拆分、阶段验收、工作包进度,统一以以下文档为准:

  1. ../technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
  2. docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_*_PROGRESS_2026-04-21.md
  3. ../technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md

本文件继续承担的职责只剩 3 件事:

  1. 解释为什么当前版本只收口现有 Agent 创作动线,不再扩一套新流程
  2. 冻结这轮明确不做的能力边界
  3. 给出高层执行顺序与判断标准

凡是涉及目录落位、命名规范、前后端真相源边界、阶段完成度和工作包状态,统一以后面的技术执行文档为准。


1. 现在最大的问题,用大白话讲是什么

不是界面丑。 不是步骤不够多。 不是入口不够花。

而是现在这条链里,很多地方在“一个流程里混着好几套脑子”。

具体就是:

  1. 用户明明在走 Agent 创作,但走到一半,很多关键数据又偷偷变成了 old profile 流程在接手。
  2. 明明已经有 Agent session 这条主线,但结果页、作品库、旧生成接口、旧编辑器能力还都在同时干活。
  3. 明明有“发布世界”这个概念,但现在实际上“不发布也能直接进入世界”。
  4. 明明有一些 session 内的数据,比如建议动作、草稿卡、澄清项、质量检查,结果走到结果页之后就像断电了一样,后面没人接着用。
  5. 明明有些功能已经决定这轮不做,但代码里和文档里还留着很多“半做不做”的说法,会持续误导后续开发。

所以这轮优化的目标不是“让系统更大”,而是:

让整条现有流程只认一条主线,别再一会儿 Agent、一会儿 legacy、一会儿旧 session、一会儿作品库各管各的。


2. 这轮优化后的目标状态

我们要收敛到下面这个状态:

用户进入 Agent 创作
-> 在现有工作区里聊天和生成草稿
-> 草稿整理完成后进入现有结果页
-> 结果页只做预览、少量必要确认、进入世界
-> 进入世界时走一条明确、统一、可解释的数据链
-> 平台“我的创作”能稳定找回这份草稿或这份作品

注意,这里有两个关键词:

  1. 还是现有动线
  2. 但背后的数据链要统一

也就是说:

前端看上去可以几乎不换流程。 但后面谁是真相源、谁负责编译、谁负责保存、谁负责恢复、哪些能力要删掉,必须彻底讲清楚。


3. 这轮不做什么

为了避免后面又做散,先把“不做什么”写清楚。

3.1 不新增新的大流程

不做这些:

  1. 不再新增“另一个 Agent 创作工作台”
  2. 不再新增“另一套草稿结果页”
  3. 不再新增“另一条作品发布流程”
  4. 不再新增“另一套创作中心入口”

3.2 不为了补 PRD 而硬补所有未完成能力

不做这些:

  1. 不把所有 lock / unlock / regenerate_scope / expand_long_tail / scene asset pipeline 一次性全打完
  2. 不为了“文档里写过”就把所有没接线面板都接进来
  3. 不把当前工作区重新改造成一个更复杂的大后台

补充更新(2026-04-21

上一轮审计里提到的一组旧 Agent 副面板,已经在工程清理中被明确判定为退出当前版本主链并物理删除,包括:

  1. CustomWorldAgentLockBar.tsx
  2. CustomWorldAgentQuickActions.tsx
  3. CustomWorldAgentSummaryPanel.tsx
  4. CustomWorldAgentIntentSummaryPanel.tsx
  5. CustomWorldAgentClarificationPanel.tsx
  6. CustomWorldAgentDraftDetailPanel.tsx
  7. CustomWorldDraftCardDetailModal.tsx
  8. CustomWorldDraftEditPanel.tsx
  9. CustomWorldGenerateEntityModal.tsx

所以这里的“不为了文档里写过就全接进来”,现在不只是态度提醒,而是已经执行过的现实边界。

3.3 不把结果页继续当旧编辑器扩写

这轮明确不再鼓励:

  1. 在结果页继续加更多直接生成角色 / 地点的按钮
  2. 在结果页继续加更多直接改 legacy profile 的编辑能力
  3. 让结果页承担越来越重的“补世界”职责

一句话:

结果页要收口,不要继续发散。


4. 接下来真正要做的 5 件事

4.1 第一件事:先定一条唯一主链,别再多套数据同时接力

这是第一优先级,也是最重要的一件事。

现在的问题不是“没东西可用”,而是“能用的东西太多了,而且互相抢活”。

接下来要明确:

  1. 当前 Agent 创作流程里,Agent session 才是草稿阶段的真相源。
  2. 结果页只是这份草稿的展示和收口,不应该变成另一套独立编辑器。
  3. 进入世界时,只能走一条明确的编译出口,不能这里转一次、那里改一次、最后谁改得晚听谁的。

用大白话讲,就是:

从聊天开始到点“进入世界”为止,中间只能有一条主水管。

不能再出现:

  1. Agent session 里一份数据
  2. 前端桥接后又一份 profile
  3. 结果页本地改完又一份 profile
  4. 自动保存到作品库后再来一份 profile

这样下去,后面谁出 bug 都说不清到底是哪一层改坏的。

所以这一阶段的目标不是改 UI而是先把话语权统一

  1. 草稿阶段谁说了算
  2. 进入世界前谁负责最终编译
  3. 作品库里保存的到底是“正式世界”还是“当前草稿快照”

这件事不解决,后面所有优化都会继续打架。


4.2 第二件事:把结果页收口,只保留当前流程真正需要的事

现在结果页的问题很简单:

它干的活太多了。

它现在既像:

  1. 草稿预览页
  2. 旧自定义世界编辑器
  3. AI 补角色/补地点的入口
  4. 自动保存中转页
  5. 进入世界前的最后一跳

这就是为什么它会越来越乱。

这轮要做的不是重做结果页,而是收口结果页。

收口方向很明确:

  1. 结果页继续保留现在你满意的浏览和进入世界体验
  2. 但要逐步去掉“它自己偷偷改世界结构”的能力
  3. 让它更像“当前草稿的总览页”,而不是“另一套世界编辑器”

用大白话讲:

结果页负责看,不负责偷偷再造一遍世界。

所以这里建议后续逐步处理:

  1. 把结果页里那些直接生成 playable/story/landmark 的旧能力下掉
  2. 把直接改 legacy profile 的重编辑能力从结果页移走或收紧
  3. 让“去 Agent 调整设定”真的是回主流程调,而不是结果页自己补完半套流程

这一步做完的好处很直接:

  1. 结果页职责会清楚很多
  2. 进入世界前的状态会更稳定
  3. 不会再出现“用户以为还在 Agent 流里,实际上已经走到 legacy 编辑器里了”

4.3 第三件事:平台入口统一,不让草稿恢复和作品查看继续割裂

现在还有一个体验问题不是流程长短的问题,而是入口不统一。

简单说就是:

  1. 后端已经能区分“草稿”和“已发布作品”
  2. 但平台页里“我的创作”主要还在看 myEntries
  3. Agent 草稿并不能自然地稳定出现在同一个主入口里

这会带来两个问题:

  1. 用户做了一半的草稿,不容易稳定找回来
  2. 系统里其实已经有创作中心能力,但主入口没认它

所以接下来要做的不是新做一个创作中心,而是:

把已经存在的聚合能力真正接回现在的平台入口。

用户看到的应该是:

  1. 还没进世界的草稿,可以继续创作
  2. 已经成型的作品,可以查看或进入世界

而不是:

  1. 草稿在一套地方
  2. 已保存作品在另一套地方
  3. 恢复创作还得靠 sessionId 或隐藏状态兜底

这一步的核心价值不是“新功能”,而是“东西别丢、入口别分裂、用户心智别断”。


4.4 第四件事:删掉重复 pipeline不再同时养两三套创作生成链

这一步很关键,而且一定要明确态度:

既然你已经决定当前前端创作流程满意,那就不能继续默认保留那么多并行旧链。

现在最典型的重复链有:

  1. Agent 创作链
  2. custom-world/sessions 世界生成链
  3. 结果页 legacy profile 直改链

它们的共同问题是:

  1. 都能生成世界
  2. 都能改世界
  3. 但不是同一套状态模型
  4. 后期维护会越来越痛苦

所以这一步不是说要立刻把所有旧东西物理删除,而是要明确分层:

  1. 哪条是当前正式主链
  2. 哪条是兼容链
  3. 哪条只是暂时留着,但不能再往上继续加功能

用大白话讲,就是:

该扶正的扶正,该降级的降级,该冻结的冻结。

尤其是旧 custom-world/sessions 这条链,如果还要保留,也只能是兼容入口,不能再和 Agent 主链平起平坐。

补充更新(2026-04-21

这条旧 custom-world/sessions 世界生成链已经完成物理删除。

因此阶段三在当前仓库里的剩余任务,不再是“决定要不要保留这条旧链”,而是:

  1. 继续收掉结果页 legacy profile 直改能力的误导性职责
  2. 继续清理文档里把旧链当成现行选项的表述

4.5 第五件事:把文稿里那些“这轮不做”的未完成项从主叙事里移掉

这是你这次特别强调的点,我完全同意,而且它很重要。

现在很多文稿的问题不是“写错了”,而是:

  1. 写了很多理论上该有的能力
  2. 但当前版本并不准备继续往那个方向扩
  3. 结果文档会不断把团队拉回“是不是还要把这些补完”的思路里

这会直接制造两种问题:

  1. 开发判断会飘
  2. 后续审计会永远得到“未完成项很多”的结论

所以这轮文档治理要做的,不是把文稿全删空,而是分清三类内容:

  1. 当前版本要继续优化的
  2. 当前版本明确不做、先冻结的
  3. 未来可以再看,但这轮不纳入执行规划的

用大白话讲:

文档也要学会闭嘴。

不是所有想过的东西,都要继续挂在当前版本的主任务里。


5. 推荐执行顺序

这轮建议按下面顺序推进,不建议乱穿插。

第一阶段:先收主链

先做:

  1. 定义当前正式主链
  2. 明确 Agent session、结果页、作品库、进入世界之间谁负责什么
  3. 停止继续增强结果页里的 legacy 编辑能力

这一阶段的目标是:

先让水管只有一根。

第二阶段:再收结果页和平台入口

再做:

  1. 结果页职责收口
  2. 平台“我的创作”入口统一
  3. 草稿恢复和作品查看走同一套入口认知

这一阶段的目标是:

让用户走起来更顺,让系统找回内容更稳定。

第三阶段:清理旧链残留表述与剩余兼容误导

再做:

  1. 清理旧 custom-world/sessions 已删除链路在文档、索引、任务清单里的残留表述
  2. 结果页直改 profile 的旧能力继续收紧
  3. 把仍保留的兼容 façade / 兼容字段边界写清楚

这一阶段的目标是:

减少旧链文档误导和兼容边界漂移。

第四阶段:最后做文档清理

最后做:

  1. 把当前版本不再追的未完成项,从主规划文稿里移出去
  2. 把“未来也许做”从“这轮要做”里拆开
  3. 让所有当前规划只服务当前版本

就当前状态补一句最重要的执行口径:

  1. 已经物理删除的旧链和旧副面板,不再作为“本轮待落地项”
  2. 历史 PRD 可以保留实现设想,但必须和“当前版本执行规划”分开
  3. 当前版本规划只保留仍对正式主链有现实约束的事项

这一阶段的目标是:

让接下来所有开发都围绕同一套现实目标执行。


6. 每个阶段做完以后,应该看到什么效果

阶段一做完

应该看到:

  1. 代码里谁是主链一眼能看明白
  2. 不会再出现一会儿 Agent、一会儿 legacy profile 接管全局的情况
  3. 进入世界时的数据来源更清楚

阶段二做完

应该看到:

  1. 结果页更干净
  2. 平台页更容易找回自己的创作
  3. 用户对“草稿”“作品”“进入世界”这三个概念不会混

阶段三做完

应该看到:

  1. 已删除旧链不再继续出现在当前执行清单里
  2. 剩余兼容层的保留边界更清楚
  3. 后续开发不会再不知道该往哪条链上接

阶段四做完

应该看到:

  1. 文档和代码目标一致
  2. 团队不会再被一堆“理论上应该补”的项拉偏
  3. 后续迭代能真正围绕“优化已有流程”推进

7. 这轮最重要的判断标准

这轮不是看我们补了多少功能。

这轮的判断标准应该是下面 5 条:

  1. 用户现在这条创作流程有没有被打断
  2. 同一个世界的数据是不是只走一条清楚的主链
  3. 结果页是不是还在偷偷承担旧编辑器职责
  4. 平台入口能不能稳定找回草稿和作品
  5. 文档是不是已经不再推动大家去补这轮明确不做的东西

如果这 5 条做好了,就说明这轮方向是对的。


8. 一句话总结

接下来的优化,不是再发明一套更复杂的创作流程,而是把当前你已经满意的这条前端动线背后的数据链、入口、职责和文档全部收紧到同一个方向上:

少一点并行、少一点桥接、少一点重复、少一点“半做半留”,把现有流程真正打磨成一条稳定主链。