ClassFeedback/memory/class-evaluation-summary

班级课评汇总目录

按周期（每周）汇总的课评档案

存放位置：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
特殊周期	期初/、期中/、期末/	期初/、期末/

课程信息板块规范

班级汇总文件的课程信息板块需包含以下内容：

> **课程信息**
> - 日期：YYYY-MM-DD（星期X）
> - 课程代码：XXX-XXX
> - 课程主题：XXXX
> - 核心知识点：XXX、XXX、XXX
>
> **已提交课评**：学生全名1、学生全名2、学生全名3[补课标记]
> **缺勤人员**：学生全名4、学生全名5（或无）

说明

• 已提交课评：列出所有已生成课评的学生全名（如"李怡瞳"、"沙佩琪"），补课学生需标记[补课]
• 缺勤人员：列出应出勤但未到校的学生全名，如无则填"无"

---

文件路径速查

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

实到人数计算规则

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

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

示例

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

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

数据统计标准

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

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

补课/体验学生处理

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

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

班级汇总文件中的标记示例：

### 张小明（补课学生）⚠️
[课评内容]
- 状态：已确认
- 个人档案：未创建（补课学生）
- 备注：如需创建档案，请回复「为张小明创建档案」

后续处理补课学生：

• 回复「为[姓名]创建档案」→ 创建个人档案 → 将该学生历史课评从班级汇总迁移到个人档案

当前学期进度

周数	日期范围	状态
第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老师