git:20260214.8a1442a to git:20260826.31d1144

---

name: ppt-roadshow-generator

dependency:

python:

- moviepy>=1.0.3

- pillow>=9.0.0

- pydub>=0.25.1

- requests>=2.28.0

system:

- ffmpeg

---

# PPT 路演视频生成器

## 任务目标

- 本 Skill 用于：从文档分析到完整路演视频的全流程生成，包含配音、音效、音乐、字幕和转场动画

- 能力包含：文档分析、品牌风格学习、结构化规划、内容生成、视觉设计、演讲稿撰写、配音、音效、字幕、视频合成

- 触发条件：用户需要制作路演视频、产品发布演示、公司介绍视频等

## 前置准备

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

```

moviepy>=1.0.3

pillow>=9.0.0

pydub>=0.25.1

requests>=2.28.0

```

- 系统依赖：FFmpeg（必需，用于视频和音频处理）

```bash

# Ubuntu/Debian

sudo apt-get install ffmpeg

# macOS

brew install ffmpeg

```

## 操作步骤

### 标准流程（完整路演视频生成）

#### 角色一：文档分析师

1. 分析用户提供的文档，提取核心信息：

- 主题和目标

- 目标受众

- 核心论点

- 关键数据和案例

2. 输出文档分析摘要供后续角色使用

#### 角色二：结构规划师（关键角色）

1. 生成结构化文档，明确每一页 PPT 讲什么：

- 页面编号

- 页面标题

- 核心内容要点（3-5 条）

- 演讲时长（建议每页 30-60 秒）

- 页面类型（封面/内容/数据/总结）

2. 输出结构化 JSON，确保逻辑连贯

3. 此结构将作为后续所有角色的基础

#### 角色三：品牌风格分析师

1. **导入设计系统**（新增功能）：

- 如果用户提供从 `web-design-analyzer` 导出的 `brand_style.json`，直接导入

- 使用 `scripts/style_learner.py --load-json ./brand_style.json` 加载配置

- 验证配置完整性（colors、fonts、layout_style）

2. **学习品牌风格**（传统方式）：

- 学习用户提供的品牌风格（如样例 PPT、图片、品牌手册）：

- 分析配色方案（主色、辅助色、强调色）

- 识别字体类型（标题字体、正文字体）

- 提取设计元素（logo、图标、装饰）

- 分析布局风格（简约/商务/创意/科技）

3. 生成品牌风格配置文件（brand_style.json）

4. 为后续视觉设计提供风格指导

#### 角色四：内容策划师

1. 基于结构化文档，规划每页的详细内容：

- 标题和副标题

- 内容要点（精炼为短语）

- 数据和图表说明

- 演讲提示

2. 应用品牌风格，确保内容与视觉一致

3. 输出完整的内容规划

#### 角色五：视觉设计师

1. 基于品牌风格和内容规划，生成 PPT 图片：

- 使用智能体的图像生成能力

- 应用品牌配色和风格

- 确保所有图片风格统一

- 生成 slide-01.png 到 slide-N.png

2. 参考品牌风格配置，调整图片色调、字体等

#### 角色六：路演撰稿师

1. 为每一页撰写详细的演讲稿/脚本：

- 开场白（10-15 秒）

- 核心内容讲解（每页 30-60 秒）

- 过渡语（衔接下一页）

- 总结语（10-15 秒）

2. 确保语言流畅自然，适合口语表达

3. 输出演讲稿（roadshow_script.txt）

#### 角色七：转场设计师

1. 设计页面过渡动画：

- 选择转场类型（淡入淡出/滑动/缩放/翻转等）

- 设置转场时长（建议 1-2 秒）

- 确保转场风格与品牌一致

2. 生成转场配置（transitions.json）

#### 角色八：音频设计师

1. 处理音频内容：

- **配音**：调用 TTS API 生成语音解说

- **音效**：添加页面切换音效、强调音效

- **音乐**：添加背景音乐（从 assets/music/ 或用户上传）

2. 调用 `scripts/audio_processor.py`：

```bash

python scripts/audio_processor.py \

--script ./roadshow_script.txt \

--style-brand ./brand_style.json \

--output ./audio/

```

3. 输出音频文件（voiceover.mp3, sound_effects/, background_music.mp3）

#### 角色九：字幕设计师

1. 生成和同步字幕：

- 根据演讲稿生成字幕文本

- 计算每句字幕的开始和结束时间

- 应用品牌字体和样式

2. 调用 `scripts/subtitle_generator.py`：

```bash

python scripts/subtitle_generator.py \

--script ./roadshow_script.txt \

--style-brand ./brand_style.json \

--output ./subtitles.srt

```

3. 输出字幕文件（subtitles.srt）

#### 角色十：视频合成师

1. 一键合成完整路演视频：

- 合并所有图片、转场、配音、音效、音乐、字幕

- 统一分辨率和帧率（1920x1080, 30fps）

- 确保音画同步

2. 调用 `scripts/roadshow_composer.py`：

