SuperAPI AI 工具集

pptx-to-html

办公与效率

查看项目

更新于 10-15 20:29

技能介绍

用途:把给定的 .pptx 演示文稿转换为可在浏览器中播放的 HTML 演示,并对照原文件进行验证。PPTX 为权威来源,未做实测对比前不得承诺完整或百分比级视觉保真度。

主要能力:转换文本、形状、背景、图片、表格、超链接和媒体;图表由 scripts/chart_extractor.py 处理,自定义形状由 scripts/shape_geometry.py 处理,SmartArt 由 scripts/smartart_parser.py 处理,动画与效果由 scripts/animation_handler.py 处理,字体由 scripts/font_manager.py 处理。

使用方式:使用用户提供的输入输出路径,脚本相对本技能目录解析,而非硬编码安装路径: python3 <skill-dir>/scripts/convert_pptx_to_html_v2.py /abs/input.pptx /abs/output-dir 150 最后一个参数为可选图片 DPI(默认 150)。布局固定使用 96 DPI,提高导出 DPI 不应改变元素坐标。运行前检查解释器与 requirements.txt 中的依赖,该包并非仅用标准库。转换器会写出 <input-stem>.html、报告、转换日志和 assets/ 目录,应查看报告中的实际路径而非假定固定文件名;交付或复制时需将 assets 与 HTML 放在一起。图表使用 CDN 上的 Chart.js,除非显式打包依赖,否则不是单一离线文件。

验证与交付:对比幻灯片数量、顺序、可见文本、媒体、表格/图表及被警告的元素;在浏览器中检查代表性幻灯片和每个已知转换缺口,包括密集/重叠内容和要求的视口尺寸;测试导航及与演示相关的超链接/媒体;报告不可用编解码器、字体替换、损坏资源或网络依赖。若只做了静态检查,应如实说明,不得声称浏览器保真或播放成功。返回实际 HTML 路径、所需资源及重要限制,使用宿主常规文件链接,不假定支持 computer:// URL。

限制:复杂母版继承、高级几何、自定义字体、动画及不支持的操作可能降级。元素失败后转换器可能继续运行,退出码 0 本身不能证明所有元素都保留,需阅读 conversion.log 和生成的报告中的警告。不要运行嵌入的宏,也不要仅为转换而发布演示文稿。修改转换器实现前先阅读 docs/architecture.md 和仓库说明,保持布局/图片 DPI 分离、XML 命名空间处理、关系缓存、相对资源链接和元素级错误报告不变,并用能覆盖改动的演示文稿验证。