NomaDamas/slides-grab

Best harness + editor + linter for generating slides in Claude Code / Codex - Claude Design Open Source Alternative

slides‑grab – AI 增強型 HTML 簡報編輯器

是什麼 – slides‑grab 是一個基於 Node 的 CLI 與瀏覽器編輯器，允許大型語言模型代理（Claude、Codex 等）將簡報幻燈片以自包含的 HTML + CSS 檔案形式建立、編輯與匯出。使用者可拖曳邊界框選取幻燈片的任意部分，要求 AI 代理重寫文字、變更樣式或替換圖片，變更會直接套用至 HTML 原始碼中。該工具隨後將簡報包轉換為 PDF、實驗性 PPTX 或 Figma 相容檔案。

為何重要 – 多數 AI 簡報生成器僅輸出靜態 HTML 或圖片。slides‑grab 透過提供 AI 代理可操作的視覺選擇介面，彌補了生成與迭代編輯之間的差距，使簡報保持完全可編輯、可搜尋，並易於重新匯出。

核心功能（如 README 所述）

AI 驅動的工作流程 – 代理可規劃大綱、設計每張幻燈片為 HTML、透過邊界框選擇進行編輯，並匯出。
瀏覽器為基礎的視覺編輯器 – 純 JavaScript 編輯器，支援拖曳選擇、內嵌文字編輯，以及點擊按鈕呼叫 AI 重寫。
豐富的匯出選項
- slides‑grab pdf – 位圖擷取 PDF（預設）或可搜尋文字 PDF（--mode print）。
- slides‑grab convert – 實驗性 PPTX 匯出（位圖或文字引擎）。
- slides‑grab figma – 專為匯入 Figma 簡報而設計的實驗性 PPTX 格式。
- slides‑grab png – 每張幻燈片的 PNG 圖像，以及用於 Instagram 風格圖形的特殊 card‑news 1:1 模式。
設計風格目錄 – 內建 95 種風格（30 種來自 pptx-design‑styles，5 種原生，60 種來自 design‑diversity）。使用者可列出、預覽或讓代理選擇一種風格。
模板與影像原生管道 – 可匯入現有的 PPTX/HTML 模板，或使用內建的 codex‑imagen 提供者（回退至 OpenAI 或 Gemini）生成影像優先的幻燈片。資源儲存在本地 <slides‑dir>/assets/ 目錄下。
CLI 工具 – edit、edit-image、validate（基於 Playwright）、tldraw（將 tldraw 圖形轉換為 SVG）、fetch-video（yt‑dlp 下載），以及安裝共享 Vercel 代理技能的輔助工具。
可擴充 – 編輯器為單一 JavaScript 檔案；無需重新建構整個專案即可新增新代理、設計或指令。

快速開始（來自 README）

# 克隆並安裝相依性
git clone https://github.com/NomaDamas/slides-grab.git && cd slides-grab
npm ci && npx playwright install chromium   # 驗證所需

# 或直接安裝 npm 套件
npm install slides-grab
npx playwright install chromium
npx slides-grab install-skills --target all --scope user

CLI 預設在 slides/ 資料夾中的 HTML 幻燈片上運作。範例工作流程：

slides-grab edit               # 開啟視覺編輯器
slides-grab validate           # 使用 Playwright 檢查 HTML
slides-grab pdf --output deck.pdf
slides-grab convert --output deck.pptx

常見使用情境

快速 AI 生成的簡報 – 讓 Claude 或 Codex 產生簡報大綱與 HTML 檔案，再透過視覺方式微調特定區段。
設計探索 – 浏覽 95 種風格圖庫，即時選擇風格，或讓代理建議自訂外觀。
影像優先的故事敘述 – 使用 slides‑grab image 生成完整幻燈片影像（預設使用 Codex 的私有影像後端），再透過 edit-image 進行編輯。
匯出為企業格式 – 將 HTML 簡報轉換為 PPTX 用於 PowerPoint，或轉換為 Figma 相容 PPTX 用於設計交接。
社群媒體卡片 – 使用 card‑news 模式生成正方形 PNG，可直接用於 Instagram 或 LinkedIn。

安裝注意事項

需要 Node ≥ 20。
validate 命令需要 Playwright（透過 npx playwright install chromium 安裝 chromium 二進位檔）。
圖像生成預設使用內建的 codex‑imagen 提供者，該提供者重用本地 Codex ChatGPT 登入資訊（~/.codex/auth.json）。可透過 --provider 和相應的 API 金鑰環境變數選擇替代提供者（openai、nano‑banana/Gemini）。
npm 套件包含 CLI 與共享 Vercel 代理技能；僅在開發或自訂擴充時才需克隆原始碼庫。

授權與致謝

採用 MIT 授權。
基於 Builder Josh 的 ppt_team_agent 專案建構（詳見 README 中的致謝）。

總結 – slides‑grab 是一個真正的開源工具，結合 AI 代理與可編輯的 HTML 簡報格式，為使用者提供生成 → 視覺選擇 → 就地 AI 重寫 → 多格式匯出的完整循環。