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-pptx skill。

用法

一律走包装脚本，它会自举环境再转换：

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 把文件发过去。

环境依赖

一键自检，缺什么直接给安装命令：

"$HOME/.claude/skills/html-to-pptx/bin/html-to-pptx" --doctor

转换替你做的事（都可单独关掉）

1. 切页——给 .slide / .cover 打分页标记；滚动报告按块边界切页，超长表格按行拆页 并重复表头，一行都不丢。
2. 画布探测——实测首页尺寸并同步 PPTX 页面大小。
3. 版式重整——修三种会丢内容的 HTML 形状：多行表格单元格、<div> 里的 <b>、<br> 换行。
4. 图表离线化——ECharts 的 CDN 标签换成内置 bundle，零出网也出图。
5. 渐变与伪元素——CSS 渐变拍平成代表色；::before / ::after 的圆点、角标、字形物化成真形状。
6. 交互控件——分段筛选、tab、<select> 压成当前选中值。

排查

仓库

本 skill 同时是开源仓库 https://github.com/yuna78/html-to-pptx（MIT）。 它首先是一个通用命令行工具（bin/html-to-pptx，终端 / CI / 任何脚本都能调，不依赖 Claude）， 其次才是 agent skill；SKILL.md 是标准 skill 描述文件，任何支持 skill 或外部命令的 agent 都能用。 改动这里的文件就是改仓库，改完记得 push。