# 新学生与补课学生处理规则

> 统一规范首次上课新学生与补课学生的课评处理

---

## 核心规则

### 规则1：首次上课（新学生）

**定义**：
- 从未在本机构上过任何课程的学生
- 刚报名入学的学生

**课评提及条件**：
- **仅在教师输入中明确写明"第一次上课"、"新学生"等关键词时，才能在课评中提及**
- 如果教师未明确说明，课评中**不自动添加**"这是孩子第一次上课"等表述

**正确示例**：
```
教师输入：小明（第一次上课）：开始不敢碰，后来搭了3层
课评输出：这节课是小明第一次上课，开始有点害羞...
```

**错误示例**：
```
教师输入：小明：开始不敢碰，后来搭了3层
课评输出：这节课是小明第一次上课... ❌（教师未说明）
```

---

### 规则2：补课学生

**定义**：
- 已在机构有档案，但第一次上这节课
- 从其他班级/时段调整到本班上课

**处理规则**：
- **不要写"第一次上课"相关表述**，即使这是该学生第一次上这节课
- 补课学生**不是新学生**，只是课程调整
- 正常生成课评，按已有档案处理

**正确示例**：
```
教师输入：小明（补课）：搭了3层，开心
课评输出：小明今天搭了3层管道，表现很开心...
```

**错误示例**：
```
教师输入：小明（补课）：搭了3层，开心
课评输出：这节课是小明第一次上课... ❌（补课≠新学生）
```

---

### 规则3：禁止自动推断

**严格禁止**：
- ❌ **禁止AI自动推断学生是补课还是第一次上课**
- ❌ 禁止根据表现猜测（如"表现生疏"→"可能是第一次"）
- ❌ 禁止根据历史记录自动判断

**必须**：
- ✅ 完全依赖教师输入中的明确标记
- ✅ 无标记时按常规学生处理

---

## 教师输入标记方式

### 单个学生输入
```
小明[第一次上课]：开始不敢碰，后来主动搭3层
小红[补课]：搭了3层，开心
```

### 批量输入
```
课程：DISC-003
班级：发现世界-周四19点

梁昕乔：快速启动，开心
钟昀昊：慢热，稳定
张小明[第一次上课]：开始不敢碰，后来主动
李小红[补课]：搭了3层，认真
```

---

## 无档案学生处理（补课/体验）

当检测到学生无个人档案时：

### 检测流程
1. AI自动检测 `memory/student/{班级}/{学生名}/` 是否存在
2. 如不存在，提醒教师该学生暂无档案
3. 请教师选择处理方式

### 处理方式

| 场景 | 处理方式 | 存储位置 |
|------|---------|---------|
| 补课学生（有档案在其他班级） | 创建档案或仅保存到班级汇总 | 双轨或仅班级汇总 |
| 体验课学生（临时试听） | 仅保存到班级汇总，不建档 | 仅班级汇总 |

### 教师选择
```
⚠️ 未找到「张小明」的个人档案

处理方式：
[1] 创建档案（补课/新学生）
[2] 仅保存到班级汇总（体验课学生）
```

---

## 🔄 简化转正流程（新增 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)

---

## 版本

- v1.1 | 2026-04-19 | 新增简化转正流程
- v1.0 | 2026-04-17 | 从各文件提取统一规范