# 批量课评生成规则

> 支持一节课给多个学生同时生成课评，保持千人千面
> 
> **存储方式**（确认后双轨保存）：
> - 班级周汇总：`memory/class-evaluation-summary/第X周/{班级}.md`（便于查看当周全班）
> - 个人历史课评：`memory/student/{班级}/{学生名}/历史课评记录.md`（保留完整成长档案）
> 
> **首次上课/补课说明**：详见 [33-first-class-rules.md](33-first-class-rules.md)

## 批量输入格式

### 表格式（推荐）

```
课程：[课程代码]
班级：[班级代码]
日期：[日期]

| 学生 | 核心表现 | 情绪 | 亮点/需关注 | 对比 |
|-----|---------|------|------------|------|
| 小明 | 观望5分钟后主动搭3层，自己调高度 | 稳定 | 比上周主动 | 进步明显 |
| 小红 | 全程专注，搭5层加弯管 | 开心 | 主动帮助旁边 | 保持 |
| 小强 | 频繁换玩法，未完整搭建 | 兴奋→烦躁 | 需引导坚持 | 和之前类似 |
```

### 列表式

```
课程：TUBE-001
班级：小小班A班
日期：2026-03-25

1. 小明：观望5分钟→主动搭3层→自己调高度，情绪稳定，比上周主动
2. 小红：全程专注搭5层加弯管，开心，主动帮助旁边
3. 小强：频繁换玩法未完整搭建，兴奋→烦躁，需引导坚持
4. 小美：搭2层就喊老师看求关注，正常，和之前类似
5. 豆豆：独自玩球不搭管道，开心，社交需引导
6. 天天：搭4层但一倒就哭，敏感，抗挫需关注
7. 糖糖：模仿小红搭得很稳，平静，模仿能力强
8. 乐乐：中途要上厕所，回来没继续，正常，身体原因
```

## 批量生成流程（确认后双轨保存）

```
输入表格 → AI解析每个学生 → 调取课程教案 → 调取班级档案 →
生成多份独立课评 → 暂存班级周汇总 → 教师审核确认 → 双轨保存
                                                          ↓
                                               ┌──────────┴──────────┐
                                               ↓                     ↓
                                    班级周汇总.md              个人历史课评.md
```

### 存储位置

| 存储位置 | 文件路径 | 用途 |
|---------|---------|------|
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |

## 避免雷同的策略

### 1. 开头差异化

| 学生类型 | 开头句式 |
|---------|---------|
| 谨慎型 | "今天[学生]终于..." |
| 活跃型 | "[学生]今天一如既往..." |
| 第一次尝试（需教师明确标注） | "这节课是[学生]第一次..." |
| 进步型 | "和上周相比，[学生]..." |

### 2. 侧重点差异化

同一节课，不同学生关注不同维度：

```
课程：TUBE-001 管道滚球（目标：空间感知+手眼协调）

小明（谨慎型）→ 侧重：参与度和勇气
"今天能主动尝试管道搭建..."

小红（熟练型）→ 侧重：创意和拓展
"不仅完成基础搭建，还自己设计了弯管路线..."

小强（困难型）→ 侧重：过程价值
"虽然最后没有完成作品，但前15分钟的探索很有价值..."
```

### 3. 建议差异化

同一节课，不同学生给不同建议：

```
小明（参与少）：在家可以用纸筒做简单轨道
小红（能力强）：可以尝试用不同材料做对比实验
小强（坚持短）：可以从5分钟小目标开始练习
```

## 批量输出格式

### 分隔输出（推荐）

```
━━━━━━━━━━━━━━━━━━━━━━━
【学生1：小明】
198字 | 5段

[课评内容]

━━━━━━━━━━━━━━━━━━━━━━━
【学生2：小红】
210字 | 5段

[课评内容]

━━━━━━━━━━━━━━━━━━━━━━━
[...]
```

### 汇总检查表

批量生成后，提供快速检查：

```
批量生成完成（8份）

字数检查：
✓ 小明：198字（符合180-220）
✓ 小红：210字（符合180-220）
⚠ 小强：165字（偏短，建议补充）
✓ ...

重复检查：
✓ 8份课评开头句式各不相同
✓ 8份课评建议各不相同
✓ 无重复用词

请审核后发送
```

## 特殊情况批量标记

| 标记 | 含义 | 处理方式 |
|-----|------|---------|
| [缺课] | 今天没来 | 不生成课评，记录缺席 |
| [早退] | 中途离开 | 课评注明"今天提前离校" |
| [情绪] | 情绪问题 | 课评侧重情绪疏导 |
| [冲突] | 与同学冲突 | 单独简短说明 |
| **[补课]** | **补课学生** | **仅保存到班级周汇总，询问是否建档** |
| **[体验]** | **体验课学生** | **仅保存到班级周汇总，不建档** |

## 批量处理补课/体验学生

当批量生成时遇到无档案学生：

**场景**：输入8个学生，其中6个有档案，2个是补课/体验学生

**AI处理流程**：
1. 正常生成8份课评
2. 检测档案状态：
   ```
   档案检查：
   ✓ 梁昕乔：有档案 → 双轨保存
   ✓ 钟昀昊：有档案 → 双轨保存
   ...
   ⚠ 张小明：无档案（补课学生）
   ⚠ 李小红：无档案（体验学生）
   ```
3. 提醒教师：
   ```
   ⚠️ 检测到2名学生暂无个人档案：
   - 张小明（补课学生）
   - 李小红（体验学生）
   
   处理方式：
   [1] 为补课学生创建档案（张小明）
   [2] 体验学生仅保留在班级汇总（李小红）
   [3] 全部仅保存到班级汇总
   ```
4. 根据教师选择执行保存

**批量输入时标记补课/体验学生**：
```
课程：DISC-007
班级：发现世界-周四19点

梁昕乔：快速启动，开心
钟昀昊：慢热，稳定
张小明[补课]：搭了3层，认真  ← 标记为补课学生
李小红[体验]：积极参与，开心    ← 标记为体验学生
```

## 效率优化

### 快捷键输入（设想）

```
输入：小明：gj5→zd3→tz（观望5分钟→主动3层→调整）
AI识别：观望5分钟后主动搭3层，自己调整
```

### 语音转文字

支持教师课后语音快速录入：
```
语音："小明今天开始不敢碰，后来搭了三层，球卡住自己调了高度"
→ 自动解析为结构化输入
```

### 模板复用

相似表现的学生，可标记"基于小红模板微调"：
```
小花的输入：同小红，但"没有帮助旁边"
→ 生成类似结构但不同细节的课评
```

## 版本
- v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明，支持标记[补课]/[体验]快速分类
- v1.0 | 2026-03-25 | 初始版本