错题本生成系统

基于 PaddleOCR + LangChain Agent 的智能错题本生成系统。上传试卷 PDF 或图片，自动识别文档结构、智能分割题目，导出为 Markdown 错题本。

项目结构

├── backend/          # Flask 后端（API + 静态资源托管）
├── frontend/         # Vue 3 + Vite + Tailwind CSS 前端
├── .env.example      # 环境变量模板
└── requirements.txt  # Python 依赖

环境部署

1. 安装依赖

需要 Python 3.11+、Node.js 18+。

# 后端依赖
pip install -r requirements.txt

# 前端依赖
cd frontend && npm install

如需处理 PDF 文件，还需安装 poppler：

# 通过 scoop
scoop install poppler

# 或通过 choco
choco install poppler

安装后重启终端，确保 pdftoppm 命令可用。

2. 配置环境变量

copy .env.example .env

编辑 .env，填写以下必需项：

# DeepSeek API（Agent 智能分割题目）
DEEPSEEK_API_KEY=your_key
DEEPSEEK_BASE_URL=https://api.deepseek.com

# PaddleOCR API（文档结构解析）
PADDLEOCR_API_URL=your_url
PADDLEOCR_API_TOKEN=your_token

可选配置见 .env.example。

3. 启动

开发模式（前后端分离，支持热更新）：

cd backend && python web_app.py

前端开发服务器会自动将 /api、/images、/download 请求代理到后端。

生产模式（Flask 托管前端静态资源）：

# 构建前端
cd frontend && npm run build

# 启动后端（自动托管构建产物）
cd backend && python web_app.py

访问 http://localhost:5001 即可使用。

支持的文件格式

PDF(.pdf)、图片(.jpg .jpeg .png .bmp .tiff .webp)，单次上传限制 50 MB。

许可证

MIT License