PPT Master 是什麼、怎麼安裝使用：讓 AI 把文檔做成原生可編輯 PPTX 的 Skill（Claude Code / Cursor / Codex）

本文根據 hugohe3/ppt-master 倉庫 README 與 Claude Code 官方文檔整理，資料核對於 2026-10-10。功能邊界與模型建議以倉庫 README 和 docs/ 目錄為準。

是什麼

PPT Master 是 Hugo He 開發的一個「做 PPT」工作流，以 Skill 的形式跑在有智能體能力的 AI 工具裏。你在對話框裏說一句「用這份 PDF 做一套幻燈片」，它在你的電腦上完成內容分析、版式設計、逐頁生成和導出，最後交給你一個 .pptx 文件。

它強調的不是「能編輯」，而是「原生」：導出的是 PowerPoint 自己的對象——原生形狀和連接線、可按需生成帶數據的圖表和表格、可編輯的公式——點開任何一個元素都能像手工做的幻燈片一樣繼續改，而不是一張張貼上去的圖片。除了從資料生成新幻燈片，README 還列了幾條路線：從參考文件裏提煉可複用的品牌和版式模板、在保留原設計的前提下給已有 .pptx 換內容、給做好的幻燈片加原生切換、動畫和旁白。

README 給自己的三個承諾是：成本透明（工具免費，只花模型的錢）、數據留在本地（除與模型通信外流程都在本機）、不綁定平台。截至 2026-10-10，GitHub 顯示該倉庫約 5.9 萬 Star、4645 Fork，最近一次推送在 2026-10-08。倉庫有中文 README（README_CN.md）。

包含哪些 Skill

倉庫的核心是一個技能 ppt-master（位於 skills/ppt-master/），由 SKILL.md、若干工作流說明和一批 Python 腳本組成。按 README 的描述，它覆蓋這些能力：

• 從資料生成：支持 PDF、DOCX、HTML、EPUB、圖片或直接粘貼的文字；
• 設計規格確認：預設先和你確認模板、畫幅、頁數等，再開始製作；也有跳過確認的快速模式；
• 原生導出：先生成每頁的 SVG，再轉換成可編輯的 DrawingML，輸出到 exports/ 目錄；加參數可以把圖表和表格導出為帶「編輯數據」功能的 PowerPoint 原生對象；
• 編輯已有 PPTX：保留設計，替換指定頁面的內容；
• 配圖：可以調用所在工具自帶的圖像生成，也可以用腳本接入圖像服務，或做網絡圖片搜尋（不配置時使用 Openverse 和 Wikimedia Commons）；
• 演講者備註、動畫與旁白：給成品補上原生動畫，並可根據備註生成旁白音頻。

README 明確說 SmartArt 是有意不做的。

怎麼安裝

前置條件：Python 3.10 及以上。Windows 需要多幾步設定，倉庫有專門的 Windows 安裝指南。

方式一：克隆倉庫（README 推薦）

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

方式二：技能市場

bash
# Cross-agent CLI (Claude Code, Cursor, Codex, etc.)
npx skills add hugohe3/ppt-master

# Or inside Claude Code
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

README 提醒：這兩種市場安裝只取回技能文件，不含完整倉庫，仍然要在安裝位置執行 pip install -r requirements.txt，後處理腳本才能運行。

不想裝 Git 的話，也可以在 GitHub 頁面下載 ZIP 解壓後安裝依賴。

怎麼用

1. 用你的 AI 工具打開 ppt-master 文件夾（IDE 裏用「打開文件夾」，命令行工具先 cd ppt-master 再啟動）。
2. 把資料放進 projects/ 目錄，在對話裏指明文件，例如：Please create a PPT from projects/q3-report/sources/report.pdf。也可以直接把文字貼進對話。
3. 它會先列出設計規格讓你確認（模板、16:9 畫幅、頁數等），確認後自動完成後續步驟。
4. 成品在 exports/<name>_<timestamp>.pptx（名稱加時間戳）。

想省掉確認環節，就明確說要快速生成，比如 Quickly generate a 5-page deck from projects/q3-report/sources/report.pdf — no need to confirm with me。對話中途如果模型丟了上下文，讓它重新讀一遍 skills/ppt-master/SKILL.md。

適合誰 / 不適合誰

適合：

• 經常要把報告、論文、方案改成幻燈片的職場人和學生，且已經在用 Claude Code、Cursor 這類工具；
• 需要拿到可繼續編輯的源文件、而不是導出圖片的人；
• 資料不便上載到在線 PPT 生成網站的場景。

不適合：

• 期待「一次生成、直接上台」的人——README 自己寫了：這是工具不是許願池，剩下的打磨要你來做；
• 用小模型或上下文窗口較小的模型的用戶，README 說明模型決定上限，便宜的模型要返工更多；
• 完全不想碰 Python 和本地環境的人。

注意事項

• 許可證：倉庫 LICENSE 為 MIT。
• 維護狀態：更新活躍，最近一次推送 2026-10-08。
• 安全提醒：這個技能會在本機運行大量 Python 腳本、安裝 pip 依賴、讀寫項目目錄；配圖功能會聯網搜尋圖片或調用圖像生成接口。安裝前通讀 SKILL.md 和腳本，依賴建議裝在虛擬環境裏。圖像生成若走腳本方式，需要在 .env 裏配置對應服務商的 API Key；網絡搜圖配置 Pexels / Pixabay 的 Key 後質素更好。密鑰文件不要提交到代碼倉庫。
• 數據：流程在本地執行，但資料內容會發送給你所用的模型服務，涉密材料先確認是否允許。
• 圖片版權：README 說明搜圖會自動處理常見的開放許可並在需要時添加署名，但商用前仍應自己核對每張圖的授權。
• 兼容性：公式要求 PowerPoint 2010 及以上；在非 PowerPoint 軟件裏打開的效果邊界見倉庫 FAQ。
• README 裏有較多贊助商（模型與接口服務）的推廣內容，與技能功能無關，選擇模型服務時請自行比較。