PPT Agent

Overview

GitHubGitHub

**PPT Agent** 是一个以代码驱动的演示文稿生成框架，采用严格的状态机驱动多 Agent 协作，将用户的简短需求转化为专业级 PPTX 文件。其设计目标是解决传统大模型直接生成幻灯片时常见的幻觉、元素重叠与布局混乱问题。 ### 核心机制 - **Subagent 阶段隔离**：Research、Outline、Style、Planning 四大阶段各自运行独立的子代理，上下文互不干扰。每个子代理创建时强制携带 `SUBAGENT_MODEL` 参数。 - **像素级 Visual QA 闭环**：每页 HTML 构建后自动截图，由大模型进行视觉审计。若检测到布局溢出，子代理通过重写 DOM 与 CSS 结构来消除冲突。 - **数据层与渲染层隔离**：每页先生成 JSON 合同并经 `planning_validator.py` 校验通过后，再驱动 HTML 渲染。 - **无状态断点恢复**：全流程不依赖进度状态文件，中断后通过扫描磁盘上已存在的产物文件（如 `outline.txt`、`style.json`、`slide-N.png`）自动推断恢复点。 ### 工作流 整体流程分为 7 个阶段：采访 → 分支确认 → 联网检索或本地资料压缩 → 叙事大纲 → 全局风格锁定 → 逐页并行生产（Planning → HTML → Visual QA）→ Preview 与双 PPTX 导出。每个阶段产物落盘后经 Gate 校验放行，失败仅回退当前步。 ### 资源规模 内置 8 套主题风格、10 种版式类型、13 种图表模板、8 类组件库以及 15 个脚本工具。 ### 使用方式 本项目以 Agent Skill 形式运行，无需独立部署。在支持 Skill 的代理环境中安装后，直接输入自然语言需求即可触发完整流程。所有产物输出至 `ppt-output/runs/<RUN_ID>/` 目录，包含网页预览和 PNG/SVG 双格式 PPTX 文件。

Q&A

如何安装 PPT Agent？AI-generated

在终端执行 `npx skills add sunbigfly/ppt-agent-skills` 即可安装。它以 Agent Skill 形式运行，无需独立部署。

PPT Agent 如何解决大模型生成 PPT 的布局问题？AI-generated

通过像素级 Visual QA 闭环，每页 HTML 构建后自动截图并由大模型审计。检测到布局溢出后，子代理以重写 DOM 与 CSS 结构的方式消除冲突，而非依赖间距微调。

生成过程中断了怎么办？AI-generated

PPT Agent 支持无状态断点恢复。中断后重新运行，它会扫描磁盘上已存在的产物文件（如 outline.txt、style.json、slide-N.png 等）自动推断恢复点继续执行。

最终输出的文件格式是什么？AI-generated

所有产物输出至 `ppt-output/runs/<RUN_ID>/` 目录，包含网页预览文件（preview.html）以及 PNG 和 SVG 两种格式的 PPTX 文件。

它的工作流程是怎样的？AI-generated

分为 7 个阶段：采访、分支确认、联网检索或本地资料压缩、叙事大纲、全局风格锁定、逐页并行生产（Planning → HTML → Visual QA）、Preview 与双 PPTX 导出。