common-skills/skills/ppt-maker/SKILL.md

---
name: ppt-maker
description: "专业级PPT一键生成。Markdown创建幻灯片，支持自动图表（饼图/柱状图/折线图）、多主题、有序/无序列表、引用块、代码块、表格、感谢页自动识别。"
---

# PPT Maker - 专业级PPT生成工具

使用 Markdown 自动创建精美 PPT，**表格数据自动转为图表**，支持多种主题和智能布局。

## 快速开始

```bash
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -i input.md -o output.pptx -t ocean
```

## 命令参数

| 参数 | 说明 | 必填 |
|------|------|------|
| `-i, --input` | 输入 Markdown 文件路径 | ✅ |
| `-o, --output` | 输出 PPTX 文件路径（自动补 .pptx 后缀） | ✅ |
| `-t, --theme` | 主题名称，默认 ocean | ❌ |
| `-l, --list` | 列出所有可用主题 | ❌ |
| `-h, --help` | 显示帮助信息 | ❌ |

## 支持的主题

| 主题 | 风格 | 适用场景 |
|------|------|----------|
| ocean | 蓝色海洋 | 科技/专业 |
| sunset | 橙红日落 | 温暖/创意 |
| purple | 紫罗兰 | 创意/设计 |
| luxury | 黑金奢华 | 高端/奢侈 |
| midnight | 深夜暗色 | 演示/震撼 |
| classic | 经典绿 | 商务/正式 |

## Markdown 语法对照

### 页面类型

```markdown
# 大标题           → 封面页（第一张幻灯片）
副标题文字          → 封面副标题

## 章节标题         → 内容页
## 感谢聆听         → 结束页（自动居中大字布局）
```

**结束页自动识别关键字：** 感谢、谢谢、thank、thanks、Q&A、问答、结束、The End、再见、联系方式

### 内容元素

```markdown
### 小标题           → 页内加粗小标题

- 无序列表项1        → 带圆点的无序列表
- 无序列表项2

1. 有序列表项1       → 带编号圆圈的有序列表
2. 有序列表项2

> 引用文字           → 带左侧竖条的引用块

普通文字             → 正文段落
```

### 表格

```markdown
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容 | 内容 | 内容 |
```

表格含数值列时**自动检测**是否转为图表（见下方图表规则）。不含数值或未匹配图表规则时，保持表格原样显示（含交替行底色）。

### 代码块

````markdown
```python
print("Hello World")
```
````

深色背景 + 等宽字体 + 圆角边框显示。

## ⭐ 自动图表生成

**核心功能：** 在 `##` 标题、`###` 小标题或表格前的正文中包含特定关键字，其下方的表格自动转为对应图表。

### 图表类型与关键字

| 图表类型 | 触发关键字 |
|----------|-----------|
| 🥧 饼图 | 饼图、饼状图、占比、比例、份额、构成、组成、百分比、比重、pie |
| 📊 柱状图 | 柱状、柱状图、柱形、排名、top、对比、比较、分布、销售额、金额、数量、业绩、产量、营收、bar |
| 📈 折线图 | 折线、折线图、趋势、增长、变化、走势、曲线、时间、月度、季度、年度、line、trend |

### 智能推断（无关键字时）

- 数值列总和在 80~120 之间 → 自动识别为**饼图**（占比数据）
- 有 ≥2 个数值点 → 默认生成**柱状图**
- 支持多列数值 → 自动生成**多系列**图表

### 数值解析

自动清理单元格中的干扰字符，以下写法均可正确识别：
- `100万` `¥250` `$1,200` `30%` `85元` `1200亿`

### 图表示例

#### 饼图示例

```markdown
## 销售占比分析
### 各产品销售占比饼图
| 产品 | 占比(%) |
|------|---------|
| 大米 | 30 |
| 高粱 | 50 |
| 小麦 | 20 |
```

#### 柱状图示例

```markdown
## 各产品销售额对比
### 年度销售额柱状图
| 产品 | 销售额(万元) |
|------|-------------|
| 大米 | 100 |
| 高粱 | 250 |
| 小麦 | 130 |
```

#### 折线图示例

```markdown
## 月度销售趋势
### 销售额变化趋势折线图
| 月份 | 销售额(万元) |
|------|-------------|
| 1月 | 35 |
| 2月 | 42 |
| 3月 | 58 |
| 4月 | 72 |
```

#### 不转图表的表格（无数值列或非图表场景）

