feat(viral-video): v1.6 单次Seedance出片+编导分镜脚本 #2124

- 输出从营销口播文案改为专业编导分镜脚本（CopyResult v1.6：overview/scene_and_lighting/shots/hard_constraints/negative_prompts/voiceover_script）
- 新 SCRIPT_GENERATION 阶段替代原 copy_fusion+storyboard+review，prompt 指导 LLM 输出严格 JSON 结构
- pipeline 简化为4步：图片分析 → 编导脚本 → TTS整段合成(上传OSS做reference_audios) → 单次Seedance出片 → 上传
- 删除：多段分镜拆分、ffmpeg concat拼接、placeholder占位视频、分段重试降级、BGM单独混音（Seedance generate_audio=true原生合成音效/BGM）
- ai_client/ai_service video_generation 支持 reference_images/reference_audios/reference_videos/generate_audio 参数
- duration 默认15秒，上限30秒；前端时长下拉 5/10/15/20/25/30s
- 首帧图模式不传 ratio（保持 #2110 修复）
- Alembic migration 088 幂等添加 voice_id/voice_source/video_ratio/video_model/copy_result 五列
- _step_image_analysis call_vision() 全路径 None 防护
- 向后兼容：final_copy=voiceover_script、storyboard=shots、老数据 _build_copy_result 降级拼装
- TS types 更新 CopyResult v1.6 结构 + ShotScript/Overview
- 96个 viral 相关单测全通过

apps/web/src/api/viral-video/types.ts

@@ -12,6 +12,14 @@ export const STYLE_STRENGTHS: { value: StyleStrength; label: string }[] = [
   { value: "strict", label: "像素级复刻" },
 ]
 
+/** v1.6 前端时长下拉选项（5/10/15/20/25/30秒） */
+export const VALID_DURATIONS = [5, 10, 15, 20, 25, 30] as const
+export type VideoDuration = (typeof VALID_DURATIONS)[number]
+
+/** v1.6 支持的画幅比例 */
+export const VALID_RATIOS = ["9:16", "16:9", "1:1"] as const
+export type VideoRatio = (typeof VALID_RATIOS)[number]
+
 export type ViralVideoStatus =
   | "pending"
   | "running"
@@ -23,39 +31,25 @@ export type ViralVideoStatus =
   | "cancelled"
 
 /**
- * 后端流水线阶段字符串。前端不展示逐阶段进度列表，仅保留类型
- * 用于轮询时判断当前在哪个大阶段（分析中 vs 文案生成 vs 视频生成）。
+ * v1.6 后端流水线阶段。单次 Seedance 出片版：
+ * image_analysis → video_analysis(可选) → intent_parsing → script_generation → review → tts → rendering → uploading
  */
 export type ViralVideoStage =
   | "image_analysis"
   | "video_analysis"
   | "intent_parsing"
-  | "copy_fusion"
-  | "storyboard"
+  | "script_generation"
   | "review"
   | "tts"
-  | "bgm_select"
   | "rendering"
-  | "musetalk"
   | "uploading"
 
 /** 图片+视频分析阶段：属于「分析图片」按钮的范围 */
 const IMAGE_ANALYSIS_STAGES = new Set<ViralVideoStage>(["image_analysis", "video_analysis"])
