# 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 管道配置

## 快速开始

```bash
# 安装
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
```

GitHub: https://github.com/poseljacob/agentic-video-editor

---

**分类**：源码
**标签**：剪辑 · Agent · Gemini
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1542