```bash

python scripts/roadshow_composer.py \

--images ./images/ \

--audio ./audio/ \

--subtitles ./subtitles.srt \

--style-brand ./brand_style.json \

--output ./roadshow_video.mp4

```

3. 输出完整的路演视频

### 品牌风格学习模式

当用户希望保持品牌风格一致时：

1. 用户提供品牌风格样例：

- PPT 样例文件

- 品牌手册

- 关键图片（logo、产品图等）

2. 执行角色三（品牌风格分析师）

3. 保存品牌风格配置供后续使用

4. 后续生成时自动应用此风格

### 与其他 Skill 协同

#### 与 web-design-analyzer 协同（新增）

- web-design-analyzer 分析网页截图，提取设计系统

- 转换为 brand_style.json（使用 `convert_to_roadshow_style.py`）

- ppt-roadshow-generator 导入品牌风格，生成路演视频

- 适用于用户希望路演视频与网页设计保持一致的场景

- 详见：[references/design-system-import-guide.md](references/design-system-import-guide.md)

#### 与 ppt-generator 协同

- ppt-generator 生成 PPT 内容（JSON）

- ppt-roadshow-generator 接收 JSON，继续处理

- 适用于用户已使用 ppt-generator 生成内容的场景

#### 与 nanobanana-ppt-visualizer 协同

- nanobanana 生成图片和播放器

- ppt-roadshow-generator 使用图片，添加配音、音效、字幕

- 适用于用户已有图片，需要完整路演视频的场景

### 可选分支

- 仅生成结构化文档：执行角色一、角色二

- 仅生成图片：执行角色一到角色五

- 仅生成演讲稿：执行角色一到角色六

- 快速模式：使用默认品牌风格，跳过角色三

## 资源索引

- 品牌风格学习：见 [scripts/style_learner.py](scripts/style_learner.py)（用途：学习用户提供的品牌风格，或加载已有配置）

- 音频处理：见 [scripts/audio_processor.py](scripts/audio_processor.py)（用途：TTS 配音、音效、音乐）

- 字幕生成：见 [scripts/subtitle_generator.py](scripts/subtitle_generator.py)（用途：生成和同步字幕）

- 视频合成：见 [scripts/roadshow_composer.py](scripts/roadshow_composer.py)（用途：一键合成完整视频）

- 品牌风格指南：见 [references/brand_style_guide.md](references/brand_style_guide.md)（用途：品牌风格学习指南）

- 设计系统导入：见 [references/design-system-import-guide.md](references/design-system-import-guide.md)（用途：从 web-design-analyzer 导入设计系统）

- 演讲稿模板：见 [references/roadshow_script_template.md](references/roadshow_script_template.md)（用途：演讲稿写作参考）

- 协同指南：见 [references/collaboration_guide.md](references/collaboration_guide.md)（用途：与其他 Skill 协同）

- 示例音乐：见 [assets/music/](assets/music/)（可选：背景音乐文件）

- 品牌风格示例：见 [assets/styles/](assets/styles/)（可选：品牌风格示例）

## 注意事项

- 十角色协作流程，确保每一步输出为下一步输入

- 品牌风格学习是保持一致性的关键，建议用户首次使用时提供样例

- 配音功能需要 TTS API 密钥，通过 `skill_credentials` 工具配置

- 音乐使用 assets/music/ 中的示例或用户上传的文件

- 视频合成使用 FFmpeg，确保已安装

- 支持一次性生成 15-100 页，风格保持一致

- 保持与用户的互动，在关键节点（如风格确认）征求反馈

## 使用示例

### 示例 1：从文档生成完整路演视频

- 功能说明：完整的十角色协作流程

- 执行方式：智能体（10 个角色） + 脚本

- 关键参数：文档路径、品牌样例（可选）、页数（如 15 页）

- 输出：完整路演视频（含配音、音效、音乐、字幕）

### 示例 2：学习品牌风格后生成

- 功能说明：先学习品牌风格，再生成视频

- 执行方式：智能体 + 脚本

- 流程：

1. 用户提供品牌样例

2. 品牌风格分析师学习并保存

3. 后续生成时自动应用

### 示例 3：从网页设计导入品牌风格（新增）

- 功能说明：导入从网页分析中提取的设计系统，生成风格一致的路演视频

- 执行方式：web-design-analyzer + ppt-roadshow-generator

- 流程：

1. web-design-analyzer 分析网页截图

2. 转换为 brand_style.json

3. ppt-roadshow-generator 导入品牌风格

4. 生成路演视频

### 示例 4：与 ppt-generator 协同

- 功能说明：使用 ppt-generator 的内容，生成路演视频

- 执行方式：ppt-generator + ppt-roadshow-generator

- 流程：

1. ppt-generator 生成 JSON

2. ppt-roadshow-generator 接收 JSON，继续处理

### 示例 5：批量生成 100 页视频

- 功能说明：一次性生成 100 页风格统一的视频

- 执行方式：智能体 + 脚本

- 关键：品牌风格学习确保一致性

- 优势：风格统一，无需人工干预