这份详细的部署教程将指引您安装和使用 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 等。你可以从下表中任选一个你熟悉或方便获取的工具。

| 类型 | 示例工具 | 备注 |
| :