---
title: "用 AI 生成年度述职 PPT 完整教程"
author: deletexiumu
pubDatetime: 2026-01-26T10:00:00+08:00
featured: false
draft: false
tags:
  - AI 工具
  - 教程
description: "手把手教你从零开始，用 AI 将周报自动生成年度述职 PPT。"
---

这是公众号文章的详细版，手把手教你从零开始配置环境、生成 PPT。

---

## 整体流程概览

```
原始周报（多份 .md 文件）
       ↓
  Step 1: Claude 阅读、整理
       ↓
年度述职内容（1 份结构化 .md）
       ↓
  Step 2: /baoyu-slide-deck
       ↓
  精美 PPT 图片（12+ 张）
```

整个过程分为两大步：
1. **内容整理**：让 Claude 阅读你的周报，提炼成适合做 PPT 的结构化内容
2. **视觉生成**：用 baoyu-slide-deck 把内容渲染成精美幻灯片

下面一步一步来。

---

## 前置准备

### 1. 确保已安装 Claude Code

如果你还没装 Claude Code，请先参考《Claude Code 完整安装与配置教程》。

验证安装：
```bash
claude --version
```

能看到版本号就说明装好了。

### 2. 确保已安装 Node.js

baoyu-skills 需要 Node.js 环境。检查是否已安装：

```bash
node --version
```

如果提示 command not found，需要先安装 Node.js：

**Mac 用户（推荐用 Homebrew）：**
```bash
brew install node
```

**或者直接下载安装包：**
访问 https://nodejs.org/ 下载 LTS 版本，双击安装即可。

---

## 第一步：配置 Gemini API

baoyu-slide-deck 使用 Google 的 Gemini 模型来生成幻灯片图片，所以需要先配置 API。

### 1.1 获取 Gemini API Key

**访问 Google AI Studio：**
https://aistudio.google.com/apikey

用你的 Google 账号登录。

**创建 API Key：**
点击页面上的 **「Create API Key」** 按钮。

如果你是第一次使用，可能需要：
- 同意服务条款
- 选择一个 Google Cloud 项目（没有的话会自动创建）

创建成功后，你会看到一串类似这样的密钥：
```
AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

**复制并妥善保存这个 Key**，待会要用。

> **注意**：这个 Key 相当于你的密码，不要泄露给别人，也不要提交到 GitHub 等公开仓库。

### 1.2 配置环境变量

我们需要把 API Key 配置成环境变量，这样 Claude Code 才能使用它。

**打开终端，编辑 shell 配置文件：**

```bash
# Mac 默认用 zsh
nano ~/.zshrc

