更新课评系统代码

This commit is contained in:
qiuyan
2026-06-02 23:01:58 +08:00
parent f8c4b6174f
commit cd05b8a5a7
45 changed files with 8260 additions and 345 deletions

View File

@@ -1,11 +1,19 @@
# 课评输出格式规则 - 学龄前版2.5-6岁
> 适用课程:意识世界(托班)、发现世界(小班)、发明世界(中班)、创造世界(大班)
> 特点:微信表情增强互动性,温暖亲切,画面感强
> **重要**:学期周数仅用于后端匹配课程主题,**课评正文不提及"第几周"**
>
> 适用课程:意识世界(托班)、发现世界(小班)、发明世界(中班)、创造世界(大班)
> 版本v5.0 | 更新日期2026-05-22
>
> **v5.0 变更**:统一版本号体系到 v5.0优化课评详细程度增加时间描述模糊化规范AI 自动扩展细节
> - 标准版字数上限扩展到300字详细版扩展到400字
> - 幼儿时间描述采用模糊化表达("一会儿"、"一阵子"、"挺长时间"
> - AI 基于学生画像和历史数据自动补充过程细节和纵向对比
> **v4.5 变更**:表单直连提交 — 取消复制粘贴,版本号同步
> **v4.4 变更**:添加版本头,统一版本号至 v4.4
> 特点:微信表情增强互动性,温暖亲切,画面感强
> ⚠️ **重要**:学期周数仅用于后端匹配课程主题,课评正文不提及"第几周"、"本周"、"今天"
> ⚠️ **关键规则**:统一使用"本节课",禁用"今天"、"本周"等
> **首次上课/补课说明**:详见 [20-workflow.md](20-workflow.md)第3节、第7节
>
> **补课/体验标记**:补课学生输出格式为 "姓名 [补课]",体验学生为 "姓名 [体验]",系统自动识别处理
> **存储位置**(课评规范标准):
> - **个人课评文件**`.claude/memory/class/{班级}/{学生名}/feedback/YYYYMMDD_课程编号-课次.md`
> - **班级总结**`.claude/memory/class/{班级}/summaries/YYYYMMDD_课程编号-课次_班级反馈.md`
@@ -20,7 +28,8 @@
- **段落简短**每段1-2句话易于阅读
- **画面感强**:描述作品细节,让家长能想象出画面
- **三维度覆盖**:课程设计、学习表现、兴趣度
- **称呼规范**:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"等套话
- **称呼规范**:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"、"小朋友"等套话
- **措辞统一**:禁用"今天",使用"本节课"
### 排版样式(三段式)
```
@@ -28,30 +37,30 @@
这节课【称呼】【整体表现描述】。【掌握程度】,【课程环节表现】。和【对比时间】相比,【进步表现】,【具体亮点】 💪✨
【课后建议】,【具体做法】 🏠
【课后建议】,【具体做法】,巩固本节课的【知识点】 🏠
```
---
## 📝 三段式结构模板
> **详细规范**三段式结构、字数弹性规则、Emoji使用规范见 [10-style.md](10-style.md)第2-4节
>
> **详细规范**三段式结构、字数弹性规则、Emoji使用规范见 [10-style.md](10-style.md)第2-4节
>
> 本文档仅保留学龄前版的**排版样式**和**具体示例**
### 结构速查
| 段落 | 内容 | 字数范围 | Emoji数量 | 推荐表情 |
|------|------|:--------:|:---------:|:-------:|
|------|------|:-------:|:---------:|:-------:|
| **第1段** | 课程知识点 | 30-55字 | 1个 | 🔍/💡自动适配 |
| **第2段** | 课堂细节(掌握+环节+亮点)| **100-220字弹性** | 1-3个 | 根据情节自动适配 |
| **第2段** | 课堂细节(掌握程度+环节表现+成长亮点)| **100-220字弹性** | 1-3个 | 根据情节自动适配 |
| **第3段** | 课后建议 | 30-55字 | 1个 | 🏠自动适配 |
**段落控制**:全文控制在**3个段落**第2段为长段落整合多个模块内容
---
### 第1段课程知识点30-40字)
### 第1段课程知识点30-55字)
**写什么**:本节课的核心结构知识或技能点,体现课程趣味性
**写法**
@@ -66,7 +75,7 @@
**示例**
```
小明今天学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固 🔍
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固 🔍
```
**表情备选**:🔍💡📚⭐
@@ -80,39 +89,39 @@
- 掌握程度:学生对该知识点的学习表现
- 课程环节:导入、探索、实践、分享各环节的状态
- 成长亮点:与之前相比的进步或突出表现
- **弹性原则**:当输入中有多个亮点或精彩瞬间时,**充分展开描述不要压缩到100-130字**可扩展到150-220字
- **弹性原则**当输入中有多个亮点或精彩瞬间时充分展开描述不要压缩到100-130字可扩展到150-220字
**格式**
```
这节课【孩子称呼】【整体状态描述】。【掌握程度描述】,【课程环节表现】。和【对比时间】相比,【进步表现】,【具体亮点】 💪✨
这节课【孩子称呼】【整体表现描述】。【掌握程度描述】,【课程环节表现】。和【对比时间】相比,【进步表现】,【具体亮点】 💪✨
```
**示例**
```
这节课小明对房子主题很感兴趣搭建环节专注投入约30分钟。互锁的方法听懂了实际操作时前两块需要老师扶着手指对齐第三块开始能自己完成。和上周比今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意 💪✨
这节课小明对房子主题很感兴趣搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
```
**表情备选**:💪✨🌱📈🎯
---
### 第3段课后建议30-50字)
### 第3段课后建议30-55字)
**写什么**:家长可以在家配合的具体活动,巩固兴趣和学习成果
**写法**
- 可操作:不说"多练习",说具体玩法
- 关联课程:在家可以用积木重复今天的互锁结构
- 关联课程:"在家可以用乐高重复本节课的互锁结构"
- 尊重家庭:用"可以试试看"而非"必须"
- **弹性原则**当第2段非常详细时建议部分也可适度扩展到40-50字,给出更具体的家庭活动建议
- **弹性原则**当第2段非常详细时建议部分也可适度扩展到40-55字,给出更具体的家庭活动建议
**格式**
```
【家庭活动建议】,【具体做法】,巩固今天的【知识点】 🏠
【家庭活动建议】,【具体做法】,巩固本节课的【知识点】 🏠
```
**示例**
```
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固今天的互锁概念 🏠
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的互锁概念 🏠
```
**表情备选**:🏠👨‍👩‍👧🎮📱
@@ -123,51 +132,69 @@
## 📊 完整示例
### 示例1小班-发现世界(三段式)
### 示例1小班-发现世界(标准版)- v4.6 更新
**输入**小明观望一会儿→主动搭3层→自己调整 ↑++
**输出**
```
小明今天学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固🔍
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固,不容易倒🔍
节课小明对房子主题很感兴趣搭建环节专注投入约30分钟💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。导入环节参与积极,分享时能说出互锁的作用,本节课的结构搭建目标顺利达成🌟。和上周比,今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意📈
节课小明对房子主题表现出浓厚兴趣,开始阶段先观察了一会儿,后来在老师鼓励下主动开始搭建,专注投入了挺长时间💪。互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐凹槽,第三块开始能独立完成,到第五块时已经能自己检查是否对齐✨。结构第一次倒了是因为底座不平,小明没有像以前那样直接推倒重来,而是拆开重新观察底座,发现左边比右边低,调整后重新搭建,这个情绪调节和问题解决能力比两周前有明显提升🌟
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固今天的互锁概念🏠
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的互锁概念🏠
```
**字数**198字符合180-220
**表情数**5第1段1个/第2段3个/第3段1个第2段表情分散在段内
**字数**258字符合220-300字标准版
**表情数**4第1段1个/第2段2个/第3段1个第2段分散在段内
**段落数**3段符合要求
**v4.6 改进点**
- 时间描述模糊化("观察了一会儿"、"挺长时间"而非精确分钟数)
- 增加过程细节第2块→第3块→第5块的进步阶梯
- 增加思维描述(发现左边比右边低)
- 增加纵向对比(两周前的情绪调节能力)
- AI 自动扩展了画像和历史数据中的细节
---
### 示例2托班-意识世界(三段式)
### 示例2托班-意识世界(标准版)- v4.6 更新
**输入**昀昊害羞→搭2层管道 ↑
**输出**
```
昀昊本节课玩了"管道滚球",让小球在管道里旅行,感受了球滚动的乐趣🔍
本节课昀昊开始有点害羞,看了2分钟才开始尝试后来在老师鼓励下搭了2层管道让小球滚下来💪。导入环节对滚球游戏很感兴趣探索环节专注尝试管道连接最后能独立完成2层搭建本节课的管道连接目标顺利达成🌟。和上周比,本节课敢自己拿管道尝试了,不再只是看着,能安静专注地玩10分钟,这个专注力对托班宝宝来说很棒了
本节课昀昊开始有点害羞,先观察了一会儿才开始尝试后来在老师鼓励下搭了2层管道让小球滚下来💪。导入环节对滚球游戏很感兴趣探索环节专注尝试管道连接最后能独立完成2层搭建本节课的管道连接目标顺利达成。和上周比,本节课敢自己拿管道尝试了,不再只是看着,能安静专注地玩一阵子,这个专注力对托班宝宝来说很棒了🌟
爸爸妈妈可以用保鲜膜筒芯或报纸卷成管道,和小球一起玩,让球从高的地方滚下来,感受运动的快乐🏠
家里可以用保鲜膜筒芯或报纸卷成管道,和小球一起玩,让球从高的地方滚下来,感受运动的快乐🏠
```
**字数**195符合180-220
**表情数**5第1段1个/第2段3个/第3段1个第2段表情分散在段内
**字数**198符合180-220字精简版-标准版之间
**表情数**3第1段1个/第2段2个/第3段1个第2段分散在段内
**段落数**3段符合要求
**语气**:更温和,适合托班
**v4.6 改进点**
- 时间描述更模糊("观察了一会儿"、"一阵子"而非"2分钟"、"10分钟"
- 保持托班适用的温和语气
- AI 自动补充了情绪变化细节
---
## ⚙️ 技术规范
### 字数控制(弹性范围)
### 技术规范(弹性范围)- v4.6 更新
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 |
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
| 输入类型 | 字数范围 | 适用场景 | 结构 |
|:-------:|:-------:|:---------|:----:|
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 | 3段 |
| **标准版** | 220-300字 | 输入有具体细节或1-2个亮点 | 3段 |
| **详细版** | 300-400字 | 输入有精彩瞬间、多个亮点或特殊表现 | 3-4段 |
**各年龄段参考**
- 托班2.5-3岁可适当减少20-30字
- 托班2.5-3岁可适当减少20-30字,时间描述更模糊
- 小班3-4岁按标准范围
- 中班4-5岁按标准范围
- 大班5-6岁可适当增加10-20字
@@ -177,7 +204,9 @@
- **标准版**输入有具体细节或1-2个亮点如"主动搭3层自己调整还帮助同伴"
- **详细版**:输入有精彩瞬间、多个亮点或特殊表现(如"第一次主动帮助同伴,调试了三次才成功,最后说这是最喜欢的作品"
### 表情数量
**AI 自动扩展**即使老师输入简洁AI 也会基于学生画像和历史数据自动补充细节,生成更丰富的课评
### Emoji数量
- **第1段**1个🔍/💡根据课程主题适配)
- **第2段**1-3个根据课堂情节亮点自动适配如💪/✨/📈等)
- **第3段**1个🏠/👨‍👩‍👧根据建议内容适配)
@@ -190,13 +219,13 @@
**第2段分散示例**
```
这节课小明对房子主题很感兴趣搭建环节专注投入约30分钟💪。互锁的方法听懂了实际操作时前两块需要老师扶着手指对齐第三块开始能自己完成✨。和上周比今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
这节课小明对房子主题很感兴趣搭建环节专注投入约30分钟💪。互锁的方法听懂了实际操作时前两块需要老师扶着手指对齐第三块开始能自己完成✨。和上周比本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
```
### Emoji适配指南
| 段落 | 内容 | 推荐表情 | 适配场景 |
|------|------|:-------:|---------|
|------|------|:-------:|:---------|
| 第1段 | 课程知识点 | 🔍/💡 | 🔍探索新知识/💡有启发 |
| 第2段 | 课堂细节 | 1-3个 | 💪努力/✨亮点/📈进步/🌟突破/😊开心 |
| 第3段 | 课后建议 | 🏠/👨‍👩‍👧 | 🏠家庭活动/👨‍👩‍👧亲子互动 |
@@ -223,23 +252,36 @@
### 学龄前版专项检查
- [ ] 字数符合弹性范围精简版180-220字/标准版220-280字/详细版280-350字根据输入内容丰富度
- [ ] **3段式结构**第1段知识点、第2段课堂细节、第3段课后建议
- [ ] 第1段和第3段末尾各1个emoji第2段emoji分散在段内紧跟对应亮点的句号之后总计3-5个
- [ ] 第1段和第3段末尾各1个emoji第2段emoji分散在段内紧跟对应亮点的句号之后总计3-5个
- [ ] 表情根据情节自动适配,不机械固定
- [ ] 称呼正确(小名>去姓>叠字>全名)
- [ ] 无"第几周"字样
- [ ] **无"今天"、"本周"、"第几周"等表述,统一使用"本节课"**
- [ ] 语气温暖亲切,有画面感
- [ ] 建议具体可操作
- [ ] **第2段充分展现输入中的精彩瞬间**(不压缩丰富内容)
---
## 📋 班级总结模板
班级总结文件(`summaries/YYYYMMDD_课程编号-课次_班级反馈.md`)使用统一模板框架,完整模板定义详见 [20-workflow.md 第5.4节](20-workflow.md)。
### 学龄前版关键要点
- **基本信息字段**表现标签提炼3-5个关键词如"积极搭建"、"创意设计"、"情绪调节快"),体现本节课核心亮点
- **情绪状态**:综合判断本节课情绪基调("开心/稳定"、"积极/稳定"、"波动"等)
- **教师备注-亮点**提炼1-2个最有代表性的亮点描述
- **本周表现分布**:根据学生实际表现评估填写
- **共性观察**:重点描述学龄前学生的参与度和兴趣表现
---
## 📝 与小学版对比
| 维度 | 学龄前版(本文件)| 小学版 |
|------|------------------|--------|
| **表情** | 3-5个第1段1个/第2段1-3个/第3段1个温暖活泼 | 3-5个第1段1个/第2段1-3个/第3段1个,简洁专业 |
| **段落** | **3段**第1段知识点、第2段课堂细节、第3段课后建议| 3段结构化 |
| **语气** | 亲切温暖,画面感 | 尊重平等,专业 |
| **字数** | 弹性范围180-350字 | 弹性范围190-350字 |
| **信息密度** | 第2段为长段落根据输入丰富度灵活扩展 | 结构化呈现,根据输入灵活扩展 |
| **emoji位置** | 第1段末尾、第2段分散在段内、第3段末尾 | 第1段末尾、第2段分散在段内、第3段末尾 |
| 维度 | 学龄前版 | 小学版 |
|------|:--------:|:-------:|
| **表情** | 3-5个第1段1个/第2段1-3个/第3段1个温暖活泼 | 3-5个简洁专业 |
| **段落** | 3段统一三段式 | 3段统一三段式 |
| **语气** | 温暖亲切,画面感 | 尊重平等,专业简洁 |
| **字数** | 弹性范围180-350字 | 弹性范围180-350字 |
| **emoji位置** | 第1段末尾、第2段分散在段内、第3段末尾 | 第1段末尾、第2段分散在段内、第3段末尾 |