Remotion 视频增强工具

任务目标

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

前置准备

• 依赖说明：scripts 脚本所需的依赖包

  moviepy>=1.0.3
  pillow>=9.0.0

• 系统依赖：FFmpeg（必需，用于视频转场处理）

  # 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：

   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：

   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：

   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：仅生成动画配置

python scripts/animation_planner.py \
  --input ./ppt_data.json \
  --style dynamic \
  --output ./animation_plan.json

• 适用于：用户希望手动调整动画参数
• 输出：animation_plan.json

模式 B：仅增强视频转场

python scripts/video_transitions.py \
  --input ./video.mp4 \
  --transitions ./animation_plan.json \
  --output ./enhanced_video.mp4

• 适用于：已有视频，需要增强转场效果
• 输出：enhanced_video.mp4

模式 C：仅生成 HTML 动画

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/video_transitions.py（用途：FFmpeg 视频转场）
• HTML 动画脚本：见 scripts/html_animations.py（用途：Framer Motion 动画）
• 转场效果指南：见 references/transition_guide.md（用途：转场效果详细说明）
• 动画模板：见 assets/animations/（可选：预设动画配置）
• HTML 模板：见 assets/templates/enhanced_viewer.html（Framer Motion 播放器）
• 协同指南：见 references/collaboration_guide.md（与其他 Skill 协同）

注意事项

• 本 Skill 不依赖任何第三方 AI API，所有动画使用 FFmpeg 和 Framer Motion 实现
• 视频转场使用 FFmpeg，确保已安装
• HTML 动画使用 Framer Motion CDN，无需安装
• 动画配置 JSON 格式必须符合规范（见 references/transition_guide.md）
• 与其他 Skill 协同时，确保输入格式正确
• 支持批量处理，但建议单个视频不超过 100 页
• Framer Motion 动画仅在现代浏览器中支持

使用示例

示例 1：与 ppt-generator 协同生成动画播放器

• 功能说明：ppt-generator 生成内容，remotion-video-enhancer 添加动画
• 执行方式：ppt-generator → remotion-video-enhancer（Framer Motion）
• 用户指令："生成一个产品介绍 PPT，使用 Framer Motion 动画"
• 输出：animated_viewer.html

示例 2：为路演视频添加高级转场

• 功能说明：增强现有视频的转场效果
• 执行方式：ppt-roadshow-generator → remotion-video-enhancer（FFmpeg 转场）
• 用户指令："为路演视频添加 Remotion 风格的转场"
• 输出：enhanced_roadshow_video.mp4

示例 3：自定义动画配置

• 功能说明：用户手动指定动画类型和参数
• 执行方式：用户提供 animation_plan.json → 视频转场
• 配置示例：

  {
    "transitions": [
      {"type": "slide", "direction": "right", "duration": 1.5},
      {"type": "zoom", "scale": 1.2, "duration": 1.0}
    ]
  }

• 输出：按自定义配置增强的视频

示例 4：批量处理多个视频

• 功能说明：一次性增强多个视频
• 执行方式：脚本批量处理
• 命令：

  python scripts/video_transitions.py \
    --input-dir ./videos/ \
    --transitions ./animation_plan.json \
    --output-dir ./enhanced_videos/

• 输出：批量增强的视频文件