# auto-grade

**Repository Path**: mrbadcoder/auto-grade

## Basic Information

- **Project Name**: auto-grade
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Auto Grader - 自动批改作业系统

基于 Claude Code 的学生作业自动批改系统，支持从 Gitee 仓库拉取学生作业并使用 AI 进行智能评分。

## 功能特性

- 自动从 Gitee 仓库拉取学生作业
- AI 智能分析题目要求和评分标准
- 支持多种文件格式（代码、文档、图片）
- 自动生成成绩表和评分细则
- 支持重新批改异常分数

## 快速开始

### 前置要求

- Python 3.6+
- openpyxl 库（`pip install openpyxl`）
- Git
- Claude Code CLI

### 安装使用

```bash
# 1. Clone 项目
git clone https://gitee.com/mrbadcoder/auto-grade.git

# 2. 进入项目目录（可随意重命名文件夹）
cd auto-grade

# 3. 安装依赖
pip install openpyxl

# 4. 在项目目录下启动 Claude Code
claude
```

### 使用流程

```
┌─────────────────────────────────────────────────────────────┐
│  1. /gradeinit - 初始化环境                                  │
│     创建 homework/、grades/ 目录和 student.xlsx              │
│     ↓                                                       │
│  2. 准备作业材料                                              │
│     - 将作业文档放入 homework/ 文件夹                         │
│     - 在 student.xlsx 填写学生信息                           │
│     ↓                                                       │
│  3. /grade - 批改作业                                        │
│     选择作业 → AI 批改 → 生成成绩表                           │
│     ↓                                                       │
│  4. /regrade - 重批异常（可选）                               │
│     仅重新批改分数异常的学生                                  │
└─────────────────────────────────────────────────────────────┘
```

## 目录结构

```
project/
├── homework/              # 老师发布的作业文档
│   ├── 实验任务一.docx
│   └── 实验任务二.pdf
├── student.xlsx           # 学生信息表
├── grades/                # 批改后的成绩
│   ├── 实验任务一.xlsx
│   └── 实验任务二.xlsx
└── temp/                  # 临时文件夹（自动创建和清理）
```

## student.xlsx 格式

| 学号 | 姓名 | 仓库地址 |
|------|------|----------|
| 2024001 | 张三 | https://gitee.com/zhangsan/homework.git |
| 2024002 | 李四 | https://gitee.com/lisi/homework.git |

## 支持的文件格式

- **文档**：`.doc`, `.docx`, `.pdf`, `.txt`
- **代码**：`.py`, `.java`, `.js`, `.ts`, `.c`, `.cpp`, `.go`, `.rs` 等
- **图片**：`.png`, `.jpg`, `.jpeg`, `.gif`, `.bmp`

## 成绩表格式

| 学号 | 姓名 | 成绩 | 分数 | 评分细则 |
|------|------|------|------|----------|
| 2024001 | 张三 | 正常 | 85 | 第一题扣5分：代码格式不规范；第三题扣10分：边界条件未处理 |
| 2024002 | 李四 | 正常 | 92 | 第二题扣8分：缺少异常处理 |

## 命令说明

| 命令 | 功能 |
|------|------|
| `/gradeinit` | 初始化批改环境，创建必要目录和文件 |
| `/grade` | 批改指定作业，生成成绩表 |
| `/regrade` | 重新批改标记为"分数异常"的学生 |

## 注意事项

1. 学生仓库中需有对应作业文件夹（如 `实验任务一/`）
2. 文件夹名称需与作业文档名称对应
3. 分数异常的学生会被标记，可用 `/regrade` 重新批改

## License

MIT