PowerPoint PPTX 布局导出助手

当需要生成或修复演示文稿，同时不破坏幻灯片母版、占位符、字体、图片、图表或演讲者备注时，请使用此技能。优先采用模板感知的编辑方式，而非从头逐页绘制幻灯片。

工作流程

1. 明确演示文稿任务：根据数据生成幻灯片、修复布局偏差、保留品牌模板、导出幻灯片、修正图表/图片位置，或恢复演讲者备注。
2. 保持原始演示文稿和模板完整。在副本上操作，并保留幻灯片母版、版式、主题文件及媒体关联关系。
3. 当布局行为不明确时，检查 PPTX 结构：

- 查看 ppt/presentation.xml、幻灯片部分、幻灯片版式、幻灯片母版、备注幻灯片、媒体、图表及关系文件。

- 使用 python-pptx 执行支持的形状、文本、表格、图片和图表操作。

- 对于库未覆盖的功能（如备注、高级图表链接、主题部分、特定占位符行为），可直接进行 OOXML 编辑。

1. 将修改锚定在幻灯片版式和占位符上。在理解模板结构前，避免使用绝对定位。
2. 保持文本层级与视觉意图一致：标题占位符、正文层级、图表标签、图片长宽比、主题字体及品牌配色。
3. 验证最终输出的演示文稿：

- 检查幻灯片数量、版式分配、占位符填充情况、图片裁剪、图表数据、演讲者备注及嵌入媒体。

- 若可能，渲染或打开演示文稿以发现文字溢出或资源缺失问题。

常见修复模式

• 占位符不匹配：插入内容前先确认版式中占位符的索引或类型；不要假设占位符顺序在不同模板间稳定。
• 图片失真：保持原始长宽比，必要时主动裁剪；确认占位符期望的是 pic 类型还是形状填充。
• 图表导出问题：除非刻意重建图表，否则应保持嵌入的工作簿/图表关系完整。
• 演讲者备注：检查备注幻灯片的关系引用；许多高级库对备注编辑支持不完整。
• 模板一致性：复用现有幻灯片版式和主题颜色，避免硬编码颜色与字体。

输出内容

提供：

• 包含受影响版式、占位符、资产或 OOXML 部分的幻灯片/演示文稿诊断报告。
• 生成或修复方案，以及按需提供的代码或修改后的演示文稿文件。
• 可视化验证说明，包括仍需在 PowerPoint 桌面端检查的内容。

仅在源需求证据相关时，阅读 references/requirement-plan.md。