name: pptx
description: 只要涉及 .pptx 文件（无论是作为输入、输出，还是同时作为两者），均应使用此技能。具体包括：创建幻灯片组、融资路演文稿或演示文档；读取、解析或提取任何 .pptx 文件中的文本内容（即使提取的内容将用于其他场景，如邮件或摘要）；编辑、修改或更新现有演示文档；合并或拆分幻灯片文件；处理模板、版式、演讲者备注或批注。无论用户后续计划如何处理内容，但凡提及“文稿组 (deck)”、“幻灯片 (slides)”、“演示文稿 (presentation)”或引用 .pptx 文件名，请触发此技能。如需打开、创建或触及任何 .pptx 文件，均请使用此技能。
license: Proprietary. LICENSE.txt has complete terms

PPTX 技能

快速参考

---

读取内容

# 文本提取
python -m markitdown presentation.pptx

# 视觉概览
python scripts/thumbnail.py presentation.pptx

# 原始 XML
python scripts/office/unpack.py presentation.pptx unpacked/

---

编辑工作流

完整细节请阅读 [editing.md](editing.md)。

1. 使用 thumbnail.py 分析模板
2. 解包 → 操作幻灯片 → 编辑内容 → 清理 → 打包

---

从零创建

完整细节请阅读 [pptxgenjs.md](pptxgenjs.md)。

当没有模板或参考演示文稿时使用。

---

设计思路

不要创建乏味的幻灯片。 纯白背景上的普通项目符号不会给人留下印象。请针对每张幻灯片考虑此列表中的想法。

开始之前

• 选择一个大胆的、与内容相关的配色方案：配色方案应该感觉专为此主题设计。如果更换颜色后仍能“适用”于完全不同的演示文稿，说明你的选择还不够具体。
• 主次分明，而不是等量齐观：一种颜色应占主导地位（60-70% 的视觉权重），搭配 1-2 种辅助色调和一种鲜明的强调色。永远不要赋予所有颜色同等权重。
• 深色/浅色对比：标题和结论幻灯片使用深色背景，内容幻灯片使用浅色背景（“三明治”结构）。或者全篇使用深色以营造高级感。
• 确定一个视觉主题：选择一个独特的元素并重复使用——圆角图片框、彩色圆圈内的图标、粗的单侧边框。在每张幻灯片上保持一致。

配色方案

选择与你的主题匹配的颜色——不要默认使用通用的蓝色。以下配色方案可供参考：

每张幻灯片注意

每张幻灯片都需要一个视觉元素——图片、图表、图标或形状。纯文本的幻灯片很难令人记住。

布局选项：

• 两列（左文右图）
• 图标+文本行（图标放在彩色圆圈内，粗体标题，下方描述）
• 2x2 或 2x3 网格（一侧图片，另一侧内容块网格）
• 半出血图片（占据左侧或右侧）并叠加内容

数据展示：

• 大号数据标注（60-72pt 的大数字，下方小标签）
• 对比列（之前/之后、优点/缺点、并排选项）
• 时间线或流程（编号步骤、箭头）

视觉润色：

• 章节标题旁的小彩色圆圈内放置图标
• 斜体强调文本，用于关键数据或标语

排版

选择有趣的字体搭配——不要默认使用 Arial。选择有个性的标题字体，并搭配清晰的正文字体。

间距

• 最小边距 0.5 英寸
• 内容块之间 0.3-0.5 英寸
• 留出呼吸空间——不要填满每一寸

避免（常见错误）

• 不要重复使用相同的布局——在不同幻灯片之间交替使用列、卡片和标注
• 正文不要居中对齐——段落和列表左对齐；仅标题可居中
• 不要缺乏大小对比——标题需要 36pt+ 才能与 14-16pt 的正文区分开
• 不要默认使用蓝色——选择能反映具体主题的颜色
• 不要随意混用间距——选择 0.3 英寸或 0.5 英寸的间距并保持一致使用
• 不要只设计一张幻灯片而其他保持平淡——要么全篇彻底投入，要么保持简单
• 不要创建纯文本幻灯片——添加图片、图标、图表或视觉元素；避免简单的标题+项目符号
• 不要忽略文本框内边距——当对齐线条或形状与文本边缘时，将文本边框 margin 设为 0，或偏移形状以考虑内边距
• 不要使用低对比度元素——图标和文本都需要与背景有强烈对比；避免浅色背景上的浅色文本或深色背景上的深色文本
• 永远不要在标题下使用强调线——这是 AI 生成幻灯片的标志；改用空白或背景色

---

QA（必需）

假设存在问题是你的职责。你的任务是找到它们。

你的第一次渲染几乎从不正确。把 QA 当成 Bug 排查，而不是确认步骤。如果初次检查发现零问题，说明你检查得不够仔细。

内容 QA

python -m markitdown output.pptx

检查遗漏内容、拼写错误、顺序错误。

使用模板时，检查是否遗留了占位文本：

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

如果 grep 返回结果，在宣布成功前修复它们。

视觉 QA

⚠️ 使用子代理——即使只有 2-3 张幻灯片。你一直盯着代码看，只会看到你预期的内容，而不是实际存在的内容。子代理拥有全新的视角。

将幻灯片转换为图像（参见转换为图像），然后使用以下提示：

视觉检查这些幻灯片。假设存在问题是你的职责——找到它们。

查找：
- 元素重叠（文本穿过形状、线条穿过文字、堆叠元素）
- 文本溢出或被剪裁到边缘/边框边界
- 装饰线为单行文本定位，但标题换行为两行
- 来源引用或页脚与上方内容碰撞
- 元素之间太近（<0.3 英寸间距）或卡片/部分几乎接触
- 间距不均（某处有大片空白，另一处拥挤）
- 与幻灯片边缘的边距不足（<0.5 英寸）
- 列或类似元素未对齐
- 低对比度文本（例如浅灰色文本在奶油色背景上）
- 低对比度图标（例如深色图标在深色背景上，没有对比圆圈）
- 文本框太窄导致过度换行
- 残留占位内容

对于每张幻灯片，列出问题或关注点，即使很小。

阅读并分析这些图片：
1. /path/to/slide-01.jpg (期望：[简短描述])
2. /path/to/slide-02.jpg (期望：[简短描述])

报告发现的所有问题，包括小问题。

验证循环

1. 生成幻灯片 → 转换为图像 → 检查
2. 列出发现的问题（如果未发现，更批判性地再看一遍）
3. 修复问题
4. 重新验证受影响的幻灯片——一个修复往往引发另一个问题
5. 重复直到完整一轮检查不再发现新问题

在完成至少一轮修复并验证之前，不要宣称成功。

---

转换为图像

将演示文稿转换为单独的幻灯片图像以进行视觉检查：

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

这将创建 slide-01.jpg、slide-02.jpg 等文件。

要在修复后重新渲染特定幻灯片：

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

---

依赖项

• pip install "markitdown[pptx]" - 文本提取
• pip install Pillow - 缩略图网格
• npm install -g pptxgenjs - 从零创建
• LibreOffice（soffice）- PDF 转换（通过 scripts/office/soffice.py 自动配置沙盒环境）
• Poppler（pdftoppm）- PDF 转图像