核心用法
kai-html-export 是一款基于 Python 的 HTML 导出工具，可将任何 HTML 文件转换为 PowerPoint（PPTX）或高清 PNG 截图。通过调用系统已安装的 Chrome/Edge/Brave 浏览器（无需额外下载 Chromium），结合 Playwright 无头浏览器引擎实现页面渲染与截图。
主要功能
| 场景 | 命令示例 |
|------|---------|
| HTML 转 PPTX（自动识别幻灯片） | `/kai-html-export presentation.html` |
| 显式 PPTX 导出 | `/kai-html-export --pptx report.html` |
| 全页截图 PNG | `/kai-html-export --png dashboard.html` |
| 2× 高清截图 | `/kai-html-export --png --scale 2 chart.html` |
技术亮点
- 零浏览器下载依赖：优先检测系统 Chrome/Edge/Brave，未安装时才回退 Playwright Chromium
- 智能幻灯片识别：自动检测
.slide元素，每个元素转为独立 PPTX 全出血页面 - 动画预处理：截图前禁用 CSS/JS 动画，确保内容完整可见
- 跨平台支持：macOS、Linux、Windows 全兼容
显著优点
1. 轻量部署：仅需 Python3 + pip 安装两个包，无需 Node.js 生态
2. 高保真输出：支持 2× Retina 分辨率截图，满足印刷级需求
3. 生态联动：专为 kai-slide-creator（HTML 演示）和 kai-report-creator（HTML 报告）设计，也支持任意自包含 HTML
4. 智能回退：未指定文件时，自动选用当前目录最新修改的 .html 文件
潜在缺点与局限性
- 浏览器依赖：虽优先使用系统浏览器，但若系统无 Chrome/Edge/Brave 且 Playwright 下载失败则无法运行
- 动态内容限制：复杂 WebGL 或需用户交互的异步渲染内容可能截图不完整
- PPTX 格式限制：输出为图片型 PPTX（每页一张截图），非可编辑矢量图形
- 样式兼容性：极度依赖浏览器的 CSS 渲染一致性，罕见情况下可能出现排版偏移
适合人群
- 需将 HTML 演示/报告快速转为可分享格式的开发者、设计师
- 使用 kai-slide-creator/kai-report-creator 生态的用户
- 希望避免 Puppeteer/Node.js 复杂部署的轻量级用户
- 需要将网页快照集成到自动化工作流的 DevOps 工程师
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 浏览器执行风险 | Playwright 执行外部 HTML 中的 JS，恶意脚本理论上可运行 | 仅处理可信来源的 HTML，避免直接导出不可信网页 |
| 文件覆盖 | 未指定输出路径时可能覆盖同名文件 | 显式指定 `[output.pptx/png]` 参数 |
| 依赖版本冲突 | `python-pptx` 与 `playwright` 版本不兼容 | 使用 uv/pip 虚拟环境隔离 |
| 截图尺寸溢出 | 极高分辨率 `--scale` 可能导致内存不足 | 根据机器配置合理设置 scale 参数 |