一、项目介绍

做汇报最费时间的是“先想结构、再找素材、最后手动排版”：一份十几页的 PPT，往往大半时间花在调格式上。你希望把大纲丢给一个智能体，它直接产出可编辑的 .pptx，却被“生成图片后无法改字”的工具有些劝退。
PPTAgent 是一个能生成可编辑 PowerPoint 的智能体。它先理解你的内容结构，再调用代码与渲染管线产出真正可二次编辑的 PPTX，并作为技能接入 Claude Code、Codex、OpenCode 等客户端，把“做 PPT”变成一句话指令。

二、项目基本信息

信息项详情
项目名称PPTAgent
GitHub地址https://github.com/icip-cas/PPTAgent
项目描述An Agentic Framework for Reflective PowerPoint Generation
作者icip-cas
开源协议MIT License
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-26

三、核心优势

  • 产出真实可编辑的 .pptx，而非不可改的图片
  • 先规划结构再生成，版式更可控
  • 以技能形式接入主流 AI 编程客户端
  • 基于 Python + Playwright，本地可跑
  • 支持 LibreOffice 渲染，导出质量稳定

四、适用场景

适合需要批量或频繁产出汇报 PPT、希望结果可二次编辑、减少排版劳动的职场与研究人员。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 依赖：Node 18+、LibreOffice、Python 3.12
git clone https://github.com/icip-cas/PPTAgent.git
cd PPTAgent/skills/pptagent
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -r requirements.txt
.venv/bin/python -m playwright install --with-deps chromium

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 把技能装进对应的 AI 客户端
.venv/bin/python scripts/install.py --client claude
.venv/bin/python scripts/install.py --client codex
.venv/bin/python scripts/install.py --client opencode
# 安装后，对客户端说：用 pptagent 生成一份 10 页的季度汇报 PPT

七、常见问题

问：生成的 PPT 能改文字吗？答：可以，产出的是标准 .pptx，文字与版式均可编辑。问：必须装 LibreOffice 吗？答：需要它做本地渲染与导出，保证排版稳定。

八、总结

PPTAgent 用一个清晰的设计，把把智能体工程能力沉淀成库这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。