-/** 文案相关阶段：属于「生成文案」按钮的范围 */
-const COPY_STAGES = new Set<ViralVideoStage>([
-  "intent_parsing",
-  "copy_fusion",
-  "storyboard",
-  "review",
-])
-/** 视频相关阶段：属于「开始生成视频」按钮的范围 */
-const VIDEO_STAGES = new Set<ViralVideoStage>([
-  "tts",
-  "bgm_select",
-  "rendering",
-  "musetalk",
-  "uploading",
-])
+/** 编导脚本阶段：属于「生成文案」按钮的范围 */
+const COPY_STAGES = new Set<ViralVideoStage>(["intent_parsing", "script_generation", "review"])
+/** 视频生成阶段：属于「开始生成视频」按钮的范围（v1.6: TTS+单次Seedance+上传） */
+const VIDEO_STAGES = new Set<ViralVideoStage>(["tts", "rendering", "uploading"])
 
 export function isImageAnalysisStage(stage: ViralVideoStage | undefined): boolean {
   return !!stage && IMAGE_ANALYSIS_STAGES.has(stage)
@@ -66,7 +60,7 @@ export function isCopyStage(stage: ViralVideoStage | undefined): boolean {
 export function isVideoStage(stage: ViralVideoStage | undefined): boolean {
   return !!stage && VIDEO_STAGES.has(stage)
 }
-/** 兼容旧调用：旧的 isAnalysisStage 视为「图片分析+文案」的所有前置阶段 */
+/** 兼容旧调用：分析图片+生成文案 的所有前置阶段 */
 export function isAnalysisStage(stage: ViralVideoStage | undefined): boolean {
   return isImageAnalysisStage(stage) || isCopyStage(stage)
 }
@@ -74,12 +68,20 @@ export function isAnalysisStage(stage: ViralVideoStage | undefined): boolean {
 /** 单张图片 VLM 识别出的商品信息 */
 export interface ImageProductAnalysis {
   name?: string
-  spec?: string
+  category?: string
   brand?: string
+  colors?: string[]
+  material_or_texture?: string
+  key_features?: string[]
+  visual_style?: string
+  scene?: string
+  target_audience_hint?: string
+  text_on_image?: string
+  /** 旧字段兼容 */
+  spec?: string
   features?: string[] | string
   label_text?: string
-  selling_points?: string[]
-  scene?: string
+  selling_points?: string
   image_index?: number
 }
 
@@ -87,10 +89,50 @@ export interface ImageAnalysisResult {
   products?: ImageProductAnalysis[]
 }
 
+/** v1.6 编导分镜脚本 - 单镜头 */
+export interface ShotScript {
+  /** 时间区间，如 "0-3秒" */
+  time_range?: string
+  /** 景别/角度/运镜，如 "近景俯拍45度，缓慢推镜" */
+  shot_type_angle_movement?: string
+  /** 场景描述+对白 */
+  scene_and_dialogue?: string
+  /** 人物动作/表情/物品操作细节 */
+  action_details?: string
+  /** 环境音+BGM提示 */
+  audio_bgm?: string
+  /** 转场方式（硬切/淡入淡出/叠化/结束） */
+  transition?: string
+  /** 参考图片索引（0-based，对应上传产品图数组） */
+  reference_image_index?: number | null
+}
+
+/** v1.6 编导分镜脚本 - 总览 */
+export interface CopyResultOverview {
+  theme?: string
+  total_duration?: number
+  aspect_ratio?: string
+}
+
+/** v1.6 编导分镜脚本（核心输出结构，给 Seedance 做 prompt，给 TTS 取 voiceover_script） */
 export interface CopyResult {
+  overview?: CopyResultOverview
+  /** 整体场景+光线描述 */
+  scene_and_lighting?: string
+  /** 逐镜头时间轴 */
+  shots?: ShotScript[]
+  /** 硬性约束（禁止字幕/水印/变形等） */
+  hard_constraints?: string[]
+  /** 负面提示词 */
+  negative_prompts?: string[]
+  /** 完整口播稿（纯文本，用于 TTS 合成） */
+  voiceover_script?: string
+  /** 向后兼容：= voiceover_script */
   final_copy?: string
+  /** 向后兼容：= voiceover_script */
   suggested_copy?: string
   title?: string
+  /** v1.5 旧字段兼容（老数据降级时可能出现） */
   scenes?: Array<{ shot: string; narration: string; duration?: number }>
 }
 
@@ -104,13 +146,18 @@ export interface StyleTemplate {
 }
 
 export interface IntentResult {
-  product: string
-  selling_points: string[]
-  target_audience: string
-  tone: string
-  structure: string
-  duration: number
+  intent?: string
+  key_messages?: string[]
+  tone?: string
+  target_emotion?: string
+  call_to_action?: string
   suggested_title?: string
+  /** v1.5 旧字段兼容 */
+  product?: string
+  selling_points?: string[]
+  target_audience?: string
+  structure?: string
+  duration?: number
   suggested_copy?: string
 }
 
@@ -123,7 +170,9 @@ export interface ViralVideoJob {
   style_template_id?: string
   style_guide?: string | Record<string, unknown>
   user_copy_text?: string
+  /** v1.6: = copy_result.voiceover_script（从 copy_result 派生，向后兼容） */
   final_copy_text?: string
+  generated_copy_text?: string
   fusion_level?: FusionLevel
   voice_id?: string
   voice_mode?: "global" | "per_video"
@@ -131,12 +180,17 @@ export interface ViralVideoJob {
   bgm_preference?: string
   intent_result?: IntentResult
   intent_text?: string
+  /** v1.6 编导分镜脚本（核心产物） */
   copy_result?: CopyResult
+  /** 向后兼容：= copy_result.shots */
+  storyboard?: ShotScript[]
   image_analysis?: ImageAnalysisResult
-  /** 视频比例 */
+  /** 视频比例：9:16 / 16:9 / 1:1，默认 9:16 */
   video_ratio?: string
-  /** Seedance 模型 ID */
+  /** Seedance 模型 ID（空=后端默认） */
   video_model?: string
+  /** 视频时长（秒，5-30，默认15） */
+  duration?: number
   progress_stage?: ViralVideoStage
   progress_percent?: number
   progress_message?: string
@@ -166,6 +220,7 @@ export interface GenerateViralVideoRequest {
   persona_id?: string
   viral_structure?: string
   marketing_purpose?: string
+  /** 视频时长（5-30秒，默认15） */
   duration?: number
   video_model?: string
   video_ratio?: string
@@ -180,23 +235,25 @@ export interface HistoryResponse {
   page_size: number
 }
 
-/** v1.5 阶段1请求：仅做图片/视频分析（POST /viral-video/analyze-images） */
+/** v1.6 阶段1请求：图片/视频分析（POST /viral-video/analyze-images） */
 export interface AnalyzeImagesRequest {
   images: string[]
   reference_video_url?: string
   style_template_id?: string
   style_strength?: StyleStrength
-  /** TTS 音色 ID（STEP1 已选音色时传；阶段2 generate-copy 可覆盖） */
+  /** TTS 音色 ID（STEP1 已选音色时传） */
   voice_id?: string
   /** 音色来源：preset | library | clone | upload */
   voice_source?: "preset" | "library" | "clone" | "upload"
-  /** Seedance 视频比例：9:16 | 16:9 | 1:1 等 */
+  /** Seedance 视频比例：9:16 | 16:9 | 1:1 */
   video_ratio?: string
   /** Seedance 模型 ID（空则使用服务端默认） */
   video_model?: string
+  /** 视频时长（秒，5-30，默认15） */
+  duration?: number
 }
 
-/** v1.5 阶段2请求：填完营销参数后生成文案+分镜（POST /viral-video/{id}/generate-copy） */
+/** v1.6 阶段2请求：填完营销参数后生成编导分镜脚本（POST /viral-video/{id}/generate-copy） */
 export interface GenerateCopyRequest {
   industry?: string
   target_customer?: string
@@ -204,6 +261,7 @@ export interface GenerateCopyRequest {
   viral_structure?: string
   marketing_purpose?: string
   bgm_preference?: string
+  /** 视频时长（秒，5-30，默认15） */
   duration?: number
   user_copy_text?: string
   fusion_level?: FusionLevel
@@ -222,13 +280,13 @@ export interface GenerateCopyRequest {
   video_model?: string
 }
 
-/** v1.5 阶段3请求：用户确认/编辑文案后开始渲染（POST /viral-video/{id}/confirm-copy） */
+/** v1.6 阶段3请求：用户确认/编辑口播文案后开始单次 Seedance 出片（POST /viral-video/{id}/confirm-copy） */
 export interface ConfirmCopyRequest {
-  /** 用户编辑后的最终文案；为空则使用 AI 生成文案 */
+  /** 用户编辑后的口播文案；为空则使用 AI 生成的 voiceover_script */
   edited_copy?: string
 }
 
-/** 分镜片段结构（后端 storyboard 字段的元素形态，保留供调试/进阶使用；主流程请使用 copy_result.scenes） */
+/** 旧分镜片段结构（保留兼容；新代码请使用 ShotScript） */
 export interface StoryboardSegment {
   order: number
   type: string