文档转PPT:PPT Master AI生成演示文稿手把手指南
【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master
手里有一份季度报告 PDF,后天要讲。PPT Master 是一个开源的 AI 生成演示文稿工具:把 PDF、网页甚至一个主题交给它,它在你本机返回一份原生可编辑的 PPTX——每个形状、文本框、图表都是真正的 PowerPoint 对象,点开就能接着拖改,而不是一堆截图。全程在 AI 工具的聊天面板里完成,不用写代码。
怎么装,第一条指令怎么发
装好只需要三步,前提只有两样:Python 3.10+,以及一个带 agent 能力的 AI 工具(能读写文件、执行命令、多轮对话即可,IDE 内置助手、Claude Code、Cline 都行,你只用它的聊天面板)。
- 拉取项目并装依赖:
git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master cd ppt-master pip install -r requirements.txt- 在 AI 工具里打开
ppt-master文件夹(IDE 走 文件 → 打开文件夹;CLI 工具先cd进去再启动)。 - 把 PDF 等源材料放进
projects/目录,在聊天面板里发:
请根据 projects/q3-report/sources/report.pdf 这份文件生成一份 PPT
装完跑通长什么样:AI 会先问你几个确认项(模板还是自由设计、画布格式、页数),然后自动完成内容分析、视觉设计、SVG 页面生成和 PPTX 导出,成品落在projects/<项目名>/exports/<项目名>_<时间戳>.pptx。生成期间浏览器自动打开http://localhost:5050实时预览 📌,选中元素就能改文字、颜色、位置,点 Apply changes 写回。赶时间就加一句跳过确认:
用 projects/q3-report/sources/report.pdf 快速生成一份 5 页 PPT,不用跟我确认
快速模式是一次性流程:你明确说的照做,没说的由 AI 直接定,中途上下文丢了只能重跑。Windows 用户先按 Windows 安装指南 配好 PATH 和运行策略。
交付物能改到什么程度,哪里是刻意不做
先给结论:它交付的是高质量可编辑草稿,不是零修改的终稿——这是定位取舍,不是能力缺口。
能力侧,打开导出的文件就能验证:
- 每个元素都是原生对象(DrawingML,PowerPoint 内部使用的矢量对象格式),在 PowerPoint、Keynote、WPS、LibreOffice 里都能继续编辑
- 走模板/结构化路线时,deck 带真正的幻灯片母版与布局(
p:sldMaster/p:sldLayout继承);自由设计路线是扁平结构 - 页面过渡默认
fade;图表、表格默认导出为可逐形状编辑的对象 - 演讲者备注可转成逐页语音嵌回 PPTX,之后在 PowerPoint 里直接导出同步旁白的 MP4,不需要第三方工具
- 支持 16:9、小红书 3:4、1:1 方形、A4 等 8 种预设画布(完整清单见 画布格式)
边界侧是两条有意的设计取舍:SmartArt 刻意不支持,映射文档里逐条写明了,别当 bug 报;元素动画默认不开,需要显式开启。
把成品调成你要的样子:材料、模式与参数
对成品影响最大的依次是你喂的材料、叙事模式和少量参数,按这个顺序调。
先喂真实材料
源材料会先转成 Markdown 再排版。手头有论文、内部文档这类专门材料时,直接给文件比让 AI 上网检索效果好;PDF、DOCX、PPTX、EPUB、HTML、Jupyter notebook 都能直接用,网页给 URL 即可,纯文字粘贴进聊天窗口也行。只有主题、想让 AI 先做主题研究补事实时,适合出初稿,不适合要事实密度高的正式交付物。
叙事模式:怎么讲,每份选一个
| 模式 | 骨架 | 什么时候用 | 什么时候别用 |
|---|---|---|---|
pyramid | 结论先行,结构化论证 | 决策汇报、董事会 | 想中立陈列资料时 |
narrative | 情境→张力→解决 | 路演、案例研究 | 要完整铺陈事实时 |
instructional | 概念拆解、循序渐进 | 培训、教程 | 需要推动决策时 |
showcase | 视觉优先,大图大数字 | 发布会、品牌展示 | 信息密集的汇报 |
briefing | 中立完整、可扫描 | 状态汇报、参考手册 | 需要给出结论时 |
模式管"怎么讲",与视觉风格互相独立,任意组合。
换一种视觉风格
内置 18 种风格,从严格网格的swiss-minimal、暗色数据仪表盘data-journalism、半透明玻璃glassmorphism,到水墨ink-wash、像素pixel-art。都没有对上时,直接用自然语言描述你要的感觉,AI 会基于风格目录做混合推演,而不是硬套预设。
对成品影响最大的几个参数
--native-charts-and-tables:符合条件的图表/表格换成带数据源、支持在 PowerPoint 里点"编辑数据"的原生对象,另存_native_charts_tables.pptx。汇报后期要改数字时用;只关心版式就别加。-a auto(或 203 个动画预设之一):开启对象级动画。有路演、现场演示需求才需要,普通汇报默认的fade过渡足够。--reflow-text:恢复 PowerPoint 自动段落换行。导出文件里文字不换行、整段顶满时用它。- 画布格式(小红书 3:4、方形 1:1、竖版 9:16、A4 等):交付物要发社交平台时指定,讲演场景保持默认 16:9。
图片有两条路径,同一份 deck 可逐张混用:AI 生图适合封面和产品图,gpt-image-2目前综合质量最佳;网络搜索零配置可用(默认 Openverse/Wikimedia),配上免费的PEXELS_API_KEY/PIXABAY_API_KEY后质量明显稳定。版权自动处理,需署名的图片会在对应页加一行小字署名。
已有一份设计不错的.pptx时,先分清要"换个内容"还是"沉淀成资产":
用这份 deck 的版式填入新内容:projects/brand/our_deck.pptx
走 Edit Native PPTX 路线,保留原页面外壳只替换内容;想沉淀成可复用模板工作区,则用:
Create a reusable Deck template from projects/brand/our_deck.pptx via /create-template
之后生成的新 deck,页数和结构都可以与参考件不同。
卡住了先查这张清单
模型选型一句话:用 Kimi K3 或 Claude 这类约 100 万 token 上下文的大模型,搭配 AI 生图——工具只负责工作流,质量上限由模型决定。⚠️ 结果不满意时先升级模型,再回头检查用法。
- AI 跑偏、忘了某个步骤 → 让它重读
skills/ppt-master/SKILL.md和当前路线的工作流文件 - 文字溢出、元素重叠 → 重跑该页,或在实时预览里直接改
- 长材料撑爆上下文窗口 → 改用分块生成(split mode)
- 没有生图 API key → 用宿主工具自带的生图,或零配置网络搜索兜底
- 动画在其他软件里显示不对 → 以 PowerPoint 为准验收,其他软件可能重映射个别效果
- 想更新到最新版 →
python3 skills/ppt-master/scripts/update_repo.py(仅 git clone 安装)
继续阅读
PPT Master 把做 PPT 最耗时的内容梳理、页面设计、逐页绘制交给 AI,交付的却是可编辑的原生文件;你付出的只有模型用量,剩下那点润色空间正是它的设计意图。
- 快速入门:从安装到第一份 deck,含实时预览、动画、旁白用法
- 常见问题:基于真实用户反馈持续维护
- 模板指南:Brand/Style/Layout/Deck 素材复用
- 音频旁白文档:备注转逐页语音与声音克隆
- PowerPoint ↔ SVG 映射指南:能力边界逐条对照
【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考