feat(viral-video): v1.5 三步分步流水线 analyze-images/generate-copy/confirm-copy #2117

Merged

auto-approve-bot merged 1 commits from fix/2115-three-stage-pipeline into develop 2026-10-01 11:57:39 +08:00

Conversation 2 Commits 1 Files Changed 11

+837 -102

xiaoxia commented 2026-10-01 11:09:38 +08:00

Owner

Copy Link

Copy Source

背景

前端 STEP1 UI 重做（#2041）要求后端支持三步独立操作：

1. 图片分析：上传图片后立即做 VLM 分析，拿到结构化商品信息展示给用户
2. 文案生成：用户填完营销参数后跑 意图→文案→分镜→审核，暂停给用户编辑文案
3. 视频渲染：用户确认/编辑文案后跑 TTS→渲染→上传

方案

最小改动：新增两个暂停状态 + 三个 Celery task + 三个端点，旧 /generate 与 /confirm-intent 完全保留兼容。

状态机

pending → running → image_analyzed → running → copy_ready → running → completed
              ↘ wait_user_confirm → running → completed (旧路径保留)
任意阶段 ↘ failed; 任意非终态 ↘ cancelled

新增端点

• POST /api/v1/viral-video/analyze-images — 阶段1：创建 job 并只跑 step1+1.5
• POST /api/v1/viral-video/{id}/generate-copy — 阶段2：写营销参数 + 跑 step2-5
• POST /api/v1/viral-video/{id}/confirm-copy — 阶段3：确认/编辑文案 + 跑 step6-9

其他

• GET /{id} 响应新增 image_analysis / storyboard / generated_copy_text 字段
• 幂等迁移：启动时 ALTER TABLE 补 storyboard + generated_copy_text 两列（create_all 不补已有表）
• WS 进度事件新增 viral_video:image_analyzed / viral_video:copy_ready
• 前端 TS types + api client 同步新增类型与三个调用函数

测试

• 新增 5 个路由单测（3 个新端点，每个正常派发+错误状态 409）
• viral 相关 93 个单测全通过
• 旧 /generate + /confirm-intent 路径单测保持通过（P0-3 等回归用例未改语义）

## 背景 前端 STEP1 UI 重做（#2041）要求后端支持三步独立操作： 1. 图片分析：上传图片后立即做 VLM 分析，拿到结构化商品信息展示给用户 2. 文案生成：用户填完营销参数后跑 意图→文案→分镜→审核，暂停给用户编辑文案 3. 视频渲染：用户确认/编辑文案后跑 TTS→渲染→上传 ## 方案 最小改动：新增两个暂停状态 + 三个 Celery task + 三个端点，旧 /generate 与 /confirm-intent 完全保留兼容。 ### 状态机 ``` pending → running → image_analyzed → running → copy_ready → running → completed ↘ wait_user_confirm → running → completed (旧路径保留) 任意阶段 ↘ failed; 任意非终态 ↘ cancelled ``` ### 新增端点 - `POST /api/v1/viral-video/analyze-images` — 阶段1：创建 job 并只跑 step1+1.5 - `POST /api/v1/viral-video/{id}/generate-copy` — 阶段2：写营销参数 + 跑 step2-5 - `POST /api/v1/viral-video/{id}/confirm-copy` — 阶段3：确认/编辑文案 + 跑 step6-9 ### 其他 - `GET /{id}` 响应新增 `image_analysis` / `storyboard` / `generated_copy_text` 字段 - 幂等迁移：启动时 ALTER TABLE 补 storyboard + generated_copy_text 两列（create_all 不补已有表） - WS 进度事件新增 viral_video:image_analyzed / viral_video:copy_ready - 前端 TS types + api client 同步新增类型与三个调用函数 ## 测试 - 新增 5 个路由单测（3 个新端点，每个正常派发+错误状态 409） - viral 相关 93 个单测全通过 - 旧 /generate + /confirm-intent 路径单测保持通过（P0-3 等回归用例未改语义）

gitea-actions bot commented 2026-10-01 11:12:00 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#2117
预览链接	https://pr-2117.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #2117 | | 预览链接 | [https://pr-2117.preview.xiaoxiajianji.com](https://pr-2117.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 1 commit 2026-10-01 11:38:50 +08:00

feat(viral-video): #2115 三阶段分步 pipeline（图片分析/生成文案/生成视频拆分） ... 3976f21c31

- 新增状态 IMAGE_ANALYZED / COPY_GENERATED，最小改动状态机：PENDING→RUNNING→IMAGE_ANALYZED→RUNNING→COPY_GENERATED→RUNNING→COMPLETED
- 新增三个 Celery task：run_viral_video_analyze / run_viral_video_generate_copy / run_viral_video_render
- 共享 _run_render_pipeline 渲染函数，兼容旧 /generate + /confirm-intent 路径（storyboard 缺失时自动兜底重算）
- 新增三个端点：
  * POST /viral-video/analyze-images  阶段1：图片VLM分析+可选参考视频风格分析
  * POST /viral-video/{id}/generate-copy  阶段2：意图解析→文案融合→分镜→合规审核
  * POST /viral-video/{id}/confirm-copy  阶段3：TTS→渲染→上传
- GET /{id} 返回 image_analysis / storyboard / generated_copy_text / copy_result（对齐前端 CopyResult 结构）
- 幂等 ALTER TABLE 补列：storyboard(JSON) / generated_copy_text(TEXT)，无 Alembic 环境下安全执行
- WS 新增 viral_video:image_analyzed / viral_video:copy_generated 事件类型
- 前端类型/API 客户端：新增 AnalyzeImagesRequest/GenerateCopyRequest/ConfirmCopyRequest/StoryboardSegment
  及 analyzeViralImages/generateViralCopy/confirmViralCopy 三个真实 API 函数，保留既有 mock 函数
- 状态值对齐前端 PR #2116 命名 copy_generated（非 copy_ready）
- 93 个 viral 相关单测全通过；musetalk 2 个超时用例失败为历史遗留与本 PR 无关

xiaoxia force-pushed fix/2115-three-stage-pipeline from 597a7aad6e to 3976f21c31 2026-10-01 11:38:50 +08:00 Compare

auto-approve-bot merged commit d390d7c310 into develop 2026-10-01 11:57:39 +08:00

auto-approve-bot deleted branch fix/2115-three-stage-pipeline 2026-10-01 11:57:43 +08:00

gitea-actions bot commented 2026-10-01 11:58:51 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #2117 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #2117 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#2117