PPT 演示文稿

PowerPoint 技能

使用场景

只要涉及 .pptx 文件——无论是作为输入、输出还是两者兼有——都应使用本技能。包括：创建幻灯片、路演文稿或演示文稿；读取、解析或从任何 .pptx 文件中提取文本（即使提取的内容将用于其他场合，例如邮件或摘要）；编辑、修改或更新现有演示文稿；合并或拆分幻灯片文件；使用模板、版式、演讲者备注或批注。只要用户提到“deck”“slides”“presentation”，或引用了某个 .pptx 文件名，无论其后打算如何处理内容，都应触发本技能。只要需要打开、创建或接触 .pptx 文件，就使用本技能。

快速参考

| 任务 | 指南 |

|------|-------|

| 读取/分析内容 | python -m markitdown presentation.pptx |

| 基于模板编辑或创建 | 阅读 editing.md |

| 从零创建 | 阅读 pptxgenjs.md |

读取内容

# Text extraction
python -m markitdown presentation.pptx

# Visual overview
python scripts/thumbnail.py presentation.pptx

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

编辑工作流

完整细节请阅读 editing.md。

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

---

从零创建

完整细节请阅读 pptxgenjs.md。

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

---

设计思路

不要制作乏味的幻灯片。白底配纯项目符号的页面不会打动任何人。请为每一张幻灯片参考下面清单中的创意。

开始之前

• 选择大胆、贴合内容的配色方案：配色应当让人感觉是专为这个主题设计的。如果把你的配色原样换到一个完全不同的演示文稿里依然“成立”，说明你的选择还不够具体。
• 主次分明而非平均分配：应有一种颜色占主导（60-70% 视觉权重），搭配 1-2 种辅助色调和一种鲜明的强调色。绝不要让所有颜色权重相等。
• 深浅对比：标题页和结尾页用深色背景，内容页用浅色（“三明治”结构）。或者全程使用深色以营造高级感。
• 坚持一个视觉母题：选定一个独特元素并反复使用——圆角图片框、彩色圆形中的图标、粗单侧边框。让它贯穿每一张幻灯片。

配色方案

选择与主题匹配的颜色——不要默认使用千篇一律的蓝色。可将以下配色作为灵感：

| 主题 | 主色 | 辅色 | 强调色 |

|-------|---------|-----------|--------|

| 午夜高管 | 1E2761（藏青） | CADCFC（冰蓝） | FFFFFF（白） |

| 森林苔藓 | 2C5F2D（森林绿） | 97BC62（苔藓绿） | F5F5F5（奶油白） |

| 珊瑚活力 | F96167（珊瑚红） | F9E795（金黄） | 2F3C7E（藏青） |

| 暖调陶土 | B85042（陶土红） | E7E8D1（沙色） | A7BEAE（鼠尾草绿） |

| 海洋渐变 | 065A82（深蓝） | 1C7293（青蓝） | 21295C（午夜蓝） |

| 炭灰极简 | 36454F（炭灰） | F2F2F2（灰白） | 212121（黑） |

| 青色信赖 | 028090（青） | 00A896（海泡绿） | 02C39A（薄荷绿） |

| 浆果奶油 | 6D2E46（浆果紫） | A26769（灰玫瑰） | ECE2D0（奶油色） |

| 鼠尾草静谧 | 84B59F（鼠尾草绿） | 69A297（桉树绿） | 50808E（石板灰） |

| 樱桃大胆 | 990011（樱桃红） | FCF6F5（灰白） | 2F3C7E（藏青） |

每张幻灯片

每张幻灯片都需要视觉元素——图片、图表、图标或形状。纯文字的幻灯片令人过目即忘。

布局选项：

• 双栏布局（左文右图）
• 图标 + 文字行（彩色圆形图标、加粗标题、下方说明）
• 2x2 或 2x3 网格（一侧放图片，另一侧放内容块网格）
• 半版出血图片（占满左侧或右侧）叠加内容

数据展示：

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

视觉润色：

• 小彩色圆形图标置于章节标题旁
• 关键数据或标语使用斜体强调文字

字体排印

选择有特色的字体搭配——不要默认使用 Arial。选一个有个性的标题字体，再搭配一个干净的正文字体。

| 标题字体 | 正文字体 |

|-------------|-----------|

| Georgia | Calibri |

| Arial Black | Arial |

| Calibri | Calibri Light |

| Cambria | Calibri |

| Trebuchet MS | Calibri |

| Impact | Arial |

| Palatino | Garamond |

| Consolas | Calibri |

| 元素 | 字号 |

|---------|------|

| 幻灯片标题 | 36-44pt 加粗 |

| 章节标题 | 20-24pt 加粗 |

| 正文 | 14-16pt |

| 说明文字 | 10-12pt 弱化 |

间距

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

避免（常见错误）

• 不要重复同一种布局——在不同幻灯片间变换栏式、卡片和标注
• 不要居中正文——段落和列表左对齐；仅标题居中
• 不要忽视字号对比——标题需要 36pt 以上才能从 14-16pt 正文中凸显
• 不要默认用蓝色——选择能反映具体主题的颜色
• 不要随意混用间距——选定 0.3" 或 0.5" 间距并保持一致
• 不要只精修一张而其余从简——要么全部用心，要么全程保持简洁
• 不要制作纯文字幻灯片——添加图片、图标、图表或视觉元素；避免只有标题加项目符号
• 不要忘记文本框内边距——将线条或形状与文字边缘对齐时，需为文本框设置 margin: 0，或将形状偏移以补偿内边距
• 不要使用低对比度元素——图标和文字都需要与背景形成强对比；避免浅底配浅字或深底配深字
• 绝不在标题下使用强调装饰线——这是 AI 生成幻灯片的典型特征；请改用留白或背景色

---

质量检查（必做）

默认一定存在问题。你的任务就是把它们找出来。

第一次渲染几乎不可能是正确的。把 QA 当作一场找错行动，而不是确认步骤。如果第一遍检查没有发现任何问题，说明你检查得还不够仔细。

内容 QA

python -m markitdown output.pptx

检查内容缺失、错别字、顺序错误。

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

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

如果 grep 有返回结果，先修复再宣布完成。

视觉 QA

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

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

Visually inspect these slides. Assume there are issues — find them.

Look for:
- Overlapping elements (text through shapes, lines through words, stacked elements)
- Text overflow or cut off at edges/box boundaries
- Decorative lines positioned for single-line text but title wrapped to two lines
- Source citations or footers colliding with content above
- Elements too close (< 0.3" gaps) or cards/sections nearly touching
- Uneven gaps (large empty area in one place, cramped in another)
- Insufficient margin from slide edges (< 0.5")
- Columns or similar elements not aligned consistently
- Low-contrast text (e.g., light gray text on cream-colored background)
- Low-contrast icons (e.g., dark icons on dark backgrounds without a contrasting circle)
- Text boxes too narrow causing excessive wrapping
- Leftover placeholder content

For each slide, list issues or areas of concern, even if minor.

Read and analyze these images:
1. /path/to/slide-01.jpg (Expected: [brief description])
2. /path/to/slide-02.jpg (Expected: [brief description])

Report ALL issues found, including minor ones.

验证循环

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 转图片