pptx

使用 python-pptx（已预装）处理 PowerPoint .pptx 文件。.pptx 本质上是一个包含 XML 部件的 ZIP 包；python-pptx 会处理底层结构，你通常不需要直接操作 XML。只有当库无法表达某些操作时，才回退到原始 OOXML（参见 Advanced 部分）。

所有操作均在沙箱 exec shell 中、当前工作目录（即上传文件所在的目录）下完成。编写一段简短的 Python heredoc 或临时 .py 文件，然后运行它。exec 执行完成后，使用工具结果中的 Generated artifacts URL，以便用户下载演示文稿。

心智模型

• 一个 presentation 由 slides（幻灯片） 组成；每张幻灯片基于一个 layout（版式） 构建；版式定义在 slide masters（幻灯片母版） 中。版式通过 idx 和类型定义 placeholders（占位符）（标题、正文、图片等）。
• 一张幻灯片包含 shapes（形状）：占位符、文本框、图片、表格、图表。
• 带文本的形状提供 .text_frame → .paragraphs → .runs。run 是承载格式信息（字体、字号、粗体、颜色）的最小单位。
• 距离单位为 EMU。可使用辅助函数：from pptx.util import Inches, Pt, Emu。

读取 / 提取

from pptx import Presentation

prs = Presentation("deck.pptx")
print(len(prs.slides), prs.slide_width, prs.slide_height)  # EMU 尺寸

for i, slide in enumerate(prs.slides, 1):
    print(f"--- slide {i} (layout: {slide.slide_layout.name}) ---")
    for shape in slide.shapes:
        if shape.has_text_frame:
            print(shape.text_frame.text)  # 用 \n 连接的段落
        elif shape.has_table:
            for row in shape.table.rows:
                print([c.text for c in row.cells])
    if slide.has_notes_slide:
      …