前言
大家好，我是一诺。国庆假期回老家带了几天，鬼天气忽冷忽热的 我和儿子都生病了。
也没有出去玩，除了在家带娃，空闲时间开源了能豆 ai 批改助手
说下产品背景
我有个朋友是英语老师，常熬夜批改作文。平时在用 DeepSeek 批改作业，可没办法批量修改，很特别麻烦。就希望能有个可以统一管理作业，沉淀教学数据的工具。
于是就有了"能豆 AI"这个产品，集成 DeepSeek 分析能力 ，实现了学生在线提交作业 → AI 实时批改 → 教师人工核实批改的完整业务闭环。
核心功能-ai 批改作业
为什么叫能豆 AI 。
我在设计 logo ，不知道叫什么好。这时我儿子在扶着墙学走路，他刚 9 个月刚会爬就想尝试走~ ，那就叫"能豆 AI"吧，因为我儿子的小名叫豆豆。
在线预览
在线体验 http://ai.dslcv.com/
仓库地址
- github ➡️ https://github.com/yinuoguan/nengdou-ai-review-helper-webgitee ➡️ https://gitee.com/wang-tians-laboratory/nengdou-ai-review-helper-web接口文档 http://124.222.166.174:3002/api/docs
架构图
总体架构图
业务流程
技术选型
前端技术栈
选择 Vue 3 + TypeScript 作为前端框架，之前一诺维护的老项目都是 vue2 ， 这次全面使用 Vue3 开发，发现用 Composition API 写起来更灵活，特别是处理复杂的业务逻辑时。
Vuex 用来管理全局状态，比如用户登录信息。局部状态还是放在组件里，这样代码更清晰。
Element Plus 是因为组件比较全面。配合 Tailwind CSS 做一些个性化的样式调整，开发速度很快。
后端技术栈
后端用的是 NestJS，说实话一开始也考虑过 Express ，但 NestJS 的装饰器和模块化设计确实香，代码组织得很清晰。
JWT 做身份认证，无状态的，扩展性好。Swagger 自动生成 API 文档。
数据存储
MongoDB 选择的原因很简单：作业数据结构比较灵活，不同类型的作业字段差异很大，用文档数据库比关系型数据库方便多了。而且 MongoDB 的查询也够用，性能也不错。
Redis 主要用来缓存一些热点数据和存储用户会话，毕竟内存数据库速度快，用户体验好。
AI 大模型
DeepSeek 是主力，性价比真的很高，批改质量也不错。关键是 API 调用稳定，价格也能接受。
后来又集成了豆包，主要是想让 AI 的反馈更温馨一点，豆包在情感表达这块做得比较好，学生看到反馈不会那么有压力。
两个模型配合使用，DeepSeek 负责专业的内容分析，豆包负责鼓励和引导，效果比单用一个模型好很多。
核心模块
1.班级管理
这是系统的基础模块，解决了教师管理多个班级的痛点：
核心功能：
- ✅ 创建班级：支持自定义班级名称、描述和邀请码✅ 学生管理：通过邀请码机制，学生可以自主加入班级✅ 状态管理：可以暂停/激活学生，灵活管理班级人员✅ 实时统计：学生数量和作业完成情况一目了然
2. 作业提交与批改模块
状态流转管理：
核心特性：
- 学生端：专用提交和查看功能，界面简洁易用教师端：批改和统计管理功能，支持批量操作管理员端：AI 批改和日志管理，系统监控
3. AI 批改集成
这是系统的技术亮点，与 DeepSeek 的深度集成：
AI 批改能力：
mindmap root((AI 批改)) DeepSeek 语法检查 逻辑分析 内容评估 豆包 情感识别 温馨反馈 学习引导 评分 多维度评价 个性化建议 数据洞察AI 批改流程：
批改质量保障：
- 多轮提示词优化，确保批改一致性人工复核机制，AI + 人工双重保障批改日志记录，便于分析和改进异步处理机制，不阻塞用户操作
4. 权限管理系统
graph TB A[超级管理员] --> B[系统配置] A --> C[用户管理] A --> D[数据监控] E[教师] --> F[班级管理] E --> G[作业发布] E --> H[批改审核] I[学生] --> J[加入班级] I --> K[提交作业] I --> L[查看成绩]功能展示
管理员端功能
主要功能：
- 系统配置管理：AI 模型参数调整，批改规则配置用户权限管理：教师和学生账号管理，权限分配数据统计分析：批改效率统计，系统使用情况分析批改日志查看：AI 批改过程追踪，质量监控
控制台看板
大模型配置 && 用户管理
教师端功能
主要功能：
- 班级创建与管理：一键创建班级，邀请码分享作业发布与管理：灵活的作业类型，截止时间设置批改结果查看：AI 初评结果查看，人工复核操作学生成绩统计：班级整体表现分析，个人进步追踪
工作台
创建班级
添加学生
发布作业
配置 AI 批改规则
作业详情
批改作业
学生端功能
主要功能：
- 班级加入：通过邀请码快速加入班级作业提交：支持草稿保存，多次修改提交批改结果查看：详细的 AI 评语和教师点评学习进度追踪：个人作业历史，成绩变化趋势
激活账户
学习中心
班级作业
提交作业
查看结果
AI 点评和老师批注
