xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 11 Pull Requests 2 Actions 1 Packages Projects Releases 7 Wiki Activity

P1: 支持生成多个预览视频 — 用户选择数量，每个可播放 #1281

New Issue
Closed
opened 2026-08-07 20:46:26 +08:00 by xiaoxia · 0 comments
xiaoxia commented 2026-08-07 20:46:26 +08:00
Owner
Copy Link
Copy Source

需求

用户可以主动选择生成预览视频的数量（如1-5个），每个预览视频都能可视化播放。预览视频必须包含用户选择的配音音频。

步骤顺序调整

当前步骤：模板(1) → 素材(2) → 预览(3) → 标题(4) → 配音(5) → 封面(6) → 确认(7)

问题： 配音在预览之后选择，导致预览视频没有音频

新步骤： 模板(1) → 素材(2) → 配音(3) → 预览(4) → 标题(5) → 封面(6) → 确认(7)

  • 配音选择移到预览生成之前
  • 预览生成时将 voice_ids 传给后端，确保预览视频包含配音

交互设计

新 Step 3 配音选择：

  • 从原 Step 5 移至此处
  • 选择配音后，进入预览生成步骤

新 Step 4 生成预览：

  • 新增「预览数量」选择器（如 1/2/3/4/5 个）
  • 点击「生成预览」后，后端批量创建对应数量的预览任务
  • 每个预览视频必须包含用户选择的配音
  • 每个预览视频使用不同的随机素材组合/截取方式
  • 预览结果区域改为网格/列表展示，每个视频独立可播放（含音频）
  • 用户可以点击某个预览视频选中它，进入下一步

当前代码现状

  • 后端API CreatePreviewRequest 已支持 voice_ids 字段
  • 前端类型定义已支持 voice_ids
  • 但前端 useStep3Preview.ts 调用时未传递 voice_ids
  • 步骤顺序：预览(3) → 标题(4) → 配音(5)，配音在预览之后

需要改动

后端

  • 新增批量预览API 或 扩展现有API支持 count 参数
  • 批量创建多个独立的 GenerationTask（is_preview=True）
  • 每个任务使用不同的随机种子/素材选取方式
  • 确保 voice_ids 被正确传入渲染流程

前端

  • 调整步骤顺序：配音移到预览之前
  • 修改 constants.ts 中的 STEPS 定义
  • useStep3Preview.ts 改为支持多个预览任务（数组）+ 传递 voice_ids
  • PreviewVideoPanel.tsx 改为网格/列表布局，支持多视频展示
  • 新增「预览数量」选择器组件
  • 每个视频卡片支持点击选中

依赖

  • #1280（预览加速）— 多预览叠加后总耗时会增加，需要先确保单个预览足够快

验收标准

  • 用户可选择生成1-5个预览视频
  • 每个预览视频都能独立播放，且包含配音音频
  • 多个预览视频的内容应有差异（不同素材组合/截取）
  • 所有预览视频并行生成，总耗时 ≈ 单个预览耗时（不是线性叠加）
  • 步骤顺序正确：配音在预览之前

相关代码

  • 后端：apps/api/app/api/routes/generation_preview.py
  • 前端 Hook：apps/web/src/pages/generate/hooks/useStep3Preview.ts
  • 前端组件：apps/web/src/pages/generate/components/PreviewVideoPanel.tsx
  • 前端 API：apps/web/src/api/generation/preview.ts
  • 步骤定义：apps/web/src/pages/generate/constants.ts（STEPS 数组）
## 需求 用户可以主动选择生成预览视频的数量（如1-5个），每个预览视频都能可视化播放。**预览视频必须包含用户选择的配音音频。** ## 步骤顺序调整 当前步骤：模板(1) → 素材(2) → 预览(3) → 标题(4) → **配音(5)** → 封面(6) → 确认(7) **问题：** 配音在预览之后选择，导致预览视频没有音频 **新步骤：** 模板(1) → 素材(2) → **配音(3)** → **预览(4)** → 标题(5) → 封面(6) → 确认(7) - 配音选择移到预览生成之前 - 预览生成时将 `voice_ids` 传给后端，确保预览视频包含配音 ## 交互设计 **新 Step 3 配音选择：** - 从原 Step 5 移至此处 - 选择配音后，进入预览生成步骤 **新 Step 4 生成预览：** - 新增「预览数量」选择器（如 1/2/3/4/5 个） - 点击「生成预览」后，后端批量创建对应数量的预览任务 - **每个预览视频必须包含用户选择的配音** - 每个预览视频使用不同的随机素材组合/截取方式 - 预览结果区域改为网格/列表展示，每个视频独立可播放（含音频） - 用户可以点击某个预览视频选中它，进入下一步 ## 当前代码现状 - 后端API `CreatePreviewRequest` **已支持** `voice_ids` 字段 - 前端类型定义**已支持** `voice_ids` - 但前端 `useStep3Preview.ts` 调用时**未传递** `voice_ids` - 步骤顺序：预览(3) → 标题(4) → 配音(5)，配音在预览之后 ## 需要改动 ### 后端 - 新增批量预览API 或 扩展现有API支持 count 参数 - 批量创建多个独立的 GenerationTask（is_preview=True） - 每个任务使用不同的随机种子/素材选取方式 - 确保 voice_ids 被正确传入渲染流程 ### 前端 - **调整步骤顺序**：配音移到预览之前 - 修改 `constants.ts` 中的 STEPS 定义 - `useStep3Preview.ts` 改为支持多个预览任务（数组）+ 传递 voice_ids - `PreviewVideoPanel.tsx` 改为网格/列表布局，支持多视频展示 - 新增「预览数量」选择器组件 - 每个视频卡片支持点击选中 ## 依赖 - **#1280**（预览加速）— 多预览叠加后总耗时会增加，需要先确保单个预览足够快 ## 验收标准 - 用户可选择生成1-5个预览视频 - 每个预览视频都能独立播放，**且包含配音音频** - 多个预览视频的内容应有差异（不同素材组合/截取） - 所有预览视频并行生成，总耗时 ≈ 单个预览耗时（不是线性叠加） - 步骤顺序正确：配音在预览之前 ## 相关代码 - 后端：`apps/api/app/api/routes/generation_preview.py` - 前端 Hook：`apps/web/src/pages/generate/hooks/useStep3Preview.ts` - 前端组件：`apps/web/src/pages/generate/components/PreviewVideoPanel.tsx` - 前端 API：`apps/web/src/api/generation/preview.ts` - 步骤定义：`apps/web/src/pages/generate/constants.ts`（STEPS 数组）
xiaoxia added the devops label 2026-08-07 20:46:26 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
P0
阻塞性，必须立即处理
 P1
高优先级
 P2
中优先级
 P3
低优先级/后考虑
 architecture
架构设计
 backend
后端相关
 blocked
阻塞中
 bug
Bug修复
 ci-bug
CI本身的bug
 ci-optimization
CI优化类任务
 ci-pipeline
CI流水线/workflow相关
 cleanup
代码清理
 devops
运维/部署/CI
 documentation
文档相关
 feature
新功能
 frontend
前端相关
 question
需要讨论确认
 ready
PR CI通过，可合并
 refactor
代码重构
No Label devops
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
auto-approve-bot xiaoxia
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1281
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?