84 lines
3.1 KiB
Markdown
84 lines
3.1 KiB
Markdown
# ClassFeedback — 课评生成与课堂反馈管理系统
|
||
|
||
穹狼科创多课程体系的课评生成工具。支持 CSP 信奥、AICODE 创意编程、Kitten 图形化三大课程，通过 AI 自动生成个性化课评，集成 OJ 做题数据和出勤管理。
|
||
|
||
## 项目信息
|
||
|
||
- **项目编号**：02
|
||
- **所属**：穹狼科创
|
||
- **管理班级**：9个班，33名学生
|
||
- **课程类型**：CSP / AICODE / K4 / 体验课
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
ClassFeedback/
|
||
├── CLAUDE.md # Claude Code 工作指引（核心文档）
|
||
├── .env # API 配置（校宝 + OJ，不要提交到 Git）
|
||
├── scripts/ # 自动化脚本（详见下方）
|
||
├── config/
|
||
│ └── hw_dict.json # OJ 作业包 ID 映射表（CSP01-CSP07）
|
||
├── data/ # API 拉取的原始数据
|
||
├── output/ # 生成产物
|
||
│ ├── 课评汇总/ # 按周归档的课评（HTML 格式）
|
||
│ ├── CSP03课前小测/ # 课前测试题
|
||
│ ├── AICODE03提示词/ # AI 课提示词手册
|
||
│ ├── AI03网页/ # 学生作品演示页面
|
||
│ ├── 家长沟通/ # 家长沟通记录
|
||
│ └── *.md / *.html # 其他生成文件
|
||
├── docs/ # 文档
|
||
│ ├── README_OJ.md # OJ 数据集成功能说明
|
||
│ └── README_备份说明.md # Git 备份方案说明
|
||
└── input/ # 输入文件（待整理）
|
||
```
|
||
|
||
## 脚本说明
|
||
|
||
| 脚本 | 语言 | 用途 |
|
||
|------|------|------|
|
||
| `analyze_course_student.py` | Python | 通过校宝 API 分析指定课程/学生/课次数据 |
|
||
| `split_feedback.py` | Python | 课评拆分 v1：从课评文本按班级拆分为独立条目 |
|
||
| `split_feedback_v2.py` | Python | 课评拆分 v2：解析逻辑改进版 |
|
||
| `update_feedback_with_oj.py` | Python | 登录 OJ 获取做题数据，追加到反馈文件 |
|
||
| `write_lesson10.py` | Python | 第十课课评批量写入 |
|
||
| `check-api-vs-local.js` | Node.js | API 出勤记录与本地课评交叉核对 |
|
||
| `query-attendance.js` | Node.js | 查询指定时间段的整体出勤率 |
|
||
| `backup.bat` | BAT | Git 本地备份脚本 |
|
||
|
||
## 使用方式
|
||
|
||
### 日常工作流（通过 Claude Code）
|
||
|
||
```
|
||
1. 确认上课信息（班级、课次）
|
||
2. 读取学生档案和风格指南
|
||
3. 提供课堂内容（出勤、作业、表现）
|
||
4. AI 生成课评 → 用户确认 → 保存归档
|
||
```
|
||
|
||
### 查询 OJ 数据
|
||
|
||
```bash
|
||
# 直接对话：「帮我查一下杨林轩最近的做题情况」
|
||
# 指定班级：「查 CSP03 本周 OJ 做题数据」
|
||
# 详细用法见 OJ作业数据API使用说明.md
|
||
```
|
||
|
||
### 查询出勤率
|
||
|
||
```bash
|
||
node scripts/query-attendance.js
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [[CLAUDE.md]] — 完整工作流程和班级信息
|
||
- [[OJ作业数据API使用说明.md]] — OJ API 使用手册
|
||
- [[docs/README_OJ.md]] — OJ 数据集成说明
|
||
- [[docs/README_备份说明.md]] — 备份方案
|
||
|
||
---
|
||
|
||
*维护者：橙子*
|
||
*最后更新：2026-06-16*
|