# PPT Master - AI 视觉内容生成系统

基于 AI 多角色协作的 SVG 内容生成系统，支持演示文稿、社交媒体、营销海报等多种格式。

## 何时使用此 Skill

- 从 Markdown/PDF/URL 生成 PPT 演示文稿
- 创建小红书、朋友圈等社交媒体图文
- 设计营销海报、信息图
- 批量生成可视化内容

## 核心工作流

```
源文档 → 创建项目 → 模板选择 → Strategist 规划 → [Image Generator 配图] → Executor 生成 SVG → 后处理 → 导出 PPTX
```

## 快速开始

### 1. 前置检查

**阅读角色定义前必须加载对应文件：**
- [Strategist](roles/Strategist.md) - 内容规划
- [Executor](roles/Executor_General.md) - SVG 生成
- [Image Generator](roles/Image_Generator.md) - 配图生成

**阅读技术约束：**
- [AGENTS.md](AGENTS.md) - 完整工作流程和规则手册
- [设计指南](docs/design_guidelines.md) - 配色、排版规范

### 2. 创建项目

```bash
mkdir -p projects/<name>/{src,output/images,output/final}
# 源文档放入 src/ 目录
```

### 3. 源文档处理

| 格式 | 工具 | 命令 |
|------|------|------|
| PDF | `tools/pdf_to_md.py` | `python3 tools/pdf_to_md.py <pdf> <out.md>` |
| URL | `tools/web_to_md.py` | `python3 tools/web_to_md.py <url> <out.md>` |
| 微信公众号 | `tools/web_to_md.cjs` | `node tools/web_to_md.cjs <url> <out.md>` |

### 4. 执行工作流

**Step 1: Strategist 分析**
- 读取源文档
- 确定画布格式（PPT 16:9 / 小红书 / 海报等）
- 规划页数、内容结构
- 输出：`projects/<name>/plan.md`

**Step 2: Image Generator 配图（可选）**
- 根据内容需求搜索或生成图片
- 图片放入 `projects/<name>/output/images/`
- 使用 `tools/embed_images.py` 嵌入 SVG

**Step 3: Executor 生成 SVG**
- 按规划逐页生成 SVG
- 输出到 `projects/<name>/output/`
- 使用 `tools/finalize_svg.py` 后处理

**Step 4: 导出 PPTX**
```bash
python3 tools/svg_to_pptx.py projects/<name> -o output.pptx
# 或使用 --use-final 使用 final/ 目录的 SVG
```

## 支持的画布格式

参考 [docs/canvas_formats.md](docs/canvas_formats.md)：

| 格式 | 尺寸 | 用途 |
|------|------|------|
| `ppt169` | 1920×1080 | 标准 PPT 16:9 |
| `ppt43` | 1440×1080 | 传统 PPT 4:3 |
| `xiaohongshu` | 900×1200 | 小红书图文 |
| `moments` | 1080×1080 | 朋友圈方形 |
| `phone9_16` | 1080×1920 | 手机全屏海报 |
| `a4` | 595×842 | A4 文档 |

## 工具速查

```bash
# SVG → PPTX

…