作业批改助手

概述

帮助老师自动批改数学作业，统计错题信息，生成 Excel 统计表和 PDF 分析报告。

依赖安装

运行此技能前需要安装以下依赖：

Python 包

系统依赖（必须安装）

Ubuntu/Debian

macOS

Windows

下载安装：https://github.com/UB-Mannheim/tesseract/wiki

工作流程

完整工作流程

步骤 1: 上传正确答案 → AI OCR 识别
↓
步骤 2: 循环上传学生作业 → AI 批改 → 记录结果
↓
步骤 3: 统计错误率 → 生成 Excel 统计表
↓
步骤 4: 生成 PDF 报告（含重点标记）

步骤 1: 上传正确答案

老师上传包含正确答案的图片（可以是纸质答案照片或电子版截图）。

AI 行为：

1. 1. 使用 OCR 识别图片中的答案
2. 解析答案内容，按题目编号存储
3. 向老师确认识别结果是否正确
4. 如需修改，允许老师手动调整

步骤 2: 上传学生作业

循环上传学生作业照片。

交互流程：

1. 1. 询问老师请上传学生作业照片
2. 提供学生姓名输入框（可选填写）
3. 如果不填姓名，使用序号标识（如：学生1、学生2）
4. 重复步骤1-3，直到老师说上传完成

AI 行为：

1. 1. OCR 识别学生作业内容
2. 与正确答案比对
3. 标记正确/错误
4. 记录错误类型

步骤 3: 生成 Excel 统计表

当老师说生成统计表或上传完成时：

输出 Excel 包含：

• - 学生姓名/序号
• 各题对错情况
• 正确题数、错误题数
• 错误率百分比

步骤 4: 生成 PDF 报告

当老师说生成 PDF或生成报告时：

PDF 内容：

1. 1. 班级概况 - 总人数、提交人数、平均正确率
2. 错题统计表 - 每道题的错题人数、错误率
3. 重点错题 - 错误率 ≥ 配置阈值的题目（默认40%）
4. 讲解建议 - AI 针对重点错题提供的解题思路和讲解要点

配置说明

修改阈值： 老师可以说设置阈值为 30%来调整

资源

scripts/requirements.txt

scripts/

• - ocrhelper.py - OCR 识别辅助工具
• generateexcel.py - 生成 Excel 统计表
• generate_pdf.py - 生成 PDF 分析报告

references/

• - answerformat.md - 答案格式规范
• outputformat.md - 输出格式说明

assets/

• - report_template.html - PDF 报告 HTML 模板