49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# Change: 将爆款视频生成的分析与改编接入任务队列，并补齐历史输入源回填
|
||
|
||
## Why
|
||
|
||
当前爆款视频生成工具的第 1 步分析和第 2 步脚本改编都在组件内直接发起异步调用，不进入统一任务队列。
|
||
这导致用户无法在任务面板里追踪进度、失败后重试，也无法在页面切换或刷新后恢复这些长耗时任务。
|
||
|
||
同时，历史记录目前只保存 `sourceLabel`。YouTube 场景还能靠文本回填 URL，本地上传视频则只剩文件名，无法在重新分析时恢复原视频输入。
|
||
|
||
## What Changes
|
||
|
||
- 将爆款视频生成工具的“视频分析”接入统一任务队列
|
||
- 将爆款视频生成工具的“脚本改编”接入统一任务队列
|
||
- 为这两类任务补充结构化任务元数据，区分普通文本任务与视频分析器内部任务
|
||
- 为分析历史补充输入源持久化：
|
||
- YouTube 记录真实 `youtubeUrl`
|
||
- 本地上传记录缓存后的视频来源信息，支持后续恢复
|
||
- 用户从历史记录重新进入分析页时，自动回填 YouTube URL 或本地视频预览，并可直接重新提交
|
||
- 保持现有素材生成、首尾帧提取和记录存储结构可兼容迁移
|
||
|
||
## Impact
|
||
|
||
- Affected specs:
|
||
- `video-analyzer`
|
||
- Affected code:
|
||
- `packages/drawnix/src/components/video-analyzer/*`
|
||
- `packages/drawnix/src/mcp/tools/video-analyze.ts`
|
||
- `packages/drawnix/src/mcp/tools/text-generation.ts`
|
||
- `packages/drawnix/src/services/task-queue-service.ts`
|
||
- `packages/drawnix/src/types/shared/core.types.ts`
|
||
- `packages/drawnix/src/utils/video-frame-cache.ts`
|
||
- `packages/drawnix/src/services/unified-cache-service.ts`
|
||
|
||
## Scope
|
||
|
||
### Included In This Change
|
||
|
||
- 视频分析任务的入队、进度展示、结果回写
|
||
- 脚本改编任务的入队、进度展示、结果回写
|
||
- 历史记录对 YouTube URL 和本地视频来源的恢复
|
||
- 必要的数据结构迁移与兼容处理
|
||
|
||
### Not Included In This Change
|
||
|
||
- 通用任务队列 UI 的大规模改版
|
||
- 将爆款视频生成的“素材生成”页面改造成新的队列协议
|
||
- 云端上传原视频或服务端持久化视频源
|
||
- 跨设备同步本地上传视频源
|