Normal view

There are new articles available, click to refresh the page.
Yesterday — 8 October 2025Main stream

开源! Vue3 + Nest.js+DeepSeek 开发 AGIC(能豆 AI 批改助手)

8 October 2025 at 14:05
itwangtian:

前言

大家好,我是一诺。国庆假期回老家带了几天,鬼天气忽冷忽热的 我和儿子都生病了。

也没有出去玩,除了在家带娃,空闲时间开源了能豆 ai 批改助手

说下产品背景

我有个朋友是英语老师,常熬夜批改作文。平时在用 DeepSeek 批改作业,可没办法批量修改,很特别麻烦。就希望能有个可以统一管理作业,沉淀教学数据的工具。

于是就有了"能豆 AI"这个产品,集成 DeepSeek 分析能力 ,实现了学生在线提交作业 → AI 实时批改 → 教师人工核实批改的完整业务闭环。

核心功能-ai 批改作业

ca3c8ae8-2f25-48af-a05a-f7db06a437c1.gif

为什么叫能豆 AI 。

我在设计 logo ,不知道叫什么好。这时我儿子在扶着墙学走路,他刚 9 个月刚会爬就想尝试走~ ,那就叫"能豆 AI"吧,因为我儿子的小名叫豆豆。

在线预览

在线体验 http://ai.dslcv.com/

仓库地址

  1. github ➡️ https://github.com/yinuoguan/nengdou-ai-review-helper-web
  2. gitee ➡️ https://gitee.com/wang-tians-laboratory/nengdou-ai-review-helper-web
  3. 接口文档 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 批改流程:

image.png

批改质量保障:

  • 多轮提示词优化,确保批改一致性
  • 人工复核机制,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 点评和老师批注

❌
❌