PPTX 技能

快速参考

读取内容

# 文本提取
python -m markitdown 演示文稿.pptx

# 视觉概览
python scripts/thumbnail.py 演示文稿.pptx

# 原始 XML
python scripts/office/unpack.py 演示文稿.pptx unpacked/

编辑工作流程

阅读 editing.md 获取完整详情。

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

从头创建

阅读 pptxgenjs.md 获取完整详情。

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

设计创意

不要创建无聊的幻灯片。 白色背景上的纯项目符号列表不会给任何人留下深刻印象。为每张幻灯片考虑此列表中的创意。

开始之前

• 选择一个大胆、内容相关的配色方案：配色方案应感觉是为这个主题量身定制的。如果把你的颜色换到完全不同的演示文稿中仍然“适用”，说明你的选择还不够具体。
• 主色压倒均等：一种颜色应占主导地位（60-70% 的视觉权重），搭配 1-2 种辅助色调和一种醒目的强调色。永远不要给所有颜色同等的权重。
• 深色/浅色对比：标题和结论幻灯片使用深色背景，内容幻灯片使用浅色背景（“三明治”结构）。或者为了高级感，全程使用深色。
• 坚持一个视觉主题：选择 ONE 个独特的元素并重复使用——圆角图像框、彩色圆圈中的图标、粗的单边边框。贯穿每一张幻灯片。

调色板

选择与您的主题匹配的颜色——不要默认使用通用蓝色。使用以下调色板作为灵感：

针对每张幻灯片

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

布局选项：

• 两栏（左侧文本，右侧插图）
• 图标 + 文本行（彩色圆圈中的图标，粗体标题，下方描述）
• 2×2 或 2×3 网格（一侧图片，另一侧内容块网格）
• 半出血图片（占据整个左侧或右侧）并叠加内容

数据展示：

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

视觉润色：

• 节标题旁的小彩色圆圈图标
• 关键统计数据或标语使用斜体强调

排版

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

间距

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

避免（常见错误）

• 不要重复相同的布局——在幻灯片间变换列、卡片和数据标注的形式
• 不要将正文居中——段落和列表左对齐；仅标题可以居中
• 不要吝啬尺寸对比——标题需要 36pt 以上才能从 14-16pt 的正文中脱颖而出
• 不要默认使用蓝色——选择反映特定主题的颜色
• 不要随意混合间距——选择 0.3 英寸或 0.5 英寸的间距并一致使用
• 不要只美化一张幻灯片而让其余保持平淡——要么全程投入设计，要么全程保持简洁
• 不要创建纯文本幻灯片——添加图片、图标、图表或视觉元素；避免简单的标题加项目符号
• 不要忘记文本框的内边距——当将线条或形状与文本边缘对齐时，将文本框的 margin 设置为 0，或偏移形状以考虑内边距
• 不要使用低对比度的元素——图标和文本都需要与背景有强烈的对比；避免浅色背景上的浅色文本或深色背景上的深色文本
• 永远不要使用标题下的强调线——这是 AI 生成幻灯片的标志；改用空白或背景颜色

质量保证（必需）

假设存在问题。您的工作是找到它们。

您的第一次渲染几乎永远不会正确。将 QA 视为一个错误排查过程，而不是一个确认步骤。如果第一次检查时您发现零问题，说明您检查得不够仔细。

内容质量保证

python -m markitdown output.pptx

检查内容缺失、拼写错误、顺序错误。

使用模板时，检查残留的占位符文本：

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

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

视觉质量保证

⚠️ 使用子代理——即使是 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 转图像