TrainPPTAgent 是一款基于 AI 的智能演示文稿生成工具。用户只需输入主题，系统即可自动通过微信搜索网络内容，生成结构完整、内容丰富的 PPT 大纲与逐页内容。项目采用 前后端分离架构：前端负责交互、大纲编辑与模板选择，后端则借助大语言模型（LLM）与强化学习（GRPO）完成内容生成与优化，使生成的 PPT 更贴合用户目标。

English：README_EN.md

强化学习训练代码请参见另外项目： 👉 PPT 模型训练代码

• 智能大纲生成 输入主题后，自动生成逻辑清晰、结构合理的演示文稿大纲。

• 逐页内容生成 采用流式传输技术，实现 PPT 内容的实时生成与展示，提升交互体验。

• 用户已有大纲或者文件上传到知识库 根据知识库的内容生成PPT。

• 模板支持 提供多种模板供用户选择，支持内容与样式的分离式填充。

• 不同模型 支持各种商业模型和本地模型，参考doc/custom_model.md。

• 前后端分离架构 前端使用 Vue.js + Vite + TypeScript，后端基于 Python (FastAPI)，架构清晰、可扩展性强。

• 强化学习驱动 引入 GRPO 强化学习方法，优化 PPT Agent 的生成效果，使结果更符合用户需求。

• 前端: Vue.js, Vite, TypeScript
• 后端: Python, Flask/FastAPI, A2A, ADK, MCP 搜索
• AI 模型: 大语言模型联网搜索（用于大纲与内容生成），可以自行取消联网搜索，如果不需要，找到agent.py中的tools=[]，改成空即可。

TrainPPTAgent/
├── backend/           # 后端代码
│   ├── mock_api/      # 模拟生成PPT
│   ├── main_api/      # 核心 API 服务
│   ├── slide_agent/   # AI Agent根据大纲撰搜索网络或者本地知识库写每页PPT
│   ├── simpleOutline/  # AI Agent 搜索并写大纲
│   ├── personaldb/     #知识库，解析各种格式的文件，用于搜索知识库生成PPT
├── frontend/          # 前端代码
│   ├── src/
│   │   ├── views/     # 页面组件（大纲、编辑等）
│   │   ├── services/  # API 调用服务
│   │   └── ...
│   └── vite.config.ts # 前端配置
└── doc/               # 项目文档
    ├── API_*.md       # API 接口文档
    ├── CHANGES.md     # 更新日志，各个文件更新了哪里
    └── ...

# 启动前端
cd frontend
npm install
npm run dev

# 启动模拟后端
cd backend/mock_api
python mock_main.py

# 1. 配置环境变量
cp env_template.txt .env
修改.env # 填入你的API密钥

# 2. 一键启动生产环境
python start.py

功能特性：

• ✅ 统一配置管理 - 所有环境变量集中在各自的.env文件
• ✅ 自动化部署 - 依赖安装、前端构建、服务启动一键完成
• ✅ 完整监控 - 进程监控、日志管理、优雅停止
• ✅ 生产就绪 - 适合正式环境的性能和稳定性配置

访问地址：

• 前端界面：http://127.0.0.1:5173

📚 详细说明请参考：生产环境部署指南

使用我们提供的启动脚本，可以一键启动所有后端服务：

cd backend
pip install -r requirements.txt
python start_backend.py

功能特性：

• ✅ 自动检查Python版本和依赖
• ✅ 自动安装所需包
• ✅ 端口占用检测和清理（需要用户确认）
• ✅ 自动设置环境文件
• ✅ 多进程管理和监控

1. 进入后端目录：

   cd backend

2. 安装依赖：

   pip install -r requirements.txt

3. 启动主 API 服务（默认运行在 http://127.0.0.1:6800）：

   cd main_api
   cp env_template .env
   python main.py

4. 启动大纲生成服务（默认运行在 http://127.0.0.1:10001）：

   cd backend/simpleOutline
   cp env_template .env   #复制完成后，修改.env文件
   python main_api.py

5. 启动 PPT 内容生成服务（默认运行在 http://127.0.0.1:10011）：

   cd backend/slide_agent
   cp env_template .env  #复制完成后，修改.env文件
   python main_api.py

详细说明： 请参考 backend/启动说明.md

1. 进入前端目录：

   cd frontend

2. 安装依赖：

   npm install

3. 启动开发服务器（默认运行在 http://127.0.0.1:5173）：

   npm run dev

提示: 前端通过 Vite 代理与后端 API 通信，具体配置请查看 frontend/vite.config.ts。

docker compose up

1. 输入主题 → 用户在前端输入主题
2. 生成大纲 → 调用 /api/tools/aippt_outline，生成 Markdown 格式的大纲
3. 生成内容 → 调用 /api/tools/aippt，结合模板逐页生成内容
4. 实时渲染 → 前端渲染并展示完整 PPT

PPTGen：可以扩展为更多功能的Agent，例如检查质量（图表等)

flowchart TD
  U((用户)) --> FE[前端界面]
  FE -->|输入主题| API[后端 API]

  API -->|调用大纲服务| Outline[大纲服务]
  Outline -->|调用 Web搜索| WebSearch1[Web 搜索]
  Outline --> API

  FE -->|确认大纲| API --> PPTGen[PPT生成服务：内部循环和检查Json格式]
  PPTGen -->|调用 Web搜索| WebSearch2[Web 搜索]
  PPTGen -->|调用 配图搜索| ImgSearch[配图搜索]
  PPTGen -->|调用 搜索上传文件| DBSearch[知识库]
  PPTGen --> API

  FE -->|渲染展示 PPT| U

• 大纲生成

• 模板选择

• 逐页生成 PPT

• 图表支持 PPT

• 图表的支持
• 支持上传自定义 PPT 模板并自动标注

• 更新日志
• 自定义模板说明
• 模版制作
• 不同的模型配置

https://github.com/pipipi-pikachu/PPTist

如有问题，请联系作者：