# Powerpoint

> 创建、读取、编辑 .pptx 幻灯片、笔记、模板。

- Skill: `tencentcloud/powerpoint` (Agent Skill)
- Install (CLI): `npx get-skill add tencentcloud/powerpoint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencentcloud/powerpoint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: Proprietary. LICENSE.txt has complete terms
- Author: tencentcloud (https://skillmd.com/u/tencentcloud)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/tencentcloud/powerpoint

---


# PowerPoint 技能#

## Harness-agent 工具#

本技能从 Octop 移植。使用以下 harness/deepagents 工具：

| 概念 | 工具 |
|---------|------|
| Shell | `execute` |
| 读/写/编辑文件 | `read_file`, `write_file`, `edit_file` |
| 查找文件/搜索内容 | `glob`, `grep` |
| 获取 URL | `web_fetch` |
| 浏览器自动化 | `browser_use` |
| 子代理工作 | `task` |
| 记忆 | `memory_store`, `memory_recall`, `memory_search` |

内置技能文件位于 `/_builtin_skills/<name>/`。用户安装的技能位于 `/skills/<name>/`。

**脚本：** 在 `init_workspace` 后的工作区根目录，使用类似
`python _builtin_skills/powerpoint/scripts/thumbnail.py deck.pptx` 的路径。

## 何时使用#

当 .pptx 文件以任何方式涉及——作为输入、输出或两者时，都使用此技能。这包括：创建幻灯片、宣传幻灯片或演示文稿；读取、解析或提取任何 .pptx 文件中的文本（即使提取的内容将在其他地方使用，如电子邮件或摘要中）；编辑、修改或更新现有演示文稿；合并或拆分幻灯片文件；使用模板、布局、演讲者备注或注释。每当用户提到 "deck"、"slides"、"presentation" 或引用 .pptx 文件名时触发，无论他们之后计划对内容做什么。如果 .pptx 文件需要被打开、创建或触碰，请使用此技能。

## 快速参考#

| 任务 | 指南 |
|------|-------|
| 读取/分析内容 | `python -m markitdown presentation.pptx` |
| 编辑或从模板创建 | 阅读 [editing.md](editing.md) |
| 从零开始创建 | 阅读 [pptxgenjs.md](pptxgenjs.md) |

---

## 读取内容#

```bash
# 文本提取
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 种辅助色调和一种鲜明的强调色。绝不要给所有颜色相同的权重。
- **深色/浅色对比**：标题 + 结论幻灯片使用深色背景，内容使用浅色（"三明治"结构）。或者全程使用深色以获得高级感。
- **承诺一个视觉母题**：选择*一种*独特元素并重复它——圆形图像框、彩色圆圈中的图标、粗单边框。在每张幻灯片中延续它。

### 调色板#

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

| 主题 | 主色 | 辅助色 | 强调色 |
|-------|---------|-----------|--------|
| **午夜行政** | `1E2761` (海军蓝) | `CADCFC` (冰蓝) | `FFFFFF` (白色) |
| **森林与苔藓** | `2C5F2D` (森林) | `97BC62` (苔藓) | `F5F5F5` (奶油) |
| **珊瑚能量** | `F96167` (珊瑚) | `F9E795` (金色) | `2F3C7E` (海军蓝) |
| **温暖赤陶** | `B85042` (赤陶) | `E7E8D1` (沙色) | `A7BEAE` (sage) |
| **海洋渐变** | `065A82` (深蓝) | `1C7293` (teal) | `21295C` (午夜) |
| **炭黑极简** | `36454F` (炭黑) | `F2F2F2` (偏白) | `212121` (黑色) |
| **Teal 信任** | `028090` (teal) | `00A896` (海泡) | `02C39A` (薄荷) |
| **Berry & Cream** | `6D2E46` (berry) | `A26769` (尘土玫瑰) | `ECE2D0` (奶油) |
| **Sage 平静** | `84B59F` (sage) | `69A297` (桉树) | `50808E` (板岩) |
| **Cherry Bold** | `990011` (cherry) | `FCF6F5` (偏白) | `2F3C7E` (海军蓝) |

### 每张幻灯片#

**每张幻灯片都需要一个视觉元素**——图像、图表、图标或形状。纯文本幻灯片容易被遗忘。

**布局选项：**
- 双栏（左侧文本，右侧插图）
- 图标 + 文本行（彩色圆圈中的图标，粗体标题，下方描述）
- 2x2 或 2x3 网格（一侧图像，另一侧内容块的网格）
- 半出血图像（全左侧或右侧）与内容叠加

**数据显示：**
- 大统计数字（60-72pt 带下方小标签）
- 比较列（之前/之后、优点/缺点、并排选项）
- 时间线或流程（编号步骤、箭头）
- 图表（条形图、饼图、折线图）

**视觉润色：**
- 章节标题旁的彩色圆圈中的图标
- 关键统计或标签的斜体强调文本
- 形状或图像旁边的装饰性线条

### 排版#

**选择有趣的字体组合**——不要默认使用 Arial。为标题选择有个性的字体，为正文搭配干净的字体。

| 标题字体 | 正文字体 |
|-------------|-----------|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri |
| 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+ 才能从正文中脱颖而出
- **不要默认使用蓝色**——选择与特定主题匹配的颜色
- **不要随机混合间距**——选择 0.3" 或 0.5" 间隙并一致使用
- **不要只设置一张幻灯片的样式而将其余部分留空**——全面承诺或全程保持简单
- **不要创建仅文本的幻灯片**——添加图像、图标、图表或视觉元素；避免纯标题 + 项目符号
- **不要忘记文本框架填充**——将线条或形状与文本边缘对齐时，设置 `margin: 0` 或偏移形状以考虑填充
- **不要使用低对比度元素**——图标 AND 文本需要对背景有强对比度；避免浅色文本在浅色背景上或深色文本在深色背景上
- **绝不使用标题下划线**——这些是 AI 生成幻灯片的标志；改用空白或背景颜色
- **永远、永远、永远不要使用默认的 PowerPoint 过渡**——使用无过渡、淡入或精美微妙的东西

---

## 质量保证（必需）#

**假设存在问题。你的工作就是找到它们。**

你的首次渲染几乎永远不会正确。将 QA 视为错误搜寻，而不是确认步骤。如果你在首次检查时发现零问题，说明你检查得不够努力。

### 内容 QA#

```bash
python -m markitdown output.pptx
```

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

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

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

如果 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. 重复直到完整遍未显示新问题

**在至少完成一次修复和验证循环之前，不要宣布成功。**

---

## 转换为图像#

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

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

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

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

```bash
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 到图像

