agentic-video-editor - 多 Agent 协作的 AI 视频自动剪辑工具
基于 Google Gemini + FFmpeg，通过 Director/Editor/Reviewer 多 Agent 流水线，将原始素材和创意简报自动剪辑成精品广告，支持 YAML 管道配置与风格模板
Agentic Video Editor
一个命令行 AI 视频编辑器，通过多 Agent 协作流水线，将原始素材和创意简报自动剪辑成精品广告。基于 Google Gemini 提供智能决策，FFmpeg 负责渲染。
核心特性
- 多 Agent 架构：Director（选镜导演）→ Trim Refiner（剪辑精修）→ Editor（渲染输出）→ Reviewer（质量评审），低分自动回溯重试
- YAML 管道配置: 通过
pipelines/*.yaml定义编辑流水线，支持 retry 阈值与反馈环路 - 风格模板:
styles/*.yaml给 Director 结构化指导，内置 DTC 证言广告模板（30秒 hook-problem-solution-CTA 结构） - 素材索引缓存: 预处理阶段自动检测场景、转写语音、建立
footage_index.json，多次运行复用 - 版本对比: 每次 retry 生成
{name}_v{N}.mp4，方便对比不同版本
Agent 分工
| Agent | 职责 | 底层 |
|---|---|---|
| Director | 搜索素材索引、选镜、排序、生成 EditPlan（含剪辑点与文字叠加） | Google Gemini via ADK |
| Trim Refiner | 精确调整每个镜头的起止点，实现紧凑剪辑 | Gemini |
| Editor | 将 EditPlan 渲染为 MP4（FFmpeg/MoviePy） | FFmpeg |
| Reviewer | 5 维度评分（贴合度、节奏、视觉质量、观看体验、整体），低分回溯 | Gemini |
使用场景
- UGC 广告制作: 将原始素材 + 创意简报自动生成 30 秒精品广告
- 视频内容创作: 批量处理素材库，快速试错不同剪辑方案
- 自动化剪辑工作流: 通过 YAML 管道定义反复使用的剪辑规范
技术栈
- Python 3.11+
- Google Gemini （通过 ADK）
- FFmpeg / MoviePy
- YAML 管道配置
快速开始
# 安装
pip install -e ".[dev]"
# 编辑
ave edit \
--footage-dir /path/to/footage \
--brief '{"product": "My Product", "audience": "Women 25-45", "tone": "authentic", "duration_seconds": 30}' \
--pipeline pipelines/ugc-ad.yaml \
--style styles/dtc-testimonial.yaml
暂无评论