核心功能
guizang-html-to-pptx 是一个专用的导出伴侣技能,用于将 guizang-ppt-skill 生成的杂志风格 HTML 演示文稿重建为原生可编辑的 PowerPoint PPTX 文件。它不会从头创建幻灯片,而是基于已存在的 HTML deck 进行精确转换,确保文字、形状、图片均为独立 PowerPoint 对象,而非整页截图。
显著优点
- 真正可编辑:文本框、形状、图片均为独立对象,用户可在 PowerPoint 中直接修改
- 字体精确匹配:完整保留 HTML 中的
--serif-zh(Noto Serif SC)、--sans-zh(Noto Sans SC)、--serif-en(Playfair Display)、--mono(IBM Plex Mono)等字体栈,通过 DrawingML 显式设置拉丁文、东亚文、复杂文三种字体 - 视觉一致性:16:9 宽屏布局,背景色、主题色、图片 placement 均与 HTML 源文件保持一致
- 智能图片处理:支持 contain/cover 两种适配模式,截图类产品 UI 保持可读性,装饰性图片支持满幅出血
- 完整 QA 流程:内置 PPTX XML 字体校验、LibreOffice PDF 渲染检查、缩略图 contact sheet 生成,确保无文字溢出、图片错位等问题
潜在局限
- 依赖前置条件:必须有已生成的 guizang HTML deck 作为输入,无法独立创建幻灯片
- 动态效果丢失:HTML 中的 Motion One 动画、WebGL shader、交互效果无法导出到 PPTX
- 字体安装依赖:目标机器需预装 Noto Serif SC、Noto Sans SC、Playfair Display、IBM Plex Mono 等字体,否则可能回退到系统默认字体
- 沙箱环境限制:LibreOffice 可视化 QA 在某些受限环境中可能需要额外权限
适合人群
- 需要将网页版精美幻灯片转换为可编辑 Office 格式的商务人士
- 设计团队交付客户最终可修改版本
- 跨国团队协作中需要 PowerPoint 原生格式的场景
- 对字体精度、排版还原度有高要求的品牌演示场景
常规风险
- 字体回退风险:若未正确设置 East Asian 字体类型,中文可能意外显示为 Songti 或 PingFang SC
- 布局溢出风险:PPTX 与 HTML 渲染引擎差异可能导致文字换行变化,需每轮修改后重新 QA
- 误用截图方案:用户若未明确指定"可编辑",可能被快速但错误的截图方案替代
- 图片版权:自动导出的图片需确保源 HTML 中使用的素材已获授权
技术实现要点
优先使用项目既有工具链(export_editable_pptx.py 等),或根据环境选择 python-pptx 或 pptxgenjs。关键代码通过 a:latin、a:ea、a:cs 三个 XML 节点强制指定多语言字体,避免系统回退。最终交付需明确声明"真正可编辑"属性及字体依赖事项。