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配置示例文件

配置步骤

复制.env.example为.env，并填写你的OJ账号信息：

OJ_BASE_URL=https://oj.qonnwolf.com
OJ_USERNAME=你的OJ用户名
OJ_PASSWORD=你的OJ密码

# 默认学生账号密码（CSP03学生统一使用）
DEFAULT_OJ_PASSWORD=codemao888

学生账号配置：
- CSP03学生：账号为学生姓名（中文名/全拼），密码统一为codemao888
- 其他班级：可在.claude/config/oj_accounts.json中配置对应班级的账号规则和默认密码
确保hw_dict.json中的作业ID与实际OJ中的作业ID一致，如果有不一致的情况，可以手动修改。

使用方法

1. 生成课后反馈

使用触发词："写 [班级] [课程代码] 的课后反馈" 例如："写周六上午CSP03班 CSP03-05 的课后反馈"

系统会自动：

获取该课次的OJ作业提交数据
分析每个学生的完成情况、错误类型、提交次数
结合学生画像和课堂表现生成个性化课评
生成班级整体反馈和微信群版本

2. 生成周期性总结

使用触发词："给我 [学生姓名] 的月度总结" 或 "给我 [班级名] 的季度总结" 系统会自动分析该时间段内的所有OJ数据和课评记录，生成成长总结。

3. 手动运行脚本获取OJ数据

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等）
知识点掌握情况
学习趋势和进步情况

注意事项

OJ课次编号可能与课程大纲编号不一致，系统会自动按标题匹配
如果作业ID映射不准确，可以手动修改.claude/config/hw_dict.json
OJ数据是客观参考，最终课评会结合老师的课堂观察进行调整

3.2 KiB Raw Blame History Unescape Escape