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

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 系统使用当前视频模型的默认尺寸作为兼容回退