xiaoxia/xiaoxia-saas

Fork 0

Files

T

xiaoxia a6e85092ce fix: 统一 ENABLE_REDIS_SESSIONS 命名，修复登录因 AttributeError 导致 500

2026-06-27 17:05:48 +08:00

5.0 KiB

Raw Blame History

专项 D：生成链生产化深化 - 完成报告

专项负责人：小虾 🦐
执行时间：2026-06-19 10:50 - 11:00 GMT+8
状态：✅ 已完成（MVP）

一、完成内容

1. 创建视频处理模块

位置：apps/worker/video_processing/

核心类：VideoProcessor

功能：

✅ 视频拼接（concatenate_videos）
✅ 缩略图生成（generate_thumbnail）
✅ 视频元数据获取（get_video_info）

2. 重写生成任务 Worker

位置：apps/worker/tasks.py::generate_video

实现流程：

1. 获取生成任务
2. 获取素材库中的素材
3. 下载素材到本地
4. 使用 FFmpeg 拼接视频
5. 生成缩略图
6. 上传到 MinIO
7. 创建 GeneratedVideo 记录
8. 更新任务状态
9. 清理临时文件

3. 扩展 MinIO 服务

位置：apps/api/app/core/storage.py

新增方法：

✅ download_file(storage_key, local_path) - 下载文件到本地
✅ upload_file 支持本地文件路径参数

4. 更新依赖

位置：requirements.txt

新增依赖：

ffmpeg-python==0.2.0 - FFmpeg Python wrapper
Pillow==10.4.0 - 图像处理
minio==7.2.9 - 对象存储
celery==5.4.0 - 任务队列

二、技术实现

VideoProcessor 核心功能

视频拼接：

使用 FFmpeg concat demuxer
支持自定义分辨率和帧率
自动生成缩略图
返回完整的视频元数据

关键代码：

processor = VideoProcessor(temp_dir=temp_dir)
result = processor.concatenate_videos(
    input_paths=local_paths,
    output_path=output_path,
    resolution=(1920, 1080),
    fps=25,
)

输出：

VideoResult(
    output_path: str,
    thumbnail_path: str,
    duration: float,
    width: int,
    height: int,
    fps: float,
    file_size: int,
)

三、MVP 范围验证

✅ 已实现

从素材库选择素材
下载素材到本地
使用 FFmpeg 拼接视频
生成缩略图
上传到 MinIO
返回正确的文件路径和元数据
清理临时文件

⚠️ 简化处理

当前只处理前 3 个视频素材
没有复杂的生成策略
没有转场效果
没有配音混音

🔜 待后续实现

转场效果
字幕叠加
配音混音
复杂生成策略
多种输出格式

四、与 Mock 的对比

Mock 实现（之前）

# 假数据
file_size=1024,
duration=10.0,
width=1920,
height=1080,
fps=25.0,

问题：

没有真实文件
无法下载
元数据固定

真实实现（现在）

# 真实处理
result = processor.concatenate_videos(...)
file_size=result.file_size,  # 真实大小
duration=result.duration,    # 真实时长
width=result.width,          # 真实分辨率
height=result.height,
fps=result.fps,              # 真实帧率

优势：

生成真实的 MP4 文件
可以下载并播放
元数据准确

五、测试建议

手工测试流程

上传 3 个视频素材到素材库
创建生成任务
等待 worker 处理
查看生成结果
下载并播放视频

预期结果

✅ 生成的视频能正常播放
✅ 视频是 3 个素材的拼接
✅ 缩略图正常显示
✅ 元数据准确

六、部署要求

系统依赖

必须预装 FFmpeg：

# Ubuntu/Debian
sudo apt-get install ffmpeg

# macOS
brew install ffmpeg

# Windows
# 下载并添加到 PATH
# https://ffmpeg.org/download.html

验证安装：

ffmpeg -version

Python 依赖

pip install -r requirements.txt

七、已知限制

1. 素材格式要求

当前只处理 mime_type 以 video/ 开头的素材
需要素材已上传到 MinIO

2. 性能考虑

生成时间与素材数量和大小成正比
建议设置 Celery task timeout（如 10 分钟）

3. 存储空间

临时文件会占用磁盘空间
已添加清理逻辑，但异常情况可能遗留

八、后续优化方向

P1 优先级

策略系统
- 根据策略智能选择素材
- 支持多种生成模式
错误处理
- 素材格式检查
- FFmpeg 错误诊断
性能优化
- 并发处理
- 缓存机制

P2 优先级

高级功能
- 转场效果
- 字幕叠加
- 配音混音
质量提升
- 多种输出格式
- 分辨率适配
- 码率控制

九、总结

✅ 核心成果

从 Mock 提升到真实媒体处理

实现了完整的视频生成管线
支持真实的 FFmpeg 处理
生成可播放的 MP4 文件

评分

生产化程度：7/10

优势：

核心流程完整
真实文件生成
元数据准确

待改进：

策略系统简单
缺少高级功能
性能有优化空间

十、验收建议

建议先进行专项 E（前端真实联调验收）

理由：

专项 D 已完成 MVP
需要端到端验证生成链是否真正可用
发现问题可以立即反馈

完成人：小虾 🦐
完成时间：2026-06-19 11:00 GMT+8

5.0 KiB Raw Blame History Unescape Escape