```markdown
## 工作计划
| 季度 | 目标 | 负责人 |
|------|------|--------|
| Q1 | 完成招聘 | 张经理 |
| Q2 | 市场拓展 | 李经理 |
```

## 使用示例

提供markdown文件，比如input.md，然后通过指令生成
```bash
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -i input.md -o output.pptx -t ocean
```
### markdown提示词示例
```markdown
# 2026年度总结报告
北灵聊AI · 年度工作汇报

## 销售占比分析
### 各产品占比饼图
| 产品 | 占比(%) |
|------|---------|
| 大米 | 30 |
| 高粱 | 40 |
| 小麦 | 20 |
| 玉米 | 10 |

## 销售额对比
### 各产品销售额柱状图
| 产品 | 销售额(万元) |
|------|-------------|
| 大米 | 100 |
| 高粱 | 250 |
| 小麦 | 130 |

## 月度趋势
### 全年销售额变化趋势折线图
| 月份 | 销售额(万元) |
|------|-------------|
| 1月 | 35 |
| 6月 | 72 |
| 12月 | 102 |

## 核心成果
### 业务拓展
- 新增客户 126 家，同比增长 35%
- 开拓西南市场，覆盖 4 个新省份

### 团队建设
1. 团队扩充至 28 人
2. 组织培训 12 场
3. 员工满意度达 92%

> 全年目标超额完成，总销售额突破 560 万元

## 感谢聆听
北灵聊AI
期待2027再创佳绩！
```


### 自然语言提示词示例
```
请使用 ppt-maker 技能，为我生成一份“2026生成式AI行业发展与企业落地趋势”的汇报型幻灯片，整体风格专业、简洁、科技感强，讲解人是北灵聊AI。

封面是2026生成式AI行业发展与企业落地趋势，副标题写“模型能力升级、企业应用加速与商业化观察”，并显示讲解人“北灵聊AI”。

第一页是企业采用生成式AI的主要应用场景分布，用饼状图展示，其中知识助手占比32，智能客服占比24，内容生成占比18，研发提效占比16，数据分析占比10。

第二页是企业AI项目预算投入对比，用柱状图展示，其中大模型平台建设预算380万，AI代码助手预算300万，AI办公助手预算260万，AI智能客服预算220万，AI营销内容生成预算180万。

第三页是2026年企业生成式AI项目推进热度趋势，用折线图展示，其中Q1热度指数48，Q2热度指数63，Q3热度指数78，Q4热度指数92。

最后一页是感谢，标题写“感谢聆听”，副标题写“欢迎交流生成式AI与企业应用实践”。
```

## 支持的命令行

```bash
# 查看帮助
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -h

# 列出所有主题
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -l

# 海洋蓝主题（默认）
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -i slides.md -o demo.pptx

# 深夜科技主题
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -i slides.md -o demo.pptx -t midnight

# 黑金奢华主题
node ~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js -i slides.md -o demo.pptx -t luxury
```


## 布局特点

### 页面类型

- **封面页** — 大标题 + 副标题 + 左侧装饰竖条
- **内容页** — 标题栏背景 + 正文区域 + 页码
- **结束页** — 居中大字 + 装饰色块 + 上下装饰线

### 装饰元素

- 顶部主题色强调条
- 左侧边栏装饰线
- 标题栏浅色背景
- 封面竖线装饰 + 底部横线

### 内容渲染

- 无序列表：主题色圆点
- 有序列表：主题色编号圆圈
- 引用块：左侧竖条 + 浅色背景 + 斜体
- 代码块：深色背景 + 等宽字体 + 圆角
- 表格：表头底色 + 交替行着色
- 图表与剩余内容并排显示（饼图右侧/柱状折线收窄后右侧）

## 注意事项

1. **Markdown格式要求：** 必须用 `#` 开头作为封面页，`##` 开头分页
2. **图表触发：** 关键字写在 `##` 标题或 `###` 小标题中最可靠
3. **表格格式：** 第一行为表头，第二行为分隔行 `|---|---|`，第三行起为数据
4. **数值列：** 表格第二列起含可解析数字才会触发图表
5. **输出格式：** 自动补 `.pptx` 后缀
6. **行内格式：** `**粗体**` `*斜体*` `~~删除线~~` 等会自动清理为纯文本

## 文件位置

- 脚本：`~/.openclaw/workspace/skills/ppt-maker/scripts/ppt-maker.js`
- 依赖：`pptxgenjs`（已安装）