优化课评系统:新增速记符号、状态面板、快速编辑功能

- 新增36-shorthand-learning.md:速记符号阶梯学习指南
- 新增37-status-panel.md:课评状态管理面板
- 新增38-quick-edit.md:快速编辑功能规则
- 更新40-keping-快速入门.md:优化快速入门指南v3.0
- 新增CHANGELOG.md:版本变更日志
- 更新第7周、第8周班级汇总文件
- 规范化学生档案存储
- 完善补课/体验学生处理逻辑
This commit is contained in:
2026-04-25 20:56:12 +08:00
parent 4810387dab
commit dcf1049b92
60 changed files with 2391 additions and 1569 deletions

116
CLAUDE.md
View File

@@ -86,19 +86,19 @@
| **学期周数与主题** | [`.claude/rules/15-semester-weeks.md`](.claude/rules/15-semester-weeks.md) | **仅后端使用**:周数用于自动匹配课程代码和主题,课评正文不显示周数 |
| 评分标准体系 | [`.claude/rules/06-scoring.md`](.claude/rules/06-scoring.md) |
### 当前周信息速查2026-04-02
### 当前周信息速查2026-04-25
| 班级 | 周数 | 课程代码 | 主题 | 核心知识点 |
|------|:---:|:-------:|:-----|:-----------|
| 发现世界周四19点 | 第5周 | DISC-005 | 天平秤 | 杠杆原理、平衡判断 |
| SPIKE周日10:30 | 第5周 | SPIKE-005 | 杯子盖球 | 传感器应用、精准控制 |
| AI03周五19点/周六14点 | 第5周 | AI03-005 | 项目整合 | 多AI协作、工作流设计 |
| 发现世界周四19点 | 第8周 | DISC-008 | 蜥蜴 | 关节连接、可动结构、仿生设计 |
| SPIKE周日10:30 | 第8周 | SPIKE-008 | 留声机 | 记录播放、循环结构、复古设计 |
| AI03周五19点/周六14点 | 第8周 | AI03-008 | 我的个人主页(上) | 内容先行、板块化设计、自定义智能体 |
### 风格规则20-29
| 课程类型 | 文件路径 | 字数 | 适用年龄 |
|---------|---------|------|---------|
| 幼儿积木搭建 | [`.claude/rules/20-style-building.md`](.claude/rules/20-style-building.md) | 180-220字 | 2.5-6岁 |
| 少儿编程入门 | [`.claude/rules/21-style-coding.md`](.claude/rules/21-style-coding.md) | 190-230字 | 6-10岁 |
| 机器人竞赛 | [`.claude/rules/22-style-robotics.md`](.claude/rules/22-style-robotics.md) | 200-240 | 8-10岁 |
| 幼儿积木搭建 | [`.claude/rules/20-style-building.md`](.claude/rules/20-style-building.md) | **弹性:180-320字** | 2.5-6岁 |
| 少儿编程入门 | [`.claude/rules/21-style-coding.md`](.claude/rules/21-style-coding.md) | **弹性190-350字** | 6-10岁 |
| 机器人竞赛 | [`.claude/rules/22-style-robotics.md`](.claude/rules/22-style-robotics.md) | **弹性:200-400字** | 8-10岁 |
### 辅助模板25-29
| 用途 | 文件路径 | 说明 |
@@ -177,18 +177,19 @@
### 五模块速查
| 模块 | 字数 | 核心维度 | Emoji |
|------|:----:|:-------:|:-----:|
| **1. 课程知识点** | 30-40字 | 兴趣度 | 🔍💡⚙️ |
| **2. 掌握程度** | 30-40字 | 学习表现 | ✨✓📊 |
| **3. 课程环节与目标达成** | 40-50字 | 目标达成 | 🎯✅ |
| **4. 成长亮点** | 40-50字 | 成长发展 | 🌱💪📈 |
| **5. 课后建议** | 30-40字 | 延伸学习 | 🏠🎮🔧 |
| 模块 | 字数范围 | 核心维度 | Emoji |
|------|:-------:|:-------:|:-----:|
| **1. 课程知识点** | 30-50字(弹性) | 兴趣度 | 🔍💡⚙️ |
| **2. 掌握程度** | 30-70字(弹性) | 学习表现 | ✨✓📊 |
| **3. 课程环节与目标达成** | 40-80字(弹性) | 目标达成 | 🎯✅ |
| **4. 成长亮点** | 40-70字(弹性) | 成长发展 | 🌱💪📈 |
| **5. 课后建议** | 30-50字(弹性) | 延伸学习 | 🏠🎮🔧 |
### 段落结构3段
- **第1段**课程知识点30-40字
- **第2段**:课堂细节长段落(掌握程度+课程环节+成长亮点100-130字
- **第3段**课后建议30-40字
### 段落结构3段,字数弹性
- **第1段**课程知识点30-50字
- **第2段**:课堂细节长段落(掌握程度+课程环节+成长亮点,**100-220字根据输入丰富度灵活扩展**
- **第3段**课后建议30-50字
- **字数弹性原则**输入越丰富课评越详细精简版180-220字/标准版220-280字/详细版280-350字
- **Emoji使用**每段末尾添加幼儿版每段1-2个小学版每段1个
---
@@ -239,15 +240,6 @@
[一键发送] [标记修改] [取消]
```
### 效率优化
| 环节 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 生成方式 | 顺序生成 | 并行生成 | 速度↑ |
| 确认次数 | 每人1次 | 批量1次 | 效率↑↑ |
| 保存操作 | 手动双轨 | 自动保存 | 便捷↑ |
| 8人课评时间 | 15-20分钟 | **3-5分钟** | **75%** |
### 存储双轨制(自动保存)
| 存储位置 | 用途 | 使用场景 | 自动/手动 |
@@ -255,45 +247,73 @@
| `class-evaluation-summary/第X周/{班级}.md` | **班级视角**:每周全班课评汇总 | 周回顾、班级分析、备课参考 | **自动生成** |
| `student/{班级}/{学生}/历史课评记录.md` | **个人视角**:学生完整课评历程 | 家长沟通、学期总结、成长追踪 | **确认后自动** |
### 学生类型自动处理
### 学生类型自动处理(更新)
| 类型 | 标记 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 正式学生 | 无标记 | 自动双轨保存 | 班级+个人 |
| 补课学生 | `[补课]` | 询问后决定 | 班级+(可选)个人 |
| **补课学生(自己班级)** | `[补课]` + **当前班级档案存在** | **自动双轨保存** | **班级+个人** |
| **补课学生(其他班级)** | `[补课]` + **当前班级档案不存在** | **询问后决定** | 班级+(可选)个人 |
| 体验学生 | `[体验]` | 仅班级汇总 | 仅班级 |
| 缺课学生 | `[缺课]` | 记录缺席 | 仅班级 |
### 补课/体验学生特殊处理
**[补课]学生处理逻辑(关键更新)**
```
当学生标记[补课]时:
1. 先检查 memory/student/{当前班级}/{学生名}/ 是否存在
2. 如存在 → 该学生为本班级补课 → 正常双轨保存
3. 如不存在 → 可能是其他老师班级学生 → 询问处理方式
[1] 仅保存到班级汇总(其他老师学生)
[2] 创建档案(新转班学生)
```
### 补课/体验学生特殊处理(更新后)
当检测到学生无个人档案时(补课/体验学生):
**处理流程**
1. **检测**AI自动检测 `memory/student/{班级}/{学生}/` 是否存在
2. **提醒**生成前提醒教师该学生无档案
3. **选择**
- **创建档案**:为该学生建立完整档案,执行双轨保存
- **仅保存到班级汇总**:不创建个人档案,仅保存在班级周汇总
1. **检测**AI自动检测 `memory/student/{当前班级}/{学生}/` 是否存在
2. **分支处理**
- **存在** → 该学生为**本班级补课学生** → **正常双轨保存**
- **不存在** → 可能是**其他老师班级学生** → **询问处理方式**
3. **询问选择**(仅档案不存在时):
- **仅保存到班级汇总**:其他老师班级学生来补课
- **创建档案**:新转班学生或后续会长期跟随
**示例**
**示例1自己班级补课学生**
```
教师输入:班级:发现世界-周四19点张小明搭了3层开心
教师输入:班级:发现世界-周四19点乔乔[补课]搭了3层开心
AI检测⚠️ 未找到「张小明」的个人档案
AI检测✅ 找到「乔乔」在本班级的个人档案
AI提醒:该学生可能是补课/体验学生,请选择:
[1] 创建档案(补课/新学生)
[2] 仅保留在班级汇总(体验课学生)
AI处理:按正式学生处理 → 双轨保存
→ 课评保存到「第7周/发现世界-周四19点.md」
→ 同时追加到「student/发现世界-周四19点/乔乔/历史课评记录.md」
```
教师选择 [2]
**示例2其他老师班级补课学生**
```
教师输入:班级:发现世界-周四19点张小明[补课]搭了3层开心
AI检测 未找到「张小明」在本班级的个人档案
AI提醒该学生标记为[补课],但不在本班级学生名单中。
可能情况:
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案(双轨保存)
教师选择 [1]
→ 课评仅保存到「第7周/发现世界-周四19点.md」
→ 标记为:张小明(体验学生,无个人档案)
→ 标记为:张小明(其他班级补课学生,无个人档案)
```
### 使用说明(优化后)
1. **指定班级**(一次即可):`班级:发现世界-周四19点`
2. **输入课评需求**:使用自然语言或速记符号描述学生表现
- **简洁输入** → 生成精简版约200字
- **详细输入** → 生成详细版约280字
3. **标记学生类型**`[补课]` `[体验]` `[缺课]` 等标记
4. **AI并行生成**:自动生成所有课评 + 自动质量检查
5. **自动保存班级汇总**:课评首先自动保存到 `class-evaluation-summary/第X周/{班级}.md`
@@ -319,10 +339,8 @@ AI提醒该学生可能是补课/体验学生,请选择:
[全部发送]
```
## 版本
---
| 版本 | 日期 | 更新内容 | 团队 |
|-----|------|---------|------|
| **v2.0** | **2026-04-19** | **流程优化**:并行生成、批量确认、自动保存、速记符号系统 | 穹狼教学团队 |
| v1.4 | 2026-04-16 | 新增补课/体验学生处理,支持仅保存到班级周汇总 | 穹狼教学团队 |
| v1.3 | 2026-04-04 | 新增"确认后保存"流程,优化课评生成体验 | 穹狼教学团队 |
## 版本历史
详见 [CHANGELOG.md](CHANGELOG.md)