英语作文 AI 批改系统

功能

• 教师管理班级，Excel 批量导入学生
• 学生上传手写作文（JPG / PNG / PDF）
• 两种 AI 评分模式：
  • 单模型模式：由一个指定模型直接评分
  • 陪审团模式（Jury）：多个模型独立评分，再由仲裁者综合生成最终报告
• 支持对已评分作文重新评分（Regrade）；重新评分时自动清除旧的陪审团结果，防止历史数据残留
• 双语评分报告（中英文）+ PDF 导出
• 支持的 AI 提供商：Qwen VL（阿里云通义千问）/ DashScope（灵积）/ Gemini（Google）
• OCR 文字识别 + 图像直接评分两种方式

技术栈

• Next.js 16 (App Router) + TypeScript + Tailwind CSS v4
• MongoDB + Mongoose + NextAuth v5
• OpenAI SDK（Qwen / DashScope）+ @google/generative-ai（Gemini）
• @react-pdf/renderer（PDF 导出）+ xlsx（Excel 导入/导出）

本地运行

环境要求

• Node.js 18+
• MongoDB（本地或 Atlas）

安装

npm install

环境变量

复制 .env.local.example 为 .env.local 并填写：

MONGODB_URI=mongodb://localhost:27017/essay-grading
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=<random-32-char-string>
ENCRYPTION_KEY=<64-hex-chars-32-bytes>
GOOGLE_AI_STUDIO_KEY=<your-google-ai-studio-key>

Qwen / DashScope API Key 在教师设置页面中输入，加密存储于数据库。

运行

npm run dev

访问 http://localhost:3000

使用流程

1. 教师注册账号 → 创建班级 → Excel 导入学生
2. 在设置页面配置 AI 模型（选择单模型或陪审团模式、指定各模型）
3. 学生用学号登录 → 上传作文图片/PDF → 等待评分
4. 查看评分报告 → 一键 Regrade 重新评分 → 导出 PDF

近期修复

• 单模型重评 / 陪审团结果残留：在 gradeEssay()（单模型路径）完成写入 gradingResult 后，同时清除 juryResults 和 juryStatus，防止切换回单模型重评时旧陪审团数据仍显示在详情页。