| name | pptx-generation |
| description | 从结构化大纲 JSON 生成 PPTX、抽取幻灯片文本、转换为可打印 HTML 预览；处理演示文稿/幻灯片/slides/deck 相关需求。 |
PPT 生成与检查
When to use
- 用户要生成一份演示文稿（PPTX），已有大纲/要点/结论。
- 需要读取既有
.pptx 的幻灯片文本、统计页数、检查结构。
- 需要把 PPTX 内容变成可打印/可预览的 HTML（离线无 LibreOffice，不能直接渲染 PPTX 为 PDF/PNG）。
决策顺序
- 生成：先整理一份结构化大纲 JSON（标题、要点、备注、可选分区），再
build_deck.py 生成 .pptx。
- 读取：
inspect_deck.py 抽取每页文本与形状统计。
- 预览：
deck_to_html.py 把幻灯片文本转成可打印 HTML，再交给 document-conversion/html_to_pdf（不能直接渲染 PPTX）。
- 不联网、不下载模板字体；版式由脚本内置的简洁模板决定。
脚本索引
| 脚本 | 用途 |
|---|
build_deck.py | 从大纲 JSON 生成 PPTX（python-pptx） |
inspect_deck.py | 抽取 PPTX 幻灯片文本/形状统计 |
deck_to_html.py | PPTX 文本 → 可打印 HTML 预览 |
组合路线
大纲.json ──build_deck──> 报告.pptx
报告.pptx ──inspect_deck──> 文本统计
报告.pptx ──deck_to_html──> 预览.html ──(document-conversion html_to_pdf)──> 预览.pdf
安全与限制
- 离线运行，不联网、不执行包安装、不下载模板。
- 大纲 JSON 必须是受控结构（见
references/input-output-contract.md）；所有标题/要点来自用户提供或模型整理的内容，不得编造幻灯片内容。
- PPTX 无法离线直接渲染为 PDF/PNG（镜像不含 LibreOffice）——要交付视觉版请走
deck_to_html → html_to_pdf。
详细说明
组合配方见 references/best-combinations.md，输入/输出契约见 references/input-output-contract.md，常见失败见 references/troubleshooting.md。每个脚本的完整用法见 scripts/*.md。
