用途
Slideshow Creator 用于从 JSON 幻灯片规范生成专业演示文稿（.pptx 和 .pdf）。其设计目标是：在生成时不需做任何设计决策——Claude 负责选择幻灯片类型并填充内容槽位，而所有视觉属性由主题预先决定。
适用情况包括：
- 为利益相关者更新、产品评审、团队演示创建幻灯片组
- 根据内容简报生成专业的 .pptx 文件
- 在无需手动排版的情况下产出风格一致的演示文稿
- 将演示文稿导出为 PDF 以便分享或归档
不适用情况包括：
- 创建复杂的数据可视化（应使用专门的图表工具）
- 构建交互式网页演示（本工具产出 .pptx，而非 HTML）
- 编辑已有的 PowerPoint 文件（本工具是从零创建新幻灯片组）
工作方式
采用两阶段架构：
- 规范阶段（Claude）：阅读内容简报，使用决策逻辑选择幻灯片类型，写出 JSON 幻灯片规范。内容槽位设有字符上限以防止溢出。这是唯一消耗 token 的阶段。
- 生成阶段（本地脚本）：运行
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"）。
完整 schema 与工作流见 references/TEMPLATE.md 和 references/platform-rules.md。
使用方式
- 阅读内容简报——理解主题、受众、篇幅、具体要求。
- 规划幻灯片组——使用决策逻辑表选择幻灯片类型。分配深色/浅色变体以营造视觉节奏（交替使用以避免单调）。
- 编写 JSON 幻灯片规范——填充内容槽位，遵守 references/slide-types.md 中的字符上限。
- 运行生成脚本——
node scripts/generate-deck.js deck-spec.json。 - 可选导出 PDF——
node scripts/export-pdf.mjs deck-spec.json output.pdf。 - 报告输出——告知用户文件所在位置。
输出契约
- 规划产物：JSON 幻灯片规范（Claude 写入的文件）
- 最终输出：.pptx 文件（+ 可选 .pdf），由该规范在本地生成
- 质量门：质量检查清单中的所有项均通过
质量检查清单
- 每张幻灯片都有有效的类型键（18 种已定义类型之一）
- 所有内容槽位遵守 references/slide-types.md 中的字符上限
- 深色/浅色变体交替以营造视觉节奏（不出现连续 3 张及以上相同变体的幻灯片）
- 幻灯片组以标题幻灯片开头、以结尾幻灯片结束
- 超过 6 张幻灯片的幻灯片组中，章节分隔符区分不同主题
- 关键幻灯片（指标、重点、过渡）包含演讲者备注
- JSON 有效（无尾随逗号、引号正确、嵌套正确）
- 颜色值为有效的主题 token 或 6 位十六进制字符串（不带 # 前缀）
参考文件
| 文件 | 用途 |
|---|---|
| references/TEMPLATE.md | JSON 幻灯片规范模板，含字段文档 |
| references/EXAMPLE.md | 完整示例：Q3 Product Update 幻灯片组（9 张） |
| references/slide-types.md | 全部 18 种幻灯片类型：内容槽位、字符上限、变体 |
| references/decision-logic.md | 内容模式 → 幻灯片类型映射、变体策略、幻灯片组篇幅 |
| references/platform-rules.md | pptxgenjs 要求、Google Slides 兼容性、输出格式 |