1

docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md

@@ -0,0 +1,388 @@
+# 当前 Agent 创作流程优化执行规划（大白话版）
+
+更新时间：`2026-04-20`
+
+## 先把话说死
+
+这轮不再加新流程。
+
+不再新增一套创作动线。
+不再为了“更完整”继续把 PRD 里没落完的所有阶段、面板、动作全补出来。
+不再把前端创作工具改成另一套长得不一样的新系统。
+
+这轮只做一件事：
+
+**把现在这条你已经满意的前端创作流程，收紧、理顺、删重、补通，让它从“能跑”变成“稳、顺、好维护、不会自己打自己”。**
+
+这份规划就是基于 [AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md](../audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md) 里已经确认的问题，重新收束出来的一版执行方案。
+
+---
+
+## 1. 现在最大的问题，用大白话讲是什么
+
+不是界面丑。
+不是步骤不够多。
+不是入口不够花。
+
+而是现在这条链里，很多地方在“一个流程里混着好几套脑子”。
+
+具体就是：
+
+1. 用户明明在走 Agent 创作，但走到一半，很多关键数据又偷偷变成了 old profile 流程在接手。
+2. 明明已经有 Agent session 这条主线，但结果页、作品库、旧生成接口、旧编辑器能力还都在同时干活。
+3. 明明有“发布世界”这个概念，但现在实际上“不发布也能直接进入世界”。
+4. 明明有一些 session 内的数据，比如建议动作、草稿卡、澄清项、质量检查，结果走到结果页之后就像断电了一样，后面没人接着用。
+5. 明明有些功能已经决定这轮不做，但代码里和文档里还留着很多“半做不做”的说法，会持续误导后续开发。
+
+所以这轮优化的目标不是“让系统更大”，而是：
+
+**让整条现有流程只认一条主线，别再一会儿 Agent、一会儿 legacy、一会儿旧 session、一会儿作品库各管各的。**
+
+---
+
+## 2. 这轮优化后的目标状态
+
+我们要收敛到下面这个状态：
+
+```text
+用户进入 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. 不把当前工作区重新改造成一个更复杂的大后台
+
+### 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 主链平起平坐。
+
+---
+
+## 4.5 第五件事：把文稿里那些“这轮不做”的未完成项从主叙事里移掉
+
+这是你这次特别强调的点，我完全同意，而且它很重要。
+
+现在很多文稿的问题不是“写错了”，而是：
+
+1. 写了很多理论上该有的能力
+2. 但当前版本并不准备继续往那个方向扩
+3. 结果文档会不断把团队拉回“是不是还要把这些补完”的思路里
+
+这会直接制造两种问题：
+
+1. 开发判断会飘
+2. 后续审计会永远得到“未完成项很多”的结论
+
+所以这轮文档治理要做的，不是把文稿全删空，而是分清三类内容：
+
+1. **当前版本要继续优化的**
+2. **当前版本明确不做、先冻结的**
+3. **未来可以再看，但这轮不纳入执行规划的**
+
+用大白话讲：
+
+**文档也要学会闭嘴。**
+
+不是所有想过的东西，都要继续挂在当前版本的主任务里。
+
+---
+
+## 5. 推荐执行顺序
+
+这轮建议按下面顺序推进，不建议乱穿插。
+
+## 第一阶段：先收主链
+
+先做：
+
+1. 定义当前正式主链
+2. 明确 Agent session、结果页、作品库、进入世界之间谁负责什么
+3. 停止继续增强结果页里的 legacy 编辑能力
+
+这一阶段的目标是：
+
+**先让水管只有一根。**
+
+## 第二阶段：再收结果页和平台入口
+
+再做：
+
+1. 结果页职责收口
+2. 平台“我的创作”入口统一
+3. 草稿恢复和作品查看走同一套入口认知
+
+这一阶段的目标是：
+
+**让用户走起来更顺，让系统找回内容更稳定。**
+
+## 第三阶段：再处理旧 pipeline 的降级和冻结
+
+再做：
+
+1. 旧 `custom-world/sessions` 链降级
+2. 结果页直改 profile 的旧能力收紧
+3. 兼容链保留边界写清楚
+
+这一阶段的目标是：
+
+**减少系统自己和自己打架。**
+
+## 第四阶段：最后做文档清理
+
+最后做：
+
+1. 把当前版本不再追的未完成项，从主规划文稿里移出去
+2. 把“未来也许做”从“这轮要做”里拆开
+3. 让所有当前规划只服务当前版本
+
+这一阶段的目标是：
+
+**让接下来所有开发都围绕同一套现实目标执行。**
+
+---
+
+## 6. 每个阶段做完以后，应该看到什么效果
+
+## 阶段一做完
+
+应该看到：
+
+1. 代码里谁是主链一眼能看明白
+2. 不会再出现一会儿 Agent、一会儿 legacy profile 接管全局的情况
+3. 进入世界时的数据来源更清楚
+
+## 阶段二做完
+
+应该看到：
+
+1. 结果页更干净
+2. 平台页更容易找回自己的创作
+3. 用户对“草稿”“作品”“进入世界”这三个概念不会混
+
+## 阶段三做完
+
+应该看到：
+
+1. 重复 pipeline 明显减少
+2. 旧链不再继续吞主流程职责
+3. 后续开发不会再不知道该往哪条链上接
+
+## 阶段四做完
+
+应该看到：
+
+1. 文档和代码目标一致
+2. 团队不会再被一堆“理论上应该补”的项拉偏
+3. 后续迭代能真正围绕“优化已有流程”推进
+
+---
+
+## 7. 这轮最重要的判断标准
+
+这轮不是看我们补了多少功能。
+
+这轮的判断标准应该是下面 5 条：
+
+1. 用户现在这条创作流程有没有被打断
+2. 同一个世界的数据是不是只走一条清楚的主链
+3. 结果页是不是还在偷偷承担旧编辑器职责
+4. 平台入口能不能稳定找回草稿和作品
+5. 文档是不是已经不再推动大家去补这轮明确不做的东西
+
+如果这 5 条做好了，就说明这轮方向是对的。
+
+---
+
+## 8. 一句话总结
+
+接下来的优化，不是再发明一套更复杂的创作流程，而是把当前你已经满意的这条前端动线背后的数据链、入口、职责和文档全部收紧到同一个方向上：
+
+**少一点并行、少一点桥接、少一点重复、少一点“半做半留”，把现有流程真正打磨成一条稳定主链。**