yuna78 html-to-pptx — HTML 转可编辑 PowerPoint
管线：HTML → 真实浏览器渲染取布局 → 可编辑 SVG 图元 → 原生 DrawingML → .pptx
完整文档见 README.md（中文）/ README.en.md；
引擎内部机制见 docs/how-it-works.md。本文件是给 agent 看的操作要点。
什么时候用
- ✅ 用户已有 HTML 报告 / 幻灯片 / dashboard，想要能继续改的
.pptx。 - ✅ 固定画布、每页一屏（任意尺寸：1280×720、1600×900……都行）。
- ✅ 长滚动报告——会自动按语义块分页。
- ❌ 用户想从零新做一套幻灯片 → 那是做 deck 的 skill 的活。
- ❌ 用户想要每页一张 AI 出图的图片式 PPT → 用图片 deck 类 skill。
- ❌ 输入是 PDF → 用
pdf-to-pptxskill。
用法
一律走包装脚本，它会自举环境再转换：
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 罕见） |
一键自检，缺什么直接给安装命令：
"$HOME/.claude/skills/html-to-pptx/bin/html-to-pptx" --doctor
转换替你做的事（都可单独关掉）
- 切页——给
.slide/.cover打分页标记；滚动报告按块边界切页，超长表格按行拆页 并重复表头，一行都不丢。 - 画布探测——实测首页尺寸并同步 PPTX 页面大小。
- 版式重整——修三种会丢内容的 HTML 形状：多行表格单元格、
<div>里的<b>、<br>换行。 - 图表离线化——ECharts 的 CDN 标签换成内置 bundle，零出网也出图。
- 渐变与伪元素——CSS 渐变拍平成代表色；
::before/::after的圆点、角标、字形物化成真形状。 - 交互控件——分段筛选、tab、
<select>压成当前选中值。
排查
| 现象 | 怎么办 |
|---|---|
node: command not found |
装 Node.js ≥ 22（brew install node） |
| 找不到 Chrome | 装 Chrome，或 --chrome <路径> |
ModuleNotFoundError: pptx |
用 bin/html-to-pptx，它会自建 venv |
| 只出了 1 页 | 没识别到分页结构；确认是幻灯片式，或让 prepare 分页（默认开） |
多行并成一段 / <b> 的字不见了 / 多行黏一行 |
重整被关了（--no-reshape），或该表没判为密排 |
| 列宽走形 | 该 deck 用 <col width> 定列宽；改成写在单元格上 |
| 图表变黑 | 填色来自被剥离的 CSS 变量——通常已被补丁覆盖，可提 issue |
| 中文变方框 | 装中文字体 |
仓库
本 skill 同时是开源仓库 https://github.com/yuna78/html-to-pptx（MIT）。
它首先是一个通用命令行工具（bin/html-to-pptx，终端 / CI / 任何脚本都能调，不依赖 Claude），
其次才是 agent skill；SKILL.md 是标准 skill 描述文件，任何支持 skill 或外部命令的 agent 都能用。
改动这里的文件就是改仓库，改完记得 push。