generated from Java-2025Fall/final-vibevault-template
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# 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 已正确安装
|