html-to-pptxlisted
Install: claude install-skill yuna78/html-to-pptx
# html-to-pptx — HTML 转可编辑 PowerPoint
管线:`HTML → 真实浏览器渲染取布局 → 可编辑 SVG 图元 → 原生 DrawingML → .pptx`
完整文档见 [`README.md`](./README.md)(中文)/ [`README.en.md`](./README.en.md);
引擎内部机制见 [`docs/how-it-works.md`](./docs/how-it-works.md)。本文件是给 agent 看的操作要点。
## 什么时候用
- ✅ 用户已有 HTML 报告 / 幻灯片 / dashboard,想要能继续改的 `.pptx`。
- ✅ 固定画布、每页一屏(任意尺寸:1280×720、1600×900……都行)。
- ✅ 长滚动报告——会自动按语义块分页。
- ❌ 用户想**从零新做**一套幻灯片 → 那是做 deck 的 skill 的活。
- ❌ 用户想要**每页一张 AI 出图**的图片式 PPT → 用图片 deck 类 skill。
- ❌ 输入是 PDF → 用 `pdf-to-pptx` skill。
## 用法
一律走包装脚本,它会自举环境再转换:
```bash
H2P="$HOME/.claude/skills/html-to-pptx/bin/html-to-pptx"
# 默认:产物与来源 HTML 同目录同名
"$H2P" /path/to/report.html
# 指定输出文件或目录
"$H2P" /path/to/report.html -o /path/to/deck.pptx
# 画布尺寸默认实测,可强制指定
"$H2P" /path/to/deck.html --canvas 1600x900
# 逃生口:某个变换帮了倒忙时
"$H2P" deck.html --no-prepare # 原样交给引擎
"$H2P" deck.html --no-reshape # 保留 prepare,不做表格/富文本重整
"$H2P" deck.html --no-pseudo # 不物化 ::before / ::after
"$H2P" deck.html --keep-prepared # 留下中间 HTML 便于排查
"$H2P" deck.html --chrome "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
```
**产物位置约定**:不带 `-o` 时,`.pptx` 写到**来源 HTML 的同目录、同文件名**。
转完把绝对路径告诉用户,并用 `SendUserFile` 把文件发过去。
## 环境依赖
| 依赖 | 缺了会怎样 |
|---|---|
| **Node.js ≥ 22** | `node: command not found` / 提示没有全局 WebSocket |
| **Google Chrome / Chromium** | 转换失败、找不到 chrome |
| **Python ≥ 3.11**(首次自动建 venv) | `ModuleNotFoundError` |
| **中文字体**(中文 deck) | 中文变方框(macOS 罕见) |
一键自检,缺什么直接给安装命令:
```bash
"$HOME/.claude/skills/html