# 如果你用的是 bash
nano ~/.bashrc
```

**在文件末尾添加这一行：**

```bash
export GEMINI_API_KEY="你的API密钥"
```

把 `你的API密钥` 替换成刚才复制的 Key。

**保存文件：**
- 按 `Ctrl + O` 保存
- 按 `Enter` 确认
- 按 `Ctrl + X` 退出

**让配置生效：**

```bash
source ~/.zshrc
```

**验证配置成功：**

```bash
echo $GEMINI_API_KEY
```

如果能看到你的 API Key，说明配置成功了。

### 1.3 网络问题处理（国内用户）

如果你在国内，直接访问 Gemini API 可能会遇到网络问题。

**方案一：使用代理**

如果你有代理，在 shell 配置文件中添加：

```bash
export https_proxy="http://127.0.0.1:你的代理端口"
export http_proxy="http://127.0.0.1:你的代理端口"
```

**方案二：使用 API 中转服务**

有一些第三方服务提供 Gemini API 的中转，可以搜索了解。使用时需要修改 API 的 base URL。

**方案三：确保终端走代理**

有时候系统代理不会自动应用到终端。可以在启动 Claude Code 前手动设置：

```bash
export https_proxy="http://127.0.0.1:7890"  # 改成你的代理端口
claude
```

---

## 第二步：安装 baoyu-skills

### 2.1 使用 npx 安装（推荐）

在终端执行：

```bash
npx skills add jimliu/baoyu-skills
```

这会自动下载并安装所有的 baoyu-skills。

### 2.2 或者在 Claude Code 中安装

启动 Claude Code，然后输入：

```
请帮我安装 github.com/JimLiu/baoyu-skills 中的 Skills
```

Claude 会自动帮你完成安装。

### 2.3 验证安装

安装完成后，在 Claude Code 中输入 `/` 然后按 Tab，应该能看到以 `baoyu-` 开头的命令，比如：
- `/baoyu-slide-deck`
- `/baoyu-infographic`
- `/baoyu-cover-image`

如果能看到这些，说明安装成功了。

### 2.4 安装了哪些技能？

baoyu-skills 包含一整套内容创作技能：

| 技能 | 用途 |
|------|------|
| baoyu-slide-deck | 生成 PPT 幻灯片 |
| baoyu-infographic | 生成信息图 |
| baoyu-cover-image | 生成文章封面图 |
| baoyu-xhs-images | 生成小红书风格图片 |
| baoyu-comic | 生成漫画 |
| baoyu-image-gen | 通用图片生成 |
| baoyu-compress-image | 图片压缩 |
| baoyu-url-to-markdown | 网页转 Markdown |

今天我们主要用 `baoyu-slide-deck`。

---

## 第三步：准备你的内容

### 3.1 整理原始素材

假设你有一年的工作周报，都是 Markdown 格式的文件：

```
2025第43周的工作周报.md
2025第44周的工作周报.md
...
2026第4周的工作周报.md
```

这些周报通常是流水账式的记录，直接做 PPT 效果不好。我们需要先让 Claude 帮我们整理。

### 3.2 让 Claude 整理内容

在 Claude Code 中，先进入你的周报目录：

```bash
cd /你的周报目录路径
```

然后让 Claude 阅读并整理：

```
请阅读当前目录下所有的工作周报文件，帮我整理成一份年度述职 PPT 的内容。

要求：
1. 用 Markdown 格式输出
2. 按主题分类，不要按时间顺序流水
3. 提炼核心成果，突出量化数据
4. 每个主题配上具体的数据指标
5. 控制在 10-15 页的内容量
6. 语言精炼，适合 PPT 展示

