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

【低优先级】一键生成预览进度条组件未实时显示后端渲染进度 #1220

New Issue
Closed
opened 2026-08-02 20:04:01 +08:00 by xiaoxia · 1 comment
xiaoxia commented 2026-08-02 20:04:01 +08:00
Owner
Copy Link
Copy Source

问题描述

一键生成剪辑预览（Step 3）中，点击"生成预览"后，预览视频能正常渲染完成并显示播放器控件，但进度条始终显示 0%，未实时反映后端的渲染进度变化。

预期行为

进度条应实时更新，显示后端返回的 progress 值变化（10%→30%→40%→80%→100%）。

实际行为

  • 进度条始终停留在 0%
  • 预览实际能成功生成（视频播放器正常出现）
  • 页面不崩溃，UI 渲染正确

排查方向

  1. 前端进度条组件是否正确消费了后端 API 返回的 progress 字段
  2. 轮询/SSE 机制是否正确解析了进度数据
  3. 后端已在 commit 3e987307 中实现了渲染进度实时上报（0%→10%→30%→40%→80%→100%），API 已正确返回 progress 值

优先级

低优先级 — 不影响核心功能，预览能正常生成和播放

验证信息

  • P0 E2E Round 3 验证通过（2026-08-02）
  • Staging 环境 commit: 3e987307
## 问题描述 一键生成剪辑预览（Step 3）中，点击"生成预览"后，预览视频能正常渲染完成并显示播放器控件，但进度条始终显示 0%，未实时反映后端的渲染进度变化。 ## 预期行为 进度条应实时更新，显示后端返回的 progress 值变化（10%→30%→40%→80%→100%）。 ## 实际行为 - 进度条始终停留在 0% - 预览实际能成功生成（视频播放器正常出现） - 页面不崩溃，UI 渲染正确 ## 排查方向 1. 前端进度条组件是否正确消费了后端 API 返回的 progress 字段 2. 轮询/SSE 机制是否正确解析了进度数据 3. 后端已在 commit `3e987307` 中实现了渲染进度实时上报（0%→10%→30%→40%→80%→100%），API 已正确返回 progress 值 ## 优先级 低优先级 — 不影响核心功能，预览能正常生成和播放 ## 验证信息 - P0 E2E Round 3 验证通过（2026-08-02） - Staging 环境 commit: `3e987307`
xiaoxia commented 2026-08-03 09:33:28 +08:00
Author
Owner
Copy Link
Copy Source

关闭原因

经前端代码全面排查，确认前端逻辑无bug。

排查结论

  1. 前端轮询逻辑正确：useStep3Preview.ts 每2秒poll一次 GET /generation/preview/{taskId}，正确读取 data.progress 并通过 setProgress(data.progress || 0) 更新UI
  2. 后端数据正确：API已正确返回progress值（0→10→30→40→80→85→95→100）
  3. 根因：E2E测试素材太小（几秒视频），渲染速度快于轮询频率（2秒），前端直接从 pending 跳到 completed，未捕获中间progress值

验证建议

如需进一步验证进度条UI效果，需使用较大素材（10秒+视频）在staging环境重测，观察是否能捕获中间progress值。

额外发现（不阻断关闭）

后端 material_usage 字段返回 dict（如 {"ratio": 0.75}），前端 PreviewTaskResponse.materialUsage 类型定义为 number，存在类型不匹配，建议后续单独修复。

结论：非前端bug，关闭此工单。

## 关闭原因 经前端代码全面排查，确认**前端逻辑无bug**。 ### 排查结论 1. **前端轮询逻辑正确**：`useStep3Preview.ts` 每2秒poll一次 `GET /generation/preview/{taskId}`，正确读取 `data.progress` 并通过 `setProgress(data.progress || 0)` 更新UI 2. **后端数据正确**：API已正确返回progress值（0→10→30→40→80→85→95→100） 3. **根因**：E2E测试素材太小（几秒视频），渲染速度快于轮询频率（2秒），前端直接从 `pending` 跳到 `completed`，未捕获中间progress值 ### 验证建议 如需进一步验证进度条UI效果，需使用较大素材（10秒+视频）在staging环境重测，观察是否能捕获中间progress值。 ### 额外发现（不阻断关闭） 后端 `material_usage` 字段返回 `dict`（如 `{"ratio": 0.75}`），前端 `PreviewTaskResponse.materialUsage` 类型定义为 `number`，存在类型不匹配，建议后续单独修复。 --- **结论**：非前端bug，关闭此工单。
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
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#1220
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?