# 班级课评汇总目录

> 按周期（每周）汇总的课评档案
> 
> 存放位置：`memory/class-evaluation-summary/`

## 目录结构

```
class-evaluation-summary/
├── README.md                          # 本说明文档
├── 模板-班级周汇总.md                  # 周汇总模板
├── 第1周/                             # 周期文件夹
│   ├── 发现世界-周四19点.md            # 班级当周课评汇总
│   ├── 发现世界-周六09点.md
│   ├── 发现世界-周六19点.md
│   ├── Wedo创造世界-周六1030.md
│   ├── Wedo创造世界-周六16点.md
│   ├── SPIKE02-周日1030.md
│   ├── AICODE-03-周五19点.md
│   └── AICODE-03-周六14点.md
├── 第2周/
│   ├── 发现世界-周四19点.md
│   └── ...
├── 第3周/
├── ...
└── 第7周/                             # 当前周（已创建）
    ├── 发现世界-周四19点.md
    ├── 发现世界-周六09点.md
    ├── 发现世界-周六19点.md
    ├── Wedo创造世界-周六1030.md
    ├── Wedo创造世界-周六16点.md
    ├── SPIKE02-周日1030.md
    ├── AICODE-03-周五19点.md
    └── AICODE-03-周六14点.md
```

## 工作流程

### 方式1：自动创建新周期（推荐）

当你发送 **「X周汇总」** 时，AI会自动：
1. 创建 `第X周/` 文件夹
2. 在该文件夹下创建8个班级的MD文档（使用模板）
3. 根据学期周数规则自动填充课程信息

**示例**：
```
你：7周汇总
AI：已创建第7周文件夹及8个班级汇总文档
```

### 方式2：生成课评并自动填充

当你发送学生表现生成课评时，AI会自动：
1. 生成个性化课评
2. 填充到对应班级的当周汇总文档
3. 标记为「待确认」状态
4. 等待你确认后同步到个人历史课评

**示例**：
```
你：乔乔：快速启动→搭3层→自己加装饰，开心
AI：生成课评 → 填充到 第7周/发现世界-周四19点.md → 等待确认
```

### 方式3：确认后双轨保存

当你回复 **「确认」** 或 **「保存」** 后，AI会自动：
1. 将课评从「待确认」改为「已确认」
2. 同步保存到个人历史课评：`student/{班级}/{学生}/历史课评记录.md`

## 文件命名规范

| 层级 | 命名格式 | 示例 |
|------|---------|------|
| 周期文件夹 | 第X周/ | 第7周/、第8周/ |
| 班级文件 | {班级名称}.md | 发现世界-周四19点.md |
| 特殊周期 | 期初/、期中/、期末/ | 期初/、期末/ |

## 文件路径速查

| 用途 | 文件路径 |
|------|---------|
| **本周汇总** | `memory/class-evaluation-summary/第7周/{班级}.md` |
| **个人历史** | `memory/student/{班级}/{学生}/历史课评记录.md` |
| **学生画像** | `memory/student/{班级}/{学生}/用户画像.md` |

## 实到人数计算规则

**实到人数** = 实际生成课评的学生数（含「已确认」和「待确认」状态）

| 状态 | 是否计入实到 | 说明 |
|------|:----------:|------|
| 已确认（☑）| ✅ 计入 | 课评已生成且教师已确认 |
| 待确认（☐）| ✅ 计入 | 课评已生成，待教师确认 |
| 待生成 | ❌ 不计入 | 教师未输入该学生表现，无课评 |
| 缺勤/请假 | ❌ 不计入 | 学生未到校，备注说明 |

### 示例

**场景**：班级应到4人，教师实际输入了2人的表现

```
应到人数：4人
实到人数：2人（基于实际生成课评数）
缺勤：无（或：小明、小红请假）
课评确认率：50%（1人已确认 / 1人待确认）
```

### 数据统计标准

```markdown
| 指标 | 数值 | 计算方式 |
|------|------|---------|
| 应到人数 | {班级总人数} | 学生档案总人数 |
| 实到人数 | {生成课评数} | 已确认 + 待确认 |
| 缺勤人数 | {未到校数} | 应到 - 实到（如无课评且未到校）|
| 课评确认率 | {百分比} | 已确认数 / 实到人数 × 100% |
```

```
教师输入 → AI生成课评 → 填充到当周班级汇总 → 【等待确认】
                                                    ↓
                                         教师回复「确认」
                                                    ↓
                                          ┌─────────┴─────────┐
                                          ↓                   ↓
                              班级汇总.md（已确认）    个人历史课评.md
                              （class-evaluation/）    （student/）
```

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

当检测到无档案学生时（补课/体验学生），数据流转略有不同：

```
教师输入（补课学生）→ AI检测无档案 → 提醒教师 → 教师选择「仅保存到班级汇总」
                                                                  ↓
                                                    仅保存到班级汇总.md（不创建个人档案）
                                                                  ↓
                                                    标记为：⚠️ 补课/体验学生（无个人档案）
```

**班级汇总文件中的标记示例**：
```markdown
### 张小明（补课学生）⚠️
[课评内容]
- 状态：已确认
- 个人档案：未创建（补课学生）
- 备注：如需创建档案，请回复「为张小明创建档案」
```

**后续处理补课学生**：
- 回复「为[姓名]创建档案」→ 创建个人档案 → 将该学生历史课评从班级汇总迁移到个人档案

## 当前学期进度

| 周数 | 日期范围 | 状态 |
|:---:|:---------|:----:|
| 第5周 | 3月30日-4月5日 | ✅ 已完成 |
| 第6周 | 4月6日-4月12日 | ✅ 已完成 |
| **第7周** | **4月13日-4月19日** | **📍 当前** |
| 第8周 | 4月20日-4月26日 | ⏳ 待创建 |

## 使用场景

1. **周回顾**：打开 `第X周/` 文件夹，查看本周全班表现
2. **备课参考**：查看上周班级汇总，了解整体掌握情况
3. **批量发送**：从当周汇总文档复制已确认的课评发送给家长
4. **学期分析**：横向对比各周 `第1周/` 到 `第7周/` 的表现变化
5. **交接班**：新教师查看历史周汇总，快速了解班级

## 自动化指令

| 指令 | 功能 |
|------|------|
| `X周汇总` | 自动创建第X周文件夹及8个班级MD文档 |
| `确认` / `保存` | 将课评从「待确认」改为「已确认」，并同步到个人档案 |
| `修改：XXX` | 重新生成课评内容 |
| `为[姓名]创建档案` | 为补课/体验学生创建个人档案，并将历史课评迁移 |

---

*创建日期：2026-04-15*  
*版本：v2.1*  
*维护者：小Q老师*