# 批量课评生成规则 v2.0（优化版）

> 支持一节课给多个学生同时生成课评，保持千人千面
> 
> **优化内容**：批量并行生成、智能分级确认、自动质量检查

---

## 🚀 批量生成流程

```
输入表格 → AI并行解析每个学生 → 预加载课程/档案 → 
并行生成多份课评 → 自动保存班级周汇总 → 质量检查 → 
批量展示 → 教师一键确认 → 自动双轨保存
```

> **核心优势**：8人课评从15-20分钟缩短至**3-5分钟**（效率提升75%）

---

## 📝 批量输入格式

### 标准列表式（推荐）

```
课程：DISC-007
班级：发现世界-周四19点
日期：4月16日

1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
5. 小强：频换玩法 wb↓--
```

### 简化表格式

```
课程：DISC-007  班级：发现世界-周四19点

学生      核心表现              情绪   对比
─────────────────────────────────────────
乔乔      gj5→zd3→zt            ↑      ++
昊昊      慢热→zd3→反复调        →      渐入佳境
小明[体验] 搭3层参与             ↑      积极
小红[补课] 专注完成              →      稳定
```

### 纯速记式（高效用户）

```
DISC-007 发现世界-周四19点

乔乔 gj5→zd3→zt ↑++
昊昊 慢热→zd3→反复调 →
小明[体验] zd3 ↑
```

---

## ⚡ 批量输出格式（优化）

### 统一展示界面

```
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成（5份）｜发现世界-周四19点｜DISC-007
━━━━━━━━━━━━━━━━━━━━━━━

✅ 乔乔      198字  正常
✅ 昊昊      205字  正常
⚠️  小强      165字  偏短
✅ 张小明[体验] 192字  体验学生
✅ 李小红[补课] 201字  补课学生

【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```

**自动通过条件**（同时满足）：
- ✅ 学生有完整档案
- ✅ 字数在弹性范围内
- ✅ 无敏感词/异常表述
- ✅ 情绪描述合理

**需人工确认条件**（任一满足）：
- ⚠️ 体验/补课学生（无档案）
- ⚠️ 字数偏差>20字
- ⚠️ 检测到负面情绪词
- ⚠️ 与上周表现差异过大
- ⚠️ 内容重复度高

---

## 🔍 自动质量检查

### 检查维度

| 检查项 | 描述 |
|--------|------|
| 字数检查 | 是否符合弹性范围（180-350字） |
| 重复检查 | 开头句式是否差异化 |
| 差异化检查 | 各课评侧重点是否不同 |
| 待关注项 | 特殊情绪/行为标记 |

### 差异化策略

**1. 开头差异化**

| 学生类型 | 开头句式示例 |
|----------|-------------|
| 谨慎型 | "今天[学生]终于主动尝试了..." |
| 活跃型 | "[学生]今天一如既往充满活力..." |
| 进步型 | "和上周相比，[学生]有了明显进步..." |
| 补课型 | "这节课[学生]融入得很好..." |
| 体验型 | "欢迎[学生]第一次来到..." |

**2. 侧重点差异化**

同一节课，不同学生类型侧重不同：
- **谨慎型** → 参与度和勇气
- **熟练型** → 创意和拓展
- **困难型** → 过程价值

**3. 建议差异化**

根据学生能力推荐不同课后活动：
- **参与少**：在家可以用纸筒做简单旋转玩具
- **能力强**：可以尝试用不同材料做对比实验
- **坚持短**：可以从5分钟小目标开始练习专注

---

## 📦 存储流程（优化后）

### 存储路径

| 位置 | 路径 | 说明 |
|------|------|------|
| 班级周汇总 | `memory/class-evaluation-summary/第X周/{班级}.md` | 全班汇总，含确认状态 |
| 个人档案 | `memory/student/{班级}/{学生}/历史课评记录.md` | 个人完整轨迹 |

> 完整存储规则和学生类型处理详见 [CLAUDE.md](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)

---

## 🏷️ 特殊情况批量处理

### 标记速查

| 标记 | 处理逻辑 | 保存位置 |
|------|---------|---------|
| `[补课]` | **检查当前班级档案** → 存在则双轨，不存在则询问 | 班级汇总+（可选）个人档案 |
| `[体验]` | 仅班级汇总，不询问 | 仅班级汇总（标记体验） |
| `[缺课]` | 记录缺席，不生成课评 | 班级汇总（标记缺课） |
| `[new]` | 创建新档案，双轨保存 | 班级汇总+个人档案 |

**[补课]处理详细逻辑**：
1. 检查 `memory/student/{当前班级}/{学生名}/`
2. 如存在 → 该学生为本班补课 → 双轨保存
3. 如不存在 → 可能为其他班级补课 → 询问处理方式
   - [1] 其他老师班级学生 → 仅班级汇总
   - [2] 新转班学生 → 创建档案

### 批量处理示例

```
输入：
DISC-007 发现世界-周四19点

1. 乔乔：gj5→zd3→zt ↑++
2. 昊昊：慢热→zd3→反复调 →
3. 张小明[体验]：搭了3层，开心
4. 李小红[补课]：专注完成，稳定
5. 王大力[缺课]

AI处理：
✓ 乔乔、昊昊：正常生成，双轨保存（正式学生）
⚠ 张小明[体验]：生成标记为"体验学生"，仅班级汇总
⚠ 李小红[补课]：检查档案 → 存在则双轨，不存在则询问
✓ 王大力[缺课]：记录"王大力：缺课"，不生成课评
```

---

## 💡 效率优化技巧

### 1. 上下文复用

```
/课评 班级：发现世界-周四19点  # 首次指定

# 后续直接输入学生，无需重复班级
乔乔：搭3层
昊昊：慢热
```

### 2. 语音批量录入

语音输入多学生表现，AI自动分段生成课评。

---

## 📊 批量生成检查清单

### 生成前检查
- [ ] 班级信息正确（或已在上下文中）
- [ ] 学生姓名无遗漏
- [ ] 标记使用正确（[补课]/[体验]/[缺课]）

### 生成后检查
- [ ] 全部学生课评已生成
- [ ] 字数符合弹性范围
- [ ] 开头句式差异化
- [ ] 建议内容个性化
- [ ] 特殊学生已标记

### 发送前检查
- [ ] 内容准确无误
- [ ] 称呼正确（小名/去姓）
- [ ] 补课/体验学生处理完毕

---

## 🎯 使用建议

### 推荐工作流程

```
Step 1: 指定班级（一次）
        /课评 班级：发现世界-周四19点
        
Step 2: 批量输入（使用速记）
        乔乔：gj5→zd3→zt ↑++
        昊昊：慢热→zd3→反复调 →
        小明[体验]：zd3 ↑
        
Step 3: AI批量生成（自动质量检查）

Step 4: 查看质量报告，一键确认

Step 5: 自动保存并发送
```

### 不同场景推荐

| 场景 | 推荐方式 | 预计时间 |
|------|---------|----------|
| 常规课后（8人） | 速记批量输入 | 3-5分钟 |
| 重点关注学生 | 自然语言详细描述 | 2-3分钟/人 |
| 边走边记 | 语音转文字 | 实时 |
| 周汇总整理 | 查看班级周汇总文件 | 1分钟 |

---

*核心理念：批量不批量，千人千面不打折*