PPT Master 完整教學 — AI 生成原生可編輯 PowerPoint

從「一份文件」到「一副完整投影片」的端到端 AI 工作流

1. 專案定位

1.1 PPT Master 是什麼

PPT Master 是一個開源的 AI 簡報生成 skill（GitHub 31K+ stars），讓你透過 AI IDE（如 Claude Code、Cursor、VS Code Copilot）對話式地將任何文件轉換為真正可編輯的 PowerPoint。

一句話定位： harness + model = agent — PPT Master 是 harness（工作流骨架），AI 模型是引擎。用最好的模型（Claude Opus + gpt-image-2）能產出最高品質的結果。

1.2 與其他 AI 簡報工具的差異

1.3 核心價值

graph LR
    A["你的文件
PDF / DOCX / 文字 / 圖片"] --> B["PPT Master
AI 工作流"]
    B --> C["真正的 .pptx
原生形狀
可編輯
可動畫
有語音旁白"]

    subgraph "PPT Master 的 4 大保證"
        D1["Real PowerPoint
每個元素可點擊編輯"]
        D2["資料本地化
除 AI API 外全本機"]
        D3["透明成本
開源免費 + AI 用量計費"]
        D4["無鎖定
多 IDE + 多模型支援"]
    end

    C --> D1
    C --> D2
    C --> D3
    C --> D4

    style B fill:#E3F2FD,stroke:#1565C0
    style C fill:#C8E6C9,stroke:#2E7D32

2. 安裝指南

2.1 前置需求

2.2 安裝步驟

方法 A — Git Clone（推薦）：

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

方法 B — ZIP 下載：

GitHub 頁面 → Code → Download ZIP → 解壓 → pip install -r requirements.txt

方法 C — Skill Marketplace：

1# 跨 agent CLI 安裝
2npx skills add hugohe3/ppt-master
3
4# 或在 Claude Code 內
5/plugin marketplace add hugohe3/ppt-master
6/plugin install ppt-master@ppt-master

安裝後仍需 pip install -r requirements.txt。

2.3 圖片生成設定（選配但推薦）

複製 .env.example 並設定 API Key：

1cp .env.example .env
2# 編輯 .env，設定 IMAGE_BACKEND 和對應的 API Key

支援的圖片生成後端（15+）：

1# 列出所有可用後端
2python3 skills/ppt-master/scripts/image_gen.py --list-backends

2.4 語音旁白設定（選配）

PPT Master 可將 speaker notes 轉為語音旁白。預設使用 edge-tts（免費、無需 API Key）。

高品質語音可選：

• ElevenLabs（ELEVENLABS_API_KEY）
• MiniMax TTS（MINIMAX_API_KEY）
• 通義 TTS（QWEN_API_KEY）
• CosyVoice（COSYVOICE_API_KEY）

所有四家都支援 voice cloning（聲音複刻）。

3. 核心架構解析

3.1 工作流全景圖

PPT Master 的核心是一個分階段的 AI 工作流，每個階段產出明確的中間產物：

graph TB
    subgraph "輸入"
        IN["PDF / DOCX / 文字 / 圖片
或直接貼內容到對話"]
    end

    subgraph "Phase 1：內容處理"
        P1["Source Content Processing
文件 → Markdown"]
    end

    subgraph "Phase 2：專案初始化"
        P2A["建立 projects/ 資料夾"]
        P2B["選擇模板或自由設計"]
        P2C["設定格式（16:9 / 4:3 等）"]
    end

    subgraph "Phase 3：策略師（Strategist）"
        P3A["design_spec.md
設計規格書"]
        P3B["spec_lock.md
鎖定版規格"]
        P3C["使用者確認設計"]
    end

    subgraph "Phase 4：圖片取得（條件性）"
        P4A["AI 生成
image_gen.py"]
        P4B["網路搜尋
image_search.py"]
    end

    subgraph "Phase 5：執行器（Executor）"
        P5A["SVG 繪製
每頁一個 SVG"]
        P5B["品質檢查
svg_quality_checker.py"]
    end

    subgraph "Phase 6：後處理與匯出"
        P6A["SVG → PPTX
svg_to_pptx.py"]
        P6B["動畫注入
pptx_animations.py"]
        P6C["語音旁白
notes_to_audio.py"]
    end

    subgraph "輸出"
        OUT["exports/.pptx
原生可編輯 PowerPoint"]
    end

    IN --> P1 --> P2A
    P2A --> P2B --> P2C --> P3A
    P3A --> P3B --> P3C --> P4A
    P3C --> P4B
    P4A --> P5A
    P4B --> P5A
    P5A --> P5B --> P6A
    P6A --> P6B --> P6C --> OUT

    style P3A fill:#FFF3E0,stroke:#E65100
    style P5A fill:#E3F2FD,stroke:#1565C0
    style P6A fill:#C8E6C9,stroke:#2E7D32
    style OUT fill:#C8E6C9,stroke:#2E7D32

3.2 關鍵路徑

3.3 核心腳本清單

4. 使用方式詳細說明

4.1 基本使用（最簡單）

在 AI IDE 的對話面板中輸入：

1你：請根據 projects/q3-report/sources/report.pdf 做一份 PPT

或直接貼內容：

1你：請將以下內容做成 PPT：[貼上你的文字...]

AI 會先確認設計規格：

1AI：收到。確認設計規格：
2    [模板] B) 自由設計
3    [格式] PPT 16:9
4    [頁數] 8-10 頁
5    ...

4.2 使用自有模板

如果你有現成的 .pptx 模板想複用：

1你：用 projects/my-template.pptx 這個模板，幫我把新內容填進去

AI 會使用 template-fill 工作流，保留模板設計、只替換內容。

4.3 進階：AI 圖片生成

在 .env 設定好 API Key 後，AI 會在策略師階段產出 image_queries.json，然後自動呼叫 image_gen.py 批次生成：

1# 手動執行（通常 AI 自動處理）
2python3 skills/ppt-master/scripts/image_gen.py \
3  --manifest projects/my-deck/image_queries.json \
4  --out projects/my-deck/images/

4.4 進階：語音旁白

1# 從 .pptx 的 speaker notes 生成語音
2python3 skills/ppt-master/scripts/notes_to_audio.py \
3  exports/my-deck.pptx \
4  --lang zh-CN \
5  --voice zh-CN-XiaoxiaoNeural

支援 5 個 TTS 後端：edge-tts（預設免費）、ElevenLabs、MiniMax、Qwen、CosyVoice。所有後端都支援 voice cloning。

4.5 更新 PPT Master

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

5. 應用場景

場景 1：會議報告 → 投影片

輸入： 一份 20 頁的 Q3 財務報告 PDF 指令： 「幫我從這份報告做一份 12 頁的摘要投影片」 輸出： 12 頁原生可編輯 PPTX，含圖表、文字方塊、自動配色

場景 2：學術論文 → 簡報

輸入： 一篇 Attention Is All You Need 論文 指令： 「做一份 8 頁的技術簡報」 輸出： 含 AI 生成示意圖、公式渲染、speaker notes 語音旁白的完整投影片

場景 3：品牌模板 → 批次填入

輸入： 公司既有 .pptx 模板 + 新季度數據 指令： 「用這個模板，把新內容填進去」 輸出： 保留品牌設計、更新內容的 PPTX

場景 4：多格式輸出

PPT Master 支援 10+ 種畫布格式：

6. 資安掃描報告

6.1 掃描範圍

掃描 skills/ppt-master/scripts/ 目錄下所有 Python 腳本（120+ 個 .py 檔案，15,000+ 行程式碼），針對以下 pattern：eval / exec / subprocess / requests / api_key / __import__ / urlopen

6.2 掃描結果

6.3 總體評估

🟢 低風險 — 程式碼品質高、安全意識良好。API Key 管理規範、無硬編碼機密、動態匯入受控。MIT 授權，活躍維護（每日 commit）。

7. FAQ

Q1：需要什麼 AI 模型？

推薦： Claude Opus（~1M tokens context）+ gpt-image-2 圖片生成。Gemini 3.5 Flash 性價比最佳。其他模型（GPT、Kimi 等）可用但品質有差。

Q2：免費嗎？

工具本身免費開源（MIT）。唯一成本是 AI 模型使用費（按用量計費）。

Q3：支援中文嗎？

完全支援。有中文 README（README_CN.md），社群活躍的中文 Issues 討論。

Q4：產出的 PPTX 需要什麼版本的 Office？

Office 2016+ 或 Microsoft 365。LibreOffice 可開啟但部分動畫/字體可能不同。

Q5：能用自己的模板嗎？

可以。使用 template-fill 工作流，AI 會分析你的模板結構，只替換內容、保留設計。

Q6：一份投影片大概要花多少 AI token？

根據複雜度，約 50K-200K tokens。用 Claude Opus 大約 $1-5 USD / 份。

8. 進階技巧

8.1 批次驗證 SVG 品質

1python3 skills/ppt-master/scripts/batch_validate.py projects/my-deck/svg_output/

8.2 SVG 編輯器（即時預覽）

1python3 skills/ppt-master/scripts/svg_editor/server.py

在瀏覽器中即時預覽和微調 SVG 佈局。

8.3 圖片旋轉 / 裁切

1python3 skills/ppt-master/scripts/rotate_images.py --help

8.4 註冊自訂模板

1python3 skills/ppt-master/scripts/register_template.py my-template.pptx

8.5 動畫配置

修改 animations.json 可自訂進場動畫和投影片轉場效果。

9. 整合進其他工作流

9.1 與 AIKT 的整合可能

PPT Master 可以作為 AIKT 系統的補充工具：

9.2 CI/CD 整合

PPT Master 的腳本都是獨立可執行的 Python CLI，可嵌入自動化管線：

1# 範例：從 markdown 批次生成投影片
2for md in reports/*.md; do
3  python3 skills/ppt-master/scripts/source_to_md/doc_to_md.py "$md"
4  # ... 接 AI 生成 → SVG → PPTX
5done

10. 重點摘要 Checklist

• 是什麼： AI 驅動的原生可編輯 PowerPoint 生成工具（31K+ stars）
• 核心差異： 產出 DrawingML 原生形狀（非圖片），可逐元素編輯
• 安裝： Python 3.10+ → pip install -r requirements.txt → 完成
• 使用： 在 AI IDE 中對話式操作，放入文件即可
• 模型： Claude Opus + gpt-image-2 品質最佳；Gemini 3.5 Flash 性價比最佳
• 圖片： 支援 15+ AI 生成後端 + 4 個網路搜尋來源
• 語音： 5 個 TTS 後端（含 voice cloning）
• 模板： 支援自有 .pptx 模板的 fill 模式
• 格式： 10+ 畫布格式（16:9 / 4:3 / 小紅書 / 微信等）
• 安全： 🟢 低風險，API Key 管理規範
• 授權： MIT，商用自由

11. 進一步閱讀