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 已正确安装
|