slides_maker：AI Agent 工具实践指南
真正理解slides_maker，要从它处理的任务开始：将论文、代码和文档转换为 Codex / Claude Code 中可供演示、可本地编辑的 PPTX，原生图表和方程、演讲者笔记、点击构建动画以及交付前的独立评论家审查。一旦进入文档与演示交付环节，内容结构和版式在转换后容易走样会直接影响交付，这也是我最关心的风险。我的评估方法是拿一份结构复杂的真实文档完成转换，然后检查标题层级、表格图片、字体版式和可编辑性是否与文档一致。我会把它列入经常交付正式文档或演示稿的团队的候选清单，而不是仅凭项目介绍直接纳入生产。
幻灯片制作器：将论文、存储库、文档或只是一个主题转换为您可以呈现的本机 PPTX
Free 并开源，由 Addsum
构建
幻灯片制作者会读取您的实际工作，从不发明数字，提供完全可编辑的本机 PowerPoint，并且在独立评论家签字之前不会将其移交。
在 Codex 或 Claude Code 中与它聊天。这不是一个快速猜测幻灯片的过程：一个由专业代理组成的小团队阅读您的论文/存储库/文档（或者在您没有时研究主题），计划故事，围绕它设计每张幻灯片，构建一个真正的 .pptx，并在看到第一个渲染后对其进行独立审查。
大多数 AI-PPT 工具都会在几秒钟内变得漂亮。当套牌“由你来防守”时，slide-maker 针对四个真正重要的事情进行了优化：
- 阅读你的来源——而不是发明它。 每个数字和图形都可以追溯到你的材料；它不会构成填充幻灯片的统计数据。 （每个“扩展主题”工具的失败模式——一位受欢迎的助手打印了43%的增长，而实际数字是12%。）
- ✏ 真实的 PowerPoint，而不是屏幕截图。 每个文本框、形状、本机图表和方程都是一个点击编辑对象 — 什么都没有 扁平化为图像。 （许多“导出到 PPTX”工具会悄悄地将三分之一的幻灯片变成无法编辑的图片。）
- ⚖ 独立审查 - 你调整大小，手中的甲板。 一个*单独的评论家试图打破甲板 - 狭窄的布局，弱对比度，与源不匹配的数字 - 并发送修复。不是作者为自己的作业评分的模型。您可以在看到第一个渲染后选择难度（或跳过）。
- 围绕您的内容设计，以任何语言，在任何画布上。 逐张组合幻灯片 - 匹配您的模板或设计一个干净的幻灯片 - 用于研究演讲、论文答辩或产品推介。不是您的文本倒入库存布局中。不仅是16:9：同样的技巧可以重组为4:3、方形1:1、小红书3:4卡片、9:16故事封面和A4打印一页纸，每个都有自己的安全区域和布局逻辑。
本机可编辑 PPTX 现在已成为赌注；有几个工具可以做到这一点。 Rarer 是一个可编辑、可追踪源头、经过评论家审查并同时为您的内容创作的套牌。诚实的限制：没有零设置云，没有共享链接，没有动画网络背景 - 它创建一个文件，在本地运行，在真实的 PowerPoint/Keynote 中干净地打开和编辑。请参阅 有什么不同 有什么不同。
Intro video · Templates · What 的 different · How 它 works · Quick start · Troubleshooting
模板库
十二个方向，一套英文，一套中文。每个都是完整的示例，包含真实内容，而不是空的占位符。
quarterly review, business update, metrics dashboard, exec readout city, culture, event, brand story paper reading, lab meeting, method overview, experiment report |
launch keynote, product reveal, spec walkthrough company overview, product matrix, customer communication, fundraising intro historical arc, industry evolution, timeline story |
seed pitch, investor meeting, fundraising deck, demo day public figure, brand archive, cultural retrospective industry research, trend explanation, structured analysis |
training deck, workshop, skills enablement, exercises trend talk, personal presentation, startup story class explanation, reading share, training material |
Chinese 版本位于 templates/decks/zh/，预览于 Chinese README.
如何使用模板
该画廊位于 slides_maker-site 存储库中，位于 templates/decks/ 下，英文位于 en/ 下，中文位于 zh/ 下。抓住一次：
git clone --depth 1 https://github.com/addsumtech/slides_maker-site.git
使用模板的两种方法：
选项 1：指向它（最简单）。 将模板路径放入您的请求中：
Use slide-maker. Follow the style of slides_maker-site/templates/decks/en/nvidia-overview/template.pptx
and build a product intro from my product.md.
它解析模板的布局和视觉系统，然后将它们应用到您的内容。
选项 2：注册它以供重复使用。 将您喜欢的模板复制到本地模板注册表中，幻灯片制作器每次都会将其列为选项：
# Claude Code users
cp -r slides_maker-site/templates/decks/en/nvidia-overview ~/.claude/slide-templates/nvidia-overview
# Codex users
cp -r slides_maker-site/templates/decks/en/nvidia-overview ~/.codex/slide-templates/nvidia-overview
布局匹配；只是复制语言不同。
视觉语言：四种以图像为主导的外观
除了模板库之外，幻灯片制作器还提供了四种完整的视觉语言：带有图片的平台的整体外观，每个平台都有系统字体的类型声音、纸张表面、自己的图像处理和六种页面布局（封面、部分、图像+文本、引用、数据、结束语）。他们列出“你的”文字和图片，但从不发明单词、数字或名称。
|
editorial · quiet photographs, large serif display, pull quotes, warm paper
对比地：ink |
soft · warm photographs, rounded sans, generous space, cream with pastel shapes
对比地：dusk |
|
collage · loud photographs as taped prints, heavy headlines, highlighter kickers, kraft grain
对比地：slate |
storybook · a watercolour illustration series melting into the paper, serif type
对比地：meadow |
Style 样本内容是样本内容，而不是您的套牌。每种语言还有一个对比背景，当您最近的套牌已经放在灯光上时自动拍摄 paper.
如何挑选一个人。 当你的套牌上有照片或插图（你自己的，或者幻灯片制作者为你生成或获取的照片或插图）时，至少有一个候选人看起来表明你是一种视觉语言：照片导致社论，软语或拼贴画，插图到故事书。或者叫出名字（“使用拼贴外观”）。要将示例打开为可编辑的牌组，请在本地构建它们：
python3 skills/slide-maker/scripts/visual_languages.py --sample out/
幻灯片制作器有何不同
AI 演示工具大致分为四类。幻灯片制作器只执行最后一个：
| 类别 | 输出 | PowerPoint 中可逐个元素编辑吗？ |
|---|---|---|
| 模板填写 | 内容倒入固定模板 | 部分受模板限制 |
| 基于图像 | 每张幻灯片一张大图片，打包到 PPTX 中 | 不，每张幻灯片都是一张图片 |
| HTML 演示 | 浏览器中的幻灯片 | 不是 PPTX |
| 本机可编辑（幻灯片制作器） | 真实文本框、形状、本机图表 | 是的，单击任意内容并编辑 |
该表是关于格式的。一些较新的工具现在还发出本机可编辑的 PPTX，因此“可编辑”本身不再具有任何区别。作用：它读取您的真实材料并拒绝发明，它对幻灯片进行独立审查，并将每张幻灯片组成您的内容，而不是将文本倒入模板中。
一个小代理团队：独立的工作，独立的激励
Slide-maker 并不是一个可以完成所有事情的提示。这是一组专门的特工，每个特工都有一个角色，故意保持独立，这样就没有人介意构建牌组并对其进行评分：
- 内容策划：主编。它进行其他人没有做过的阅读，并决定每张幻灯片“说”什么——要点、证据、叙述弧——每个数字都追溯到来源和覆盖范围，确保材料中的关键点不会被无声地丢弃（每个数字要么落在幻灯片上，要么被标记为有意识地剪切）。因为整个故事都在一个人的头脑中流动，所以这个甲板作为一个论点而不是一堆幻灯片组合在一起。
- 幻灯片设计（艺术总监）：用独立的思维来决定批准的故事外观 - 每张幻灯片的视觉形式、调色板（每种颜色一个意思，整个甲板）、版式、节奏、图标以及点击构建实际赢得一席之地的地方。它首先根据内容绘制每个页面的草图，然后才到达组件库，因此甲板是经过设计的，而不是模板化的。
- 评论家：没有构建这套牌的独立评论家。它通过两个镜头来判断渲染的幻灯片——内容保真度（与源数据不匹配的数字，丢失的关键点）和设计（狭窄的布局，弱对比度，合规但死气沉沉的幻灯片）——并发送修复。选秀中没有任何利益，这正是它诚实的原因。
- 仲裁者：对于高风险套牌，在任何更改之前进行第二次独立检查，确认评论家的发现是真实的，因此循环修复了真正的问题，而不是噪音。
- 资产准备：一个构建时执行器，一旦您批准了设计计划，它就会并行实现计划的资产（图形裁剪、方程图像、生成的板、图标）。它的设计决策为零，因此即使是大型甲板也可以快速构建。
最重要的是，它做了大多数工具会跳过的三件事：
- 它在绘制之前进行读取。 论文会从头到尾地阅读，存储库从 README 开始，当您没有材料时，它会首先在线研究该主题。每个数字和图形都可以追溯到来源，并且您可以在绘制任何幻灯片之前确认结构草案。它不会将摘要粘贴到第一张幻灯片上就到此为止。
- 不仅仅是文本保持可编辑。 数据图表默认为本机 PowerPoint 图表，您可以双击并重新编号。默认情况下，公式被排版为可编辑的本机数学文本，而不是屏幕截图（只有分数和矩阵等二维布局会回退到渲染图像）。纸质图形按原样从 PDF 中裁剪，从未重新绘制。
- 包含脚本；动作由您选择。 演示文稿在演讲者备注中包含完整的每张幻灯片脚本，因此您可以带着它走上舞台。点击构建——一次一拍地显示一张幻灯片——是在面试中提供的，而不是假设的：假设你想要一个简单的点击，而幻灯片是静态的，这是正确的结果，而不是缺失的功能。当您确实需要它们时，它会决定它们在“哪里”获得一席之地并完全展示这些幻灯片，而不是对半页进行动画处理。
如果您进行大量迭代，还有一件事很重要：每个牌组都是由文件旁边附带的构建脚本生成的。用一句话更改焦点、幻灯片计数或模板，它就会干净地重新生成，而不是您手动重新制作幻灯片。
随着时间的推移，它会变得越来越“属于你”。当你继续以相同的方式跨平台引导偏好时——带有安静镶边的生动数据，没有模板卡，排版方程——它会将其记录为便携式品味配置文件：你在注册表根目录下拥有的一个普通文件，你可以逐行读取、编辑或删除它。未来的套牌将其视为默认设置，因此您无需重新教授相同的内容。它只是“种子”一个选择——无论你在当前牌组上说什么总是获胜——并且一个全新的用户从一个干净的石板开始，没有假定的风格。
它并不能保证一次性打造出完美的套牌。它删除了昂贵的部分——阅读材料、规划结构、布置页面、制作图表、编写脚本——并为您提供一个可以继续编辑的真实文件。剩下的修饰是你的，这就是为什么输出是原生 PPTX。
它是如何运作的
- 它首先询问。 听众是谁，演讲时长，幻灯片多少张，现场还是自读，什么风格。简短的回答就足够了。如果你很着急，就说“你决定”——然后它会自己选择合理的答案，并在构建之前发布它的选择，因此错误的猜测会让你看一眼，而不是重建（只有缺少的主题或来源仍然需要你）。
- 它读取（或研究）材料。 论文、文档、存储库——加上 Word/Excel/CSV/图像/视频/音频，以及通过目的驱动分类的整本书——被忠实地阅读，提取优先（它永远不会猜测像素的数字）：从 PDF 中裁剪的数字，逐行验证的关键数字，幻灯片上没有来源的任何内容。只有一个主题，它首先在网上研究当前信息，然后据此进行工作。
- 你批准故事，然后是外观 - 就在聊天中。 内容规划者会发布一个紧凑的每张幻灯片表（每张幻灯片说了什么，哪个人物承载它，甲板如何流动），加上它选择的叙述弧线和它拒绝的两个弧线以及各自失败的原因 - 所以你可以推翻结构，而不仅仅是措辞。一旦你确认了故事，艺术总监就会以同样的方式发布设计计划（外观、调色板、每张幻灯片的形式、动作）。在两个最便宜的时刻进行两次快速确认以改变方向——无需打开计划文件。
- 它生成 PPTX。 布局由代码保证，并在构建时和渲染输出时进行自动布局检查。溢出、重叠和字体问题都会出现在那里 - 没有人想到要检查的罕见故障也是如此：文件 PowerPoint 拒绝打开。 读取几何图形和像素的检查在结构上对格式错误的部分是盲目的，因此文件本身也经过验证。在真实构建上进行测量：重复的动画元素留下的甲板保存没有错误，渲染良好，并通过了每个布局检查 - 第一个标志是 PowerPoint 提供在用户面前“修复”它。
- 您看到渲染，然后由独立评论家对其进行评论。 首先发布渲染的牌组，然后您可以在您面前选择审阅工作 -
fast（默认）到thorough，或none（如果它已经是您想要的）。评论家代理（与高风险套牌上的仲裁者交叉检查）根据演示标准判断幻灯片；修复陆地，重新检查甲板，然后才交付给~/Downloads/<deck-name>/。 PDF 和浏览器预览是在交接时生成的，而不是在每次构建时生成的（仍在编辑的套牌会使它们立即过时）——并且它们在审查实际运行的记录上进行门控，因为跳过检查的模型与会写下声称没有检查的注释的模型相同。 - 你用简单的语言调整它。 不完美？只需在聊天中这么说（“将第 7 张幻灯片变成图表”、“剪切介绍”、“更温暖的调色板”、“将其制作为 10 张幻灯片”、“缩短注释”），它就会从相同的脚本中干净地重建。禁止用手拖箱子；不断完善，直到正确为止。
费用是多少： 该工具是免费的；您只需支付 AI 使用量。阅读、规划和构建是成本较低的部分 - 独立审查循环是令牌的去向，因此在第一次渲染后，它会作为一个问题被问到，甲板就在你面前：
review: |
什么运行 | 测量的 |
|---|---|---|
fast（默认） |
1 名通才评论家，1 轮，前 5 名声明经过事实核查 | ~6 个子代理 · ~250k 代币 · ~10–20 分钟 |
standard |
2 位重点评论家（内容 + 设计），2 轮，前 10 名声明 | ~12 · ~600k · ~30–60 分钟 |
thorough |
多评委小组+仲裁员交叉检查，3轮，每个索赔 | ~32 · ~2M · ~1–2 小时 |
none |
没有评论 - 对您所看到的感到满意，按原样接受 | 0 |
Figures 来自一张 12 页的纸牌，2026 年 7 月 — magnitude. 的订单
快速启动
第 1 步：安装
更喜欢市场？幻灯片制作者也发布在 腾讯 SkillHub 和 ClawHub — 最后一个直接安装到 OpenClaw，因此 OpenClaw 用户也可以获得幻灯片制作器 — 按照每个页面的安装说明获取它，然后返回运行时 下面的依赖项（无论您如何安装，它们都适用）。
Slide-maker 依赖于三个系统工具：Python 3.9+、LibreOffice（为自动布局检查渲染幻灯片预览）和一个用于图标的 SVG 光栅器（librsvg、cairosvg 或任何 Chrome 系列浏览器）。为您的 OS 安装它们：
| OS | LibreOffice | 图标光栅器 |
|---|---|---|
| macOS | brew install --cask libreoffice |
brew install librsvg |
| Linux | sudo apt install libreoffice |
sudo apt install librsvg2-bin |
| 窗户 | winget install TheDocumentFoundation.LibreOffice |
安装了 Chrome 或 Edge（使用无头） |
（Windows 也可以；我们只是对其进行较少的测试，因此，如果您遇到环境怪异，请运行下面的 check_env.py 进行自我诊断或打开包含错误的问题。）
准备好这些系统工具后，安装幻灯片制作器本身。下面的四行克隆存储库，安装其 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 both
如果仅使用一种工具，请将 both 替换为 codex 或 claude。不确定缺少什么？ 检查命令 打印确切的修复。
更喜欢单线？仅使用 npx skills 安装技能（无克隆，约 1.1 MB）：
npx skills add addsumtech/slides_maker
它提示输入代理和范围。该技能位于 skills/slide-maker/ 下，并且存储库不包含重资产（图库和演示站点位于 slips_maker-site 中），因此安装保持小而快。添加 -g 以全局安装（所有项目），添加 -a claude-code（或 -a codex）以跳过代理提示，并添加 -y 以实现完全非交互式运行。您仍然需要上面的运行时依赖项：LibreOffice、SVG 光栅器和 python3 -m pip install -r skills/slide-maker/requirements.txt。
在 Claude Code 上，您还可以将其添加为插件，以便它通过正常的插件命令保持更新：
/plugin marketplace add addsumtech/slides_maker
/plugin install slide-maker@slides-maker
这是相同的技能，只是由 Claude Code 的插件系统管理，而不是复制到您的技能文件夹中。上面的运行时依赖关系仍然适用。
保持最新状态
幻灯片制作器会在询问您任何问题之前进行检查，并且当您处于当前状态时保持完全沉默。当有新版本存在时，它不会自行更新，也不会只是提及它 - 它会在顶部询问一次：
- 是 — 它会为您更新，然后在新版本上构建整个套牌。您不需要知道如何安装它：它会自行计算并运行正确的命令。
- 否 — 不更新；基于您已安装的版本构建。
- 其他 — 您有本地更改。它向您展示什么是您的以及即将到来的内容，并且它本身并不能解决任何问题。
远程查找会缓存 24 小时，但每次都会重新读取“您”是否有未提交的工作 - 一天前的“您的树是干净的”正是导致某人的编辑被覆盖的读取。离线时，它会保持安静而不是妨碍。
不想被告知：export SLIDE_MAKER_NO_VERSION_CHECK=1。
第2步：调用它并回答采访（推荐路径）
最好、最可靠的结果来自调用该技能并逐步回答其简短的面试：
/slide-maker
采访以可点击的选项卡形式打开（主题·模板·目的和受众·风格和语言）：箭头键移动，Enter键选择，每个问题都附带现成的选项。它也能识别回访的用户：保存的模板和过去的主题在常规选项旁边显示为“使用我以前的主题之一”选项，仅在您选择它时才会扩展。 回答每个问题使这套牌成为你的而不是通用的：受众、长度、现场阅读与自读、密度、语言和外观都指导着计划。简短的答案很好，并且“你决定”始终是有效的答案。 （这里不要求审查工作 - 您可以在第一次渲染后选择它，手头有甲板。）
着急吗？一句台词也有效，但将其视为捷径，而不是最佳路径：
Use slide-maker to create a PPT from paper.pdf.
它直接从您的文件开始并跳过主题问题，这很方便。但你没有回答的每个问题都会成为技能必须做出的假设，因此你通常会花更多时间进行调整。 当套牌很重要时，回答采访。（在 Codex 中没有斜杠命令；相同的问题以纯文本形式出现。完全支持，只是点击次数较少。Claude Code 是更顺畅的旅程。）
不管怎样，接下来是一段简短的对话，而不是即时写作练习：
It: Before I build: which template? Who is the audience, how long,
live or self-read? Is this PDF the only source?
English or Chinese, visual-first or balanced?
You: For my advisor and labmates, 12 minutes, live. Only paper.pdf.
English, visual and concise. You pick the look.
It: (after reading the paper) Here is the plan: 15 slides.
Slide 4 places the paper's Figure 1 whole; the results page
becomes a native chart you can re-number...
Confirm the direction and I will build.
- 您可以在构建幻灯片之前选择外观 - 无需询问。 当幻灯片制作者从头开始设计时（您没有自己的模板），它会将 四种样式方向 呈现到一个浏览器链接中并等待您选择。这四个中至少有一个是为您的主题发明的寄存器，而不是库存预设，并且机械检查会拒绝一组其选项是四层相同油漆的设置 - 所以这是一个真正的选择，而不是形式。
- 将您的材料放入当前项目中，或在请求中提供完整路径。 根本没有材料？ 给它一个主题；它首先在网上进行研究，然后与您达成一致的结构。
其他打开方式：
Use slide-maker to create a technical presentation from this repository.
I have a reference PPT: /path/ref.pptx. Use its visual style only, not its content,
and make a new English deck from paper.pdf.
可选：AI 图像生成
如果您想要生成的封面、页面插图或完整生成的视觉标识，请在聊天中说“使用 AI 图像生成”。有两种方法可以为其提供支持：Codex 订阅使用其内置图像生成（无需密钥），或者设置 OpenAI API 密钥来遍历 API。两者都没有，slide-maker 仍然可以生成完全可编辑的 PPTX。
最适合的场景
研究演讲是主场，因为它解析论文中的问题、方法、结果、图表和方程。但是，每当需要清楚地解释材料时（或者当您只有一个主题而没有材料时），它可以为您提供第一套材料，您可以展示并继续编辑。
| 你有什么 | 你能做什么 |
|---|---|
| 论文、实验结果、纸质图 | 实验室会议及论文阅读、会议口头报告、海报、提案、论文答辩、实验报告 |
| 代码存储库、README 文件、技术文档 | 实验室会议、回购演练、架构演讲、进度更新、工程回顾 |
| 课程材料、产品文档、市场数据 | 课堂讲座、产品介绍、市场分析、提案 |
| 还没有什么，只是你脑子里的一个话题 | 给它一个主题；特工在线研究当前信息，与您就结构达成一致，然后从头开始构建套牌 |
| 参考号PPT | 新主题、新内容、重新组织的故事：它的外观，你的材料 |
| 一个需要超越 16:9 的故事 | rednote (小红书) 3:4 图像注释、方形 1:1 帖子、9:16 故事封面、4:3 场地甲板、A4 打印单页纸 — 相同的标识和组件，每个表面都通过平台安全区重新组合 |
故障排除
如果生成或预览渲染失败，请运行对您的环境的检查。大多数失败都是缺少 Python 依赖项或 LibreOffice：
# Codex
python3 ~/.codex/skills/slide-maker/scripts/check_env.py
# Claude Code
python3 ~/.claude/skills/slide-maker/scripts/check_env.py
它会打印任何缺失内容的确切修复。
对于环境之外的所有内容 - 构建错误、lint 结果及其用简单语言表示的含义、渲染失败、图像来源、CJK 问题 - 有专门的症状→原因→修复页面：故障排除和 FAQ。失败的 lint 运行会打印指向它的指针。如果此处未涵盖问题，请使用错误输出打开问题。
安全性
此存储库中的任何位置都没有存储或硬编码凭证，并且 CI 会扫描每个推送（工作树和完整历史记录）以查找凭证形状而不是前缀。如果扫描仪在此处报告了 sk- 密钥，则它与 CSS 类名匹配（sk-body、sk-split、sk-rail — sk- 是 sculpture 的缩写）； SECURITY.md 展示了如何在十秒内确认这一点，以及如何报告任何真实情况。
