初始化课评系统仓库:包含规则配置、学生档案、课程教案、班级汇总

This commit is contained in:
qiuyan
2026-05-08 14:15:00 +08:00
commit 16af260a11
300 changed files with 30338 additions and 0 deletions

View File

@@ -0,0 +1,388 @@
# 新学生与补课学生处理规则 v1.3
> 统一规范首次上课新学生与补课学生的课评处理
>
> **v1.3 更新**:优化跨班级补课处理 - 检测到跨班级补课学生时**自动**完成双轨保存(班级汇总+跨班级个人档案),无需询问
>
> **v1.2 更新**:新增跨班级补课处理 - 支持将课评跨班级保存到原个人档案,便于追踪完整成长轨迹
---
## 核心规则
### 规则1首次上课新学生
**定义**
- 从未在本机构上过任何课程的学生
- 刚报名入学的学生
**课评提及条件**
- **仅在教师输入中明确写明"第一次上课"、"新学生"等关键词时,才能在课评中提及**
- 如果教师未明确说明,课评中**不自动添加**"这是孩子第一次上课"等表述
**正确示例**
```
教师输入小明第一次上课开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课,开始有点害羞...
```
**错误示例**
```
教师输入小明开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课... ❌(教师未说明)
```
---
### 规则2补课学生分两种情况处理
**补课学生定义**
因各种原因(请假、调课等)需要在非原班级时间补课的学生。
**⚠️ 重要:补课学生分两类,处理方式不同**
#### 情况A自己班级的学生补课
- **判断标准**:学生在 `memory/student/{当前班级}/` 目录中存在
- **处理方式****正常双轨保存**(班级汇总 + 个人档案)
- **说明**:这是你自己的学生,只是补课,无需额外确认
**示例**
```
教师输入:乔乔[补课]搭了3层开心
AI检测乔乔在本班级档案中存在 → 按正式学生处理
处理结果:双轨保存
```
#### 情况B跨班级补课档案在其他班级
- **判断标准**:学生在 `memory/student/{其他班级}/` 目录中存在(跨班级补课)
- **处理方式****自动双轨保存(跨班级模式)**
- 课评保存到**补课班级**周汇总(当前班级)
- 课评**自动追加**到**原班级**个人历史课评记录.md标注补课班级信息
- **无需询问,自动完成**
- **跨班级保存说明**如果学生档案在A班来B班补课
- 课评保存到B班班级周汇总
- 课评追加到A班个人历史课评记录.md标注"【跨班级补课】在B班完成"
**跨班级补课自动处理示例**
```
教师输入:班级:发现世界-周六09点林瀚丞[补课]搭了3层开心
AI检测 未找到「林瀚丞」在「发现世界-周六09点」的个人档案
✅ 找到「林瀚丞」在「发现世界-周四19点」的个人档案
判断跨班级补课学生原班级周四19点补课班级周六09点
自动处理结果:
→ 课评保存到「第7周/发现世界-周六09点.md」班级汇总
→ 课评追加到「student/发现世界-周四19点/林瀚丞/历史课评记录.md」个人档案
标注【跨班级补课】本节课程在周六09点班第7周完成
✅ 自动完成,无需教师确认
```
#### 统一规则
- **不要写"第一次上课"相关表述**,即使这是该学生第一次上这节课
- 补课学生**不是新学生**,只是课程调整
- 正常生成课评,按已有档案处理(或询问后的选择处理)
#### ⚠️ 重要规则:课评正文禁止提及补课
**绝对禁止**
-**课评正文中绝对不能提及学生来补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课(如"今天特别来参加"、"临时加入"等)
**正确处理**
- ✅ 课评正文**完全按正常学生**撰写,仿佛学生就是本班正常上课的学生
-`[补课]`标记**仅作为后台参考**,用于档案存储路径判断
- ✅ 补课信息仅保存在班级汇总的元数据中,不进入课评正文
**正确示例**
```
教师输入:林瀚丞[补课]:积极分析课程任务,专注完成了绿色身体、黑色头部的蜥蜴设计
课评输出(正确):
瀚丞本节课学习了"蜥蜴"的仿生搭建...(正常撰写,完全不提补课)
课评输出(错误):
瀚丞本节课作为补课学生,学习了"蜥蜴"... ❌(禁止提及补课)
瀚丞今天来补课,学习了"蜥蜴"... ❌(禁止提及补课)
```
**说明**
- 家长看到课评时不应知道孩子是补课还是正常上课
- 补课标记仅用于教师内部管理和档案存储
- 保持课评的一致性和专业性
---
### 规则3禁止自动推断
**严格禁止**
-**禁止AI自动推断学生是补课还是第一次上课**
- ❌ 禁止根据表现猜测(如"表现生疏"→"可能是第一次"
- ❌ 禁止根据历史记录自动判断
**必须**
- ✅ 完全依赖教师输入中的明确标记
- ✅ 无标记时按常规学生处理
---
## 教师输入标记方式
### 单个学生输入
```
小明[第一次上课]开始不敢碰后来主动搭3层
小红[补课]搭了3层开心
```
### 批量输入
```
课程DISC-003
班级:发现世界-周四19点
梁昕乔:快速启动,开心
钟昀昊:慢热,稳定
张小明[第一次上课]:开始不敢碰,后来主动
李小红[补课]搭了3层认真
```
---
## 无档案学生处理(补课/体验)
当检测到学生无个人档案时:
### 检测流程(自动处理版)
1. AI自动检测 `memory/student/{当前班级}/{学生名}/` 是否存在
2. **如存在**:该学生为本班级补课学生 → **正常双轨保存**(班级汇总 + 个人档案)
3. **如不存在**:自动搜索 `memory/student/` 下**所有班级目录**
- **如在其他班级存在**:该学生为**跨班级补课学生** → **自动双轨保存(跨班级模式)**
- ✅ 保存到**补课班级**周汇总(当前班级)
- ✅ 追加到**原班级**个人历史课评记录.md标注补课班级信息
- **无需询问,自动完成**
- **如任何班级都不存在**:可能是其他老师班级学生 → **询问处理方式**
### 处理方式(更新版)
| 场景 | 判断条件 | 处理方式 | 存储位置 |
|------|---------|---------|---------|
| **自己班级补课学生** | 档案在当前班级目录存在 | 双轨保存 | 班级汇总 + 个人档案 |
| **跨班级补课学生** | 档案在其他班级目录存在 | **自动双轨保存(跨班级模式)** | 班级汇总(补课班级)+ 个人档案(原班级,标注补课信息)|
| **其他老师班级补课学生** | 档案不在任何班级目录 | 询问后决定 | 班级汇总(可选创建档案)|
| **体验课学生** | 无标记或标记[体验] | 仅班级汇总 | 班级汇总(标记体验)|
### 询问流程(其他老师班级补课学生)
```
⚠️ 未找到「张小明」在「发现世界-周四19点」班级的个人档案
该学生标记为[补课],但不在本班级学生名单中。
可能情况:
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案(双轨保存)
[3] 档案在其他班级目录 → 询问是否迁移或仅班级汇总
请选择处理方式:
```
### 自动保存通知(跨班级补课)
当检测到跨班级补课学生时,**自动执行**以下操作,无需询问:
```
⚠️ 检测到「林瀚丞」为跨班级补课学生
档案位置:发现世界-周四19点原班级
补课班级:发现世界-周六09点当前班级
📋 课评归属规则以补课班级周六09点的周数为准
- 原班级周四19点当前进度第8周
- 补课班级周六09点当前进度第7周
- 本节课评将按第7周记录
✅ 自动处理结果:
→ 课评保存到「第7周/发现世界-周六09点.md」补课班级班级汇总
→ 课评追加到「student/发现世界-周四19点/林瀚丞/历史课评记录.md」原班级个人档案
标注【跨班级补课】本节课程在周六09点班第7周完成
💡 提示:如需调整保存方式,可输入「调整{学生}保存方式」
```
---
## 🔄 简化转正流程(新增 v1.1
### 原流程问题
- 体验学生转正需要回复"转为正式"
- 历史课评需要从班级汇总迁移到个人档案
- 操作步骤多,容易遗忘
### 优化后流程
#### 方案1智能检测转正推荐
当体验/补课学生连续上课达到**3次**时AI主动提示
```
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 转正建议
张小明已连续上3节课第5周、第6周、第7周
- 第5周体验课积极参与
- 第6周体验课专注完成
- 第7周体验课表现稳定
建议为其创建正式档案,便于:
✓ 追踪完整成长轨迹
✓ 生成学期总结报告
✓ 家长沟通更有依据
[创建正式档案] [继续体验] [下周再提醒]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案2一键转正快捷
输入简化指令:
```
教师:小明转正
教师:小明[正式]
AI处理
1. 创建个人档案memory/student/{班级}/小明/
2. 自动迁移历史课评(从班级汇总提取)
3. 标记后续课评为"正式学生"
4. 双轨保存生效
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正完成:张小明
已创建:
- 用户画像.md模板待完善
- 历史课评记录.md已迁移3次课评
- 成长素材.md待补充
历史课评已迁移:
- 第5周 DISC-005 天平秤
- 第6周 DISC-006 长颈鹿
- 第7周 DISC-007 旋转飞机
下次输入"小明"将按正式学生处理
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案3输入时标记升级灵活
支持在输入时直接标记状态变化:
```
输入:小明[体验→正式]:今天表现很好
AI处理
1. 自动创建档案
2. 迁移历史课评
3. 生成本次课评
4. 双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正并生成课评:张小明
状态变化:体验 → 正式
已创建个人档案并迁移历史记录
本次课评已双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 转正数据迁移
#### 自动迁移内容
| 内容 | 来源 | 目标 | 操作 |
|------|------|------|------|
| 历史课评 | 班级周汇总 | 个人历史课评.md | 自动提取并追加 |
| 用户画像 | 无 | 新建用户画像.md | 创建模板 |
| 成长素材 | 无 | 新建成长素材.md | 创建空文件 |
#### 迁移示例
```markdown
# 迁移前(班级汇总)
### 张小明(体验学生)⚠️
【第5周课评内容】
【第6周课评内容】
【第7周课评内容】
---
# 迁移后(个人档案)
## 历史课评记录.md
### 2026-04-04 | 课程代码DISC-005
**课评内容**【第5周内容】
**备注**:体验期间,原记录在班级汇总
### 2026-04-11 | 课程代码DISC-006
**课评内容**【第6周内容】
**备注**:体验期间,原记录在班级汇总
### 2026-04-17 | 课程代码DISC-007
**课评内容**【第7周内容】
**备注**:体验期间,原记录在班级汇总
### 转正记录
- 转正日期2026-04-17
- 转正周数第7周
- 已上课时3节
- 来源:体验课转正
```
### 转正后班级汇总更新
```markdown
# 原标记(体验期间)
### 张小明(体验学生)⚠️
# 更新后(转正后)
### 张小明(已转正 ✅)
- 转正日期2026-04-17
- 个人档案:已创建
- 历史课评:已迁移至个人档案
```
### 转正统计
在班级学期总览中添加转正统计:
```
## 学生流动情况
| 类型 | 人数 | 说明 |
|------|:----:|:-----|
| 正式学生 | 30人 | 学期初已建档 |
| 体验转正 | 3人 | 本学期从体验转正式 |
| 补课转入 | 2人 | 从其他班级转入 |
| 当前体验 | 2人 | 正在体验中 |
### 本学期转正记录
| 学生 | 原状态 | 转正周 | 已上课时 | 转正原因 |
|------|:------:|:------:|:--------:|:---------|
| 张小明 | 体验 | 第7周 | 3节 | 连续参与,表现稳定 |
| 李小红 | 补课 | 第5周 | 2节 | 转入正式班级 |
```
---
## 相关文件
- 输入格式规则:[30-input-format.md](30-input-format.md)
- 批量生成规则:[32-batch-generation.md](32-batch-generation.md)
- 快速入门:[40-keping-快速入门.md](40-keping-快速入门.md)