核心用法
kai-html-export 是一款将HTML文件转换为PPTX演示文稿或PNG图片的实用工具。它通过无头浏览器捕获页面内容,支持两种主要模式:
PPTX导出:自动检测HTML中的 .slide 元素,将每个幻灯片捕获为全幅页面,最终组装成PowerPoint文件。导出前自动禁用动画确保内容完整可见。
PNG截图:支持全页截图,可通过 --scale 2 参数生成2倍分辨率的视网膜级高清图片,适合分享报告或网页快照。
显著优点
1. 零Node.js依赖:直接使用系统已安装的Chrome/Edge/Brave浏览器,无需额外下载Chromium,大幅减少安装负担
2. 智能回退机制:若系统无可用浏览器,自动回退到Playwright内置Chromium
3. 无缝生态集成:专为 kai-slide-creator(HTML演示)和 kai-report-creator(HTML报告)设计,开箱即用
4. 灵活参数控制:支持自定义分辨率(--width/--height)和缩放比例,满足印刷级输出需求
5. 智能文件选择:未指定文件时自动选用当前目录最新修改的HTML文件
潜在局限
- 依赖本地Python3环境和两个Python包(playwright、python-pptx),首次使用需安装
- PPTX模式要求HTML包含特定的
.slide类元素才能正确分页 - 复杂CSS动画或WebGL内容可能在截图时出现渲染差异
- 仅支持静态HTML导出,无法保留交互功能
适合人群
- 需要将HTML演示文稿转换为Office格式的商务用户
- 设计师/开发者快速生成网页截图或演示材料
- 使用
kai-slide-creator或kai-report-creator生态的用户 - 追求轻量级方案、不愿配置Puppeteer/Node环境的用户
常规风险
- 浏览器路径暴露:调用系统浏览器可能泄露本地浏览器配置路径
- 文件IO操作:读写本地HTML和生成PPTX/PNG文件,需注意临时文件清理
- 依赖版本冲突:playwright与系统Chrome版本不匹配可能导致截图异常
- 敏感内容泄漏:截图可能意外捕获HTML中的隐藏或敏感信息