2311061111-lyt/autograde/README.md

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