PPT Master 教學手冊

企業 AI 簡報平台建置手冊 — 從 Prompt 到原生可編輯 PowerPoint 的完整實戰指南

基於 PPT Master v2.11.0 ｜ 最後更新：2026-06-30 ｜ GitHub Stars: 34.4k+

📋 目錄 (Table of Contents)

第一部分：基礎概念與架構

1. PPT Master 介紹
2. PPT Master 系統架構
3. 核心技術解析
4. SVG → DrawingML 原理
5. PPT Master 工作流程

第二部分：AI Agent 與安裝設定

6. AI Agent Skill
7. 安裝教學
8. 系統設定

第三部分：模板與 Prompt 工程

9. Template 使用
10. Prompt Engineering
11. 文件來源
12. Speaker Notes

第四部分：AI 模型與 IDE 整合

13. AI 模型支援
14. 與 Claude Code 整合
15. 與 GitHub Copilot 整合
16. 與 Cursor 整合
17. 與 MCP 整合

第五部分：進階應用

18. 與企業知識庫整合
19. 實戰案例
20. Mermaid 圖集
21. 常用 Prompt 範例

第六部分：最佳實務與效能

22. 最佳實務
23. 效能最佳化

第七部分：維運管理

24. 系統維護
25. 系統升級

第八部分：FAQ、疑難排解與參考

26. 常見問題 FAQ
27. Troubleshooting
28. 與其他工具比較

第九部分：企業導入與未來發展

29. 企業導入建議
30. 適用 SSDLC
31. 未來發展

附錄

• 檢查清單 (Checklist)

📖 文件說明

🎯 文件目標

本手冊將 PPT Master 定位為企業 AI 簡報生成平台，涵蓋以下核心能力：

1. AI 原生簡報生成 — 透過自然語言 Prompt 產出 100% 原生可編輯的 PowerPoint 檔案
2. 多來源文件轉換 — 支援 PDF、Word、Excel、網頁、Markdown 等多種格式轉為專業簡報
3. 企業品牌治理 — 透過模板系統確保所有簡報符合企業品牌識別
4. 多 AI 平台整合 — 無縫整合 Claude Code、GitHub Copilot、Cursor、Gemini CLI 等主流 AI 開發環境
5. 演講自動化 — 自動生成 Speaker Notes 並轉換為語音旁白

🎯 適用對象

第1章 PPT Master 介紹

1.1 發展背景

PPT Master 由金融領域從業者 Hugo He（具備 CPA、CPV、諮詢工程師背景）創建並持續維護。截至 2026 年 6 月，專案在 GitHub 上已獲得 34,400+ Stars、2,900+ Forks，最新穩定版本為 v2.11.0，累計發布 9 個版本，擁有 16 位貢獻者。專案以 MIT 授權 開源，主要語言為 Python（85.9%）。

作為一位每天需要製作投融資簡報的專業人士，Hugo He 深刻體會到傳統 AI 簡報工具的痛點：生成的投影片無法在 PowerPoint 中逐元素編輯。

現有的 AI 簡報工具大致分為四類：

📊 專案數據（2026-06）：GitHub Stars 34.4k ｜ Forks 2.9k ｜ 最新版本 v2.11.0 ｜ 授權 MIT ｜ 16 位貢獻者 ｜ Python 85.9%

1.2 解決什麼問題

PPT Master 解決了 AI 簡報生成領域的核心矛盾：

• 問題一：AI 生成的簡報是「圖片」而非「物件」，無法修改文字、調整顏色
• 問題二：企業簡報需要反覆微調，純 AI 生成無法滿足最後一哩路
• 問題三：現有工具與 AI IDE（Claude Code / Cursor / VS Code + Copilot / Gemini CLI）缺乏原生整合
• 問題四：企業品牌識別（Logo、色彩、字型）難以在 AI 簡報中統一
• 問題五：企業資料安全——多數 SaaS 工具需將文件上傳至第三方伺服器

1.3 核心理念

PPT Master 的設計哲學可以用一個公式概括：

harness + model = agent

• harness（駕馭工具）：PPT Master 本身，負責工作流程管理、SVG 轉換、品質控制
• model（AI 模型）：Claude / GPT / Gemini 等，負責內容理解與視覺設計
• agent（完整代理）：兩者結合形成完整的簡報生成代理

📌 重要觀念：PPT Master 不是「許願池」。AI 負責產出高品質設計初稿（消除 90% 的空白頁工作），最後的打磨由使用者在 PowerPoint 中完成。工具的天花板等於使用者的天花板。

1.4 設計思想

1.5 適合哪些情境

✅ 適合：

• 需要在 PowerPoint 中微調的商務簡報
• 將大量文件（PDF / Word / Excel / PPTX / 網頁）快速轉為簡報
• 企業品牌一致性要求高的場景
• AI 開發者想在 IDE 中直接生成簡報
• 需要自動生成 Speaker Notes 和語音旁白
• 資料安全敏感場景（金融、政府、法規遵循）
• 需要產出社群媒體內容（小紅書 3:4、IG 1:1、Story 9:16）

❌ 不適合：

• 需要即時協作的線上簡報（建議使用 Google Slides）
• 僅需簡單文字投影片（過度殺傷力）
• 無 AI 模型 API 預算的場景
• 需要零設定、瀏覽器即開即用的體驗（建議使用 Gamma / Canva）

1.6 適合哪些企業

• 金融業（投融資簡報、年度報告、董事會簡報）
• 科技業（技術簡報、架構設計、產品介紹）
• 顧問業（提案簡報、專案報告）
• 教育機構（教育訓練、課程教材）
• 任何需要大量製作 PowerPoint 的組織

1.7 適合哪些人

• AI 工程師與開發者（在 IDE 中直接生成）
• PM / SA / 架構師（將需求文件轉為簡報）
• 業務 / 行銷人員（快速產出提案與產品介紹）
• 主管層（年度報告、策略簡報）

⚠️ 注意事項：PPT Master 是 AI Skill，不是獨立應用程式。它需要在 AI IDE（如 Claude Code、Cursor、VS Code + Copilot）中運行。

第2章 PPT Master 系統架構

2.1 整體架構概覽

PPT Master 採用三階段管線架構，將簡報生成拆解為內容理解、視覺設計、工程轉換三個階段：

