2.8 KiB
2.8 KiB
video-analyzer Specification
Purpose
TBD - created by archiving change update-video-analyzer-task-queue. Update Purpose after archive.
Requirements
Requirement: 视频分析必须进入统一任务队列
爆款视频生成工具在用户提交视频分析时，系统 SHALL 创建一个可追踪的队列任务，而不是仅在组件内直接等待异步结果。
Scenario: YouTube 视频分析入队
- WHEN 用户在爆款视频生成工具第 1 步输入 YouTube URL 并开始分析
- THEN 系统创建一个视频分析任务并出现在任务队列中
- AND 任务完成后将结构化分析结果写回对应的分析记录
Scenario: 本地上传视频分析入队
- WHEN 用户在爆款视频生成工具第 1 步上传本地视频并开始分析
- THEN 系统创建一个视频分析任务并出现在任务队列中
- AND 任务完成后将结构化分析结果写回对应的分析记录
Requirement: 脚本改编必须进入统一任务队列
爆款视频生成工具在用户执行 AI 脚本改编时，系统 SHALL 创建一个可追踪的队列任务，并在完成后回写镜头脚本。
Scenario: 脚本改编任务完成后回写
- WHEN 用户在第 2 步提交 AI 改编脚本
- THEN 系统创建一个脚本改编任务并出现在任务队列中
- AND 任务完成后将改编后的镜头数据写回当前分析记录
Requirement: 历史分析记录必须保存可恢复输入源
爆款视频生成工具保存分析历史时，系统 SHALL 同时保存足以恢复再次分析的输入源快照。
Scenario: 保存 YouTube 输入源
- WHEN 用户使用 YouTube URL 完成一次分析
- THEN 历史记录保存原始
youtubeUrl
Scenario: 保存本地上传输入源
- WHEN 用户使用本地视频完成一次分析
- THEN 系统将本地视频缓存到本地存储
- AND 历史记录保存恢复该视频所需的缓存引用与文件元数据
Requirement: 从历史记录重新进入分析页时必须回填输入源
用户从爆款视频生成工具的历史记录重新进入分析页时，系统 SHALL 尝试恢复原始输入源，而不是只展示历史结果。
Scenario: 回填 YouTube URL
- WHEN 用户打开一条来自 YouTube 的历史分析记录
- THEN 分析页自动回填对应的 YouTube URL
Scenario: 恢复本地上传视频
- WHEN 用户打开一条来自本地上传的历史分析记录且本地缓存仍可用
- THEN 分析页自动恢复视频预览
- AND 用户可以直接重新提交分析
Scenario: 本地视频缓存不可恢复时安全降级
- WHEN 用户打开一条来自本地上传的历史分析记录但原视频缓存已丢失
- THEN 系统保留原有分析结果展示
- AND 明确提示该历史记录无法恢复原视频输入