powerpoint
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChinesePowerpoint Skill
PowerPoint 技能
When to use
适用场景
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.
只要涉及.pptx文件（作为输入、输出或两者皆是），都可使用本技能。包括：创建幻灯片演示文稿、推介演示文稿或演讲文稿；读取、解析或提取任意.pptx文件中的文本（即使提取的内容将用于其他地方，如邮件或摘要）；编辑、修改或更新现有演示文稿；合并或拆分幻灯片文件；处理模板、版式、演讲者备注或批注。当用户提到“演示文稿”“幻灯片”“演讲文稿”或提及.pptx文件名时，无论他们后续打算如何处理内容，都触发本技能。如果需要打开、创建或修改.pptx文件，请使用本技能。
Quick Reference
快速参考
| Task | Guide |
|---|---|
| Read/analyze content | |
| Edit or create from template | Read editing.md |
| Create from scratch | Read pptxgenjs.md |
| 任务 | 指南 |
|---|---|
| 读取/分析内容 | |
| 基于模板编辑或创建 | 阅读 editing.md |
| 从零创建 | 阅读 pptxgenjs.md |
Reading Content
读取内容
bash
undefinedbash
undefinedText extraction
文本提取
python -m markitdown presentation.pptx
python -m markitdown presentation.pptx
Visual overview
可视化概览
python scripts/thumbnail.py presentation.pptx
python scripts/thumbnail.py presentation.pptx
Raw XML
原始XML
python scripts/office/unpack.py presentation.pptx unpacked/
---python scripts/office/unpack.py presentation.pptx unpacked/
---Editing Workflow
编辑工作流
Read editing.md for full details.
- Analyze template with
thumbnail.py - Unpack → manipulate slides → edit content → clean → pack
详细内容请阅读 editing.md。
- 使用 分析模板
thumbnail.py - 解压 → 调整幻灯片 → 编辑内容 → 清理 → 打包
Creating from Scratch
从零创建
Read pptxgenjs.md for full details.
Use when no template or reference presentation is available.
详细内容请阅读 pptxgenjs.md。
适用于没有模板或参考演示文稿的场景。
Design Ideas
设计思路
Don't create boring slides. Plain bullets on a white background won't impress anyone. Consider ideas from this list for each slide.
不要制作乏味的幻灯片。 白底纯项目符号不会给人留下任何印象。为每张幻灯片参考以下设计思路。
Before Starting
开始之前
- Pick a bold, content-informed color palette: The palette should feel designed for THIS topic. If swapping your colors into a completely different presentation would still "work," you haven't made specific enough choices.
- Dominance over equality: One color should dominate (60-70% visual weight), with 1-2 supporting tones and one sharp accent. Never give all colors equal weight.
- Dark/light contrast: Dark backgrounds for title + conclusion slides, light for content ("sandwich" structure). Or commit to dark throughout for a premium feel.
- Commit to a visual motif: Pick ONE distinctive element and repeat it — rounded image frames, icons in colored circles, thick single-side borders. Carry it across every slide.
- 选择贴合内容的大胆配色方案：配色方案应专为当前主题设计。如果把你的配色换到完全不同的演示文稿中依然“适用”，说明你的选择不够有针对性。
- 主次分明：一种颜色应占主导（视觉占比60-70%），搭配1-2种辅助色调和一种醒目的强调色。绝不能让所有颜色占比均等。
- 明暗对比：标题页和结论页用深色背景，内容页用浅色（“三明治”结构）。或全程使用深色背景，营造高端质感。
- 坚持视觉主题：选择一个独特元素并重复使用——圆角图片框、彩色圆圈中的图标、单侧粗边框。让它贯穿每一张幻灯片。
Color Palettes
配色方案
Choose colors that match your topic — don't default to generic blue. Use these palettes as inspiration:
| Theme | Primary | Secondary | Accent |
|---|---|---|---|
| Midnight Executive | | | |
| Forest & Moss | | | |
| Coral Energy | | | |
| Warm Terracotta | | | |
| Ocean Gradient | | | |
| Charcoal Minimal | | | |
| Teal Trust | | | |
| Berry & Cream | | | |
| Sage Calm | | | |
| Cherry Bold | | | |
选择与主题匹配的颜色——不要默认使用通用蓝色。以下配色方案可供参考：
| 主题 | 主色 | 辅助色 | 强调色 |
|---|---|---|---|
| 午夜商务风 | | | |
| 森林苔藓风 | | | |
| 活力珊瑚风 | | | |
| 暖调赤陶风 | | | |
| 海洋渐变风 | | | |
| 炭黑极简风 | | | |
| 青蓝信赖风 | | | |
| 浆果奶油风 | | | |
| 鼠尾草静谧风 | | | |
| 樱桃醒目风 | | | |
For Each Slide
单页幻灯片设计
Every slide needs a visual element — image, chart, icon, or shape. Text-only slides are forgettable.
Layout options:
- Two-column (text left, illustration on right)
- Icon + text rows (icon in colored circle, bold header, description below)
- 2x2 or 2x3 grid (image on one side, grid of content blocks on other)
- Half-bleed image (full left or right side) with content overlay
Data display:
- Large stat callouts (big numbers 60-72pt with small labels below)
- Comparison columns (before/after, pros/cons, side-by-side options)
- Timeline or process flow (numbered steps, arrows)
Visual polish:
- Icons in small colored circles next to section headers
- Italic accent text for key stats or taglines
每张幻灯片都需要视觉元素——图片、图表、图标或形状。纯文本幻灯片容易被遗忘。
版式选项：
- 双栏布局（左侧文本，右侧插图）
- 图标+文本行（图标置于彩色圆圈内，搭配加粗标题和下方描述）
- 2x2或2x3网格（一侧图片，另一侧内容块网格）
- 半出血图片（左侧或右侧全屏）叠加内容
数据展示：
- 大数字标注（60-72号大数字，下方配小标签）
- 对比栏（前后对比、优缺点对比、并列选项）
- 时间线或流程示意图（带编号步骤、箭头）
视觉优化：
- 章节标题旁添加彩色小圆圈中的图标
- 关键数据或标语使用斜体强调文本
Typography
排版
Choose an interesting font pairing — don't default to Arial. Pick a header font with personality and pair it with a clean body font.
| Header Font | Body Font |
|---|---|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri Light |
| Cambria | Calibri |
| Trebuchet MS | Calibri |
| Impact | Arial |
| Palatino | Garamond |
| Consolas | Calibri |
| Element | Size |
|---|---|
| Slide title | 36-44pt bold |
| Section header | 20-24pt bold |
| Body text | 14-16pt |
| Captions | 10-12pt muted |
选择有趣的字体搭配——不要默认使用Arial。挑选一款有个性的标题字体，搭配简洁的正文字体。
| 标题字体 | 正文字体 |
|---|---|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri Light |
| Cambria | Calibri |
| Trebuchet MS | Calibri |
| Impact | Arial |
| Palatino | Garamond |
| Consolas | Calibri |
| 元素 | 字号 |
|---|---|
| 幻灯片标题 | 36-44号加粗 |
| 章节标题 | 20-24号加粗 |
| 正文文本 | 14-16号 |
| 说明文字 | 10-12号浅色调 |
Spacing
间距
- 0.5" minimum margins
- 0.3-0.5" between content blocks
- Leave breathing room—don't fill every inch
- 最小边距0.5英寸
- 内容块间距0.3-0.5英寸
- 留足呼吸空间——不要填满每一寸区域
Avoid (Common Mistakes)
避坑指南（常见错误）
- Don't repeat the same layout — vary columns, cards, and callouts across slides
- Don't center body text — left-align paragraphs and lists; center only titles
- Don't skimp on size contrast — titles need 36pt+ to stand out from 14-16pt body
- Don't default to blue — pick colors that reflect the specific topic
- Don't mix spacing randomly — choose 0.3" or 0.5" gaps and use consistently
- Don't style one slide and leave the rest plain — commit fully or keep it simple throughout
- Don't create text-only slides — add images, icons, charts, or visual elements; avoid plain title + bullets
- Don't forget text box padding — when aligning lines or shapes with text edges, set on the text box or offset the shape to account for padding
margin: 0 - Don't use low-contrast elements — icons AND text need strong contrast against the background; avoid light text on light backgrounds or dark text on dark backgrounds
- NEVER use accent lines under titles — these are a hallmark of AI-generated slides; use whitespace or background color instead
- 不要重复使用相同版式——在幻灯片间变换分栏、卡片和标注样式
- 不要让正文居中对齐——段落和列表左对齐；仅标题居中
- 不要忽略字号对比——标题需36号以上，与14-16号正文形成明显区分
- 不要默认使用蓝色——选择能体现特定主题的颜色
- 不要随意设置间距——选择0.3英寸或0.5英寸的间距并保持一致
- 不要只美化单张幻灯片——要么全程统一风格，要么保持简洁
- 不要制作纯文本幻灯片——添加图片、图标、图表或视觉元素；避免纯标题+项目符号的形式
- 不要忘记文本框内边距——当线条或形状与文本边缘对齐时，设置文本框或调整形状位置以适配内边距
margin: 0 - 不要使用低对比度元素——图标和文本都需要与背景形成强烈对比；避免浅色文本配浅色背景或深色文本配深色背景
- 绝对不要在标题下方添加装饰线——这是AI生成幻灯片的典型特征；改用留白或背景色替代
QA (Required)
质量检查（必做）
Assume there are problems. Your job is to find them.
Your first render is almost never correct. Approach QA as a bug hunt, not a confirmation step. If you found zero issues on first inspection, you weren't looking hard enough.
默认存在问题。你的任务是找出它们。
首次生成的幻灯片几乎不可能完美。把质量检查当作找bug，而非确认步骤。如果第一次检查没发现任何问题，说明你还不够仔细。
Content QA
内容检查
bash
python -m markitdown output.pptxCheck for missing content, typos, wrong order.
When using templates, check for leftover placeholder text:
bash
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"If grep returns results, fix them before declaring success.
bash
python -m markitdown output.pptx检查是否有内容缺失、拼写错误、顺序错误。
使用模板时，检查是否有残留的占位符文本：
bash
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"如果grep返回结果，修复后再确认完成。
Visual QA
视觉检查
⚠️ USE SUBAGENTS — even for 2-3 slides. You've been staring at the code and will see what you expect, not what's there. Subagents have fresh eyes.
Convert slides to images (see Converting to Images), then use this prompt:
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.⚠️ 使用子代理——即使只有2-3张幻灯片。你一直盯着代码，看到的是预期效果，而非实际效果。子代理能提供全新视角。
将幻灯片转换为图片（见下文转换为图片），然后使用以下提示词：
请视觉检查这些幻灯片。默认存在问题——找出它们。
检查要点：
- 元素重叠（文本穿过形状、线条覆盖文字、元素堆叠）
- 文本溢出或被边缘/文本框边界截断
- 装饰线为单行文本设计，但标题换行成了两行
- 来源引用或页脚与上方内容冲突
- 元素间距过近（小于0.3英寸）或卡片/区块几乎贴合
- 间距不均（一处留白过大，另一处过于拥挤）
- 幻灯片边距不足（小于0.5英寸）
- 分栏或同类元素未对齐
- 文本对比度低（如浅灰色文本配米黄色背景）
- 图标对比度低（如深色图标配深色背景且无对比色圆圈）
- 文本框过窄导致换行过多
- 残留占位符内容
针对每张幻灯片，列出问题或需要注意的地方，即使是小问题也不要遗漏。
请阅读并分析以下图片：
1. /path/to/slide-01.jpg（预期：[简要描述]）
2. /path/to/slide-02.jpg（预期：[简要描述]）
请报告所有发现的问题，包括小问题。Verification Loop
验证循环
- Generate slides → Convert to images → Inspect
- List issues found (if none found, look again more critically)
- Fix issues
- Re-verify affected slides — one fix often creates another problem
- Repeat until a full pass reveals no new issues
Do not declare success until you've completed at least one fix-and-verify cycle.
- 生成幻灯片 → 转换为图片 → 检查
- 列出发现的问题（如果没发现问题，更仔细地重新检查）
- 修复问题
- 重新验证受影响的幻灯片——一次修复往往会引发新问题
- 重复上述步骤，直到完整检查未发现新问题
至少完成一次修复-验证循环后，才能确认完成。
Converting to Images
转换为图片
Convert presentations to individual slide images for visual inspection:
bash
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slideThis creates , , etc.
slide-01.jpgslide-02.jpgTo re-render specific slides after fixes:
bash
pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed将演示文稿转换为单张幻灯片图片，用于视觉检查：
bash
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide此命令会生成 、 等文件。
slide-01.jpgslide-02.jpg修复后重新渲染特定幻灯片：
bash
pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixedDependencies
依赖项
- - text extraction
pip install "markitdown[pptx]" - - thumbnail grids
pip install Pillow - - creating from scratch
npm install -g pptxgenjs - LibreOffice () - PDF conversion (auto-configured for sandboxed environments via
soffice)scripts/office/soffice.py - Poppler () - PDF to images
pdftoppm
- - 文本提取
pip install "markitdown[pptx]" - - 缩略图网格生成
pip install Pillow - - 从零创建幻灯片
npm install -g pptxgenjs - LibreOffice () - PDF转换（通过
soffice自动配置沙箱环境）scripts/office/soffice.py - Poppler () - PDF转图片
pdftoppm