94 lines
3.2 KiB
Markdown
94 lines
3.2 KiB
Markdown
# CSP学生OJ数据集成功能说明
|
||
|
||
## 功能概述
|
||
|
||
本项目现在已经集成了OJ数据获取和分析功能，可以自动从Hydro OJ系统获取学生的作业提交数据，结合学生画像和课堂表现，生成个性化的课评反馈。
|
||
|
||
## 文件结构说明
|
||
|
||
```
|
||
.claude/
|
||
├── rules/
|
||
│ └── oj_data.md # OJ数据获取和分析规则
|
||
├── skills/
|
||
│ ├── claude_skill.md # 技能总览
|
||
│ ├── generate_feedback_skill.md # 课评生成技能（集成OJ数据）
|
||
│ ├── student_profile_collector_skill.md # 学生画像采集技能
|
||
│ └── periodic_summary_skill.md # 周期性总结生成技能
|
||
└── config/
|
||
└── hw_dict.json # OJ作业ID映射表（包含CSP01-CSP07所有课次的作业ID）
|
||
|
||
scripts/
|
||
├── update_feedback_with_oj.py # OJ数据获取和分析脚本
|
||
└── analyze_course_student.py # 课程学生数据分析脚本
|
||
|
||
.env.example # OJ配置示例文件
|
||
```
|
||
|
||
## 配置步骤
|
||
|
||
1. 复制.env.example为.env，并填写你的OJ账号信息：
|
||
```
|
||
OJ_BASE_URL=https://oj.qonnwolf.com
|
||
OJ_USERNAME=你的OJ用户名
|
||
OJ_PASSWORD=你的OJ密码
|
||
|
||
# 默认学生账号密码（CSP03学生统一使用）
|
||
DEFAULT_OJ_PASSWORD=codemao888
|
||
```
|
||
|
||
2. 学生账号配置：
|
||
- CSP03学生：账号为学生姓名（中文名/全拼），密码统一为`codemao888`
|
||
- 其他班级：可在`.claude/config/oj_accounts.json`中配置对应班级的账号规则和默认密码
|
||
|
||
3. 确保hw_dict.json中的作业ID与实际OJ中的作业ID一致，如果有不一致的情况，可以手动修改。
|
||
|
||
## 使用方法
|
||
|
||
### 1. 生成课后反馈
|
||
使用触发词："写 [班级] [课程代码] 的课后反馈"
|
||
例如："写 周六上午CSP03班 CSP03-05 的课后反馈"
|
||
|
||
系统会自动：
|
||
- 获取该课次的OJ作业提交数据
|
||
- 分析每个学生的完成情况、错误类型、提交次数
|
||
- 结合学生画像和课堂表现生成个性化课评
|
||
- 生成班级整体反馈和微信群版本
|
||
|
||
### 2. 生成周期性总结
|
||
使用触发词："给我 [学生姓名] 的月度总结" 或 "给我 [班级名] 的季度总结"
|
||
系统会自动分析该时间段内的所有OJ数据和课评记录，生成成长总结。
|
||
|
||
### 3. 手动运行脚本获取OJ数据
|
||
```bash
|
||
python scripts/update_feedback_with_oj.py \
|
||
--course CSP03-05 \
|
||
--title "递归算法应用" \
|
||
--class-name "周六上午CSP03班" \
|
||
--date 20260506 \
|
||
--students "张三,李四,王五"
|
||
```
|
||
|
||
## 支持的CSP课程
|
||
目前已支持CSP01到CSP07所有课次的作业ID映射，覆盖：
|
||
- CSP01（入门级）
|
||
- CSP02（基础级）
|
||
- CSP03（进阶级）
|
||
- CSP04（提高级）
|
||
- CSP05（竞赛级入门）
|
||
- CSP06（竞赛级提高）
|
||
- CSP07（竞赛级冲刺）
|
||
|
||
## OJ数据分析维度
|
||
系统会自动分析每个学生的：
|
||
- 作业完成率（AC题数/总题数）
|
||
- 提交次数和调试效率
|
||
- 错误类型分布（WA/RE/CE/TLE等）
|
||
- 知识点掌握情况
|
||
- 学习趋势和进步情况
|
||
|
||
## 注意事项
|
||
1. OJ课次编号可能与课程大纲编号不一致，系统会自动按标题匹配
|
||
2. 如果作业ID映射不准确，可以手动修改.claude/config/hw_dict.json
|
||
3. OJ数据是客观参考，最终课评会结合老师的课堂观察进行调整
|