SlideCraft

▶ 观看 65 秒演示 · MP4 · 使用 Storygro 制作

通过一条提示词生成可编辑的 PowerPoint 演示文稿。描述目标，选择风格，交付可供合作伙伴使用的演示文稿。
一条提示词 · 安装 · 10 分钟制作第一份演示文稿 · 作品集网站 · 文档 · 路线图 · 更新日志

---

将一条提示词粘贴到 ChatGPT、Claude 或 Codex，即可生成可编辑的 PowerPoint——包含行动导向的标题、有来源依据的数据，以及交接前的审核。不是幻灯片图片。

最简单的方法：一条提示词

无需安装，也不需要 YAML。将下面的内容粘贴到 ChatGPT（Agent 模式）、Codex、Claude 或 Claude Code——任何能够运行代码并打开链接的助手——然后填写方括号中的内容：

Study the repository https://github.com/eiler2005/slidecraft (read AGENTS.md first) and use
SlideCraft to make me an editable PowerPoint deck.

Topic: [what the deck is about]
For whom and why: [who will read it and what they should decide or do]
Length: 15–20 slides
Language: [English / Russian / …]
Content: [your notes, key points, numbers with their sources, links or files]
Style: [e.g. calm consulting look, dark keynote, or "match the colours of https://…"]

Follow the SlideCraft workflow: show me the action-title chain and 2–3 cover options before
building, cite a source for every number, then give me the .pptx and a PDF.

助手会在自己的环境中运行 npx @eiler2005/slidecraft，编写演示文稿、进行检查，然后交付可编辑的 PowerPoint。已使用 Codex 和 Claude Code 对这条提示词进行测试——查看它们各自未经修改的生成结果，以及独立审核：Codex · Claude Code。ChatGPT 的 Agent 模式使用这条提示词的精简版本，端到端生成了一份五页演示文稿；它过程中遇到的工具错误已在 0.7.5 中修复。Claude.ai 的代码执行功能遵循同一份 AGENTS.md；我们尚未亲自运行过。内容可以使用任何语言。无法执行代码的聊天助手仍可编写 deck.yaml；你可以自行使用 npx @eiler2005/slidecraft build deck.yaml 来构建。若需重复使用，请将其安装到助手中（安装）。

SlideCraft 是什么

SlideCraft 将目标转化为咨询级演示文稿。你只需说明演示文稿需要实现什么目标，以及面向哪些读者。SlideCraft 会针对任务推荐模板，为你构建故事线和供你审批的行动标题草稿，然后撰写幻灯片并将其渲染为可编辑的 PowerPoint、无障碍矢量 PDF 和独立 HTML 演示文稿；此外，如果读者需要阅读而非观看，还会生成一页摘要和 Word 备忘录。最后通过合伙人式审阅完成闭环。

它适用于任何能运行命令的 AI Agent 或大模型：

• Claude Code — 提供技能和按模型层级划分的 Agent 的插件；
• OpenAI Codex — 可安装的技能；
• Claude Desktop、Cursor、VS Code、Windsurf、Gemini CLI — MCP 服务，只需一条 install 命令即可连接；
• Aider 或你自己的脚本 — 通过 AGENTS.md 和 JSON CLI 使用。

它基于你的资料开展工作：数字取自你的 Excel 或 CSV 文件，只录入一次；来源会注明所引用报告中的页码；同事在 PowerPoint 中编辑的文本也会同步回演示文稿。

底层是一个零安装 CLI。每种版式都使用公制兼容字体进行测量，因此能在 SlideCraft 中放下的文本也能放进 PowerPoint——并通过逐行对照真实 PowerPoint 输出进行验证。

为什么一个提示词就能生成可编辑的 PowerPoint

大多数 AI 演示文稿工具最终生成的是网页或幻灯片图片，因此还得有人在 PowerPoint 中重建演示文稿——而董事会、客户和品牌团队实际使用的正是 PowerPoint。SlideCraft 只需在你已使用的助手中输入一个提示词，就能生成一个文本、表格、图表、备注和图标都是原生对象的 .pptx。模型负责内容，SlideCraft 则补上模型缺少的部分：

