
PPT-Design-Skill
一句话生成4万种风格、可编辑的专业PPT
PPT-Design-Skill 是一个面向 AI 编程助手(OpenCode、Claude Code、Codex)的演示文稿设计技能包,用 Python 实现。它解决的是「AI 能写内容却做不出专业级 PPT」的痛点:传统 AI 生成 PPT 往往排版粗糙、风格单一、交付物不可编辑。该项目的核心能力包括:内置 4 万多种视觉样式供选择,覆盖从商务汇报到创意提案的多种场景;提供像素级精确的 Build Mode 控制,让用户能像操作设计软件一样调整元素位置与层级;集成 AI 图像生成,可按需产出配图;最终输出原生可编辑的 PPTX 文件,而非图片或 PDF,保证后续可持续修改。整体流程从需求分析、视觉方向确认到成品交付形成闭环,适合需要高质量、可迭代演示文稿的专业用户。
项目数据
使用教程
环境要求
- Python 运行时(安装器会自动安装 pptx-designer 包)
- 目标 AI 编码助手之一:Claude Code / Codex / OpenCode / DeepSeek Harness
- Windows + PowerShell(安装与渲染脚本为 .py / .ps1)
- 可选渲染依赖:Microsoft PowerPoint,或 LibreOffice + Poppler(pdftoppm)
安装与启动步骤
-
1克隆仓库
README 要求先克隆仓库,所有安装命令都在仓库根目录执行
git clone https://github.com/sunchaokun/PPT-Design-Skill.git cd PPT-Design-Skill -
2一键安装运行时
运行安装器,它会自动安装已发布的 pptx-designer Python 包并复制 skill 到所选编码助手
python installer/install.py --platform all --force -
3检查运行时
确认 Python 环境与 pptx-designer 依赖已就绪,输出无报错即正常
python skill/scripts/check_runtime.py -
4装到指定助手
按需把 skill 单独安装到某个编码助手,可换成 codex / opencode / deepseek-harness
python installer/install.py --platform claude --force -
5安装渲染依赖
桌面渲染器属于系统依赖,需要 PowerPoint 或 LibreOffice+Poppler 时可显式安装
python installer/install.py --render-deps -
6导出并渲染
用渲染脚本把 PPTX 转成 PDF 和 PNG,正式交付前必须做 PNG 视觉检查
powershell -ExecutionPolicy Bypass -File skill/scripts/render_pptx.ps1 -InFile examples/new_examplex/louvre_abudhabi/output/louvre_abudhabi_complete.pptx -OutDir output/louvre-abudhabi-rendered
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--platform | 是 | 选择安装到哪个 AI 编码助手,或 all 表示全部 | claude |
--force | 否 | 强制重新安装或覆盖已有安装 | --force |
--render-deps | 否 | 显式安装桌面渲染相关系统依赖 | python installer/install.py --render-deps |
-InFile / -OutDir | 是 | 渲染脚本的输入 PPTX 路径与输出目录 | -InFile x.pptx -OutDir output/x |
如何确认成功
运行 python skill/scripts/check_runtime.py 无报错,且目标编码助手中已出现该 skill 即安装成功。
常见问题
Q:该选哪种生成模式?
A:交付级、正式汇报默认用 Build Mode(逐页逐元素控制最强);快速探索用 FreeStyle Mode;必须沿用企业模板时用 VI Build Mode。不确定就用 Build Mode。
Q:没有安装 PowerPoint 还能渲染吗?
A:可以。渲染器优先调用 PowerPoint COM,无 PowerPoint 时改用 LibreOffice 生成 PDF,再用 Poppler 的 pdftoppm 转成 PNG。
Q:生成的 PPT 可以继续编辑吗?
A:可以。最终输出是原生可编辑的 PPTX 文件,而不是图片或 PDF,实际生成由已发布的 pptx-designer Python 包负责。
Q:需要手动 pip install 吗?
A:不需要。运行 installer/install.py 时安装器会自动安装已发布的 pptx-designer Python 包。
Q:渲染出的 PDF/PNG 有什么用?
A:用于视觉复核。无论用哪种模式,正式交付前都必须经过 PNG 视觉检查,必要时返工。
注意事项
- README 的 Install 段落说明:必须先克隆仓库,然后在仓库根目录运行安装器。
- 安装器会自动处理 pptx-designer,无需手动安装该 Python 包。
- 桌面渲染依赖属于系统依赖,可用 python installer/install.py --render-deps 显式安装。
- 正式交付前务必完成 PNG 视觉检查,不要直接交付未经复核的结果。
核心亮点
- 内置4万+视觉样式,风格覆盖广,减少从零设计成本
- 输出原生可编辑PPTX,不是图片或PDF,后续修改无障碍
- 提供像素级Build Mode控制,元素位置和层级可精细调整
不足之处
- 依赖特定AI编程助手环境,脱离这些工具后使用门槛较高
- 4万+样式库的实际筛选与匹配效果需更多用户验证
- 文档/社区待观察
适用场景
- 用Claude Code写方案后直接生成可编辑的商务汇报PPT
- 为产品发布会快速产出多套视觉风格的演示稿并挑选
- 在Codex中根据需求文档自动生成带配图的培训课件
替代项目
python-pptx、Marp、Slidev
项目介绍
上一篇:KeyType
下一篇:pymupdf4llm
同类项目推荐
sunshine-control-panel
开源
一站式管理游戏库、监控内存,AI 助手加持,让大屏启动更高效。
Sunshine Foundation 大屏桌面管理器 | Tauri + Vue 3,游戏库管理、米塔AI助手、内存监控···
Stirling PDF
开源
本地部署 PDF 工具箱
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
obsidian-md2wechat
开源
一键将 Obsidian 笔记排版成公众号文章,告别手动调格式
Obsidian → WeChat | Obsidian 插件一键排版发布到微信公众号,键排版发布到微信公众号:···
pdf2md
开源
浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。
Browser based tool to convert PDFs to Markdown