slide-maker：从你的材料生成可编辑的 PPT

English

_{增和科技 Addsum 出品 · 免费开源}

slide-maker 是一个生成可编辑 PPT 的开源 AI 技能，可在支持技能的 AI 助手中使用。提供论文、代码仓库、文档或一个主题，它会整理内容、设计页面，生成可在 PowerPoint 中继续编辑的 .pptx，并附上用于后续修改的生成脚本。

你可以先选模板，也可以提供参考 PPT。生成前确认内容结构和设计方向，生成后查看预览，再决定独立评审的力度。

视频介绍 · 模板库 · 功能与交付 · 工作流程 · 快速开始 · 遇到问题

快速开始

先把 slide-maker 安装到你使用的 AI 助手中。打开电脑的终端，复制并运行下面一行命令，再按提示选择 AI 助手和安装范围：

npx skills add addsumtech/slides_maker

安装后即可向 AI 助手提出制作需求。首次使用会自动检查运行环境，缺什么再按提示安装。以下示例中的 paper.pdf 换成你的文件名即可：

用 slide-maker，根据 paper.pdf 做一份中文组会汇报。
观众是导师和同学，现场讲 12 分钟，约 15 页。
图多字少，先给我看内容结构和设计方向。

想指定画风，可以先在下方选模板，再复制对应提示词。

模板库

内置三十套模板，每套提供两种配色，以及封面、章节、图文、要点、引语、数据、结尾七类页面。字体、图表和页面版式使用同一套设计，实际生成时会按你的内容调整。

搭配图片使用的四套分别是：杂志（editorial）、柔和（soft）、拼贴（collage），用于排版你的照片；绘本（storybook），用于搭配一组插画。其余二十六套用可编辑的原生形状构成画面，无需准备配图。

下面是十二套精选模板。点击样张下方的“查看全部页面”，可查看该模板的全部页面和两种配色。

杂志 照片排版 查看全部页面	海报大字 发布会、宣言、观点 查看全部页面	水墨 文化、历史、器物 查看全部页面
漫画分镜 讲故事、用户旅程、科普讲解 查看全部页面	黑胶唱片 音乐、播客、文化活动 查看全部页面	彩绘玻璃 文化遗产、文化活动、庆典 查看全部页面
导视线路 路线图、流程、新人上手 查看全部页面	黑板报 课程、课堂、培训 查看全部页面	食谱卡 美食、烹饪、食谱 查看全部页面
电路板 硬件、物联网、嵌入式 查看全部页面	绘本 插画叙事 查看全部页面	体育记分牌 体育、比赛、团队战绩 查看全部页面

查看全部三十套模板

模板怎么用

在在线模板库选好画风，复制提示词，再粘贴到已安装 slide-maker 的 AI 助手中，并提供材料、观众和页数。例如：

用 slide-maker，选择标本图鉴（herbarium）模板的浅色配色。
根据 notes.md，做一份给初中生讲解的 8 页生物课件。

不确定选哪套，可以让它按主题推荐。已有学校或公司的 PPTX，也可以提供文件，让它参考字体、配色和版式。

功能与交付

材料中的关键数字会对照来源核验，论文图优先直接裁取原图。只有主题、没有材料时，会先联网调研，再整理内容。用于正式汇报前，仍需确认关键数据和结论符合你的原意。

工作流程

1. 明确需求：确定主题、材料、观众、时长、页数和风格。没想好的设计细节可以交给它决定，关键假设会在制作前说明。
2. 阅读材料：提取文字、图表、数据和公式，整理出处；支持论文、代码仓库、Word、Excel、CSV、图片，以及音视频材料。
3. 确认方案：先看逐页内容结构，再确认字体、配色、版式和动效。没有现成模板时，可以先比较设计方向。
4. 生成与检查：构建 PPTX，渲染页面，检查文件结构、文字溢出、遮挡和字体等问题。
5. 查看预览并评审：第一版预览出来后，选择评审档位。独立评审检查内容和设计，修订后复查，再交付文件。
6. 继续修改：直接说“第 7 页改成图表”“压到 10 页”或“备注短一点”，它会基于原生成脚本重出一版。

