用途:把 HTML 幻灯片导出为 .pptx,且文件中的文字、形状、图片均为可在 PowerPoint 中编辑的原生对象。一次 gen_pptx 调用即完成捕获、字体处理、生成与下载。
主要能力与用法:先确认幻灯片结构(幻灯片选择器、导航方式、字体、是否有缩放容器),用 show_to_user 让幻灯片出现在用户预览中,再调用 gen_pptx。输入包括 width/height(CSS px,需匹配幻灯片尺寸)、slides 数组(每页一项,含 showJs 与 selector)、hideSelectors、resetTransformSelector,以及字体策略:可选 googleFontImports、fontSwaps,或两者都省略以保留品牌字体。字体替换在捕获前完成,保证布局正确回流。仅当用户要求 Google Slides 时才传 offer_google_slides: true,导出对话框会出现发送到 Google Slides 按钮,需用户点击才上传。
若使用 deck-stage 组件:resetTransformSelector 填 "deck-stage",showJs 用 document.querySelector('deck-stage').goTo(N)(0 索引),selector 用 "deck-stage > [data-deck-active]",且无需 hideSelectors。演讲者备注会从 #speaker-notes 自动按索引读取,无需传入。
结果会返回验证标志(警告而非错误),如重复捕获、尺寸不匹配、备注数量不符、字体超时或替换失败、图片解码失败、重置选择器未命中。属预期情况可直接确认下载;确有问题则修正输入重试。与用户沟通时不要直接转述这些内部标志名或技术细节,用平实语言说明。
限制:资料未提供收费、价格、平台支持范围、效果保证或具体性能数据;showJs 在 iframe 内作为同步表达式执行,不要 await;带较长 CSS 过渡的幻灯片需加大延迟(默认 600ms)。