1.5 KiB
1.5 KiB
需求分析 — 视频帧显示链路修复
问题背景
用户报告三个关联问题：
- 项目库中没有默认视频
Data_MyVideo_1.mp4 - 点击默认视频进入分割工作区后，画面区域一片黑（无影像）
- 导入新视频后进入工作区，同样看不到视频帧
根因分析
| 问题 | 根因 |
|---|---|
| 无默认项目 | 后端 lifespan 无自动种子逻辑；server.ts 硬编码项目但前端根本不请求 Express |
| 工作区黑屏 | CanvasArea.tsx 硬编码 Unsplash 外链，未从 store 读取帧；进入工作区不调用帧列表 API |
| 导入后黑屏 | 上传未关联 project_id；上传后未触发 /api/media/parse 帧提取；后端 /frames 返回的是 MinIO 对象名而非可访问 URL |
需求拆解
| 编号 | 需求 | 优先级 |
|---|---|---|
| R1 | 后端启动时自动检测并注册 Data_MyVideo_1.mp4 为默认项目 |
P0 |
| R2 | 后端 /api/projects/{id}/frames 返回 presigned URL 而非对象名 |
P0 |
| R3 | 后端 ProjectOut 增加 frame_count 供前端显示 |
P1 |
| R4 | 前端 VideoWorkspace 进入时自动获取帧列表并写入 store |
P0 |
| R5 | 前端 CanvasArea 从 store 读取当前帧 URL 并渲染 |
P0 |
| R6 | 前端 FrameTimeline 从 store 读取真实帧数据，支持切换 |
P0 |
| R7 | 前端 ProjectLibrary 上传流程：创建项目 → 带 project_id 上传 → 触发解析 |
P0 |
| R8 | 后端 upload 接口支持无 project_id 时自动创建项目 | P1 |