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 重写 → 多格式导出的完整循环。