waytouniverse/ppt-generator：从 Markdown 大纲生成风格统一的 PPT 图片
waytouniverse/ppt-generator：从 Markdown 大纲生成风格统一的 PPT 图片
waytouniverse/ppt-generator 是一个根据 PPT 大纲逐页生成视觉风格统一图片的 Skill，支持 Claude Code、OpenClaw 和 Codex。它把封面作为视觉锚点，再用设计规格、风格描述和布局百分比约束后续内页，最终输出每页一张 16:9、2K 分辨率的 PNG 图片。
公开仓库：waytouniverse/ppt-generator。
一分钟看效果
最小试跑先从克隆、安装或目录检查开始，确认能打开入口文件、读取 Skill 规则或启动对应服务。
cp -r ppt-generator ~/.claude/skills/
cp -r ppt-generator ~/.agents/skills/
cp -r ppt-generator ~/.codex/skills/
python3 scripts/parse_outline.py path/to/outline.md跑通后重点确认这些产物：
- 封面页 PNG
- 风格统一的内页 PNG
- 结构化页面列表
- 设计规格说明
- 完整 PPT 图片文件夹
自制结构图把项目的最小路径压成一条线：先确认输入，再套用规则或模板，最后检查能交付的文件。
为什么需要这个项目
用 AI 逐页生成 PPT 图片时，最大问题是每页像不同设计师做的：颜色、字体、材质和排版比例都不稳定。这个项目用封面图、DESIGN SPEC、STYLE DESCRIPTION 和统一布局百分比做双通道风格锚定，让整套图片围绕同一个视觉基线生成。
核心功能
- 输入 Markdown 格式 PPT 大纲，自动解析封面和内页结构。
- 先生成封面，再从封面提取配色、字体、氛围等视觉风格。
- 把封面作为参考图传入每页，强化图生图的一致性。
- 支持 Claude Code、OpenClaw 和 Codex 三种技能安装路径。
- 使用 `scripts/parse_outline.py` 把 Markdown 大纲解析成结构化页面列表。
与传统方案对比
| 维度 | 传统流程 | 自动化流程 |
|---|---|---|
| 核心目标 | 人工做 PPT 与配图 | 用本项目搭建自动化流程 |
| 适用场景 | 一次性汇报、临时排版 | 需要复用模板、生成、预览和修改的演示生产 |
| 输入格式 | 文章、想法、截图分散在不同文件 | 主题、Markdown、模板、脚本或 Agent 指令 |
| 输出形态 | 手工维护的 PPT 文件 | HTML、PPTX、PNG、视频或可继续编辑的项目产物 |
| 模板处理方式 | 靠人记住字体、配色和版式 | 把模板、规则和检查步骤放进仓库或 Skill |
| 检查方式 | 人工翻页找问题 | 命令、预览、目录检查或视觉 QA 逐步确认 |
| 适合人群 | 偶尔做演示的人 | 希望把 PPT 生产流程沉淀成工具的开发者和内容团队 |
工作原理
- 读取 Markdown 大纲，解析封面页和各内容页。
- 生成第一张封面图。
- 分析封面，提取设计规格和风格描述。
- 逐页生成内页，复用封面参考图和布局比例规范。
- 输出每页一张 16:9、2K PNG。
- 检查页面顺序、文字内容和整体风格是否统一。
仓库结构
下面按公开文件和二次开发时应保留的工程入口整理，实际新增目录应以你的本地改造为准。
ppt-generator/
├── README.md
├── SKILL.md
├── 使用教程.md
├── scripts/parse_outline.py
├── agents/openai.yaml
├── examples/
├── templates/
├── references/
├── outputs/环境要求
- Claude Code、OpenClaw 或 OpenAI Codex。
- Python 3，用于运行大纲解析脚本。
- gpt-image 技能，用于图片生成并支持参考图。
- 需要能配置 gpt-5.5 风格提取和 gpt-image-2 图片生成的 API。
安装方式
cp -r ppt-generator ~/.claude/skills/
cp -r ppt-generator ~/.agents/skills/
cp -r ppt-generator ~/.codex/skills/
python3 scripts/parse_outline.py path/to/outline.md推荐使用流程
- 先写 Markdown 大纲，明确封面页和每一页内容。
- 把技能复制到对应 Agent 的 skills 目录。
- 在 `SKILL.md` 中配置 base_url 和 api_key 占位。
- 让 Agent 按大纲生成封面图。
- 从封面提取风格，再逐页生成内页。
- 检查输出文件夹中的 PNG 是否风格统一。
常用命令
cp -r ppt-generator ~/.claude/skills/
cp -r ppt-generator ~/.codex/skills/
python3 scripts/parse_outline.py examples/outline.md
ls outputwaytouniverse/ppt-generator 适合目标明确的“先有大纲，再生成整套图片”的场景。它把封面作为视觉锚点，解决逐页生成时最容易失控的风格一致性问题，最后得到的是一组可以直接放进 PPT 或视频流程里的高分辨率页面图。