utility-slideshow-creator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Slideshow Creator

幻灯片生成器

Generate professional presentations (.pptx and .pdf) from a JSON deck specification. Zero design decisions at generation time — Claude selects slide types and fills content slots; all visual properties are pre-decided by the theme.

基于JSON演示文稿规范生成专业演示文稿（.pptx和.pdf格式）。生成过程无需手动设计决策——Claude会选择幻灯片类型并填充内容槽；所有视觉属性均由主题预先确定。

When to Use

适用场景

Creating slide decks for stakeholder updates, product reviews, team presentations
Generating professional .pptx files from content briefs
Producing consistent presentations without manual formatting
Exporting presentations to PDF for sharing or archiving

为利益相关方更新、产品评审、团队汇报创建演示文稿
根据内容摘要生成专业的.pptx文件
无需手动格式设置即可制作风格一致的演示文稿
将演示文稿导出为PDF用于分享或存档

When NOT to Use

不适用场景

Creating complex data visualizations (use dedicated charting tools)
Building interactive web presentations (this produces .pptx, not HTML)
Editing existing PowerPoint files (this creates new decks from scratch)

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

How It Works

工作原理

Two-phase architecture:

Spec phase (Claude) — Read the content brief, select slide types using decision logic, write a JSON deck specification. Content slots have character limits calibrated to prevent overflow. This is the only phase that costs tokens.
Generation phase (Local script) — Run
```
node scripts/generate-deck.js deck-spec.json
```
to produce .pptx. Optionally run
```
node scripts/export-pdf.mjs deck-spec.json
```
for PDF. Deterministic rendering, zero token cost.

Both outputs come from the same JSON spec, so .pptx and .pdf always match.

两阶段架构：

规范阶段（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 Slide Types

18种幻灯片类型


title_dark
title_light
section
content
bullets
two_col
stat
dual_stat
quote
three_card
four_grid
timeline
process_flow
agenda
highlight
table
icon_rows
closing

#	Type Key	Purpose	Default Variant
1	`title_dark`	Opening slide (bold)	dark only
2	`title_light`	Opening slide (internal/lighter)	light only
3	`section`	Section divider	dark
4	`content`	Paragraph explanation	light
5	`bullets`	3-6 key points	light
6	`two_col`	Side-by-side comparison	light
7	`stat`	Single key metric	light
8	`dual_stat`	Two metrics compared	dark
9	`quote`	Testimonial or pull quote	dark
10	`three_card`	Three parallel concepts	dark
11	`four_grid`	Four concepts in 2x2 grid	dark
12	`timeline`	Dates or milestones (max 6)	light
13	`process_flow`	Sequential workflow (max 5)	light
14	`agenda`	Meeting agenda (max 7)	light
15	`highlight`	Key finding or executive summary	light
16	`table`	Tabular data	light
17	`icon_rows`	Feature list with markers (max 4)	light
18	`closing`	End slide	dark only

Full slot definitions and character limits:

references/slide-types.md


title_dark
title_light
section
content
bullets
two_col
stat
dual_stat
quote
three_card
four_grid
timeline
process_flow
agenda
highlight
table
icon_rows
closing

序号	类型键	用途	默认变体
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

Decision Logic (Quick Reference)

决策逻辑（速查）

Content Pattern	Use
Opening the deck (bold)	`title_dark`
Opening the deck (internal)	`title_light`
Transitioning between topics	`section`
Paragraph explanation	`content`
List of 3-6 points	`bullets`
Side-by-side comparison	`two_col`
Single key metric	`stat`
Two metrics compared	`dual_stat`
Testimonial or pull quote	`quote`
Three parallel concepts	`three_card`
Four concepts in a grid	`four_grid`
Dates or milestones	`timeline`
Sequential workflow	`process_flow`
Meeting agenda	`agenda`
Key finding or summary	`highlight`
Tabular data	`table`
Feature list with markers	`icon_rows`
Ending the deck	`closing`

