大师
- 作者仓库星标 0
- 作者仓库 ppt-master
- 领域
- 写作
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @lzfxxx · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Node.js · Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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
python3 tools/svg_to_pptx.py <project> -o <out.pptx>
# PDF/网页 → Markdown
python3 tools/pdf_to_md.py <in.pdf> <out.md>
python3 tools/web_to_md.py <url> <out.md>
# 图片处理
python3 tools/embed_images.py <svg> <image_dir>
python3 tools/crop_images.py <image> [options]
python3 tools/fix_image_aspect.py <image>
# SVG 后处理
python3 tools/finalize_svg.py <project>
python3 tools/svg_quality_checker.py <project>
# 项目管理
python3 tools/project_manager.py create <name>
python3 tools/project_manager.py list
```
## 示例项目
- [examples/ppt169_demo](examples/ppt169_demo/) - PPT 16:9 完整示例
- [examples/xiaohongshu_demo](examples/xiaohongshu_demo/) - 小红书图文示例
- [examples/poster_demo](examples/poster_demo/) - 海报设计示例
## 依赖安装
```bash
# Python 依赖
pip install python-pptx Pillow beautifulsoup4 requests lxml
# Node.js 工具(可选,用于微信公众号抓取)
npm install
```
## 关键约束
1. **SVG 技术限制**: 禁用 `filter`、`mask`、`clipPath` 等 PPT 不兼容特性
2. **图片格式**: 嵌入前必须使用 `embed_images.py` 处理
3. **字体**: 使用系统标准字体(微软雅黑、思源黑体等)
4. **颜色**: 遵循设计规范中的配色方案
## 完整文档
- [📖 工作流教程](docs/workflow_tutorial.md) - 详细步骤和案例
- [🎨 设计指南](docs/design_guidelines.md) - 视觉规范
- [📐 画布格式](docs/canvas_formats.md) - 所有支持格式
- [🖼️ 图片嵌入指南](docs/svg_image_embedding.md) - 图片处理最佳实践
- [📊 图表模板](templates/charts/) - 13 种标准化图表
## 在线预览
查看生成效果:[GitHub Pages 预览](https://hugohe3.github.io/ppt-master/)
章节与文件索引
按说明文件中的顺序排列。
何时使用此 Skill
1. 前置检查
3. 源文档处理
4. 执行工作流
支持的画布格式
文件/命令 -> tools/pdf_to_md.py · python3 tools/pdf_to_md.py <pdf> <out.md> · 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> · projects/<name>/plan.md · projects/<name>/output/images/
内容校验值 -> 010e3b15889c
当前原文的自动摘译,尚未人工审校。
何时使用此 Skill
从 Markdown/PDF/URL 生成 PPT 演示文稿 创建小红书、朋友圈等社交媒体图文 设计营销海报、信息图 批量生成可视化内容
1. 前置检查
阅读角色定义前必须加载对应文件: Strategist - 内容规划 Executor - SVG 生成 Image Generator - 配图生成 阅读技术约束:
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支持的画布格式
参考 docs/canvas_formats.md: 格式 · 尺寸 · 用途
ppt169· 1920×1080 · 标准 PPT 16:9ppt43· 1440×1080 · 传统 PPT 4:3xiaohongshu· 900×1200 · 小红书图文