评审与用量

技能本身免费，运行时使用你的 AI 订阅或 API 额度。页数、材料长度、生图和评审力度都会影响耗时与用量。

长篇 PPT 会按章节分工评审，并检查整体连贯性。让它“自己决定”时，默认至少运行 fast，不会自动跳过评审。

安装与环境

自动安装和手动安装任选一种即可。大多数用户选择自动安装。

自动安装（推荐）

在终端中运行：

npx skills add addsumtech/slides_maker

按提示选择你使用的 AI 助手和安装范围。希望在不同项目中使用时，可选择全局安装。安装完成后，直接向 AI 助手提出制作需求。

如果提示找不到 npx，或 Node.js 版本过旧，请先安装 Node.js 22.20 或更高版本，重新打开终端后再运行命令。

手动安装

需要保留源码或自行维护安装时，可以使用下面的方式。电脑需已安装 Git 和 Python，在终端中依次运行：

git clone --depth 1 https://github.com/addsumtech/slides_maker.git
cd slides_maker
python3 -m pip install -r skills/slide-maker/requirements.txt
python3 skills/slide-maker/scripts/install_skill.py --target all

最后一条命令会把技能安装到本机已有的 AI 助手技能目录中。

/plugin marketplace add addsumtech/slides_maker
/plugin install slide-maker@slides-maker

运行环境

无论选择哪种安装方式，首次制作 PPT 时都会检查运行环境，并尝试自动安装缺少的 Python 依赖包。Python、LibreOffice 等系统工具如有缺失，按提示补齐即可；已安装的工具无需重复安装。

需要 Python 3.9+、用于生成页面预览的 LibreOffice，以及用于处理 SVG 图标的 librsvg、cairosvg 或 Chrome 系浏览器。需要自行安装系统工具时，可参考：

Windows 的测试覆盖较少。若终端只有 python 命令，可将示例中的 python3 换成 python。其他问题见遇到问题。

开始制作

把材料交给已安装技能的 AI 助手，或提供它能读取的文件路径，然后直接说明需求。Claude Code 也可以输入 /slide-maker。

除了上方的论文汇报示例，也可以从代码仓库开始：

用 slide-maker，按这个代码仓库做一份给新同事看的技术介绍。
重点讲架构和主要流程。

已有参考 PPT 时，说明要参考的部分：

参考 /path/ref.pptx 的字体、配色和版式。
用 paper.pdf 的内容重新做一份中文汇报。

它会补问观众、页数、风格等影响方案的信息，短句回答即可。希望它代选时，可以说“你定”。

更新与可选生图

有新版本时，slide-maker 会先询问是否更新；已是最新或离线时不打扰。远端版本信息缓存 24 小时，本地改动会每次重新检查。需要关闭版本提醒时，设置 export SLIDE_MAKER_NO_VERSION_CHECK=1。

需要生成封面或插画时，在对话中说明即可。可使用当前 AI 助手提供的图片生成工具，或配置 OpenAI API key。生图是可选项，不影响原生文字、形状和图表的生成。

适合什么场景

遇到问题

生成或渲染报错时，可让助手找到技能内的 scripts/check_env.py 并运行。全局安装也可以按实际目录运行：

# 通用技能目录
python3 ~/.agents/skills/slide-maker/scripts/check_env.py

# Codex
python3 ~/.codex/skills/slide-maker/scripts/check_env.py

# Claude Code
python3 ~/.claude/skills/slide-maker/scripts/check_env.py

检查会列出缺失依赖及修复命令。

生成失败、字体显示异常、预览报错和图片来源等问题，可查阅故障排查与常见问题。仍无法解决时，请在 Issues 中附上报错输出。

安全与开源协议

安全问题的报告方式见 SECURITY.md。本项目采用 MIT 协议。