Initial TrueGrowth source import

openspec/changes/add-comic-strip-generator/design.md

@@ -0,0 +1,104 @@
+## Context
+
+「连环画生成」是面向多页图片的独立创作工具。它需要把一段故事拆成可控分镜，再把公共风格、角色设定、画幅和每页情节组合为多次图片生成请求。与普通单图生成相比，它的主要风险是批量任务、历史恢复和导出阶段可能产生高并发网络请求、大图持久化或内存峰值。
+
+## Goals / Non-Goals
+
+- Goals:
+  - 提供独立工具入口，能力名为 `comic-generation-workflow`
+  - 支持故事到分镜提示词规划，并允许公共提示词与单页提示词分别编辑
+  - 支持串行和并行图片生成，保留可观察、可取消、可重试的队列状态
+  - 支持轻量历史记录和 ZIP/PPTX/PDF 导出
+  - 明确内存约束：不持久化大图/base64，导出按引用 fetch 并限流或串行
+- Non-Goals:
+  - 本次不要求实现复杂分镜排版编辑器或画布级漫画排版
+  - 本次不要求提供角色一致性训练、LoRA 管理或跨模型风格迁移
+  - 本次不把导出的 ZIP/PPTX/PDF 作为长期历史附件持久化
+
+## Decisions
+
+- Decision: 使用两阶段工作流
+
+  - 阶段一为提示词规划，产出 `commonPrompt` 与 `pages[]`
+  - 阶段二为图片生成，按每页 `commonPrompt + pagePrompt` 提交图片任务
+  - 用户可以在生成前编辑公共提示词、单页提示词、页序和页数
+
+- Decision: 公共提示词和单页提示词分开存储
+
+  - 公共提示词承载画风、角色、镜头语言、统一负面约束和画幅
+  - 单页提示词承载当前页剧情、动作、对白提示和构图重点
+  - 生成请求阶段才组合最终提示词，避免历史记录中产生大量重复长文本
+
+- Decision: 生成队列必须有明确并发边界
+
+  - 串行模式按页序一张一张生成，适合强调连续性和低资源占用
+  - 并行模式使用小并发上限，适合快速探索，但仍通过队列调度限制同时运行任务
+  - 已完成页面只保存结果引用和轻量预览元数据，不复制原始大图
+
+- Decision: 历史记录只保存可恢复的轻量状态
+
+  - 保存标题、创建/更新时间、规划文本、页列表、模型参数、任务状态、错误摘要和结果 URL/asset id
+  - 不保存原图二进制、大图 data URL、base64、完整响应体或批量导出文件
+  - 历史恢复时按引用加载预览，引用失效时展示可重生或重新导出的状态
+
+- Decision: 导出采用流式/限流资源处理
+
+  - ZIP 导出逐页 fetch 图片并写入压缩包条目，避免先把全部图片读入数组
+  - PPTX/PDF 导出按页拉取图片并及时释放中间对象
+  - 所有导出默认串行或低并发 fetch，失败时停止或标记失败页，不扩大内存占用
+
+## Data Shape
+
+```ts
+type ComicProject = {
+  id: string;
+  title: string;
+  createdAt: number;
+  updatedAt: number;
+  commonPrompt: string;
+  generationMode: "serial" | "parallel";
+  concurrencyLimit: number;
+  modelConfig: {
+    providerId: string;
+    modelId: string;
+    aspectRatio?: string;
+    size?: string;
+  };
+  pages: ComicPage[];
+};
+
+type ComicPage = {
+  id: string;
+  index: number;
+  title?: string;
+  prompt: string;
+  locked?: boolean;
+  status: "draft" | "queued" | "running" | "succeeded" | "failed" | "cancelled";
+  resultRef?: {
+    url?: string;
+    assetId?: string;
+    thumbnailUrl?: string;
+  };
+  error?: string;
+};
+```
+
+## Risks / Trade-offs
+
+- 风险: 并行生成导致供应商限流或本地内存峰值
+  - Mitigation: 并行模式必须使用并发上限，并允许回退到串行生成
+
+- 风险: 历史记录把图片 base64 写入本地存储
+  - Mitigation: 历史 schema 明确禁止大图/base64，仅保存引用和轻量元数据
+
+- 风险: 导出多页 PPTX/PDF 时一次性读入全部图片
+  - Mitigation: 导出实现必须逐页 fetch，串行或限流处理，并在写入后释放临时对象
+
+- 风险: 重新规划覆盖用户手动修改
+  - Mitigation: 支持锁定页面和保留已编辑字段，重新规划只更新未锁定草稿
+
+## Open Questions
+
+- 并行生成默认并发上限是 2 还是跟随供应商配置动态决定
+- 历史图片引用过期后是否提供一键批量重生
+- PPTX/PDF 是否需要额外支持封面页和目录页