html-to-pptx — HTML 演示文稿转 PPTX

将 html-ppt 生成的 HTML 演示文稿一键转换为 .pptx 文件。

Agent 使用指南

当用户说"导出 PPTX"、"转成 PPT"、"HTML 变 PPTX"或类似的话时：

1. 确认 HTML 文件路径 — 通常在 ~/.claude/skills/html-ppt/examples/<deck-name>/index.html，或用户指定的路径
2. 运行转换命令：

   bash ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.sh <html文件路径>

3. 报告结果 — 告诉用户 PPTX 文件的路径和大小
4. 可选参数：
   • --ratio 4:3 — 指定宽高比（支持 16:9、4:3、3:4、1:1）
   • -- --quality 80 — 指定 JPEG 质量（1-100，默认 92）
   • -- --quality png — 强制 PNG 格式（无损但文件较大）

工作原理

1. headless Chrome 截图：逐页将 HTML 渲染为 PNG 图片（支持 #/N 深度链接）
2. pptxgenjs 组装：将图片按顺序嵌入 PPTX，每张铺满整页

因为是截图方式，PPTX 会 100% 还原 HTML 的视觉效果，包括字体、颜色、布局、渐变等。

命令参考

# 自动检测页数
bash scripts/html-to-pptx.sh /path/to/deck/index.html

# 指定页数
bash scripts/html-to-pptx.sh /path/to/deck/index.html 8

# 4:3 宽高比
bash scripts/html-to-pptx.sh /path/to/deck/index.html all --ratio 4:3

# 指定 JPEG 质量（更小文件）
bash scripts/html-to-pptx.sh /path/to/deck/index.html all -- --quality 80

# 无损 PNG 格式
bash scripts/html-to-pptx.sh /path/to/deck/index.html all -- --quality png

输出文件与 HTML 同目录，文件名相同但扩展名为 .pptx。

依赖

• Google Chrome：macOS 默认路径 /Applications/Google Chrome.app
• pptxgenjs：npm install -g pptxgenjs

注意事项

• 输出的 PPTX 中每页是一张图片，不可编辑文字（但视觉效果完美还原）
• 如果需要可编辑文字的 PPTX，应使用 pptx skill 从头创建
• 适合场景：需要将 html-ppt 作品分享给只接受 PPTX 格式的同事/客户