更新课评系统代码

This commit is contained in:
qiuyan
2026-06-02 23:01:58 +08:00
parent f8c4b6174f
commit cd05b8a5a7
45 changed files with 8260 additions and 345 deletions

View File

@@ -1,7 +1,12 @@
# 学生特殊处理:补课、新学生、转正
> 从 20-workflow.md 拆分,专注补课/体验/新学生/转正规则
> 版本v4.0 | 更新日期2026-05-14
> 版本v4.5 | 更新日期2026-05-20
>
> **v4.5 变更**:简化补课存储规则 — 取消补课专用目录和双向记录,补课记录统一保存在学生原班级,文件名加 `_补课` 后缀
> **v4.4 变更**:统一版本号至 v4.4;更新日期
> **v4.2 变更**:统一禁用"今天";删除示例中禁止的时间表述
> **v4.1 变更**:新增表单补课区入口说明 — 补课/体验学生可通过网页表单的「补课/体验学生区」录入
>
> **v4.0 变更**同步课评规范V1.0 — 新增补课双向记录规则;更新存储路径为 `.claude/memory/class/` 标准结构;新增补课目录 `补课/` 专用路径
@@ -11,12 +16,15 @@
### 1.1 核心规则
**绝对禁止**课评正文中绝对不能提及学生来补课相关内容
**录入入口**补课/体验学生可通过 [网页表单的「补课/体验学生区」](20-workflow.md#step-3-网页表单填写form-first-模式) 录入(选择班级后自动创建),也可在聊天中直接输入 `姓名 [补课]` 格式
**绝对禁止**:课评正文(给家长看的部分)绝对不能提及学生来补课相关内容。
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"
- ❌ 禁止暗示学生非正常上课("今天特别来参加"、"临时加入"、"从其他班级过来"
- ❌ 禁止暗示学生非正常上课("本节课特别来参加"、"临时加入"、"从其他班级过来"
- ✅ 课评正文完全按正常学生撰写
-`[补课]`标记仅用于后台档案管理
- ✅ 文件开头元信息可以标注补课来源(如"(补课,来自 AICODE06洋芋周日1400"),不影响家长阅读的正文内容
**示例**
@@ -29,10 +37,10 @@
课评输出(错误):
小红本节课作为补课学生,学习了"旋转飞机"... ❌
小红今天来补课,学习了"旋转飞机"... ❌
小红来补课,学习了"旋转飞机"... ❌
```
### 1.2 补课学生分类处理
### 1.2 补课学生分类处理v4.5更新)
**情况A自己班级的学生补课**
- **判断**:学生在 `.claude/memory/class/{当前班级}/` 目录中存在
@@ -40,9 +48,10 @@
**情况B跨班级补课档案在其他班级**
- **判断**:学生在 `.claude/memory/class/{其他班级}/` 目录中存在
- **处理**自动跨班级保存(课评规范标准)
-课评文件保存到补课班级的 `补课/{学生名}/feedback/YYYYMMDD_课程编号.md`
-原班级侧生成补课追踪文件 `feedback/YYYYMMDD_课程编号-课次(补课-去班级名).md`
- **处理**课评文件保存到学生原班级的 `feedback/YYYYMMDD_课程编号-课次_补课.md`
-文件名加 `_补课` 后缀,一眼识别
-文件内容开头标注补课信息(补课时间、补课班级)
- ✅ 课评正文正常撰写,不提及补课
- **无需询问,自动完成**
**情况C其他老师班级补课学生**
@@ -51,7 +60,7 @@
- [1] 保存到补课班级的 `补课/{学生名}/feedback/`(仅班级记录)
- [2] 创建新档案(在本班建立 `profile.md`
### 1.3 跨班级补课示例
### 1.3 跨班级补课示例v4.5更新)
```
教师输入:班级:发现世界-周六09点林瀚丞[补课]:积极分析课程任务,专注完成了绿色身体、黑色头部的蜥蜴设计
@@ -62,11 +71,14 @@ AI检测
判断跨班级补课学生原班级周四19点补课班级周六09点
自动处理(课评规范标准
补课班级侧:保存到「补课/林瀚丞/feedback/YYYYMMDD_DISC-008.md」
内容开头注明"(补课,来自 发现世界-周四19点"
→ 原班级侧:保存到「林瀚丞/feedback/YYYYMMDD_DISC-008(补课-去发现世界-周六09点).md」
(简要记录补课去向)
自动处理(v4.5简化规则
保存到原班级:「林瀚丞/feedback/YYYYMMDD_DISC-008_补课.md」
文件内容开头标注:
- 课程代码DISC-008
- 课程主题:蜥蜴
- 补课班级:发现世界-周六09点
- 补课时间:周日 09:00
(正文正常撰写,不提及补课)
```
---
@@ -116,32 +128,90 @@ AI检测
---
## 四、课评规范V1.0补课记录要求
## 四、补课存储规则v4.5更新)
### 4.1 补课目录结构
### 4.1 新规则核心变更
| 版本 | 存储方式 | 说明 |
|------|---------|------|
| v4.4及以前 | 双向记录 + 补课专用目录 | 原班级和补课班级各存一份,创建`补课/`目录 |
| **v4.5** | **单记录 + 原班级保存** | **只保存在学生原班级,文件名加`_补课`后缀** |
### 4.2 v4.5存储结构
```
.claude/memory/class/{学生原班级}/
├── 学生姓名/
│ ├── profile.md
│ ├── summary/
│ │ └── 成长素材.md
│ └── feedback/
│ ├── 20260419_DISC-007.md ← 正常上课
│ ├── 20260505_DISC-009_补课.md ← 补课记录(文件名加后缀)
│ └── 20260509_DISC-010(请假).md
```
### 4.3 补课文件格式
**文件名**`YYYYMMDD_课程编号-课次_补课.md`
**文件内容**
```markdown
# DISC-009 课评
**日期**: 2026-05-05
**课评内容**
- 课程代码DISC-009
- 课程主题:机器人瓦力
- 补课班级周日9:00补课班级
- 原班级:发现世界-周六09点
嘉铭本节课学习了"机器人瓦力"...
(正文正常撰写,不提及补课)
**教师备注**
- 亮点:
- 需关注:
- 确认状态:☑ 已确认2026-05-05
```
### 4.4 规则优势
-**学生所有记录在一个文件夹**:方便查看完整学习轨迹
-**一眼识别补课记录**:通过 `_补课` 后缀区分
-**避免临时班级目录**:不再创建 `周日9点` 等补课专用班级
-**简化存储结构**:取消双向记录,减少文件冗余
---
## 五、历史规则存档v4.4及以前)
> 以下规则已于 v4.5 废弃,仅作参考
### 5.1 已废弃补课目录结构v4.4
```
.claude/memory/class/{补课班级}/
├── 学生姓名/ ← 正式学生
│ └── feedback/
│ └── YYYYMMDD_课程编号.md
└── 补课/ ← 补课学生专用
│ └── YYYYMMDD_课程编号-课次.md
└── 补课/ ← 补课学生专用(已废弃)
└── {学生姓名}/
└── feedback/
└── YYYYMMDD_课程编号.md
└── YYYYMMDD_课程编号-课次.md
```
### 4.2 双向记录
### 5.2 已废弃双向记录v4.4
**补课产生两条文件记录**
| 位置 | 文件名 | 内容 |
|------|--------|------|
| 原班级侧 | `feedback/YYYYMMDD_课程编号-课次(补课-去班级名).md` | 记录"去了哪补课" |
| 补课班级侧 | `补课/{学生}/feedback/YYYYMMDD_课程编号.md` | 正常课评,开头注明来源 |
| 原班级侧 | `feedback/YYYYMMDD_课程编号-课次(补课-去班级名).md` | 记录"去了哪补课",无正文 |
| 补课班级侧 | `补课/{学生}/feedback/YYYYMMDD_课程编号-课次.md` | 正常课评,文件开头注明来源 |
### 4.3 自动化统计影响
---
- 补课学生必须在补课班级的 `补课/` 目录下有课评文件
- 原班级侧的 `(补课-去...).md` 文件用于标记出勤状态(补课=到课)
- 系统三级查找的第二级会搜索所有 `补课/` 目录
*规则版本v4.5 | 更新日期2026-05-20*