主题建议：
- 核心成果概览
- 平台性能优化
- 数据处理能力
- 技术改进项目
- 下一年规划
```

### 3.3 优化 Prompt 的技巧

**明确你的重点方向：**
```
重点突出：平台稳定性、查询性能、数据规模
弱化：日常运维、会议记录
```

**指定数据格式：**
```
数据呈现方式：
- 用百分比表示提升/下降
- 用绝对数字表示规模（如 394 亿条）
- 用对比展示变化（优化前 vs 优化后）
```

**指定受众：**
```
受众是技术团队负责人，需要体现技术深度但不过于细节
```

### 3.4 保存整理后的内容

Claude 输出内容后，把它保存成一个新的 Markdown 文件：

```
年度述职.md
```

你可以让 Claude 直接帮你保存：
```
请把刚才整理的内容保存到 年度述职.md 文件
```

---

## 第四步：生成 PPT

### 4.1 基本用法

内容准备好后，执行：

```
/baoyu-slide-deck 年度述职.md
```

Claude Code 会：
1. 读取文件内容
2. 生成 PPT 大纲（会让你确认）
3. 逐页生成幻灯片图片

### 4.2 常用参数详解

```
/baoyu-slide-deck 年度述职.md --slides 12 --style corporate --audience executives --lang zh
```

**--slides（页数）**
- 推荐 8-25 页，最多 30 页
- 少于 8 页内容会太挤，多于 25 页容易疲劳
- 年度述职一般 12-15 页比较合适

**--style（视觉风格）**

| 风格 | 特点 | 适用场景 |
|------|------|----------|
| corporate | 商务正式，蓝色系 | 年度汇报、正式场合 |
| minimal | 极简留白，黑白灰 | 技术分享、学术风格 |
| creative | 色彩活泼，有创意 | 团队内部分享、轻松场合 |
| tech | 科技感，深色系 | 技术大会、产品发布 |

**--audience（目标受众）**
- `beginners`：新手，需要更多解释
- `intermediate`：有一定基础
- `experts`：专家，可以更深入
- `executives`：高管，侧重结果和数据

**--lang（语言）**
- `zh`：中文
- `en`：英文
- `ja`：日文

### 4.3 其他实用参数

**只生成大纲，不生成图片：**
```
/baoyu-slide-deck 年度述职.md --outline-only
```

先看大纲是否满意，满意后再生成完整 PPT，节省 API 调用。

**重新生成某一页：**
```
/baoyu-slide-deck 年度述职.md --regenerate 5
```

只重新生成第 5 页，不影响其他页面。

**指定输出目录：**
```
/baoyu-slide-deck 年度述职.md --output ./slides/
```

### 4.4 生成过程

执行命令后，Claude Code 会：

1. **分析内容** → 理解你的文档结构
2. **生成大纲** → 列出每一页的标题和要点，让你确认
3. **确认后开始渲染** → 逐页生成幻灯片图片
4. **保存结果** → 图片保存在当前目录或指定目录

整个过程会显示进度，耐心等待即可。

---

## 第五步：使用生成的 PPT

### 5.1 生成的文件

生成完成后，你会得到一组图片文件：

```
slide_01.png
slide_02.png
slide_03.png
...
slide_12.png
```

### 5.2 导入到 PowerPoint / Keynote

**方法一：作为图片插入**
- 新建空白 PPT
- 每一页插入一张图片，铺满整页
- 优点：保持原样，不会变形
- 缺点：不能编辑文字

**方法二：作为背景**
- 设置每页的背景为生成的图片
- 可以在上面添加可编辑的文字框

### 5.3 微调建议

如果某一页不满意：
- 可以用 `--regenerate N` 重新生成那一页
- 可以用 PS/Figma 局部修改
- 可以在 PPT 软件中添加覆盖层修改

---

## 常见问题排查

### Q: 提示 GEMINI_API_KEY 未设置

检查环境变量是否配置正确：
```bash
echo $GEMINI_API_KEY
```

如果为空，重新配置并 `source ~/.zshrc`。

### Q: 网络连接失败

大概率是网络问题。确保：
1. 代理已开启
2. 终端能访问外网（`curl https://google.com`）
3. 代理已配置到环境变量

### Q: 生成的图片质量不好

1. 检查原始内容是否结构清晰
2. 尝试换一个 style
3. 使用 `--regenerate` 重新生成不满意的页面

### Q: 命令找不到

确保 baoyu-skills 已正确安装，尝试重新安装：
```bash
npx skills add jimliu/baoyu-skills
```

---

## 实战 Prompt 模板

### 模板一：年度述职

```
请阅读当前目录下所有工作周报，整理成年度述职 PPT 内容。

要求：
- Markdown 格式
- 按主题分类：成果概览、核心项目、数据指标、技术突破、明年规划
- 突出量化数据，用数字说话
- 每个主题 2-3 个要点
- 控制在 12 页内容量
- 受众：部门负责人
```

### 模板二：项目汇报

```
请阅读这份项目文档，整理成项目汇报 PPT 内容。

要求：
- 结构：背景问题 → 解决方案 → 实施过程 → 成果数据 → 经验总结
- 突出问题的痛点和解决后的收益对比
- 技术细节适度，侧重业务价值
- 8-10 页
```

### 模板三：技术分享

```
请把这篇技术文章整理成技术分享 PPT 内容。

要求：
- 结构：Why → What → How → Demo → Q&A
- 概念解释清晰，配合示例
- 代码片段精简，突出关键部分
- 受众：有一定技术基础的开发者
- 15 页左右
```

---

## 小结

整个流程其实就两步：

1. **让 Claude 整理内容** → 把流水账变成结构化的演示内容
2. **用 /baoyu-slide-deck 生成** → 把内容变成精美幻灯片

关键点：
- Gemini API 配置正确
- 原始内容质量决定最终效果
- 善用参数调整风格和页数
- 不满意可以单页重新生成

有问题随时在星球提问，我会尽快回复。

---

## 相关阅读

- [AI 制作 PPT 全景指南：从四大流派到 Claude Code 实战](/posts/ai-ppt-complete-guide/) — 四大技术流派对比 + 三个 Skill 横评，选型更全面