• 咨询方法；
• 经过尺寸测量的版式；
• PowerPoint 自身的文本规则；
• 来源和数字核查；
• 最终视觉审阅。

演示文稿一次就能做好，并且后续修改时仍可编辑。

客观的限制。

• “一键”需要能运行代码的助手（ChatGPT agent mode、Codex、支持代码执行的 Claude、Claude Code）。
• 高质量来自几次简短审批，而不是跳过审批。
• 内容质量取决于你提供的数字和来源。
• PowerPoint 是参照标准；Keynote 和 Google Slides 会略有差异。
• 可编辑演示文稿正逐渐成为 Copilot 和 Gemini 的标准功能。SlideCraft 的长期优势在于方法和核查，而非文件格式。

完整分析：为什么可编辑的 PowerPoint 很重要——以及这一说法的适用边界。

效果展示

本演示文稿介绍 SlideCraft，而 SlideCraft 本身就是用一个 deck.yaml制作的：

PDF · PowerPoint · 单页摘要 · 所有示例

初次了解？从这里开始——十分钟制作你的第一份演示文稿 · 你能做什么——按任务查看功能 · 示例库——可供复制的 11 份完整演示文稿

**亲自查看成果：**在 docs/showcase/orchestration-run/ 查看完整运行过程、所有格式及其审阅报告 · 在 docs/showcase/fde-engineer/ 查看一份通过完整工作流制作的英文和俄文演示文稿（示例）· 查看 SlideCraft 重制版与原稿并排呈现的逐页对比及 HTML，运行 npm run comparison → comparison/index.html · 查看内容所在位置

项目缘起

SlideCraft 由 Denis Ermilov 开发。Denis 在 B2B 金融科技和企业平台领域拥有 20 年经验，涉及全国规模的支付系统、与中国、印度和东南亚建立直接连接的跨境支付枢纽、与 Volkswagen Group 柏林团队合作开发的经销商网络平台；他目前担任 Cinimex Group 的产品总监。这段经历中，有很大一部分用于制作与 McKinsey & Company、Accenture 和 IBM 等咨询公司合作项目的演示文稿：董事会文件、战略建议、指导委员会进展报告和提案。这些工作让他总结出几条简明规则：先给出答案，每张幻灯片只表达一个主张，每个数字都要注明出处，绝不能为了塞下内容而把文字缩小到难以阅读。大多数规则都可以机械化执行，因此这个项目把这些咨询实践转化为软件，让 AI Agent 每次都能遵循。

Denis 也会撰文探讨 AI，避免炒作：Digital Bank（2023 年）和 When Intelligence Became Cheap（2026 年），属于一个三册系列，探讨当智能变得廉价之后，人、公司与信任会如何变化。→ Amazon 上的书籍 · GitHub 个人主页

60 秒

you     › Make a deck: the board should approve a partner-led entry into Germany
agent   › Brief: board of 5, decision = €6M phase-1 budget, deck goes out as PDF.
          Outputs: PPTX (pptxgenjs) + PDF rendered by PowerPoint, because readers get the PDF.   ✅ CP1
agent   › Three templates — opened picker.html:
          A  Strategy recommendation · Consulting Classic   (answer first, 3 reasons, plan, ask)
          B  Strategy recommendation · Executive
          C  Executive update · Corporate Blue
you     › A                                                                                      ✅ CP2
agent   › Governing thought: "Entering Germany now captures a €40M window before two rivals scale"
          01 Entering the German mid-market can add €40M revenue by 2028
          02 Entering Germany now captures a €40M window before two rivals scale
          03 The UK business is profitable, growing and ready to fund a second market  …     ✅ CP3
agent   › Built 11 slides. Review: 0 blockers, 2 majors fixed, 1 minor left.                    ✅ CP4
          slidecraft/northwind-germany/dist/northwind-germany.pptx · .pdf · previews/ · manifest.json

工作原理

演示文稿由什么组成。 四个相互独立的层，全部是可供你阅读和比较差异的纯文件：

