remotion-video-enhancer

# Remotion 视频增强工具

## 任务目标
- 本 Skill 用于：为 PPT 内容和视频添加 Remotion 风格的转场和动画效果
- 能力包含：高级视频转场、Framer Motion 交互式动画、动画序列规划、多媒体增强
- 触发条件：用户需要增强视频转场效果、添加交互式动画、或与其他 PPT Skill 协同

## 前置准备
- 依赖说明：scripts 脚本所需的依赖包
  ```
  moviepy>=1.0.3
  pillow>=9.0.0
  ```
- 系统依赖：FFmpeg（必需，用于视频转场处理）
  ```bash
  # Ubuntu/Debian
  sudo apt-get install ffmpeg

  # macOS
  brew install ffmpeg
  ```

## 操作步骤

### 标准流程（完整动画增强）

#### 步骤 1：接收输入数据
根据协同模式，接收不同输入：
- **来自 ppt-generator**：JSON 格式的 PPT 数据
- **来自 nanobanana-ppt-visualizer**：图片文件或 HTML 播放器
- **来自 ppt-roadshow-generator**：已合成的视频文件
- **用户直接提供**：图片序列、视频文件或 JSON 数据

#### 步骤 2：动画规划与配置
1. 分析输入内容，确定动画类型：
   - 视频转场增强（使用 FFmpeg）
   - HTML 交互式动画（使用 Framer Motion）
   - 混合模式（视频 + HTML）
2. 调用 `scripts/animation_planner.py`：
   ```bash
   python scripts/animation_planner.py \
     --input ./input_data \
     --style dynamic \
     --output ./animation_plan.json
   ```
3. 输出动画配置（animation_plan.json），包含：
   - 每个页面/片段的转场类型
   - 动画时长和缓动曲线
   - 元素入场/出场效果
   - 交互式触发条件

#### 步骤 3：视频转场增强（FFmpeg）
1. 调用 `scripts/video_transitions.py`：
   ```bash
   python scripts/video_transitions.py \
     --input ./video.mp4 \
     --transitions ./animation_plan.json \
     --output ./enhanced_video.mp4
   ```
2. 支持的转场类型：
   - **淡入淡出 (Fade)**：经典淡入淡出效果
   - **滑动 (Slide)**：上下左右滑动
   - **缩放 (Zoom)**：推拉镜头效果
   - **翻转 (Flip)**：3D 翻转效果
   - **旋转 (Rotate)**：旋转过渡
   - **模糊 (Blur)**：模糊过渡
   - **溶解 (Dissolve)**：像素溶解效果
   - **弹性 (Elastic)**：弹性动画
3. 每种转场支持自定义：
   - 转场时长（默认 1-2 秒）
   - 缓动曲线（linear, ease-in, ease-out, ease-in-out, bounce, elastic）
   - 方向（上下左右）

#### 步骤 4：HTML 动画增强（Framer Motion）
1. 调用 `scripts/html_animations.py`：
   ```bash
   python scripts/html_animations.py \
     --input ./ppt_data.json \
     --template enhanced_viewer.html \
     --output ./animated_viewer.html
   ```
2. Framer Motion 动画效果：
   - **页面过渡**：流畅的页面切换动画
   - **元素入场**：标题、内容逐个进场
   - **悬停效果**：鼠标悬停时的反馈动画
   - **点击效果**：点击时的涟漪或缩放效果
   - **滚动效果**：滚动时的视差动画
3. 交互式特性：
   - 键盘导航动画
   - 触摸手势支持
   - 全屏过渡动画
   - 进度条动画

#### 步骤 5：输出增强内容
1. 视频增强输出：`enhanced_video.mp4`
2. HTML 动画输出：`animated_viewer.html`
3. 动画配置：`animation_plan.json`

### 与其他 Skill 协同

