项目介绍
EduBuddy（AI 学生帮手）是一个由人工智能驱动的智能教育辅助平台，面向中小学和大学学生，提供从学习规划、练习出题到进度跟踪的完整学习闭环。
🎯 设计理念
传统学习工具往往是"静态"的——题目库固定、反馈千篇一律。EduBuddy 将大型语言模型（LLM）深度融入学习流程，让每一个环节都具备"智能感知"：
- 个性化：基于学生年级、学科与当前水平，AI 定制专属学习路线
- 即时反馈：答题后 AI 评估并给出精准、有温度的批改意见
- 数据驱动：持续记录每次练习，量化知识点掌握度，识别薄弱环节
- 多模态录入：纸质题目可通过拍照 OCR、语音朗读等方式录入系统
✨ 核心功能一览
| 功能模块 | 说明 | AI 能力 |
|---|---|---|
| 📚 学习路线 | 个性化学习计划，包含节点、资源、预计时长 | GPT 生成结构化学习路径 |
| 🎯 智能出题 | 按科目/知识点/难度/题型生成题目 | GPT 出题 + 生成详解 |
| ✍️ 答题练习 | 选择题、填空题、简答题、计算题交互式作答 | GPT 智能批改 + 评分 |
| 🤖 AI 解题 | 一键获取解题过程、知识点、易错提示 | GPT 详细解析 |
| 🔊 语音朗读 | 题目与解析支持 TTS 朗读（浏览器原生） | Web Speech API |
| 📊 进度可视化 | 折线图、雷达图、饼图多维展示学习状态 | — |
| 💡 AI 建议 | 智能分析薄弱环节，输出优先级改进建议 | GPT 分析学习数据 |
| 📋 评估报告 | 一键生成 Markdown 格式综合学习评估报告 | GPT 撰写专业报告 |
| 📤 多模态录入 | PDF / 图片 OCR / 语音 / 文本四种方式导入题目 | GPT-4V + Whisper |
| 🤝 资源分享 | 题目/路线一键共享，支持站内消息通知 | — |
| 👥 多角色 | 学生/教师/管理员角色，独立进度跟踪 | — |
🛠️ 技术栈概览
🖥️ 前端
React 18 · TypeScript · Ant Design 5 · ECharts · Zustand · Vite · React Router 6
⚙️ 后端
Node.js · Express 4 · TypeScript · better-sqlite3 · JWT · bcryptjs · multer
🗄️ 数据库
SQLite（WAL 模式）· better-sqlite3 驱动 · 12 张核心表 · 完整外键约束
🤖 AI 服务
OpenAI SDK · 兼容 DeepSeek / 通义千问 / Kimi 等 · GPT-4V Vision · Whisper ASR
🗂️ 适用场景
- 学生自学：通过 AI 出题进行专项练习，自主制定学习计划
- 教师辅助：批量生成课后练习题，分享给学生并查看班级整体进度
- 家庭教育：家长设置学习目标，孩子完成练习，系统自动生成周报
- 机构部署：支持多用户并发，可部署于私有服务器或云平台
📋 系统要求
| 组件 | 最低版本 | 推荐版本 |
|---|---|---|
| 操作系统 | Linux（Ubuntu 20.04+） | Ubuntu 22.04 LTS |
| Node.js | 18.x | 20.x LTS |
| npm | 8.x | 10.x |
| 内存 | 512 MB | 2 GB+ |
| 磁盘空间 | 500 MB | 2 GB+（用于上传文件） |
| 构建工具 | build-essential + python3 | —（用于编译 better-sqlite3） |
EduBuddy 目前以 SQLite 作为嵌入式数据库，适合中小规模部署（并发用户 <500）。数据库采用 WAL 模式，在读多写少场景下性能优异。