层	文件	内容
简报	brief.yaml	目标、需求、受众、演示文稿的用途 → 对应的输出
故事线 × 主题	从 14 × 7 中选择	适用于任务的论证结构，以及视觉风格
内容	deck.yaml（+ sections/*.yaml）	按照 46 种布局规范编写的行动标题和幻灯片内容；来自 Excel/CSV 的 sources:、facts:、封面视觉、language:
你的素材	materials/、assets/	按页引用的报告、数据文件、图片

布局会将内容转换为单一的 Scene IR；引擎再将其转换为可编辑的 PPTX、PDF、HTML、一页式文档和 Word 备忘录。文本按照 PowerPoint 的实测规则排版，因此 HTML 和 PPTX 会在相同位置换行。

组装流程——八个阶段，四个由你批准的检查点（见上方图片的第一行）：简报 → 选择模板 → 故事线 → 行动标题幽灵演示文稿 → 构建 → 审阅 → 视觉 QA → 交付。

检查方式。 每次构建后都会自动检查（确保内容完整显示、每个数字都有来源、各处数字一致、对比度和几何布局）；再进行文案适配循环和伙伴审阅；随后由审阅模型检查每张幻灯片在 PowerPoint 和浏览器中的呈现，并撰写 REPORT.md——给出结论并指出需要你关注的问题。检查期间所做的每项更改都会记录在 REVIEW-LOG.md 中。

能力最强的模型负责故事线和审阅；更快的模型则并行编写幻灯片并适配文案（Claude Code 中的 Opus、Sonnet 和 Haiku；在其他环境中则使用你配置的模型）。

完整流程：工作流 · 架构 · 最终视觉 QA · 设计封面 · 俄语及其他语言的演示文稿 · 编排模板和完整运行示例

模板库

模板由**故事线（适用于某项任务的论证结构）× 主题（视觉风格）**构成。任何故事线都适用于任何主题。十四种故事线 × 六种主题（也可以使用你自己的品牌主题），由四十二种布局构建而成。图库网站展示了每种故事线在每种主题下的效果，以及各种格式的示例演示文稿。

战略建议 · Consulting Classic — 结论先行，三个理由、计划、请求	高管动态 · Executive — 指导委员会、董事会、季度业务回顾：计划与实际及预测对比、待决策事项	叙事故事 · Midnight — 主题演讲和演讲：引入、历程、转折点、洞见
路演演示文稿 · Modern Pitch — 问题、解决方案、市场、增长、团队、融资请求	研究成果汇报 · Editorial — 问题、方法、发现、影响	客户提案 · Corporate Blue — 理解、方法、计划、团队、商务条款

所有故事线 → · 所有主题 → · 所有布局 →

故事线代表任务，主题决定外观：14 种故事线 × 7 种主题，可独立选择。在每张幻灯片中，通过 slidecraft exhibits 安排信息，使用 slidecraft components 重用原生库组件，并通过 layout: composition 将其组合起来。共享的设计元素和内容通过统一的 Scene IR 提供给 HTML 和可编辑 PowerPoint 引擎。构建指南 · 架构图和验证限制。

还包含：商业论证、产品概览、案例研究、项目启动会、复盘、培训 / 工作坊、销售 / 客户季度业务回顾、投资备忘录。提供自己的大纲，SlideCraft 会将其映射到布局。

轻巧快捷：examples/europe-first-trip — 五页旅行指南（2×2 价值地图、按旅行者类型划分的 Harvey 球适配度、预算图表、“谁适合去哪里”表格），通过插件 Agent 和 Codex 的实时端到端运行生成，然后经过整理。 你的品牌： slidecraft theme import brand.potx --id contoso --font-dir ./fonts 会创建包含你的颜色、字体和徽标的主题；slidecraft calibrate --theme ./slidecraft-theme/contoso.json 会根据实际 PowerPoint 检查换行（应用你的品牌）。模板中的图片会保留原位，标题栏和幻灯片尺寸会成为整个演示文稿的框架（也支持 4:3），其 Office 主题也会应用到每个 PPTX 中。

你的旧演示文稿： slidecraft import old.pptx --render 会将文本、表格、图表数据、图片和备注提取到草稿 deck.yaml 中；随后，/slidecraft:import 会根据渲染后的原稿逐页重新设计（导入 PPTX）。

输出和引擎

一份规范，多种引擎——由你选择，SlideCraft 会根据你对演示文稿的用途给出建议。

引擎	输出	可编辑	适用场景	安装	许可证
pptxgenjs (默认)	PPTX	✅ 原生文本、表格、图表、备注	你或团队将继续编辑的演示文稿	已捆绑	MIT
native (默认)	PDF	—	带可选中文本的矢量 PDF；适用于 CI 和自动化	已捆绑	MIT
pptx-convert	PDF	—	将 PDF 交付给读者——由 PowerPoint/LibreOffice 本身渲染，像素级一致	你的 Office 套件	—
html	HTML + PDF	可在浏览器中编辑	在浏览器中演示、分享链接、制作具有丰富装饰效果的故事型演示	生成 PDF 需要 Chrome	MIT
artifact-tool	PPTX	✅	对 OpenAI 适配器进行明确的本地评估	Codex 运行时	专有，仅用于评估/测试——绝不捆绑
onepager	PDF（A4）	—	一页呈现核心观点：将每张幻灯片作为缩略图，并配上行动标题	已捆绑	MIT
docx	DOCX	✅	预读材料和备忘录：标题设为标题样式，文本和表格可编辑，附件以图片呈现	已捆绑	MIT

推荐： 对于任何需要离开团队内部流转的内容，使用 pptxgenjs；artifact-tool 仅用于在 Codex 中明确进行内部评估/测试（不得用于生产、商业用途或基准测试）；始终生成 PDF——追求速度时使用 native，PDF 本身就是交付物时使用 pptx-convert；在浏览器中演示时使用 HTML。

保真度： 文本按照 PowerPoint 自身的测量规则排版，因此 HTML 与可编辑的 PPTX 保持一致；每份演示文稿都会在最后经过审核模型检查，并生成一份报告，指出需要你留意的内容（规则 · 视觉 QA · 校准报告）。

slidecraft doctor 会显示你的计算机上有哪些可用功能。了解各引擎的优缺点：引擎对比 · 选择输出引擎 · 引擎参考。

安装

选择你的 Agent。它们都使用同一个 CLI，即已提交的程序包 dist/slidecraft.mjs（Node ≥ 22.12，无需 npm install）。

使用对象	设置	然后
Claude Code	/plugin marketplace add eiler2005/slidecraft 然后 /plugin install slidecraft@slidecraft	/slidecraft:new <演示文稿必须达成的目标，以及面向谁>
OpenAI Codex	npm i -g @eiler2005/slidecraft 然后 slidecraft codex install（技能位于 ~/.codex/skills/slidecraft*）	codex "Using SlideCraft, make a 5-slide deck that …"
Cursor、Gemini CLI、Aider、Copilot agents，以及任何带 Shell 的大模型	npm i -g @eiler2005/slidecraft，或克隆；让 Agent 使用 AGENTS.md	“遵循 AGENTS.md，制作一份……的演示文稿”——参见与任何 Agent 搭配使用
Claude Desktop、Cursor、VS Code、Windsurf、Gemini CLI——或以上全部	npx @eiler2005/slidecraft install 会连接找到的所有 AI 应用（MCP 服务 + Claude Code 插件 + Codex 技能）	“使用 SlideCraft 制作一份……的演示文稿”——参见与 MCP 应用搭配使用
没有 Agent，或使用任何脚本	npx @eiler2005/slidecraft——无需克隆（npm）	npx @eiler2005/slidecraft build deck.yaml

git clone https://github.com/eiler2005/slidecraft && cd slidecraft
node dist/slidecraft.mjs build examples/strategy-recommendation/deck.yaml
open examples/strategy-recommendation/dist/northwind-germany.pptx

MCP 服务： npx @eiler2005/slidecraft mcp（stdio）。已列入官方 MCP Registry，名称为 io.github.eiler2005/slidecraft，因此支持注册表的客户端可以找到并安装它。

手动编写 deck.yaml：教程 · 演示文稿规范 · CLI 参考。

你将获得

文件	内容
<id>.pptx	可编辑的 PowerPoint：原生文本框、表格和图表、演讲者备注、每个主题的幻灯片母版
<id>.pdf	带标签的无障碍矢量 PDF：标题、替代文本、表头、来源链接（或使用 pptx-convert 由 PowerPoint 渲染）
<id>.html	单个自包含文件：键盘导航、演示者备注（N）、打印为 PDF
<id>-onepager.pdf	A4 单页摘要：标题链及幻灯片缩略图
<id>.docx	Word 备忘录：行动标题作为标题、可编辑文本和表格、作为图像的展示材料、备注
previews/NN-<slide>.png	用于审阅和分享的幻灯片预览
manifest.json	引擎和版本、输入的 sha256、数据文件和输出、每项事实的值、检查结果、限制；在人工签字确认前，visual_review: false

构建结果具有确定性：相同的演示文稿会生成字节完全相同的 PPTX 和 PDF。

原则

• 先给答案。 建议放在第 2 张幻灯片；之后的内容都用于证明它。
• 行动标题。 每个标题都是完整的论断句；从上到下阅读，标题会逐步论证观点。
• 每张幻灯片传达一个信息。 展示材料用于证明标题；细节放入备注或备份材料。
• 每个数字都有来源。 示例数据会明确标注。不编造任何内容。
• 可编辑，而非栅格化。 文本、表格和图表均保留为原生对象。
• 绝不截断。 如果文本放不下，SlideCraft 会告知需要删减多少个字符，而不是缩小文字直到难以辨认。

方法论：写作标准 · 视觉标准 · 展示材料选择 · 讲故事 · 审阅。

布局库

六组共 46 种布局。

分组	布局
框架	title（封面、结束页） · agenda（议程、章节分隔页）
信息传达	exec-summary（SCR、关键信息） · key-points（分栏、卡片、列表） · big-statement（观点、引言、重点数字） · text-image · text · before-after · composition（在不同区域展示多个图表） · native-canvas（定制、可编辑形状） · freeform · freeform-canvas（HTML/CSS，与任何幻灯片一样经过检查）
数字	kpi-tiles · chart-takeaway（条形图、柱形图、堆叠图、折线图、组合条形图 + 折线图） · evidence-panorama · waterfall · bubble-chart（气泡图、散点图、增长率—市场份额组合图） · marimekko · tornado · football-field · funnel（漏斗、金字塔） · data-table
分析决策	options-comparison（文本、Harvey-ball 评级，最多 5 个选项） · matrix-2x2 · swot · five-forces · pestel · business-model-canvas · value-chain · seven-s（McKinsey 7S） · issue-tree（议题、驱动因素） · maturity-model（网格、阶梯） · coverage-map · architecture（分区 + 登记表） · evidence-chain · risk-matrix
序列	process-steps（人字形、编号） · timeline（里程碑、甘特图） · gate-matrix · process-compare（现状与提议方案对比） · cadence（角色日历） · callout（截图上的编号标注）
人员 · 收尾	team-cards · org-chart · raci · next-steps（决策、行动）

规范、限制和缩略图： 布局参考。添加自定义布局： 添加布局。

路线图

已在 0.5 版推出：

• 数字只需填写一次： 使用 facts: 和 {{id}}，图表和表格直接读取 Excel 与 CSV 数据；
• 同一个数字，处处一致： 如果某项指标在不同幻灯片中显示的数值不一致，检查功能会发出提示；
• 页面级来源： ingest 可读取 PDF、Word、PowerPoint 和 Excel 材料；幻灯片会引用 report#p14；
• 编辑内容同步回去： sync 会将 PowerPoint 中编辑的文本同步回演示文稿；
• 框架和图表： SWOT、五力分析、PESTEL、商业模式画布、气泡图和组合图、marimekko、tornado、football field（共 40 种布局）；
• 适用于所有 AI 应用： 提供 MCP 服务和一行式 install，支持 Claude Desktop、Cursor、VS Code、Windsurf、Gemini CLI、Claude Code 和 Codex。

已在 0.7 版推出：

• 图片和图标： 提供有许可的图库照片（Openverse、Pexels、Pixabay），并在幻灯片、备注和清单中标明来源；提供 114 个可编辑图标；
• 根据样例创建主题： 从 PDF、截图或网站提取颜色、字体和边距；
• 更多框架： 价值链、McKinsey 7S、组合条形图 + 折线图（现有 46 种布局）；
• 数字校验： 检查整个演示文稿中的总计、期间和单位；
• 封面由你选择： 制作前先比较 2–3 个封面选项；封面没有视觉元素时会发出提示；
• 清晰、裁剪得当的照片： 无需密钥即可从 Wikimedia Commons 和 Openverse 获取照片，并测量下载大小；imageFocus 可让主体保持在画面中；
• 通过一个提示词完成测试： README 中的提示词未经修改，直接在 Codex 和 Claude Code 中运行，并对每次运行进行独立审查。

已在 0.6 版推出：

• 文本与 PowerPoint 完全一致： HTML 和 PPTX 共用实测的 Office 规则，并提供校准模式和 10 套演示文稿语料测试门槛；
• 最终视觉 QA： 审阅模型会在 PowerPoint 和浏览器中检查每张幻灯片，并生成报告和审阅日志；
• 醒目的封面： 封面可添加主题图案或图片；
• 支持任何语言： 标签、数字、排版和校对均遵循 language: 设置；来源信息会放在演讲者备注中。

接下来：实时预览、表格同步、演示者工具。参见 ROADMAP.md。

隐私与网络访问

SlideCraft 在你的设备上或助手的沙盒中运行。它不需要账户，也不会收集遥测数据，更不会将你的演示文稿内容发送到任何地方。它只会在你提出要求时联网：

• npx @eiler2005/slidecraft 会从 npm 下载软件包；
• 图库照片（imageQuery、slidecraft images --stock）会从 Openverse 和 Wikimedia Commons 搜索并下载；如果你设置了 PEXELS_API_KEY / PIXABAY_API_KEY，则会从 Pexels 和 Pixabay 搜索并下载；搜索词会离开你的设备；
• 生成的图片（imagePrompt、slidecraft images）会将提示词发送到兼容 OpenAI 的 API，并使用你的 OPENAI_API_KEY；
• slidecraft theme from https://… 会在你的本地 Chrome 中打开该网页，以读取其颜色和字体。

--dry-run 会在发送任何内容之前列出每条提示词或搜索内容。渲染使用你本地的 PowerPoint、LibreOffice 或 Chrome。你的素材保存在 slidecraft/ 中，该目录已被 git 忽略。

贡献

欢迎提交问题和 PR，尤其是新布局、主题和故事线。请先阅读 CONTRIBUTING.md；npm run check 会运行 lint、类型检查和 1,200 多项测试，其中包括对每种布局进行像素哈希视觉回归测试。

许可证

SlideCraft 采用 PolyForm Shield License 1.0.0，源码可见（但并非 OSI 开源）：

• 个人和公司均可免费使用——无论是个人使用、工作中使用、在公司内使用还是为客户服务：你都可以制作演示文稿、修改代码、将其集成到自己的工作流中，并附上许可证副本进行分享。你制作的演示文稿归你所有，可用于任何用途。
• 不得与其竞争——你不得将 SlideCraft，或基于它构建的产品，作为与 SlideCraft 竞争的产品或服务提供。
• 商业许可证——如需销售、托管、贴牌或将 SlideCraft 嵌入竞争产品，或需要企业条款和支持，请联系 [email protected]。详情见：COMMERCIAL.md。
• 名称——“SlideCraft”及其徽标不受 PolyForm 许可；分支项目必须使用不同的名称。

在公司中使用 SlideCraft？ 团队与品牌套件抢先体验——为你配置企业模板，并为团队共享品牌套件。

截至 0.6.0（含）的版本均以 MIT License 发布，且继续适用该许可证。随附字体采用 SIL OFL (fonts/SOURCES.md)，图标为 Tabler Icons（MIT），第三方库继续遵循各自的许可证 (NOTICE)。咨询方法是作者早期内部工作的通用化成果。