Full decision logic with variant strategy:

references/decision-logic.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 Deck Spec Format

JSON演示文稿规范格式

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" }
  ]
}

Colors accept theme token names (

"accent"

"secondary"

"tertiary"

"warm"

) or 6-character hex strings (

"2563EB"

Full schema and workflow:

references/TEMPLATE.md

and

references/platform-rules.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" }
  ]
}

颜色支持主题令牌名称（

"accent"

、

"secondary"

、

"tertiary"

、

"warm"

）或6位十六进制字符串（

"2563EB"

）。

完整架构和工作流程：

references/TEMPLATE.md

和

references/platform-rules.md

Instructions

使用步骤

Read the content brief — Understand topic, audience, length, specific requirements
Plan the deck — Select slide types using the decision logic table. Assign dark/light variants for visual rhythm (alternate to avoid monotony).
Write the JSON deck specification — Fill content slots, respecting character limits from
```
references/slide-types.md
```

Run the generation script —

node scripts/generate-deck.js deck-spec.json

Optionally export PDF —

node scripts/export-pdf.mjs deck-spec.json output.pdf

Report the output — Tell the user where the file(s) are

阅读内容摘要 —— 了解主题、受众、长度和具体要求
规划演示文稿 —— 使用决策逻辑表选择幻灯片类型。为营造视觉节奏分配深色/浅色变体（交替使用以避免单调）。
编写JSON演示文稿规范 —— 填充内容槽，遵守
```
references/slide-types.md
```
中的字符限制

运行生成脚本 ——

node scripts/generate-deck.js deck-spec.json

可选：导出PDF ——

node scripts/export-pdf.mjs deck-spec.json output.pdf

告知输出结果 —— 告诉用户文件的存储位置

Output Contract

输出约定

Planning artifact: JSON deck specification (the file Claude writes)
Final output: .pptx file (+ optional .pdf), generated locally from the spec
Quality gate: All items in the quality checklist pass

规划产物：JSON演示文稿规范（由Claude编写的文件）
最终输出：.pptx文件（+可选的.pdf文件），基于规范本地生成
质量检查：通过质量检查清单中的所有项目

Quality Checklist

质量检查清单

Every slide has a valid type key (one of the 18 defined types)
All content slots respect character limits from
```
references/slide-types.md
```
Dark/light variants alternate for visual rhythm (no 3+ consecutive same-variant slides)
Deck has a title slide (first) and a closing slide (last)
Section dividers separate distinct topics in decks > 6 slides
Speaker notes included for key slides (stats, highlights, transitions)
JSON is valid (no trailing commas, proper quoting, correct nesting)
Color values are valid theme tokens or 6-character hex strings (no
```
#
```
prefix)

每张幻灯片都有有效的类型键（属于定义的18种类型之一）
所有内容槽均遵守
```
references/slide-types.md
```
中的字符限制
深色/浅色变体交替使用以营造视觉节奏（无连续3张及以上相同变体的幻灯片）
演示文稿包含开场幻灯片（第一张）和结束幻灯片（最后一张）
超过6张幻灯片的演示文稿使用章节分隔页区分不同主题
关键幻灯片（指标、重点、过渡页）包含演讲者备注
JSON格式有效（无尾随逗号、引号正确、嵌套合理）
颜色值为有效的主题令牌或6位十六进制字符串（无
```
#
```
前缀）

References

参考文件

File	Purpose
`references/TEMPLATE.md`	JSON deck specification template with field documentation
`references/EXAMPLE.md`	Worked example: Q3 Product Update deck (9 slides)
`references/slide-types.md`	All 18 slide types: content slots, character limits, variants
`references/decision-logic.md`	Content pattern → slide type mapping, variant strategy, deck sizing
`references/platform-rules.md`	pptxgenjs requirements, Google Slides compatibility, output format

文件	用途
`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兼容性、输出格式