Initial TrueGrowth source import

docs/MULTI_IMAGE_GENERATION_WORKFLOW_LESSONS.md

@@ -0,0 +1,61 @@
+# 多图生成工作流经验总结
+
+更新日期：2026-04-30
+
+## 背景
+
+「多图生成」原本以连环画为主要入口，但实际承载的是多页图片规划、批量生成和导出流程。它需要覆盖故事分镜、教程步骤、产品手册、营销图文等更多场景，同时保持批量生成时的稳定性和低内存占用。
+
+## 经验
+
+### 1. 改展示名，不要轻易改工具 id
+
+面向用户的工具名可以从「连环画生成」扩展为「多图生成」，但内部 `comic-creator` id、存储 key、任务元数据不应同步重命名。展示层改名能降低迁移风险，也避免历史记录、任务恢复和懒加载注册失效。
+
+落地原则：
+
+- 用户可见的 `name` / `description` 放宽到多场景表达。
+- 内部 id、组件名、存储 key 保持稳定。
+- 业务文案可扩展，数据结构不为一次改名付出迁移成本。
+
+### 2. 提示词优化入口优先复用公共能力
+
+公共提示词和单页提示词都需要优化入口，但不必新增 `comic.common` / `comic.page` 场景实体。现有 `PromptOptimizeButton` 与 `tool.image` 场景已经能覆盖图片生成提示词优化。
+
+落地原则：
+
+- 公共提示词使用普通润色，重点收敛整套图片的统一风格。
+- 单页提示词允许结构化 JSON，保留更强的画面可控性。
+- 优化 icon 放在标题行，避免占用 textarea 编辑区。
+- 不新增场景实体，除非现有 `tool.image` 已无法表达业务差异。
+
+### 3. 串行生成应跳过已有图，但不能丢失连续性
+
+串行生成的价值在于后一页参考前一页图片。如果跳过已生成页时简单从待生成列表取上一项，会丢失真实上一页参考图。
+
+更稳的做法：
+
+- 批量串行时过滤已有 `imageUrl` 的页面，避免重复消耗生成额度。
+- 单页重生不跳过，保留用户主动覆盖能力。
+- 每次生成当前页前，从最新记录里按 `pageNumber - 1` 查找上一页图片。
+- 被跳过的已生成页仍可作为后一页参考图。
+
+### 4. 首尾页操作要隐藏无效动作
+
+第一页不能上移、最后一页不能下移。相比禁用按钮，直接不渲染无效 icon 更清爽，也减少误点击和 hover 噪音。
+
+落地原则：
+
+- `index > 0` 才显示上移。
+- `index < pages.length - 1` 才显示下移。
+- 批量生成中仍禁用有效的排序按钮，避免任务执行期间页面顺序变动。
+
+## 检查清单
+
+- 工具展示名是否只改用户可见层？
+- 是否避免新增不必要的优化场景实体？
+- 串行批量是否跳过已有图？
+- 单页重生是否仍能覆盖已有图？
+- 跳过页是否仍能被后一页作为参考图？
+- 列表中的无效操作 icon 是否被隐藏而不是仅禁用？
+- 提示词优化按钮是否禁用生成中状态？