更新K4课程README,清理旧的班级记忆文件,调整目录结构
This commit is contained in:
93
docs/README_OJ.md
Normal file
93
docs/README_OJ.md
Normal file
@@ -0,0 +1,93 @@
|
||||
# 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数据是客观参考,最终课评会结合老师的课堂观察进行调整
|
||||
Reference in New Issue
Block a user