| name | pptx |
| description | PowerPoint 演示文稿处理。用于读取现有 PPTX 信息、创建新演示文稿、提取媒体文件。支持文本、图片、表格、图表、形状、媒体、演讲者备注。当用户提到 .pptx 文件或需要操作 PowerPoint 时触发。 |
| license | MIT |
| argument-hint | [file|slide|object|master] [action] [path] |
| user-invocable | true |
PPTX - PowerPoint 演示文稿处理
依赖：pptxgenjs 4.0+ (创建演示文稿) + adm-zip (读取现有 PPTX)
⚠️ 重要限制
pptxgenjs 4.0 只能创建新演示文稿，无法编辑现有文件！
- ✅ 支持：创建新演示文稿、读取现有文件信息、提取内容
- ❌ 不支持：编辑现有 PPTX 文件（添加/修改/删除幻灯片或对象）
编辑现有文件的替代方案：
- 使用
file read 读取现有文件内容
- 使用
file create 创建新文件，添加修改后的内容
- 删除原文件，重命名新文件
工具
本技能提供四个工具：
| 工具 | 最终名称 | 说明 |
|---|
file | pptx__file | 文件级操作（读取、创建、提取） |
slide | pptx__slide | 幻灯片创建（仅限新建演示文稿） |
object | pptx__object | 内容对象操作（添加、提取） |
master | pptx__master | 模板母版（定义、列出） |
file - 文件级操作
通过 action 参数区分具体操作：
| action | 功能 | 关键参数 |
|---|
read | 读取演示文稿信息 | scope, slideNumbers |
create | 创建演示文稿 | source, slides, markdown |
extract | 提取媒体文件 | outputDir, extractType |
read - 读取演示文稿
参数：
action (string, required): "read"path (string, required): PPTX 文件路径scope (string, optional): 读取范围
info: 基本信息（幻灯片数量、元数据）text: 提取所有文本内容structure: 提取结构信息（形状、图片等）media: 提取媒体信息（图片、视频列表）
slideNumbers (number[], optional): 指定幻灯片编号
示例：
pptx__file({ action: "read", path: "presentation.pptx", scope: "info" })
pptx__file({ action: "read", path: "presentation.pptx", scope: "text" })
pptx__file({ action: "read", path: "presentation.pptx", scope: "structure" })
create - 创建演示文稿
参数：
action (string, required): "create"path (string, required): 输出文件路径source (string, optional): 创建来源 - data 或 markdown（默认: data）slides (object[], optional): 幻灯片数据数组markdown (string, optional): Markdown 内容properties (object, optional): 文档属性
title: 标题author: 作者company: 公司layout: 布局（LAYOUT_16x9, LAYOUT_4x3, LAYOUT_WIDE）
示例：
pptx__file({
action: "create",
path: "new.pptx",
slides: [
{ title: "第一章", content: "这是内容" },
{ title: "第二章", texts: ["要点一", "要点二"] }
],
properties: { title: "我的演示", author: "张三" }
})
pptx__file({
action: "create",
path: "markdown.pptx",
source: "markdown",
markdown: "# 标题页\n\n## 内容\n- 要点一\n- 要点二"
})
extract - 提取媒体文件
参数：
action (string, required): "extract"path (string, required): PPTX 文件路径outputDir (string, optional): 输出目录extractType (string, optional): 提取类型 - images, media, all
示例：
pptx__file({
action: "extract",
path: "presentation.pptx",
outputDir: "images",
extractType: "images"
})
slide - 幻灯片创建
创建新的演示文稿并添加幻灯片。
参数：
action (string, required): "add"output (string, required): 输出文件路径title (string, optional): 幻灯片标题content (string | string[], optional): 幻灯片内容slides (object[], optional): 多个幻灯片数据background (object, optional): 背景配置master (object, optional): 母版配置properties (object, optional): 文档属性
示例：
pptx__slide({
action: "add",
output: "single.pptx",
title: "演示标题",
content: ["要点一", "要点二"]
})
pptx__slide({
action: "add",
output: "multi.pptx",
slides: [
{ title: "第一页", content: "内容一" },
{ title: "第二页", texts: ["要点A", "要点B"] }
]
})
object - 内容对象操作
通过 action 参数区分具体操作：
| action | 功能 | 关键参数 |
|---|
add | 创建包含对象的演示文稿 | type, text, image, chart 等 |
extract | 提取对象内容 | type, outputDir |
add - 添加对象到新演示文稿
参数：
action (string, required): "add"output (string, required): 输出文件路径type (string, required): 对象类型
text: 文本image: 图片table: 表格chart: 图表shape: 形状media: 视频/音频notes: 演讲者备注
properties (object, optional): 文档属性
文本示例：
pptx__object({
action: "add",
output: "text.pptx",
type: "text",
text: "Hello World",
options: { fontSize: 24, bold: true, color: "FF0000" }
})
图片示例：
pptx__object({
action: "add",
output: "image.pptx",
type: "image",
image: { path: "photo.jpg", x: 1, y: 1, w: 4, h: 3 }
})
表格示例：
pptx__object({
action: "add",
output: "table.pptx",
type: "table",
table: {
rows: [
[{ text: "姓名" }, { text: "年龄" }],
[{ text: "张三" }, { text: "25" }]
],
x: 0.5, y: 1, w: 9
}
})
图表示例：
pptx__object({
action: "add",
output: "chart.pptx",
type: "chart",
chart: {
type: "bar",
data: [
{ name: "销售额", labels: ["一月", "二月"], values: [100, 150] }
],
title: "月度销售额"
}
})
支持的图表类型：
bar, bar3D: 柱状图line, line3D: 折线图pie, pie3D: 饼图doughnut: 环形图area, area3D: 面积图scatter: 散点图radar, radar3D: 雷达图bubble, bubble3D: 气泡图
extract - 提取对象内容
参数：
action (string, required): "extract"path (string, required): PPTX 文件路径type (string, required): 提取类型 - images, media, textoutputDir (string, optional): 输出目录
示例：
pptx__object({
action: "extract",
path: "presentation.pptx",
type: "images",
outputDir: "extracted"
})
master - 模板母版
通过 action 参数区分具体操作：
| action | 功能 | 关键参数 |
|---|
define | 定义母版并创建演示文稿 | name, background, objects |
list | 列出母版布局 | path |
define - 定义母版
参数：
action (string, required): "define"output (string, required): 输出文件路径name (string, required): 母版名称background (object, optional): 背景配置objects (object[], optional): 母版上的固定对象slideNumber (object, optional): 幻灯片编号配置properties (object, optional): 文档属性
示例：
pptx__master({
action: "define",
output: "template.pptx",
name: "CompanyTemplate",
background: { color: "F5F5F5" },
objects: [
{ text: "公司名称", options: { x: 0.5, y: 0.2 } }
]
})
list - 列出母版
参数：
action (string, required): "list"path (string, required): PPTX 文件路径
示例：
pptx__master({
action: "list",
path: "template.pptx"
})
幻灯片数据结构
创建演示文稿时，每个幻灯片支持以下字段：
interface SlideData {
title?: string;
content?: string;
texts?: (string | TextItem)[];
images?: ImageItem[];
tables?: TableItem[];
charts?: ChartItem[];
shapes?: ShapeItem[];
background?: Background;
notes?: string;
}
快速参考
| 任务 | 工具 | action |
|---|
| 读取基本信息 | file | read (scope: info) |
| 提取文本 | file | read (scope: text) |
| 提取结构 | file | read (scope: structure) |
| 提取媒体信息 | file | read (scope: media) |
| 创建演示文稿 | file | create |
| 提取媒体文件 | file | extract |
| 创建幻灯片 | slide | add |
| 添加文本 | object | add (type: text) |
| 添加图片 | object | add (type: image) |
| 添加表格 | object | add (type: table) |
| 添加图表 | object | add (type: chart) |
| 添加形状 | object | add (type: shape) |
| 添加媒体 | object | add (type: media) |
| 添加备注 | object | add (type: notes) |
| 提取对象 | object | extract |
| 定义母版 | master | define |
| 列出母版 | master | list |
更新日志
- 2026-03-28: 升级到 pptxgenjs 4.0.1，重新设计工具架构（4 个工具）
- 2026-03-28: 重要变更：移除编辑现有文件的功能（pptxgenjs 4.0 不支持）
- 2026-03-28: 新增图表类型支持（14 种图表）
- 2026-03-28: 新增演讲者备注、媒体、母版定义功能
- 2026-03-28: 新增 Markdown 创建支持
