utility-slideshow-creator

幻灯片制作工具

根据 JSON 幻灯片配置生成专业演示文稿（.pptx 和 .pdf）。生成时无需做任何设计决策——Claude 选择幻灯片类型并填充内容槽位；所有视觉属性都由主题预先设定。

适用场景

• 为利益相关方更新、产品评审和团队演示制作幻灯片
• 根据内容简报生成专业的 .pptx 文件
• 无需手动排版，即可制作风格统一的演示文稿
• 将演示文稿导出为 PDF，以便分享或存档

不适用场景

• 创建复杂的数据可视化（请使用专用图表工具）
• 构建交互式网页演示文稿（此工具生成的是 .pptx，而非 HTML）
• 编辑现有 PowerPoint 文件（此工具会从头创建新的幻灯片）

工作原理

双阶段架构：

1. 配置阶段（Claude） - 阅读内容简报，根据决策逻辑选择幻灯片类型，并编写 JSON 幻灯片配置。内容槽位设有字符数限制，以避免内容溢出。这是唯一会消耗 token 的阶段。
2. 生成阶段（本地脚本） - 运行 node scripts/generate-deck.js deck-spec.json 生成 .pptx。也可选择运行 node scripts/export-pdf.mjs deck-spec.json 生成 PDF。渲染结果确定，且不消耗 token。

两种输出都来自同一份 JSON 配置，因此 .pptx 和 .pdf 始终保持一致。

18 种幻灯片类型

#	类型键	用途	默认变体
1	title_dark	开场页（醒目）	仅深色
2	title_light	开场页（内部／简洁）	仅浅色
3	section	章节分隔页	深色
4	content	段落说明	浅色
5	bullets	3-6 个要点	浅色
6	two_col	并排比较	浅色
7	stat	单项关键指标	浅色
8	dual_stat	两项指标对比	深色
9	quote	客户评价或重点引述	深色
10	three_card	三个并列概念	深色
11	four_grid	2x2 网格中的四个概念	深色
12	timeline	日期或里程碑（最多 6 项）	浅色
13	process_flow	顺序工作流（最多 5 步）	浅色
14	agenda	会议议程（最多 7 项）	浅色
15	highlight	关键发现或执行摘要	浅色
16	table	表格数据	浅色
17	icon_rows	带标记的功能列表（最多 4 项）	浅色
18	closing	结束页	仅深色

完整的槽位定义和字符数限制：references/slide-types.md

决策逻辑（快速参考）

内容模式	使用类型
幻灯片开场（醒目）	title_dark
幻灯片开场（内部）	title_light
主题之间的过渡	section
段落说明	content
3-6 个要点的列表	bullets
并排比较	two_col
单项关键指标	stat
两项指标对比	dual_stat
客户评价或重点引述	quote
三个并列概念	three_card
网格中的四个概念	four_grid
日期或里程碑	timeline
顺序工作流	process_flow
会议议程	agenda
关键发现或摘要	highlight
表格数据	table
带标记的功能列表	icon_rows
幻灯片结束	closing

包含变体策略的完整决策逻辑：references/decision-logic.md

JSON 幻灯片配置格式

{
  "title": "Q3 Product Update",
  "author": "Product Team",
  "footerText": "Internal . Q3 Review",
  "slides": [
    { "type": "title_dark", "title": "Q3 Product Update", "subtitle": "October 2026" },
    { "type": "stat", "stat": "94%", "label": "Customer satisfaction score", "accentColor": "secondary" },
    { "type": "bullets", "title": "What Shipped", "bullets": ["Feature A", "Feature B", "Feature C"] },
    { "type": "closing" }
  ]
}

颜色可以使用主题 token 名称（"accent"、"secondary"、"tertiary"、"warm"），也可以使用 6 位十六进制字符串（"2563EB"）。

完整架构和工作流：references/TEMPLATE.md 和 references/platform-rules.md

说明

1. 阅读内容简报——了解主题、受众、篇幅和具体要求
2. 规划幻灯片——使用决策逻辑表选择幻灯片类型。为视觉节奏分配深色／浅色变体（交替使用，避免单调）。
3. 编写 JSON 幻灯片组规范——填充内容槽位，并遵守 references/slide-types.md 中的字符数限制
4. 运行生成脚本——node scripts/generate-deck.js deck-spec.json
5. 可选：导出 PDF——node scripts/export-pdf.mjs deck-spec.json output.pdf
6. 报告输出——告知用户文件所在位置

输出约定

• 规划文件：JSON 幻灯片组规范（Claude 编写的文件）
• 最终输出：.pptx 文件（以及可选的 .pdf），根据规范在本地生成
• 质量门槛：质量检查清单中的所有项目均通过

质量检查清单

• 每张幻灯片都有有效的类型键（18 种已定义类型之一）
• 所有内容槽位均符合 references/slide-types.md 中的字符数限制
• 深色／浅色变体交替使用，以形成视觉节奏（不得连续 3 张或以上使用相同变体）
• 幻灯片组包含标题页（第一张）和结束页（最后一张）
• 超过 6 张幻灯片的幻灯片组中，各主题之间由章节分隔页隔开
• 关键幻灯片（数据、重点、过渡）包含演讲者备注
• JSON 有效（无尾随逗号、引号正确、嵌套正确）
• 颜色值为有效的主题令牌或 6 位十六进制字符串（不带 # 前缀）

参考资料

文件	用途
references/TEMPLATE.md	JSON 幻灯片组规范模板及字段说明
references/EXAMPLE.md	完整示例：Q3 产品更新幻灯片组（9 张幻灯片）
references/slide-types.md	全部 18 种幻灯片类型：内容槽位、字符数限制、变体
references/decision-logic.md	内容模式 → 幻灯片类型映射、变体策略、幻灯片组规模
references/platform-rules.md	pptxgenjs 要求、Google Slides 兼容性、输出格式