#### 与 ppt-generator Skill 协同
```
用户请求："生成一个带高级转场的 PPT 视频"

┌─────────────────────────────────────────────────────────┐
│  ppt-generator Skill                                    │
├─────────────────────────────────────────────────────────┤
│  7 角色协作生成 JSON 数据                                │
│  输出：ppt_data.json                                    │
└─────────────────────────────────────────────────────────┘
                          │
                          ▼ JSON 数据
┌─────────────────────────────────────────────────────────┐
│  remotion-video-enhancer Skill                         │
├─────────────────────────────────────────────────────────┤
│  1. 动画规划（animation_planner.py）                     │
│  2. HTML 动画增强（html_animations.py）                 │
│  3. 输出：animated_viewer.html                          │
└─────────────────────────────────────────────────────────┘
```

#### 与 nanobanana-ppt-visualizer Skill 协同
```
用户请求："为生成的播放器添加 Framer Motion 动画"

┌─────────────────────────────────────────────────────────┐
│  nanobanana-ppt-visualizer Skill                        │
├─────────────────────────────────────────────────────────┤
│  生成 HTML 播放器 + 图片                                  │
│  输出：viewer.html, slide-*.png                          │
└─────────────────────────────────────────────────────────┘
                          │
                          ▼ HTML 文件
┌─────────────────────────────────────────────────────────┐
│  remotion-video-enhancer Skill                         │
├─────────────────────────────────────────────────────────┤
│  1. 使用 Framer Motion 增强 viewer.html                 │
│  2. 添加页面过渡、元素入场、交互效果                      │
│  3. 输出：animated_viewer.html                           │
└─────────────────────────────────────────────────────────┘
```

#### 与 ppt-roadshow-generator Skill 协同
```
用户请求："为路演视频添加高级转场效果"

┌─────────────────────────────────────────────────────────┐
│  ppt-roadshow-generator Skill                           │
├─────────────────────────────────────────────────────────┤
│  10 角色协作生成路演视频                                  │
│  输出：roadshow_video.mp4                                │
└─────────────────────────────────────────────────────────┘
                          │
                          ▼ 视频文件
┌─────────────────────────────────────────────────────────┐
│  remotion-video-enhancer Skill                         │
├─────────────────────────────────────────────────────────┤
│  1. 动画规划（animation_planner.py）                     │
│  2. 视频转场增强（video_transitions.py）                 │
│  3. 应用 Remotion 风格转场                              │
│  4. 输出：enhanced_roadshow_video.mp4                   │
└─────────────────────────────────────────────────────────┘
```

### 独立使用模式

#### 模式 A：仅生成动画配置
```bash
python scripts/animation_planner.py \
  --input ./ppt_data.json \
  --style dynamic \
  --output ./animation_plan.json
```
- 适用于：用户希望手动调整动画参数
- 输出：animation_plan.json

#### 模式 B：仅增强视频转场
```bash
python scripts/video_transitions.py \
  --input ./video.mp4 \
  --transitions ./animation_plan.json \
  --output ./enhanced_video.mp4
```
- 适用于：已有视频，需要增强转场效果
- 输出：enhanced_video.mp4

#### 模式 C：仅生成 HTML 动画
```bash
python scripts/html_animations.py \
  --input ./ppt_data.json \
  --template enhanced_viewer.html \
  --output ./animated_viewer.html
```
- 适用于：需要交互式动画播放器
- 输出：animated_viewer.html

### 可选分支
- **快速模式**：使用默认动画配置，跳过动画规划
- **自定义模式**：用户提供自定义动画配置 JSON
- **批量处理**：一次性处理多个视频或 PPT
- **模板模式**：使用预设动画模板（见 assets/animations/）

## 资源索引
- 动画规划脚本：见 [scripts/animation_planner.py](scripts/animation_planner.py)（用途：生成动画配置）
- 视频转场脚本：见 [scripts/video_transitions.py](scripts/video_transitions.py)（用途：FFmpeg 视频转场）
- HTML 动画脚本：见 [scripts/html_animations.py](scripts/html_animations.py)（用途：Framer Motion 动画）
- 转场效果指南：见 [references/transition_guide.md](references/transition_guide.md)（用途：转场效果详细说明）
- 动画模板：见 [assets/animat