Initial TrueGrowth source import

openspec/specs/video-batch-generation/spec.md

@@ -0,0 +1,71 @@
+# video-batch-generation Specification
+
+## Purpose
+TBD - created by archiving change update-batch-video-chaining. Update Purpose after archive.
+## Requirements
+### Requirement: 批量视频生成必须按镜头顺序串行执行
+
+爆款 MV 与爆款视频生成工具在用户执行“全部→生成视频”时，系统 SHALL 按镜头顺序逐段生成视频，而不是一次性并发提交全部片段。
+
+#### Scenario: 串行生成下一段
+
+- **WHEN** 用户在生成页点击“全部→生成视频”
+- **THEN** 系统只创建当前镜头的视频任务
+- **AND** 当前镜头成功后才开始下一镜头的视频生成
+
+### Requirement: 片段之间必须自动传递尾帧到下一段首帧
+
+系统 SHALL 在串行批量生成时自动提取上一段视频尾帧，并将其作为下一段的首帧输入。
+
+#### Scenario: 首段使用参考图启动
+
+- **WHEN** 用户已上传参考图并开始批量生成
+- **THEN** 第 1 段使用参考图作为首帧输入
+
+#### Scenario: 后续段使用上一段尾帧
+
+- **WHEN** 第 N 段视频生成成功且存在第 N+1 段
+- **THEN** 系统提取第 N 段视频尾帧
+- **AND** 将该尾帧写入第 N+1 段的首帧输入
+
+#### Scenario: 已生成片段跳过并继续传帧
+
+- **WHEN** 某一镜头已经存在已生成视频
+- **THEN** 系统跳过该镜头的新任务创建
+- **AND** 直接从已有视频提取尾帧并继续驱动下一镜头
+
+### Requirement: 批量串行生成失败后必须自动重试
+
+系统 SHALL 在批量串行生成的当前镜头失败后立即自动重试，直到成功或用户主动停止本轮批量生成。
+
+#### Scenario: 当前镜头失败后立即重试
+
+- **WHEN** 批量生成中的某个镜头任务失败
+- **THEN** 系统立即重新提交或重试该镜头任务
+- **AND** 不推进到下一镜头
+
+#### Scenario: 用户主动停止批量生成
+
+- **WHEN** 用户在批量串行生成过程中执行停止
+- **THEN** 系统停止当前批量编排
+- **AND** 不再创建后续镜头任务
+
+### Requirement: 生成页必须提供统一的视频尺寸参数
+
+爆款 MV 与爆款视频生成工具的生成页 SHALL 在视频模型下方提供尺寸选择，并统一作用于单镜头生成与批量生成。
+
+#### Scenario: 单镜头与批量入口共享尺寸
+
+- **WHEN** 用户在生成页选择某个视频尺寸
+- **THEN** 单镜头“生成视频”与“全部→生成视频”都使用该尺寸参数
+
+#### Scenario: 模型切换时回退到有效尺寸
+
+- **WHEN** 用户切换视频模型且当前已选尺寸不被新模型支持
+- **THEN** 系统自动回退到新模型的默认尺寸
+
+#### Scenario: 旧记录缺少尺寸字段
+
+- **WHEN** 用户打开一条旧历史记录且其中未保存视频尺寸
+- **THEN** 系统使用当前视频模型的默认尺寸作为兼容回退
+