【Hello AI 科技致善】教学助手

乡村教师教学助手 - 项目介绍
一、摘要
面向中国乡村教师群体,在日常教学场景下提供AI辅助教案生成、习题练习、作业批改等核心教学能力,目前通过功能测试验证系统可正常运行,有效降低乡村教师备课时间和教学压力。
二、真实场景与需求
目标人群
• 中国乡村教师:主要分布在偏远地区,师资力量相对薄弱,信息化水平有限
• 承担多学科教学任务的教师
• 教学资源相对匮乏的基层教育工作者
痛点描述

  1. 教案编写耗时:乡村教师往往需要花费大量时间手写教案,且缺乏优质教学资源参考
  2. 作业批改困难:一个教师可能同时负责多个班级,批改作业耗时耗力,批改质量难以保证
  3. 习题资源匮乏:难以获取高质量的练习题库,命题能力有限
  4. 学情分析缺失:缺乏有效的数据化手段了解学生学习情况
  5. 信息化能力有限:部分乡村教师对复杂软件工具不熟悉,需要简洁易用的系统
    现有做法
    • 手工编写教案:依赖教科书和经验,费时费力,缺乏创新
    • 题海战术:大量印发试卷,缺少针对性训练
    • 作业批改粗放:只能检查对错,难以分析学生知识点掌握情况
    • 资源获取困难:网络条件有限,难以获取优质网络教育资源
    为什么不够:
    • 效率低下
    • 缺乏个性化
    • 难以持续
    • 缺乏数据支撑
    三、作品介绍
    项目类型
    Web应用程序 - 乡村教师教学助手
    技术架构
    • 前端:Vue 3 + TypeScript + Element Plus + Vite
    • 后端:Python + FastAPI
    • 数据库:SQLite
    • AI能力:支持 DeepSeek API / 百度千帆API
    核心功能
    模块
    功能描述

教案生成
根据输入的教学主题、年级、科目,AI自动生成完整教案

教案历史
记录历史教案,支持查看、编辑、导出、删除

习题练习
支持选择题、填空题、判断题、简答题四种题型自动生成

习题历史
管理历史习题记录,支持批量删除

作业批改
图片上传作业,AI自动批改并给出分析

作业历史
记录作业批改历史,支持批量删除和导出

学生管理
管理学生信息,录入学生数据

学情分析
可视化展示学生学习数据和分析报告

通知中心
接收系统通知

个人中心
用户信息管理和设置

四、用 SOLO 实现的过程
任务拆解

  1. 需求分析与规划 - 确定项目定位和核心功能
  2. 技术选型与架构设计 - 选择前后端技术栈
  3. 项目初始化与配置 - 搭建开发环境
  4. 数据库设计与实现 - 创建数据模型
  5. 后端API开发 - 实现各功能模块接口
  6. 前端页面开发 - 实现用户界面
  7. 功能测试与修复 - 全面测试并修复问题
  8. 文档编写 - 整理开发规范和项目文档
    关键 Prompt 示例
    创建一个面向乡村教师的AI教学助手Web应用,包含:
  9. 教案生成功能 - 根据主题、年级、科目生成教案
  10. 习题练习功能 - 支持选择题、填空题、判断题、简答题
  11. 作业批改功能 - 图片上传后AI批改
  12. 学情分析功能 - 数据可视化展示
  13. 学生管理功能
    需要完整的前后端代码使用的 SOLO 能力
    • 深度思考 - 分析项目需求和技术方案
    • 代码生成 - 创建完整的前后端代码结构
    • 代码修改 - 修复bug和优化功能
    • 文件操作 - 创建和编辑各类项目文件
    • 搜索能力 - 查找相关代码和文档
    踩过的坑
  14. 模块导入错误 - 修复了后端Python文件中错误的import路径
  15. 404错误 - 补充了缺失的API接口
  16. 前端服务启动问题 - 清理了Vite缓存解决了页面无法打开问题
  17. 浏览器缓存问题 - 多次清理缓存解决静态资源加载问题
    五、成果展示
    代码仓库
    项目路径:e:\github\乡村教师教学助手
    项目结构
    乡村教师教学助手/
    ├── backend/ # 后端项目
    │ ├── app/
    │ │ ├── api/ # API接口
    │ │ ├── models/ # 数据模型
    │ │ ├── schemas/ # 数据模式
    │ │ ├── services/ # 业务逻辑
    │ │ └── main.py # 主入口
    │ └── requirements.txt

    ├── frontend/ # 前端项目
    │ ├── src/
    │ │ ├── api/ # API调用
    │ │ ├── views/ # 页面组件
    │ │ ├── router/ # 路由配置
    │ │ └── …
    │ └── package.json

    ├── docs/ # 文档
    ├── .trae/ # 规则配置
    └── 项目介绍.md运行方式
    后端启动:
    cd backend
    pip install -r requirements.txt
    uvicorn app.main:app --reload --host 0.0.0.0 --port 8000前端启动:
    cd frontend
    npm install
    npm run dev访问地址:http://localhost:5173
    功能演示
  18. 登录注册 - 用户注册和登录功能
  19. 首页 - 数据统计和快速入口
  20. 教案生成 - 输入教学主题,AI自动生成教案






  21. 习题生成 - 选择题型和数量,自动生成练习题


  22. 作业批改 - 上传作业图片,AI智能批改

  23. 学生管理 - 管理和录入学生信息
  24. 学情分析 - 数据可视化展示学习情况



    验证方式
    :white_check_mark: 所有功能模块已通过测试
    :white_check_mark: 前后端联调正常
    :white_check_mark: 界面交互流畅
    :white_check_mark: API接口正常工作
    六、技术亮点
  25. AI能力集成 - 融合DeepSeek和百度千帆API,提供智能教学辅助
  26. 流式响应 - 使用SSE实现AI内容流式输出,提升用户体验
  27. 多种题型支持 - 覆盖主流题型,满足不同学科需求
  28. 数据可视化 - 图表展示学情数据,便于教学决策
  29. 简洁易用 - 针对乡村教师特点,界面简洁,操作简单
  30. 离线优先 - SQLite本地数据库,网络依赖小

仓库地址

这个报错我见过,大概率是端口被占用了。先在终端跑 netstat -ano | findstr :3000(端口号换成你用的),看看有没有别的进程在用这个端口。找到之后 taskkill /F /PID <ID号> 关掉就行。也有可能是之前那个 node 进程没完全退出,端口还挂着,Ctrl+C 关掉终端再重新开一个试。再不行的话删掉 node_modules 下面的 .vite 缓存目录,有时候缓存会导致奇怪问题。

1 个赞

好的 感谢老师指导

1 个赞

这是那个做的好强啊