📦 Kai Export PPT Lite

kai-export-ppt-lite 无需浏览器，将 HTML 演示文稿导出为可编辑 PPTX。纯 Python —— 无 Playwright、无 Chrome、无 Node.js。

命令 Command | 作用 ---|--- python3 /scripts/export-sandbox-pptx.py [output.pptx] [--width 1440] [--height 900] | 主入口；可作为真实文件或内联脚本运行 python3 /scripts/run-skill-export.py [output.pptx] [--width 1440] [--height 900] | 可选极简引导，当运行时提供真实 skill 目录时使用

依赖 Package | 安装方式 ---|--- beautifulsoup4 | 通常由 skill metadata 自动安装，或 pip install beautifulsoup4 lxml | 同上 python-pptx | 同上 Pillow | 同上

用法 本地仓库亦可直接： python3 scripts/export-sandbox-pptx.py [output.pptx] [--width 1440] [--height 900]

沙箱执行 不要对 agent 运行时做任何假设。本 skill 必须容忍：

• 无固定 skill 根路径
• 无 __file__
• notebook / cell 式内联执行
• 依赖可能已装或缺失

在托管沙箱内按以下优先级：

• 默认：获取并执行 scripts/export-sandbox-pptx.py
• 若运行时提供真实 skill 目录，可调用：

• 仅支持内联 Python 时，直接内联 scripts/export-sandbox-pptx.py；HTML 通过沙箱 VFS/附件传入，PPTX 写入沙箱产物目录。

为何 scripts/export-sandbox-pptx.py 是稳定路径

• 不假设 skill 根、环境变量、安装器布局
• 容忍缺失 __file__
• 缺失 vendored contracts/ 时仍可运行，仅预设保真度降低
• 先尝试运行时依赖自举，失败再报错

禁止模式

• 假设已安装 skill 目录存在
• 假设 notebook / cell 沙箱中存在 __file__
• 假设构建时依赖一定已装
• 把 run-skill-export.py 当作唯一支持路径

选项 Flag | 说明 ---|--- --width N | 幻灯片宽度，像素（默认 1440） --height N | 幻灯片高度，像素（默认 900） --with-chrome | 添加页码与导航点

提取规则 HTML 元素 → PPTX 输出 h1-h6, p, li, span → 可编辑文本框 div（带背景/边框） → 圆角矩形填充 table, tr, td, th → 单元格矩形含文本框 img（http/file/data-uri） → 嵌入图片 svg → 占位矩形

限制（无浏览器）

• CSS 变量：仅支持 :root 静态替换
• 布局：模拟 flex-column，非像素级还原
• 计算样式：不可用，仅依赖内联 style +