快速入口

开源仓库：https://github.com/rbetree/TeachDo

一句话介绍

TeachDo 是一套面向教师的 AI 备课工作台：以“课程/单元”为工作流单位，把大纲、教案、PPT 等产物做成可编辑、可导出、可沉淀复用的资产，而不是一次性生成结果。

解决什么

备课过程通常跨越“材料收集 → 结构梳理 → 内容扩写 → 课件制作 → 导出交付”，单点工具难以覆盖全链路，也难保证可控与可复用。TeachDo 通过流式生成（SSE）+ 产物入库管理，将生成、编辑、引用知识库（KB-RAG）与导出串成闭环：前端统一走 /api/*，由 backend/main_api 作为 BFF 编排大纲服务、内容生成服务与 KB 服务，降低前端复杂度并便于后端演进。

仓库按能力拆成多服务：backend/main_api 负责统一对外接口与编排，backend/simpleOutline 负责大纲生成，backend/slide_agent 负责 PPT 逐页内容生成，backend/personaldb 负责 KB 的文件处理、向量化与检索；前端唯一入口在 frontend/（Vue 3 + Vite + TypeScript），开发环境通过代理把请求转发到主 API，减少跨域与环境切换成本。

从产物角度看，TeachDo 强调“能落地”：教案支持导出标准 .docx；PPT 生成支持模板选择与增量生成，产物默认以 Markdown 入库，最终 PPTX 在独立编辑器导出，确保生成结果可编辑、可复用、可追踪。

核心亮点

  • SSE 流式输出：Outline/教案/PPT/助教对话可边生成边预览与中断
  • 多服务拆分：backend/ 下按能力分服务，main_api 聚合并对前端提供统一接口
  • KB-RAG：上传资料向量化，生成时可选择引用范围提升准确性与可控性
  • 独立编辑器：PPT 产物默认入库为 Markdown，最终 PPTX 由编辑器导出
  • 一键启动脚本：根目录 start.py 负责本地开发环境拉起与进程管理

快速开始

cp env_template.txt .env
python3 start.py

启动后默认前端端口 5174，主 API 6800（其余服务端口见 README）。

start.py 面向本地开发“一键拉起”场景：会按配置启动前后端与相关服务，并在 logs/ 下落日志方便排障。若你更偏好分别启动或容器化部署，仓库 README 也提供了对应方式与生产环境说明。