用途:处理 .pptx 文件的创建、编辑与内容分析。.pptx 本质是包含 XML 与资源的 ZIP 包,可按任务选用不同工具链。
读取与分析:仅提取文字可转为 markdown:python -m markitdown path-to-file.pptx。需要处理批注、演讲者备注、版式、动画、设计元素或复杂格式时,须解包读取原始 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 读取配色与字体,再抽样 slide1.xml 核对实际字体与颜色。
无模板新建:使用 html2pptx 工作流,先阅读 html2pptx.md 全文;每页生成尺寸正确的 HTML(如 16:9 用 720pt×405pt),图表表格区域用 class="placeholder";渐变与图标先用 Sharp 栅格化为 PNG;再用 html2pptx.js 转换并在占位区用 PptxGenJS 添加图表表格,最后 pptx.writeFile() 保存。图表或表格页建议用整页或两栏布局,不要纵向堆叠。随后用 python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 生成缩略图检查文字裁切、重叠、边界与对比度问题并迭代修正。
套用模板新建:先 python -m markitdown template.pptx > template-content.md 并生成缩略图,制作 template-inventory.md(幻灯片从 0 开始编号),据此写 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 提取全部形状与文字属性后替换占位内容。
编辑现有文件:先读 ooxml.md 全文,解包后编辑 XML,每次修改后立即运行 python ooxml/scripts/validate.py <dir> --original <file> 校验,最后用 python ooxml/scripts/pack.py <input_directory> <office_file> 打包。
限制:具体收费、平台支持与性能数据暂未提供;脚本路径若不匹配可用 find . -name "unpack.py" 定位。