Initial commit: 课评反馈系统 v1.0

memory/class-evaluation-summary/README.md

@@ -0,0 +1,156 @@
+# 班级课评汇总目录
+
+> 按周期（每周）汇总的课评档案
+> 
+> 存放位置：`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` |
+
+## 数据流转
+
+```
+教师输入 → 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老师*