这份详细的部署教程将指引您安装和使用 PPT Master——一个AI驱动的工具，能将您的文档或主题直接转化为原生、可编辑的 PowerPoint (.pptx) 演示文稿。

PPT Master 的核心优势在于，它生成的不仅仅是静态的图片，而是包含原生形状、过渡动画、数据图表、表格、演讲者备注，甚至支持使用您自己的 .pptx 模板的真实 PowerPoint 文件。

🔧 系统要求与准备

在开始之前，请确保您的环境满足以下条件：

  1. 操作系统：macOS、Linux 或 Windows。
  2. Python 3.10+：这是唯一需要您手动安装的软件。从 python.org 下载安装。
    • macOS/Linux：通常已预装或可通过包管理器安装 (brew install python)。
    • Windows：请务必在安装时勾选“Add Python to PATH”。详细步骤可参考 Windows 安装指南。

📥 安装 PPT Master

你可以通过两种方式获取 PPT Master。

方式一：通过 Git 克隆（推荐）

此方式方便后续更新。

1
2
3
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

方式二：下载 ZIP 压缩包

无需 Git，适合快速试用。

  1. 访问 GitHub 页面，点击 Code → Download ZIP。

  2. 解压下载的文件，进入 ppt-master 文件夹。

  3. 在终端中打开该文件夹，运行依赖安装命令：

    1
    pip install -r requirements.txt

🤖 选择并配置你的 AI 代理

PPT Master 本身是一个工作流程（skill），需要在一个具备代理能力 (agent-capable) 的 AI 工具中运行，例如 Cursor、Claude Code、GitHub Copilot 等。你可以从下表中任选一个你熟悉或方便获取的工具。

类型 示例工具 备注
IDE 内置代理 Cursor, Trae, Windsurf, VS Code 编辑器自带 AI 助手
IDE 插件/扩展 Claude Code (VS Code/JetBrains), GitHub Copilot, Cline 安装在 VS Code 等宿主中
命令行代理 Claude Code CLI, Codex CLI, Gemini CLI 在终端中运行

模型推荐：为获得最佳效果，推荐使用 Kimi K3 或 Claude 等具有大上下文窗口（约1M tokens）的强大模型。你没有这些模型密钥？项目赞助商 PackyCode、APIKEY.FUN 和 RunAPI 提供按需付费的 API 访问，新用户有专属优惠。

🚀 首次运行：生成你的第一份 PPT

  1. 打开项目：用你选择的 AI 工具（如 Cursor）打开 ppt-master 文件夹。

  2. 准备素材：将你的源文件（PDF、DOCX、图片等）复制到项目根目录下的 projects/ 文件夹中。

  3. 在聊天中下达指令：在 AI 工具的聊天面板中，直接告诉它你的需求。最直接的方式是将文件拖入聊天窗口。

    1
    请根据 projects/我的报告/report.pdf 生成一份 PPT。

    • 或直接粘贴内容：

      1
      请将以下内容转化为一份 PPT：[粘贴你的文本内容...]

  4. AI 工作流：AI 代理会按以下步骤自动处理：

    • 确认设计规格：默认会先与您确认页数、设计风格、是否使用模板等。
    • 分析与规划：分析源材料，规划演示文稿结构和叙事逻辑。
    • 生成内容与设计：撰写每页的文字内容、设计布局，并生成对应的 SVG 图形。
    • 导出 PPTX：最后，它会将生成的 SVG 转换为一个原生 .pptx 文件，保存在 exports/ 文件夹中。

快速生成模式：如果你不想经过确认步骤，可以一开始就明确指令：

1
快速生成一份5页的 PPT，内容来自 projects/我的报告/report.pdf，无需确认。

此模式下，AI 会直接生成最终 PPT。

📝 核心功能与使用技巧

  • 使用自己的PPT模板：如果你有设计好的 .pptx 模板，可以告知AI：“请根据这个模板，填充 projects/新报告.pdf 的内容”。AI 会尽力保留模板设计，替换内容。
  • 添加过渡动画和备注：你可以在生成时或生成后要求AI为幻灯片添加过渡动画或演讲者备注。
  • 生成数据图表和表格：如果源材料中包含数据，AI 可以生成原生的 PowerPoint 图表和表格，你之后可以在 PowerPoint 中直接编辑数据。
  • 获取网络或AI生成的图片：
    • AI 生图：如果配置了如 gpt-image-2 的生图API，AI 可生成封面等关键图片。
    • 网络搜索：配置免费的 PEXELS_API_KEY 或 PIXABAY_API_KEY，AI 可从网络搜索高质量图片。
    • 配置方法：在项目根目录下创建 .env 文件（可复制 .env.example），填入你的API密钥。

🔄 更新与帮助

  • 更新（Git 克隆方式）：

    1
    python3 skills/ppt-master/scripts/update_repo.py

  • 遇到问题？：

    • 首先查阅项目 FAQ，其中包含模型选择、布局、导出等常见问题。
    • 如果AI失去上下文，可以在聊天中要求它阅读 skills/ppt-master/SKILL.md 文件以重新加载规则。
    • 你可以在 GitHub Issues 报告问题。

总结：PPT Master 的核心是“用AI生成可编辑的PPT文件”。你只需要准备 Python 环境、一个 AI 编码工具和你的源材料，然后在聊天中下达指令即可。