PPT Master 完全指南:Claude Code 一键安装与PPT实操

摘要：本文详细介绍 PPT Master——一款基于 Claude Code 的 AI 驱动演示文稿生成系统。从项目介绍、一键安装、功能详解到小红书风格 PPT 实操案例，手把手教你如何用 AI 工具 10 分钟生成高质量演示文稿。 核心卖点：做 PPT 的痛点，10 年来没变过——找模板花 2 小时，排版对齐花 1 小时，改稿又花 3 小时。但今天，AI 把这件事压到了 10 分钟。

目录

1. PPT Master 项目介绍
2. 从 0 到 1 安装流程
3. 实操案例：小红书风格 AI 工具分享 PPT
4. 最佳实践与技巧
5. 常见问题
6. 总结

一、PPT Master 项目介绍

1.1 什么是 PPT Master？

PPT Master 是一款AI 驱动的多角色协作演示文稿生成系统，通过多角色协作（Strategist → Image_Generator → Executor），将源文档（PDF/DOCX/URL/Markdown）转换为原生可编辑的 PPTX 文件（基于真正的 PowerPoint 形状 DrawingML）。

• GitHub 项目：https://github.com/hugohe3/ppt-master |
  

• 📄 多源输入：支持 PDF、Word、EPUB、网页链接、Markdown、纯文本描述
• 🎨 10 种画布格式：PPT 16:9/4:3、小红书、微信朋友圈、Instagram Story 等
• 🎭 3 种执行器风格：通用灵活、咨询顾问、顶级咨询（MBB 级）
• 🤖 AI 智能配图：集成火山豆包 API，自动生成极简风格配图
• 📝 演讲者笔记：自动生成完整的演讲脚本

1.2 支持的画布格式

1.3 20+ 预置模板

系统内置 20+ 模板，分为五大类：

二、从 0 到 1 安装流程

2.1 方式 A：命令行完整部署 SOP

# 1. 临时注入网络代理，防止 GitHub 拉取超时export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897echo "✅ 代理已临时注入"# 2. 进入项目目录（没有则自动创建）mkdir -p ~/AI_Projects && cd ~/AI_Projectspwd  # 确认路径：/Users/xxx/AI_Projects# 3. 克隆官方源码git clone https://github.com/hugohe3/ppt-master.gitcd ppt-master# 4. 克隆成功后清理代理，防止污染后续环境unset https_proxy http_proxy all_proxyecho "✅ 代理已清理，源码拉取完成"

✅ 看到项目目录结构：ppt-master/├── README_CN.md├── CLAUDE.md├── requirements.txt├── scripts/└── ...

# 1. 静默读取项目文档cat README_CN.md | head -50  # 快速浏览项目说明cat CLAUDE.md  # 专为 AI 助手准备的部署指南# 2. 确认 Python 版本要求（需要 3.8+）python3 --version  # 建议：Python 3.10+# 3. 创建虚拟环境（推荐使用 uv，速度更快）# 方式 A：使用 uv（推荐）uv venv --python 3.10source .venv/bin/activate# 方式 B：使用 python3 -m venvpython3 -m venv .venvsource .venv/bin/activate# 4. 安装所有依赖pip install -r requirements.txt# 如遇权限问题，添加 --user 参数pip install -r requirements.txt --user

✅ 虚拟环境已激活（命令行前缀显示 (.venv)）✅ pip list 显示所有依赖已安装✅ 无红色报错信息

# 1. 检查 .env 配置文件ls -la .env*  # 查看是否有 .env.example 模板# 2. 生成 .env 文件cp .env.example .env# 或手动创建cat > .env << 'EOF'# 火山豆包 API（用于 AI 配图）DOUBAO_API_KEY=your_api_key_here# Tavily Search API（用于网络搜索）TAVILY_API_KEY=tvly-dev-xxxxxxxxxxxxxxxxx# 大模型 API（根据需求选择配置）OPENAI_API_KEY=sk-xxxGEMINI_API_KEY=xxxQWEN_API_KEY=sk-xxxEOF

✅ .env 文件已创建✅ API Key 已填入（至少配置一个大模型 API）

# 1. 验证项目结构ls -la ~/AI_Projects/ppt-master/# 2. 验证脚本可执行性python3 scripts/project_manager.py --help# 3. 测试依赖导入python3 -c "import pptx; import pandas; import PIL; print('✅ 所有依赖正常')"

✅ 所有依赖正常usage: project_manager.py [-h] {init,import-sources,build} ...PPT Master Project Manager

2.2 方式 B：配置为 Claude Code Skill（推荐小白）

完成方式 A 部署后，PPT Master 已经可以独立运行。接下来，只需要一句话，就能把它变成 Claude Code 的 Skill，以后就可以通过对话直接调用。

第一步：让 Claude Code 自动创建 Skill

在 Claude Code 中输入以下命令：

帮我创建一个 PPT 生成的 Skill，调用路径是 ~/AI_Projects/ppt-master/scripts/project_manager.py

Claude Code 会自动帮你：

1. 创建 ~/.claude/skills/ppt-auto-gen/ 文件夹
2. 生成 SKILL.md 配置文件
3. 创建调用脚本 ppt-auto-gen.sh
4. 配置触发关键词

✅ Skill 创建完成✅ 路径已配置：~/AI_Projects/ppt-master

第二步：调用 Skill 生成 PPT

创建好后，以后做任何 PPT 只需要一句话：

使用 Skill: ppt-auto-gen

"帮我生成一份关于 AI 趋势的高质量 PPT""制作一份产品介绍演示文稿""create a presentation about market analysis"

2.3 使用方式对比

方式 A 部署 → 方式 B 配置（一句话） → 日常使用方式 B 触发

三、实操案例：小红书风格 AI 工具分享 PPT和 AI 趋势分析 PPT

4.1 案例背景