# PPTX

当涉及到 .pptx 文件的任何操作时使用此技能, , 无论是作为输入、输出还是两者兼有。包括：创建幻灯片、演示文稿或路演材料；读取、解析或提取任何 .pptx...

- Repository: https://github.com/agentscope-ai/QwenPaw (37135 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add agentscope-ai/QwenPaw --skill pptx -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/QwenPaw --skill pptx -g -a codex -y`
Cursor: `npx skills add agentscope-ai/QwenPaw --skill pptx -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/QwenPaw --skill pptx -g -a gemini-cli -y`

## Description

当涉及到 .pptx 文件的任何操作时使用此技能, , 无论是作为输入、输出还是两者兼有。包括：创建幻灯片、演示文稿或路演材料；读取、解析或提取任何 .pptx 文件中的文本（即使提取的内容将用于其他地方，如邮件或摘要）；编辑、修改或更新现有演示文稿；合并或拆分幻灯片文件；处理模板、布局、演讲者备注或批注。当用户提到“演示文稿”、”幻灯片“、”PPT“或引用 .pptx 文件名时触发，无论他们之后打算如何使用内容。如果需要打开、创建或操作 .pptx 文件，就使用此技能。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

> **重要：** 所有 `scripts/` 路径都相对于此技能目录。
> 运行方式：`cd {this_skill_dir} && python scripts/...`
> 或使用 `execute_shell_command` 的 `cwd` 参数。

# PPTX 技能

## 前置依赖

- **markitdown[pptx]**：从演示文稿中提取文本
- **Pillow**：生成缩略图网格
- **pptxgenjs**（`npm install -g pptxgenjs`）：从零开始创建演示文稿
- **LibreOffice**（`soffice`）：演示文稿转 PDF
- **pdftoppm**（poppler-utils）：PDF 转图片，用于缩略图/视觉工作流
- 如果 `pdftoppm` 不可用，可使用 Python 备选方案 `pdf2image`。
- 在 Windows 上，依赖项必须已安装并在 `PATH` 中可用；如果缺失，报告依赖问题并停止（不要反复重试）。

## 快速参考

| 任务 | 指南 |
|------|------|
| 读取/分析内容 | `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 种辅助色调和一种鲜明的点缀色。切勿让所有颜色等量分配。
- **明暗对比**：标题页和结尾页用深色背景，内容页用浅色（"三明治"结构）。或者全程使用深色背景营造高端感。
- **坚持一个视觉主题**：选择一个独特元素并反复使用, , 圆角图片框、彩色圆圈中的图标、粗单边边框。将其贯穿每张幻灯片。

### 配色方案

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

The rest: https://github.com/agentscope-ai/QwenPaw/blob/HEAD/src/qwenpaw/agents/skills/pptx-zh/SKILL.md