用途:在需要处理 .pptx 演示文稿时使用,包括创建新演示文稿、编辑现有演示文稿、分析其内容(文字、备注、评论、版式、主题等)。.pptx 本质是包含 XML 与其他资源的 ZIP 压缩包,可读取或修改。
主要能力:文本提取可转 Markdown:python -m markitdown path-to-file.pptx;需要访问评论、演讲者备注、幻灯片版式、动画、设计元素或复杂格式时,可解包读取原始 XML:python ooxml/scripts/unpack.py <office_file> <output_dir>(脚本位于 skills/pptx/ooxml/scripts/unpack.py,找不到时用 find . -name "unpack.py" 定位)。关键结构包括 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/。字体与颜色可从 ppt/theme/theme1.xml 的颜色方案与字体方案,以及 ppt/slides/slide1.xml 的实际字体与颜色中分析。
无模板创建:按 html2pptx 工作流将 HTML 幻灯片转为 PowerPoint。需先完整阅读 html2pptx.md,为每张幻灯片创建带正确尺寸(如 16:9 为 720pt×405pt)的 HTML,文本用 p、h1-h6、ul、ol,图表/表格区域用 class="placeholder",渐变与图标先用 Sharp 栅格化为 PNG。用 html2pptx.js 库转换,用 PptxGenJS 添加图表和表格,用 pptx.writeFile() 保存。随后生成缩略图校验:python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4,检查文字截断、重叠、位置、对比度问题。
模板创建:先完整阅读 ooxml.md;复制模板 cp template.pptx working.pptx;生成缩略图查看可用幻灯片;用 python scripts/rearrange.py template.pptx working.pptx 0,5,12,12,23 重排(0 起始索引,可重复,缺号跳过);用 python scripts/inventory.py working.pptx text-inventory.json 提取文本清单;据清单编写 replacement-text.json,注意脚本会清空清单中所有文本形状,只有提供 paragraphs 的形状才写入新文本,bullet 为 true 时不要手动加项目符号;最后 python scripts/replace.py working.pptx replacement-text.json output.pptx。
适用场景:读取演示文稿文字、分析版式与主题、从 HTML 精确创建幻灯片、基于模板批量替换内容。限制:需具备相应脚本与库环境;未提供依赖安装、版本要求及收费信息。