用途:以编程方式创建、编辑和分析 .pptx 演示文稿。.pptx 本质是包含 XML 与资源的 ZIP 压缩包,因此可通过文本提取、原始 XML 访问或 html2pptx 工作流处理。
主要能力:读取与分析内容时,可用 python -m markitdown path-to-file.pptx 将文档转为 Markdown 提取文本;批注、演讲者备注、幻灯片版式、动画、设计元素和复杂格式需解包读取原始 XML,命令为 python ooxml/scripts/unpack.py <office_file> <output_dir>。关键结构包括 ppt/presentation.xml、ppt/slides/slide{N}.xml、ppt/notesSlides/notesSlide{N}.xml、ppt/comments/modernComment_*.xml、ppt/slideLayouts/、ppt/slideMasters/、ppt/theme/、ppt/media/。可从 theme1.xml 提取配色与字体,并在各 XML 中检索颜色与字体引用。
使用方式:无模板新建时采用 html2pptx 工作流,先完整阅读 html2pptx.md,为每页创建合适尺寸的 HTML(如 16:9 用 720pt × 405pt),文本使用 p、h1-h6、ul、ol,图表/表格区域用 class="placeholder",渐变与图标先用 Sharp 栅格化为 PNG;再用 html2pptx.js 转换并保存,随后用 python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 生成缩略图做视觉校验。编辑现有文件时先完整阅读 ooxml.md,解包、编辑 XML,每次编辑后用 python ooxml/scripts/validate.py <dir> --original <file> 校验,最后用 python ooxml/scripts/pack.py <input_directory> <office_file> 打包。基于模板创建时,先提取文本与缩略图,建立 template-inventory.md,再规划 outline.md 与 template_mapping,用 python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52 复制、重排、删除幻灯片,用 python scripts/inventory.py working.pptx text-inventory.json 提取全部文本。
适用场景:程序化生成演示文稿、按模板批量产出、分析或修改现有 PPT 的版式与备注。
限制:资料未提供收费、价格、平台支持范围与效果保证等信息;部分脚本路径需按项目根目录定位,若不存在可用 find . -name "unpack.py" 查找。