# VibeVault 自动评分配置

本目录包含 VibeVault 项目的自动评分配置和脚本，用于指导自动评分工具识别和执行评分流程。

## 目录结构

```
autograde/
├── run.sh          # 主评分脚本，包含核心评分逻辑
├── config.yml      # 评分配置文件，定义评分步骤和关键文件
└── README.md       # 本说明文件
```

## 评分流程

自动评分流程主要包括以下步骤：

1. **运行编程测试**：使用 Gradle 运行项目中的测试用例
2. **编程测试评分**：使用 `grade_grouped.py` 对编程测试结果进行评分
3. **报告评分**：使用 `llm_grade.py` 对 REPORT.md 进行评分
4. **前端报告评分**：使用 `llm_grade.py` 对 FRONTEND.md 进行评分
5. **聚合最终成绩**：使用 `aggregate_final_grade.py` 聚合各部分成绩
6. **生成 PDF 报告**：使用 `generate_pdf_report.py` 生成最终评分报告

## 关键文件

- **run.sh**：主评分脚本，执行所有评分步骤
- **config.yml**：评分配置文件，定义评分流程和关键文件
- **test_groups.json**：测试分组配置（项目根目录）
- **REPORT.md**：后端与系统设计报告（项目根目录）
- **FRONTEND.md**：前端界面与交互设计报告（项目根目录）
- **.llm_rubrics/**：LLM 评分标准目录（项目根目录）

## 使用方法

1. 确保项目已通过 Gradle 构建并运行测试
2. 执行 `./autograde/run.sh` 启动评分流程
3. 查看生成的评分文件和报告

## 注意事项

- 本目录的配置与 `.gitea/workflows/autograde.yml` 保持一致
- 评分脚本依赖外部获取的评分工具（在 CI 流程中自动下载）
- 确保 Python 3 和 Gradle 已正确安装