# SmartEval

**Repository Path**: shadow_stock/smart-eval

## Basic Information

- **Project Name**: SmartEval
- **Description**: 基于大语言模型的智能实验报告自动批改系统，解决高校实验教学中实验报告批改任务繁重、反馈滞后、质量监测不足等突出问题
- **Primary Language**: Python
- **License**: CC-BY-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-31
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学生作业批改系统

这是一个基于Python的学生作业批改系统，用于自动化批改Word格式的学生作业。

## 功能特点

- 自动检查文档格式（字体、间距、页边距等）
- 检查文档结构（目录、标题层级等）
- 检查文档内容（内容长度、引用等）
- 生成详细的批改报告
- 支持批量处理多个文档
- 保持原始文件不变，生成新的批改报告

## 安装要求

- Python 3.6+
- 依赖包（见requirements.txt）：
  - python-docx
  - pandas
  - numpy
  - Pillow
  - tqdm

## 安装步骤

1. 克隆或下载本项目
2. 安装依赖包：
   ```bash
   pip install -r requirements.txt
   ```

## 使用方法

1. 准备学生作业文件：
   - 将学生作业文件放在一个目录中
   - 文件名格式必须为：`学号_姓名.doc` 或 `学号_姓名.docx`

2. 运行批改程序：
   ```bash
   python main.py <输入目录> <输出目录>
   ```

   将从config.json中读取

3. 查看结果：
   - 批改报告将保存在输出目录的 `reports` 子目录中
   - 日志文件将保存在输出目录的 `logs` 子目录中
   - 统计信息将保存在输出目录的 `statistics` 子目录中

## 输出说明

系统会为每个学生作业生成一个批改报告，包含以下内容：
- 学生信息
- 格式检查结果
- 内容检查结果
- 结构检查结果
- 具体问题和建议

## 注意事项

- 确保输入目录中的文件名格式正确
- 确保有足够的磁盘空间存储输出文件
- 建议定期备份输出目录中的文件

## 开发说明

项目结构：
```
homework_grading_system/
├── main.py                 # 主程序入口
├── graders/               # 批改相关代码
│   └── document_grader.py # 文档批改核心类
├── utils/                 # 工具函数
│   ├── file_utils.py     # 文件操作工具
│   └── logger.py         # 日志工具
└── README.md             # 项目说明文档
```