二次开发与架构说明

这页只回答三件事：

  1. 先让开发者本地跑通
  2. 再用一张图和一张表说明架构与模块职责
  3. 最后给出常见改造入口

快速本地开发（先跑起来）

方式 A：后端一键启动（推荐）

cd backend
./start.sh

方式 B：手动启动后端

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py

启动前端

cd web
pnpm install # 或者 npm install
npm run dev

访问：

  • 前端：http://localhost:3000 账号：18888888888 密码：12345678
  • 管理后台：http://localhost:3000/admin 账号：admin 密码：admin123

如果你只想先体验，不做开发，先看 安装与部署。

系统架构图（简版）

目录与模块说明（你最常改的）

后端 backend/

路径作用
main.pyFastAPI 入口，注册 API 路由
llm_planner.py生成 PPT 大纲与页面文案结构
image_gen.py调图像模型生成/重绘幻灯片
repository.py数据访问层，封装 CRUD
database.py数据库初始化与迁移
models.pyORM 模型定义
file_handler.py上传文档解析（PDF/DOCX/TXT/MD）
storage/会话、图片等运行数据

前端 web/src/

路径作用
views/页面级视图（创建页、编辑器、作品页）
components/通用组件（画布、缩略图、版本面板）
stores/Pinia 状态管理
js/services/API 请求封装
locale/多语言文案

常见二次开发（按优先级）

1) 换模型或网关（最常见）

先改 backend/.env（最快）：

API_KEY=xxx
BASE_URL=xxx
MODEL_LOGIC=xxx
MODEL_IMAGE=xxx

如果协议不兼容，再改代码：

  • llm_planner.py（规划请求/响应）
  • image_gen.py（图片生成请求/响应）

2) 调整内容风格 / 视觉风格

  • 内容规则：改 llm_planner.py 与 docs/system_prompt.md
  • 图像风格：改 image_gen.py 里的 style prompt

常见改造清单（最实用）

加字段（如标签/备注）

  1. 改 models.py
  2. 改 database.py（迁移）
  3. 改 repository.py + main.py
  4. 改前端 services/ + stores/ + 页面组件
  • 改 web/.env 的 VITE_APP_TITLE / VITE_APP_LOGO
  • 换 web/public/images/ 静态资源

教学演示建议（简版）

  • 现场走一遍：创建 -> 规划 -> 生成
  • 打开 Network 看 /ppt/plan 与 /ppt/generate_slide
  • 最后看 storage/images 与 SQLite 落盘

相关阅读