# Homework Grader

> 老师作业批改助手，用于自动批改数学作业、统计错题、生成Excel统计表和PDF报告。当老师需要：(1) 上传正确答案并让AI识别 (2) 批量上传学生作业照片进行批改 (3) 统计全班错误率并生成错题分析报告 (4) 生成重点错题PDF供讲解使用时，触发此skill。

- Skill: `dvcrn/homework-grader` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add dvcrn/homework-grader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/homework-grader/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/homework-grader

---


# Homework Grader - 作业批改助手

## Overview

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

## 依赖安装

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

### Python 包
```bash
pip install -r scripts/requirements.txt
```

### 系统依赖（必须安装）
```bash
# Ubuntu/Debian
sudo apt install tesseract-ocr

# macOS
brew install tesseract

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

## Workflow

### 完整工作流程

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

---

## Step 1: 上传正确答案

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

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

---

## Step 2: 上传学生作业

循环上传学生作业照片。

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

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

---

## Step 3: 生成 Excel 统计表

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

**输出 Excel 包含：**
- 学生姓名/序号
- 各题对错情况
- 正确题数、错误题数
- 错误率百分比

---

## Step 4: 生成 PDF 报告

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

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

---

## 配置说明

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| threshold | 重点错题错误率阈值 | 40% |

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

---

## Resources

### scripts/requirements.txt
Python 依赖包列表

### scripts/
- `ocr_helper.py` - OCR 识别辅助工具
- `generate_excel.py` - 生成 Excel 统计表
- `generate_pdf.py` - 生成 PDF 分析报告

### references/
- `answer_format.md` - 答案格式规范
- `output_format.md` - 输出格式说明

### assets/
- `report_template.html` - PDF 报告 HTML 模板