graph TB
    subgraph "Stage 1：內容理解與設計規劃"
        A[來源文件<br/>PDF / DOCX / XLSX / URL / MD] --> B[Source Content Conversion<br/>source_to_md 腳本]
        B --> C[Markdown 正規化<br/>content contract]
        C --> D[Project Manager<br/>project_manager.py init]
        D --> E[Template 選項<br/>brand / layout / deck]
        E --> F[Strategist 角色<br/>八項確認]
        F --> G[design_spec.md + spec_lock.md]
    end

    subgraph "Stage 2：AI 視覺生成"
        G --> H[Image Acquisition<br/>AI 生成 / 網路搜尋]
        H --> I[Executor 角色<br/>逐頁生成 SVG]
        I --> J[svg_output/<br/>手寫 SVG 檔案]
        J --> K[SVG Quality Checker<br/>品質檢查]
    end

    subgraph "Stage 3：工程轉換"
        K --> L[total_md_split.py<br/>分離 Speaker Notes]
        L --> M[finalize_svg.py<br/>SVG 後處理]
        M --> N[svg_to_pptx.py<br/>DrawingML 轉換]
        N --> O[exports/*.pptx<br/>原生可編輯 PowerPoint]
    end

    style A fill:#e1f5fe
    style O fill:#c8e6c9
    style F fill:#fff3e0
    style I fill:#fff3e0

2.2 角色系統

PPT Master 採用單一代理角色切換模式，而非平行子代理：

📌 為何不使用子代理？ 頁面設計依賴完整的上游上下文（前頁色彩、圖示風格、排版節奏），子代理會以過時的上下文快照開始工作，導致視覺一致性快速退化。

2.3 Spec 傳播機制

PPT Master 使用雙文件機制確保設計一致性：

抗漂移機制：SKILL.md 強制 Executor 在生成每一頁前重新讀取 spec_lock.md，確保色彩值、字型大小等在 20+ 頁中保持逐字一致。

2.4 執行紀律（十條強制規則）

2.5 即時預覽架構（Live Preview）

PPT Master 提供基於 localhost:5050 的即時預覽介面，在生成過程中即可查看與編輯：

操作方式：

• 點選元素 → 側邊面板修改屬性 → 點擊 Apply changes 寫入 svg_output/
• 或點選元素 → 輸入注解 → 點擊 Submit annotations → 在 Chat 中說「apply my annotations」
• Ctrl+Z 支援復原

💡 實務說明：即時預覽不是完整的自由畫布（如 Gamma / Canva），不提供拖曳縮放控制點，且重新匯出 PPTX 仍需透過 Chat 觸發。此功能基於社群貢獻者 @WodenJay 的 PR #85 建構。

第3章 核心技術解析

3.1 技術堆疊關係

PPT Master 的核心技術堆疊涉及多個層次的格式轉換：

graph LR
    subgraph "AI 層"
        A[AI Model<br/>Claude / GPT / Gemini]
    end

    subgraph "中間格式層"
        B[SVG<br/>Scalable Vector Graphics]
    end

    subgraph "Office 層"
        C[DrawingML<br/>Office 繪圖標記語言]
        D[Open XML<br/>OOXML 封裝格式]
        E[PPTX<br/>PowerPoint 檔案]
    end

    subgraph "展示層"
        F[PowerPoint<br/>桌面 / Web / Mobile]
    end

    A -->|生成| B
    B -->|轉換| C
    C -->|封裝| D
    D -->|壓縮| E
    E -->|開啟| F

    style B fill:#fff3e0
    style C fill:#e8eaf6

3.2 SVG（Scalable Vector Graphics）

SVG 是 W3C 標準的 XML 向量圖形格式，在 PPT Master 中作為中間格式（pivot format）：

3.3 DrawingML

DrawingML 是 Microsoft Office 的原生繪圖標記語言，屬於 OOXML 標準的一部分：

3.4 SVG → DrawingML 元素映射

3.5 座標系統與單位轉換

SVG 世界：像素（px），原點左上角
  viewBox="0 0 1280 720"  → 16:9 畫布

DrawingML 世界：EMU（English Metric Unit）
  標準投影片：12192000 × 6858000 EMU

轉換公式：
  EMU = px × 9525
  pt  = px × 0.75（字型大小）

3.6 PowerPoint 原生物件

PPT Master 生成的每個元素都是 PowerPoint 原生物件：

• Native Shape（原生形狀）：矩形、圓形、箭頭等可直接拖曳調整
• Native Text（原生文字）：文字框可直接點擊編輯、變更字型
• Gradient（漸層）：線性 / 放射漸層可在格式面板調整
• Path（路徑）：自訂曲線可編輯控制點
• Shadow（陰影）：Office 原生陰影效果
• Absolute Position（絕對定位）：每個元素都有精確的座標位置

💡 實務建議：由於每個元素都是原生物件，你可以在 PowerPoint 中對任何元素執行「右鍵 → 編輯圖案」來微調形狀。

第4章 SVG → DrawingML 原理

4.1 為什麼選擇 SVG 作為中間格式？

PPT Master 團隊經過嚴格的排除法選定 SVG：

4.2 轉換流程

flowchart TD
    A[AI 模型] -->|手寫 SVG 程式碼| B[svg_output/*.svg]
    B --> C{SVG Quality Checker}
    C -->|通過| D[finalize_svg.py]
    C -->|失敗| A
    D -->|Base64 圖片內嵌<br/>viewBox 標準化| E[svg_final/*.svg]
    E --> F[svg_to_pptx.py]

    subgraph "DrawingML 轉換引擎"
        F --> G[drawingml_converter.py<br/>主轉換器]
        G --> H[drawingml_elements.py<br/>元素轉換器]
        G --> I[drawingml_paths.py<br/>路徑指令解析]
        G --> J[drawingml_styles.py<br/>樣式生成器]
        G --> K[drawingml_utils.py<br/>座標 / 色彩工具]
    end

    H --> L[python-pptx<br/>PPTX 封裝]
    I --> L
    J --> L
    K --> L
    L --> M[exports/*.pptx<br/>原生可編輯 PowerPoint]

    style A fill:#e1f5fe
    style M fill:#c8e6c9

4.3 轉換引擎架構

轉換引擎位於 skills/ppt-master/scripts/svg_to_pptx/ 目錄下：

4.4 可編輯性保證

PPT Master 確保可編輯性的機制：

1. 逐元素分派：每種 SVG 元素有專門的 translator，非整檔翻譯
2. Office 相容模式：預設為 2019 前版本生成 PNG fallback
3. 原生形狀優先：<rect> 優先映射為 <a:prstGeom prst="rect"> 而非自訂幾何
4. 文字框獨立：每個 <text> 生成獨立的 <p:sp> 形狀，可個別編輯

4.5 SVG 限制（黑名單機制）

DrawingML 是 SVG 表達力的嚴格子集。以下 SVG 特性在 PPT Master 中被禁用：

有條件允許：

• marker-start / marker-end：僅用於箭頭
• clip-path：僅用於 <image> 裁切

⚠️ 常見錯誤：在 SVG 中使用 CSS class 定義樣式會導致轉換後所有樣式遺失。務必使用行內樣式（inline style）。

第5章 PPT Master 工作流程

5.1 完整七步驟工作流

flowchart TD
    S1["Step 1：來源內容處理<br/>🔄 自動"] --> S2["Step 2：專案初始化<br/>🔄 自動"]
    S2 --> S3["Step 3：模板選項<br/>⏭️ 預設跳過"]
    S3 --> S4["Step 4：Strategist 階段<br/>⛔ BLOCKING — 八項確認"]
    S4 --> S5["Step 5：圖像獲取<br/>📷 條件性"]
    S5 --> S6["Step 6：Executor 階段<br/>🎨 逐頁生成 SVG"]
    S6 --> S7["Step 7：後處理 & 匯出<br/>📦 自動"]

    S4 -.->|使用者確認| S5

    style S4 fill:#ffcdd2
    style S7 fill:#c8e6c9

5.2 各步驟詳細說明

Step 1：來源內容處理

將輸入文件轉換為統一的 Markdown 格式：

# PDF → Markdown
python scripts/source_to_md/pdf_to_md.py input.pdf

# Word → Markdown
python scripts/source_to_md/doc_to_md.py input.docx

# Excel → Markdown
python scripts/source_to_md/excel_to_md.py input.xlsx

# 網頁 → Markdown
python scripts/source_to_md/web_to_md.py "https://example.com"

# 現有 PPTX → Markdown
python scripts/source_to_md/ppt_to_md.py input.pptx

Step 2：專案初始化

python scripts/project_manager.py init --name "我的簡報"

產出專案結構：

projects/my_presentation/
├── source/          # 來源文件
├── analysis/        # 結構分析
├── svg_output/      # SVG 輸出
├── svg_final/       # SVG 最終版
├── exports/         # PPTX 輸出
├── backup/          # 備份
├── design_spec.md   # 設計規格
└── spec_lock.md     # 執行合約

Step 3：模板選項（Opt-in）

預設跳過，僅在使用者明確提供模板目錄路徑時觸發。

Step 4：Strategist 八項確認（BLOCKING）

Strategist 會與使用者確認以下八項設計決策：

1. 投影片數量與結構
2. 視覺風格（Visual Style）
3. 敘事模式（Narrative Mode）
4. 色彩方案（Color Palette）
5. 字型選擇
6. 圖示風格與圖示庫
7. 圖片策略
8. 畫布格式

Step 5：圖像獲取

• AI 圖像生成（gpt-image-2 / Gemini / FLUX）
• 網路圖片搜尋（Openverse / Pexels / Pixabay）
• 圖片切片（slice_images.py）

Step 6：Executor 逐頁生成 SVG

每頁的生成流程：

1. 讀取 spec_lock.md（抗漂移）
2. 參考前頁設計上下文
3. 手寫 SVG 程式碼至 svg_output/
4. 執行品質檢查
5. 記錄 Speaker Notes

Step 7：後處理與匯出

# 分離 Speaker Notes
python scripts/total_md_split.py

# SVG 最終化（Base64 內嵌、viewBox 標準化）
python scripts/finalize_svg.py

# DrawingML 轉換 → PPTX
python scripts/svg_to_pptx.py

5.3 五個產物

5.4 路由系統

PPT Master 根據不同輸入情境自動選擇工作流：

beautify-pptx 與主管線的區分法則

選擇 beautify 或主管線的關鍵判斷：來源簡報的頁面切割是要保留的資訊，還是只是前一位作者的結構而可以改善？

• 保留 → beautify：頁數、順序、每頁用詞完全保留，僅重新排版
• 改善 → 主管線：允許合併 / 分割 / 重新排序頁面

template-fill 工作流

當使用者已有完成的 .pptx 並希望保留其設計僅替換內容時：

1. 提供現有 .pptx + 新材料
2. AI 將簡報視為原生投影片庫
3. 使用者選擇適合的頁面（可重用、重新排序）
4. AI 將新文字、表格、圖表資料直接寫入原始 OOXML
5. 原始設計、版型、圖片、動畫完全保留

⚠️ 重要區分：template-fill 不會變更版型、新增頁面或替換圖片。如需全新結構或不同頁數，應使用 create-template 流程。

5.5 分割模式（Split Mode）

當信號顯示內容較重（≥ 18 頁、大量來源材料、或 topic-research 累積大量網路資料），AI 會在 Strategist 階段提示可選的分割模式：

分割模式犧牲約 6K tokens（重讀 SKILL.md）來釋放 60-200K 的 Phase A 上下文空間，讓 Phase B 有更多空間重讀 sources/ 產出更豐富的投影片內容。

📌 一般情況下不需要分割模式，10-15 頁簡報可輕鬆在 200K 上下文視窗內完成。

第6章 AI Agent Skill

6.1 什麼是 Skill？

在 AI Agent 架構中，Skill 是一組可被 AI 代理調用的工具與工作流程定義。PPT Master 以 Skill 形式發布，而非獨立應用程式。

AI IDE（Claude Code / Cursor / VS Code）
  ↓ 載入
Skill（PPT Master）
  ↓ 定義
工作流程 + 腳本 + 模板 + 參考文件
  ↓ 驅動
AI 模型執行簡報生成

6.2 SKILL.md 結構

PPT Master 的 SKILL.md（約 71.4 KB）是工作流程的權威文件：

skills/ppt-master/
├── SKILL.md              # 主工作流程定義（7 步驟）
├── references/           # 角色定義與技術規格
│   ├── strategist.md     # Strategist 角色定義
│   ├── executor-base.md  # Executor 角色定義
│   ├── shared-standards.md
│   ├── canvas-formats.md # 畫布格式規格
│   ├── animations.md
│   ├── image-layout-patterns.md
│   ├── modes/            # 敘事模式目錄
│   ├── visual-styles/    # 視覺風格目錄
│   ├── image-renderings/ # 圖片渲染風格
│   └── image-palettes/   # 圖片色彩調色盤
├── scripts/              # 可執行工具腳本
├── templates/            # 版面 / 圖表 / 圖示庫
│   ├── layouts/
│   ├── charts/           # 70+ 圖表模板
│   └── icons/            # 三個圖示庫
└── workflows/            # 獨立工作流程
    ├── routing.md
    ├── topic-research.md
    ├── template-fill-pptx.md
    ├── beautify-pptx.md
    └── ...（12+ 工作流程）

6.3 IDE 整合方式

6.4 Agent Workflow 範例

在 Claude Code 中生成簡報的典型對話：

使用者：請將這份 PDF 轉為 10 頁的技術簡報
Claude：[呼叫 pdf_to_md.py 轉換]
Claude：[初始化專案]
Claude：[Strategist 階段] 我建議以下設計方案：
         - 10 頁結構：封面 + 大綱 + 8 頁內容
         - 視覺風格：Corporate Modern
         - 色彩：深藍 #1a365d + 金色 #d4a843
         您確認嗎？
使用者：確認，但色彩改為公司的 #003366 + #FF6600
Claude：[更新 spec_lock.md]
Claude：[Executor 階段 — 逐頁生成 SVG]
Claude：[後處理 — 匯出 PPTX]
Claude：簡報已生成至 exports/tech_presentation_20260630.pptx

第7章 安裝教學

7.1 前置需求

7.2 三種安裝方式

方式 A：下載 ZIP（不需 Git）

1. 前往 https://github.com/hugohe3/ppt-master
2. 點擊 Code → Download ZIP
3. 解壓至工作目錄
4. 安裝依賴：

cd ppt-master
pip install -r requirements.txt

方式 B：Git Clone

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

方式 C：Skill 市場安裝（推薦）

# 跨 Agent CLI 安裝
npx skills add hugohe3/ppt-master

# 或在 Claude Code 中
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

7.3 各平台安裝指南

📎 完整 Windows 指南：PPT Master 提供專用的逐步式 Windows 安裝指南，涵蓋 PATH 設定、執行原則等細節：Windows Installation Guide

Windows

# 1. 安裝 Python（建議使用 Microsoft Store）
winget install Python.Python.3.12

# 2. 確認 Python 版本
python --version  # 須 >= 3.10

# 3. Clone 專案
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master

# 4. 安裝依賴
pip install -r requirements.txt

# 5. 驗證安裝
python -c "import pptx; print('python-pptx OK')"

⚠️ Windows 注意事項：可能需要設定 Set-ExecutionPolicy RemoteSigned 執行原則。詳見 Windows 安裝指南。

macOS

# 1. 安裝 Python
brew install python

# 2. Clone 與安裝
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

Linux（Ubuntu / Debian）

# 1. 安裝 Python
sudo apt update
sudo apt install python3 python3-pip python3-venv

# 2. Clone 與安裝
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

WSL

# 與 Linux 相同步驟
sudo apt install python3 python3-pip
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

7.4 IDE 安裝設定

Claude Code

# 方式一：Plugin 市場
/plugin install ppt-master@ppt-master

# 方式二：本地載入
cd ppt-master
claude  # 自動讀取 CLAUDE.md

VS Code + GitHub Copilot

1. 將 ppt-master/ 加入工作區
2. 確保 Copilot Agent Mode 已啟用
3. 在 Chat 中輸入：@workspace 請用 PPT Master 生成簡報

Cursor

1. 將 ppt-master/ 加入 Cursor 工作區
2. 開啟 Composer（Cmd+K / Ctrl+K）
3. 輸入簡報生成 Prompt

Gemini CLI

# 確保 Gemini CLI 已安裝
gemini --version

# 載入 PPT Master Skill
cd ppt-master
gemini  # 自動讀取 SKILL.md

7.5 安裝驗證

# 驗證 Python 依賴
python -c "
import pptx
import lxml
import PIL
print('✅ 所有核心依賴安裝成功')
"

# 驗證腳本可執行
python skills/ppt-master/scripts/project_manager.py --help

第8章 系統設定

8.1 環境變數

PPT Master 透過 .env 檔案管理設定，讀取順序：

1. 當前工作目錄 .env
2. 技能目錄 .env
3. Clone 根目錄 .env
4. ~/.ppt-master/.env

# .env 範例
# ─── AI 圖像生成 ───
IMAGE_BACKEND=gpt-image-2        # 推薦：gpt-image-2
OPENAI_API_KEY=sk-xxx            # OpenAI API Key

# ─── 圖片搜尋（選擇性，免費 API Key 可改善品質）───
PEXELS_API_KEY=xxx               # Pexels 免費 API
PIXABAY_API_KEY=xxx              # Pixabay 免費 API

# ─── 其他 AI 圖像後端（選擇性）───
GEMINI_API_KEY=xxx               # Google Gemini

8.2 畫布格式系統

PPT Master 支援多種畫布格式，不僅限於 PPT：

8.3 圖像後端設定

8.4 圖片搜尋設定

8.5 輸出設定

第9章 Template 使用

9.1 模板設計原則

PPT Master 的模板系統遵循以下原則：

• 預設為自由設計：不使用模板時，AI 擁有完全的設計自由度
• 模板是 Opt-in：只有明確提供模板目錄路徑才會觸發
• 機械觸發：裸名稱或風格描述不會觸發模板匹配
• 模板是地板也是天花板：使用模板會限制設計的上限

9.2 三種模板類型

9.3 企業品牌模板（brand）

品牌模板定義企業的視覺識別元素：

# Brand Template: ACME Corp

## Identity
- **Primary Color**: #003366
- **Secondary Color**: #FF6600
- **Accent Color**: #00A651
- **Font (Heading)**: Noto Sans TC Bold
- **Font (Body)**: Noto Sans TC Regular
- **Logo**: assets/acme_logo.png
- **Icon Style**: Outlined / Monochrome
- **Tone**: Professional / Authoritative

9.4 版面模板（layout）

版面模板定義頁面結構與排版方式：

# Layout Template: Technical Deck

## Structure
- **Canvas**: PPT 16:9
- **Page Types**: cover, toc, content, split, comparison, summary
- **Max Pages**: 15

## Page Type Definitions
### cover
- Full-width background
- Centered title
- Subtitle + Date

### content
- Left 60% content area
- Right 40% illustration area
- Bottom navigation bar

9.5 從現有 PPTX 建立模板

PPT Master 提供兩條不同的現有 PPTX 重用路徑：

create-template 三種複製模式

mirror 模式消費方式：mirror 模板不含 {{}} 占位符，Strategist 根據 design_spec.md §V Page Roster 描述為每個專案頁配對一個 mirror 頁，Executor 複製該 SVG 並直接對內容進行就地編輯——保留所有裝飾、裁切與幾何。

PPTX 導入管線

create-template 工作流使用 pptx_template_import.py 直接讀取 OOXML，擷取：

• 主題色彩、字型、每個 Master 的主題設定
• Master / Layout 結構、占位符元資料
• 可重用圖片資產
• 產出分層 svg/ 檢視 + svg-flat/ 平面預覽

⚠️ 回退方案：當無法提供原始 PPTX 時，可使用截圖集（cover.png / chapter.png / content.png / closing.png），但保真度會顯著下降。建議截圖僅作為 PPTX 的輔助說明，而非唯一參考。

模板簽證確認（Template Brief）

create-template 工作流在生成前強制確認以下項目：

確認後產出 [TEMPLATE_BRIEF_CONFIRMED] 標記，後續步驟才會執行。此為硬門檻機制。

9.6 模板目錄結構

PPT Master 的內建模板分為三個獨立目錄：

派生的模板目錄結構範例：

skills/ppt-master/templates/layouts/<your_template_id>/
├── design_spec.md          # 設計規格；§VI 列出每頁
├── 01_cover.svg
├── 02_chapter.svg
├── 02_toc.svg              # 選擇性
├── 03_content.svg
├── 03a_content_two_col.svg # fidelity 模式變體
├── 04_ending.svg
├── logo.png                # 品牌資產
└── bg_pattern.jpg

9.7 模板融合

PPT Master 支援多模板融合：

• brand + layout：brand 覆蓋 identity 段落，layout 覆蓋 structure 段落
• 同類衝突：以 Git merge 風格呈現給使用者選擇

💡 實務建議：建議企業先建立 brand 模板，再讓各部門自定 layout 模板。brand 確保品牌一致，layout 滿足不同場景需求。

第10章 Prompt Engineering

10.1 簡報 Prompt 撰寫原則

10.2 各情境 Prompt 指南

管理簡報

請根據以下季度業績數據，生成一份 12 頁的管理簡報：
- 受眾：CEO 與高階主管
- 風格：專業簡潔、以圖表為主
- 色彩：深藍 + 白色
- 必須包含：KPI 儀表板、趨勢圖、下季度計畫
- 資料來源：[附上 Excel 或 PDF]

教育訓練

請將以下技術文件轉為教育訓練簡報：
- 受眾：新進員工
- 風格：明亮友善、多圖示
- 頁數：15-20 頁
- 每頁重點不超過 3 個
- 包含互動練習頁
- 資料來源：[附上技術文件]

技術架構

請生成一份系統架構簡報：
- 受眾：技術團隊
- 風格：黑色主題、工程風格
- 必須包含：架構圖、元件關係、部署拓撲
- 使用 Mermaid 風格的流程圖
- 資料來源：[附上架構文件]

專案報告

請將專案進度報告轉為簡報：
- 受眾：專案 Stakeholders
- 風格：專業中性
- 頁數：8-10 頁
- 必須包含：時程甘特圖、風險矩陣、里程碑
- 資料來源：[附上專案報告]

需求規格

請將需求規格書轉為簡報：
- 受眾：SA / 開發團隊
- 風格：結構化、條列式
- 必須包含：Use Case 圖、流程圖、資料流圖
- 資料來源：[附上 SRS 文件]

第11章 文件來源

11.1 支援格式總覽

11.2 來源轉換範例

# PDF 轉換（自動擷取文字、表格、圖片）
python scripts/source_to_md/pdf_to_md.py quarterly_report.pdf

# 網頁轉換（支援動態內容擷取）
python scripts/source_to_md/web_to_md.py "https://docs.example.com/guide"

# Excel 轉換（自動識別表頭與資料範圍）
python scripts/source_to_md/excel_to_md.py sales_data.xlsx

💡 實務建議：對於 Confluence / Notion 等知識庫平台，建議先匯出為 PDF 或 Markdown，再由 PPT Master 處理。

第12章 Speaker Notes

12.1 Speaker Notes 生成

PPT Master 在 Executor 階段為每頁自動生成演講備忘錄：

• Speaker Notes 是純 TTS 友好文字（無 Markdown 標記）
• 語調與內容配合該頁的設計意圖
• 每頁 3-5 句核心講稿

12.2 TTS 語音旁白系統

12.3 語音生成流程

flowchart LR
    A[Speaker Notes<br/>純文字] --> B[語言偵測]
    B --> C[推薦 3-6 個<br/>候選語音]
    C --> D{使用者確認}
    D --> E[TTS 生成<br/>音訊檔案]
    E --> F[嵌入 PPTX<br/>recorded-narration]
    F --> G[重新匯出 PPTX]

    style D fill:#fff3e0

12.4 兩種嵌入路徑

PPT Master 提供兩種音訊嵌入方式：

12.5 聲音克隆（Voice Cloning）

四個雲端提供商支援從短樣本克隆聲音，再以該聲音朗讀整套簡報：

职責分離：聲音克隆本身在提供商的主控台或 API 中完成，PPT Master 僅負責消費端——接收 voice_id 並以該聲音朗讀每頁的 Notes。PPT Master 永遠不會上傳你的聲音樣本。

# 使用克隆聲音範例
python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
  --provider minimax --voice-id <your-cloned-voice-id> \
  --minimax-model speech-2.8-hd

⚠️ 授權提醒：僅克隆自己擁有或已獲明確授權的聲音。voice_id 一次設定後可永久重用。

12.6 影片匯出

嵌入旁白後的 PPTX 可直接透過 PowerPoint 原生功能匯出為影片：

1. 開啟旁白版 .pptx
2. File → Export → Create a Video
3. 選擇品質（4K / Full HD / HD）與「使用錄製的計時與旁白」
4. 匯出 .mp4（或 Windows 上的 .wmv）

💡 參考檔案大小：20 頁簡報 Full HD 影片通常為 30-80 MB。

12.7 操作指令

# 生成語音旁白
python scripts/notes_to_audio.py --voice "zh-TW-HsiaoChenNeural" --rate "+10%"

# 嵌入至 PPTX（完整計時 + 自動推進）
python scripts/native_enhance_pptx.py --recorded-narration audio

# 匯出影片（使用 PowerPoint 原生功能）
# PowerPoint → File → Export → Create a Video

💡 實務建議：使用 --rate "+10%" 稍微加速語音，可讓簡報節奏更緊湊。中文簡報推薦使用 zh-TW-HsiaoChenNeural（女聲）或 zh-TW-YunJheNeural（男聲）。

第13章 AI 模型支援

13.1 模型比較

📌 模型選擇核心原則：PPT Master 是 harness，不是完整 agent——harness + model = agent，輸出天花板完全由模型決定。以弱模型評估 PPT Master，就像用一檔試駕跑車再說它慢。

13.2 推薦配置

13.3 AI 圖像三維系統

PPT Master 使用三維系統控制 AI 圖像風格：

第14章 與 Claude Code 整合

14.1 安裝與設定

# 方式一：Plugin 市場（推薦）
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

# 方式二：本地載入
cd /path/to/ppt-master
claude  # 自動讀取 CLAUDE.md

14.2 入口點：CLAUDE.md

PPT Master 在根目錄提供 CLAUDE.md 作為 Claude Code 的入口點，包含：

• Skill 載入指令
• 可用工作流程清單
• 快速開始指南

14.3 工作流程範例

# 從 PDF 生成簡報
claude "請將 report.pdf 轉為 10 頁專業簡報"

# 從主題生成簡報
claude "請生成一份關於 Kubernetes 架構的技術簡報，12 頁"

# 使用品牌模板
claude "請用 templates/acme-brand 模板將 spec.md 轉為簡報"

# 生成語音旁白
claude "請為最新生成的簡報添加中文語音旁白"

14.4 專案管理

# 查看專案清單
python scripts/project_manager.py list

# 重新匯出（從備份 SVG）
python scripts/project_manager.py re-export --project my_presentation

# 清理舊專案
python scripts/project_manager.py clean --older-than 30d

第15章 與 GitHub Copilot 整合

15.1 Agent Mode 設定

1. 確保 VS Code 已安裝 GitHub Copilot 擴充功能
2. 將 ppt-master/ 加入工作區
3. PPT Master 透過 AGENTS.md 定義 Agent 能力
4. 確認 Copilot Agent Mode 已啟用（VS Code 設定）

15.2 使用方式

在 Copilot Chat 中：

@workspace 請用 PPT Master 將 requirements.md 轉為簡報

@workspace 請生成一份 Spring Boot 架構設計簡報，10 頁

@workspace 請將上次生成的簡報添加 Speaker Notes

15.3 Workspace 整合

• Copilot 會自動讀取 AGENTS.md 了解可用能力
• 透過 @workspace 觸發 PPT Master 工作流程
• 支援檔案參照：可直接引用工作區中的文件

💡 實務建議：Copilot Agent Mode 的上下文視窗可能小於 Claude Code，建議簡報頁數控制在 10-12 頁以內以確保品質。若 AI 失去上下文，可要求它重新讀取 skills/ppt-master/SKILL.md。

第16章 與 Cursor 整合

16.1 Composer 模式

在 Cursor Composer 中：

請用 PPT Master 將以下內容生成簡報：
[貼上或引用文件內容]

16.2 Agent 模式

Cursor 的 Agent 模式會自動讀取 SKILL.md 並按工作流程執行。

16.3 Rules 設定

可在 .cursorrules 中加入 PPT Master 相關規則：

# PPT Master Rules
- 使用 PPT Master Skill 生成簡報
- 遵循 SKILL.md 定義的 7 步驟工作流
- SVG 必須手寫，禁止腳本生成

16.4 工作流程

Cursor Composer → SKILL.md → Strategist → 八項確認 → Executor → PPTX

第17章 與 MCP 整合

17.1 MCP 架構

PPT Master 透過 .claude-plugin/marketplace.json 定義 MCP 整合介面，並可透過 Claude Code Plugin Marketplace 生態系安裝：

{
  "name": "ppt-master",
  "version": "2.11.0",
  "description": "AI-powered native editable PPTX generation",
  "skills": ["ppt-master"],
  "entry": "skills/ppt-master/SKILL.md"
}

安裝方式：

# 跨 Agent CLI 安裝
npx skills add hugohe3/ppt-master

# 或在 Claude Code 中
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

📌 市場安裝僅取得 Skill 檔案（非完整 repo），仍需從安裝位置執行 pip install -r requirements.txt。

17.2 MCP 工具呼叫

PPT Master 的腳本可作為 MCP Tools 被呼叫：

17.3 MCP 工作流程

sequenceDiagram
    participant User as 使用者
    participant IDE as AI IDE
    participant MCP as MCP Server
    participant PPT as PPT Master

    User->>IDE: "生成簡報"
    IDE->>MCP: 載入 Skill
    MCP->>PPT: 初始化專案
    PPT-->>MCP: 專案結構
    MCP->>IDE: Strategist 確認
    IDE->>User: 八項確認
    User->>IDE: 確認設計
    IDE->>MCP: 執行生成
    MCP->>PPT: 逐頁 SVG → PPTX
    PPT-->>MCP: exports/*.pptx
    MCP-->>IDE: 完成通知
    IDE-->>User: 簡報已生成

第18章 與企業知識庫整合

18.1 整合策略

PPT Master 不直接連接知識庫平台，而是透過中間格式整合：

18.2 企業知識庫工作流程

flowchart LR
    A[Confluence<br/>SharePoint<br/>Notion] -->|匯出| B[PDF / DOCX / MD]
    B -->|source_to_md| C[Markdown]
    C -->|PPT Master| D[PPTX]
    D -->|發布| E[SharePoint<br/>OneDrive<br/>Teams]

    style A fill:#e1f5fe
    style D fill:#c8e6c9

18.3 批次處理建議

對於需要定期從知識庫生成簡報的場景：

1. 建立標準化的 Prompt 模板
2. 使用 brand 模板確保品牌一致
3. 排程匯出 → 轉換 → 生成流程
4. 版本控制所有 Prompt 與模板

第19章 實戰案例

19.1 技術簡報

場景：向技術團隊介紹微服務架構遷移方案

Prompt：
請將附件的微服務遷移方案文件轉為 12 頁技術簡報：
- 受眾：後端開發團隊（15 人）
- 風格：深色主題、工程風格
- 必須包含：現有架構圖、目標架構圖、遷移時程、風險矩陣
- 每頁重點不超過 3 個
- 使用 Monospace 字型呈現程式碼

19.2 教育訓練

場景：新進員工入職訓練教材

Prompt：
請將新人入職手冊轉為教育訓練簡報：
- 受眾：新進員工
- 風格：明亮友善、大量插圖
- 頁數：20 頁
- 包含：公司介紹、組織架構、開發流程、工具介紹
- 每頁配圖
- 加入 Speaker Notes 作為講師講稿

19.3 需求規格

場景：向 Stakeholder 展示系統需求

Prompt：
請將 SRS 文件轉為需求規格簡報：
- 受眾：PM、SA、業務代表
- 風格：結構化、條列式
- 必須包含：Use Case 清單、流程圖、資料流圖、非功能需求
- 使用表格呈現需求追溯矩陣

19.4 架構設計

場景：架構審查會議

Prompt：
請生成系統架構設計簡報：
- 受眾：架構審查委員會
- 風格：專業中性、大量圖表
- 必須包含：C4 架構圖（Context、Container、Component）
- 包含技術選型比較表
- 包含效能基準數據

19.5 專案報告

Prompt：
請將月度專案進度報告轉為簡報：
- 受眾：PMO、專案 Sponsor
- 包含：進度甘特圖、預算使用、風險矩陣、下月計畫
- 使用紅黃綠燈標示狀態

19.6 產品介紹

Prompt：
請生成產品介紹簡報：
- 受眾：潛在客戶
- 風格：品牌色、商務感
- 包含：產品特色、競品比較、定價方案、客戶案例
- 加入 Speaker Notes 作為業務講稿

19.7 年度報告

Prompt：
請將年度報告數據轉為簡報：
- 受眾：全體同仁
- 風格：大器、資訊圖表為主
- 包含：年度 KPI、營收趨勢、團隊成長、明年展望
- 大量使用圖表和數字視覺化

19.8 董事會簡報

Prompt：
請生成董事會季度報告簡報：
- 受眾：董事會成員
- 風格：高端專業、極簡設計
- 包含：財務摘要、策略進展、風險評估、決議事項
- 每頁只有一個核心訊息
- 總頁數不超過 10 頁

19.9 投資簡報

Prompt：
請生成投資提案 Pitch Deck：
- 受眾：VC / 天使投資人
- 風格：現代科技感
- 包含：問題陳述、解決方案、市場規模、商業模式、
        團隊介紹、財務預測、融資需求
- 參考 YC 標準 Pitch Deck 結構

第20章 Mermaid 圖集

20.1 系統架構圖

graph TB
    subgraph "使用者端"
        U[使用者] --> IDE[AI IDE<br/>Claude Code / Cursor / VS Code]
    end

    subgraph "PPT Master 核心"
        IDE --> SK[SKILL.md<br/>工作流程定義]
        SK --> ST[Strategist<br/>設計規劃]
        ST --> EX[Executor<br/>SVG 生成]
        EX --> PP[Post-Processing<br/>後處理引擎]
    end

    subgraph "來源處理"
        PDF[PDF] --> SM[source_to_md]
        DOC[DOCX] --> SM
        XLS[XLSX] --> SM
        WEB[URL] --> SM
        SM --> MD[Markdown]
        MD --> ST
    end

    subgraph "圖像獲取"
        AI_IMG[AI 圖像生成<br/>gpt-image-2] --> EX
        WEB_IMG[網路圖片<br/>Pexels / Pixabay] --> EX
    end

    subgraph "輸出"
        PP --> PPTX[PPTX<br/>原生可編輯]
        PP --> SVG_F[SVG Final<br/>預覽]
        PP --> BK[Backup<br/>備份]
    end

    style PPTX fill:#c8e6c9
    style U fill:#e1f5fe

20.2 AI 處理流程圖

flowchart TD
    A[使用者輸入 Prompt] --> B{有來源文件？}
    B -->|是| C[Source → Markdown 轉換]
    B -->|否| D[topic-research 工作流<br/>AI 先研究]
    C --> E[專案初始化]
    D --> E
    E --> F{需要模板？}
    F -->|是| G[載入 brand / layout / deck]
    F -->|否| H[自由設計模式]
    G --> I[Strategist 八項確認]
    H --> I
    I --> J{使用者確認？}
    J -->|修改| I
    J -->|確認| K[寫入 spec_lock.md]
    K --> L[圖像獲取]
    L --> M[Executor 逐頁生成 SVG]
    M --> N[SVG 品質檢查]
    N -->|失敗| M
    N -->|通過| O[後處理 & PPTX 匯出]
    O --> P[✅ 簡報完成]

    style J fill:#fff3e0
    style P fill:#c8e6c9

20.3 SVG → PPTX 生成流程

flowchart LR
    subgraph "SVG 層"
        A[svg_output/*.svg<br/>手寫 SVG] --> B[total_md_split.py<br/>分離 Notes]
        B --> C[finalize_svg.py<br/>Base64 內嵌]
    end

    subgraph "轉換層"
        C --> D[svg_to_pptx.py]
        D --> E[drawingml_converter<br/>主轉換器]
        E --> F[elements<br/>元素轉換]
        E --> G[paths<br/>路徑解析]
        E --> H[styles<br/>樣式生成]
    end

    subgraph "輸出層"
        F --> I[python-pptx<br/>PPTX 封裝]
        G --> I
        H --> I
        I --> J[exports/*.pptx]
    end

    style A fill:#fff3e0
    style J fill:#c8e6c9

20.4 Template 流程

flowchart TD
    A{模板來源} -->|現有 PPTX| B[create-template 工作流]
    A -->|品牌指南| C[create-brand 工作流]
    A -->|手動建立| D[Markdown 定義]

    B --> E{複製模式}
    E -->|standard| F[5 頁骨架]
    E -->|fidelity| G[按來源聚類]
    E -->|mirror| H[1:1 逐字複製]

    C --> I[brand 模板]
    D --> J[layout / deck 模板]

    F --> K[模板目錄]
    G --> K
    H --> K
    I --> K
    J --> K

    K --> L{融合策略}
    L -->|brand + layout| M[brand 覆蓋 identity<br/>layout 覆蓋 structure]
    L -->|衝突| N[Git merge 風格<br/>使用者選擇]

20.5 Prompt 工程流程

flowchart TD
    A[使用者 Prompt] --> B[語意解析]
    B --> C{Prompt 類型判斷}
    C -->|簡報生成| D[主 SVG 管線]
    C -->|模板填充| E[template-fill-pptx]
    C -->|美化現有| F[beautify-pptx]
    C -->|添加旁白| G[native-enhance-pptx]
    C -->|自訂動畫| H[customize-animations]

    D --> I[Strategist 分析 Prompt]
    I --> J[提取設計需求]
    J --> K[生成 design_spec.md]
    K --> L[八項確認]
    L --> M[鎖定 spec_lock.md]
    M --> N[Executor 執行]

20.6 企業導入流程

flowchart LR
    A[PoC 評估<br/>2 週] --> B[Pilot 試行<br/>1 個月]
    B --> C[品牌模板建立<br/>2 週]
    C --> D[教育訓練<br/>1 週]
    D --> E[全面推廣<br/>持續]
    E --> F[治理與優化<br/>持續]

    A -.->|選定 AI 模型<br/>驗證品質| A
    B -.->|收集回饋<br/>調整設定| B
    C -.->|Logo / 色彩 / 字型<br/>版面模板| C
    D -.->|Prompt 範例<br/>操作 SOP| D
    E -.->|使用量追蹤<br/>品質監控| E
    F -.->|模板更新<br/>Prompt 優化| F

    style A fill:#e1f5fe
    style F fill:#c8e6c9

第21章 常用 Prompt 範例

21.1 簡報生成類

21.2 模板與風格類

21.3 進階操作類

21.4 企業場景類

第22章 最佳實務

22.1 Prompt 最佳實務

22.2 Template 最佳實務

22.3 圖片最佳實務

22.4 Icon / Chart / Table 最佳實務

22.5 Brand / Theme 最佳實務

• 建立企業 brand 模板目錄，包含 Logo、色彩、字型定義
• 限制可用色彩為 3-5 個（主色、輔色、強調色）
• 統一字型（建議中文使用 Noto Sans TC）
• 定義禁用元素（如某些動畫效果）

22.6 動畫最佳實務

• 頁面過渡：預設 fade 0.4s 已足夠，避免過度花俏
• 元素動畫：預設關閉是正確的，僅在必要時開啟
• 動畫錨點：使用頂層 <g id="..."> 群組作為動畫目標
• 靜態框架：背景、頁首、頁尾自動跳過動畫
• 錄製旁白模式：拒絕 on-click 動畫（避免衝突）

第23章 效能最佳化

23.1 生成速度

23.2 Token 最佳化

23.3 上下文視窗建議

23.4 圖片與 SVG 最佳化

第24章 系統維護

24.1 版本管理

# 查看當前版本
cat skills/ppt-master/SKILL.md | head -5

# 更新至最新版
python skills/ppt-master/scripts/update_repo.py

# 或使用 Git
git pull origin main
pip install -r requirements.txt

24.2 Template 管理

24.3 Prompt 管理

建議建立 Prompt Library：

prompt-library/
├── 技術簡報/
│   ├── 架構設計.md
│   ├── API介紹.md
│   └── 技術選型.md
├── 管理簡報/
│   ├── 季度報告.md
│   └── 年度回顧.md
└── 教育訓練/
    ├── 新人入職.md
    └── 技術培訓.md

24.4 日誌與備份

24.5 維護 SOP

1. 每週：檢查 PPT Master 是否有新版本
2. 每月：審查並更新企業模板
3. 每季：回顧 Prompt Library，新增常用 Prompt
4. 每年：評估 AI 模型更新，調整推薦配置

第25章 系統升級

25.1 升級流程

flowchart TD
    A[檢查新版本<br/>GitHub Releases] --> B[閱讀 Release Notes]
    B --> C{有 Breaking Change？}
    C -->|是| D[在測試環境驗證]
    C -->|否| E[直接升級]
    D --> F{驗證通過？}
    F -->|是| E
    F -->|否| G[等待修復或<br/>調整設定]
    E --> H[備份現有目錄]
    H --> I[執行升級]
    I --> J[驗證核心功能]
    J --> K[通知團隊]

    style H fill:#fff3e0

25.2 升級指令

# 方式一：update_repo.py（推薦）
python skills/ppt-master/scripts/update_repo.py

# 方式二：Git Pull
git stash           # 保存本地修改
git pull origin main
git stash pop       # 恢復本地修改
pip install -r requirements.txt

# 方式三：重新安裝
npx skills update hugohe3/ppt-master

25.3 版本差異注意事項

第26章 常見問題 FAQ

安裝與環境

簡報生成

SVG 與 DrawingML

模板

AI 模型

Speaker Notes 與音頻

IDE 整合

效能與限制

第27章 Troubleshooting

27.1 安裝問題

27.2 SVG 問題

27.3 DrawingML 問題

27.4 PowerPoint 問題

27.5 Template 問題

27.6 Prompt 問題

27.7 MCP / IDE 問題

第28章 與其他工具比較

28.1 完整比較表

28.2 選型建議

第29章 企業導入建議

29.1 導入路線圖

29.2 教育訓練計畫

29.3 權限管理

29.4 品牌治理

• 建立統一的 brand 模板，鎖定企業色彩、字型、Logo
• 定期審查生成的簡報是否符合品牌規範
• 建立禁用清單（不當配色、未授權圖片等）

29.5 AI 治理

第30章 適用 SSDLC

30.1 各階段導入方式

PPT Master 可在軟體開發生命週期（SSDLC）的各階段輔助文件產出：

30.2 SSDLC 文件自動化流程

flowchart LR
    A[需求文件<br/>SRS] --> B[PPT Master]
    C[架構文件<br/>SAD] --> B
    D[測試報告<br/>Test Report] --> B
    E[維運報告<br/>Ops Report] --> B

    B --> F[需求簡報]
    B --> G[架構簡報]
    B --> H[測試簡報]
    B --> I[維運簡報]

    F --> J[Stakeholder<br/>Review]
    G --> J
    H --> J
    I --> J

    style B fill:#fff3e0
    style J fill:#c8e6c9

第31章 未來發展

31.1 已完成的里程碑（2026 Q1-Q2）

• ✅ 原生 PPTX 路徑（glow / rotate / text-decoration / stroke-linejoin）
• ✅ 主題研究工作流（無來源生成）
• ✅ 70+ 圖表模板 + 三個圖示庫
• ✅ spec_lock.md 機器可讀合約
• ✅ 即時預覽 + 直接編輯（L1 / L2 / L3）
• ✅ AI 圖像三維系統（rendering × palette × type）
• ✅ 模板三類整合（brand / layout / deck）
• ✅ Mode × Visual-style 雙目錄（5 模式 + 18 視覺風格）
• ✅ template-fill / beautify / native-enhance 三條直接 PPTX 路線
• ✅ 互動式八項確認頁面（Confirm UI）
• ✅ 切片式 spot-illustration 管線
• ✅ 網路圖片 entity-safety 閘門
• ✅ PPTX 導入管線（pptx_template_import.py 直接讀取 OOXML）
• ✅ 聲音克隆支援（ElevenLabs / MiniMax / Qwen / CosyVoice）
• ✅ 頁面過渡與元素動畫系統（原生 OOXML）
• ✅ 多格式畫布支援（小紅書 / IG / Story / A4）
• ✅ Claude Code Plugin Marketplace 整合
• ✅ 穩定版本 v2.11.0 發布（累計 9 個 Release）

31.2 進行中

• 🔄 多簡報來源合併校準
• 🔄 spot-illustration 真實使用校準

31.3 明確的 Non-Goals

PPT Master 團隊明確表示以下不會實作：

31.4 未來趨勢

• AI Agent 生態系：更多 AI IDE 原生支援 Skill，工具間的互通性提升
• MCP 標準化：Model Context Protocol 將成為 AI 工具整合標準
• Office AI 競合：Microsoft 365 Copilot 提供原生整合，但成本與彈性不同
• 自動化流程：從文件管理系統自動觸發簡報生成
• 模型進化：隨著 AI 模型能力提升，各模型間的品質差距將持續縮小
• 多模態整合：未來模型可能直接理解視覺設計，進一步提升版面品質

📌 持續追蹤：關注 GitHub Releases 與 Roadmap 取得最新進展。

檢查清單 (Checklist)

✅ 安裝與環境

• Python 3.10+ 已安裝
• pip install -r requirements.txt 成功
• AI IDE（Claude Code / Cursor / VS Code）已安裝
• AI 模型 API Key 已設定
• .env 檔案已建立
• PPT Master Skill 已載入

✅ 首次使用

• 使用簡單 Prompt 生成測試簡報
• 確認 PPTX 可在 PowerPoint 中正常開啟
• 確認所有元素可逐一編輯
• 測試 Speaker Notes 是否正確生成

✅ 企業導入

• brand 模板已建立（Logo、色彩、字型）
• Prompt Library 已建立
• API Key 管理流程已建立
• 團隊已完成教育訓練
• 使用指南已發布

✅ 維運管理

• 版本更新流程已建立
• 模板定期審查流程已建立
• 備份機制已確認
• 問題回報管道已建立

✅ 安全與治理

• API Key 使用環境變數，未寫死在程式碼中
• 月度 API 使用上限已設定
• 敏感簡報審查流程已建立
• AI 模型資料安全已確認

📖 文件版本：v1.1（2026-06-30）

基於：PPT Master v2.11.0（GitHub Stars 34.4k+ ｜ MIT 授權）

更新紀錄：

• v1.1（2026-06-30）：全面更新至 v2.11.0，新增即時預覽架構、模板三模式、聲音克隆、分割模式、PPTX 導入管線等內容
• v1.0（2026-06-30）：初版發布

參考來源：PPT Master GitHub ｜ Getting Started ｜ FAQ ｜ Templates Guide ｜ Audio Narration

授權：本教學手冊依據 PPT Master 官方開源資料（MIT 授權）吸收重寫，以企業教育訓練教材方式呈現。