优化课评系统:新增速记符号、状态面板、快速编辑功能
- 新增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:
116
CLAUDE.md
116
CLAUDE.md
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user