更新课评系统代码

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,7 +1,15 @@
# 风格规则:课评写作风格与结构规范
> 合并文件:幼儿积木搭建 + 少儿编程入门 + 机器人竞赛 + 通用结构规范
> 版本v3.1(合并版)| 更新日期2026-05-05
> 版本v4.6 | 更新日期2026-05-20
>
> **v4.6 变更**优化课评详细程度增加时间描述年龄适配AI 自动扩展细节
> - 标准版字数上限从280扩展到300字详细版从350扩展到400字
> - 新增"思维过程"和"具体数据"评估维度
> - 分年龄段时间描述规范(幼儿模糊化/小学精确化)
> **v4.5 变更**:表单直连提交 — 取消复制粘贴,版本号同步
> **v4.4 变更**:统一版本号至 v4.4;更新日期
> **v3.2 变更**:禁用"今天",统一使用"本节课";禁用"本周"等时间表述
---
@@ -13,6 +21,11 @@
| 输出字数 | **弹性范围180-350字**(根据输入内容丰富度自动调整) |
| 段落数 | **3段** |
### ⚠️ 关键措辞规范(必须遵守)
- **禁用"今天"**,统一使用"本节课"
- **禁用"本周"、"这周"、"上周课"、"第几周"**等时间表述
- 姓名规则:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"、"小朋友"等套话
### 课程类型与风格对应
| 课程类型 | 适用年龄 | 风格特点 | 基准字数 |
@@ -33,13 +46,18 @@
| **第2段** | 课堂细节(掌握程度+课程环节+成长亮点)| **100-220字弹性** | 见下表 |
| **第3段** | 课后建议 | 30-55字 | 见下表 |
### 2.2 字数弹性规则
### 2.2 字数弹性规则v4.6 优化版)
| 输入类型 | 字数范围 | 触发条件 |
|:-------:|:-------:|:---------|
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 |
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
| 输入类型 | 字数范围 | 触发条件 | 结构 |
|:-------:|:-------:|:---------|:----:|
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 | 3段 |
| **标准版** | 220-300字 | 输入有具体细节或1-2个亮点 | 3段 |
| **详细版** | 300-400字 | 输入有精彩瞬间、多个亮点或特殊表现 | 3-4段 |
**v4.6 优化说明**
- 标准版上限从280字扩展到300字允许更充分的细节描述
- 详细版上限从350字扩展到400字支持4段式结构
- AI 基于学生画像和历史数据自动扩展细节,无需老师额外输入
### 2.3 各年龄段字数调整
@@ -63,27 +81,46 @@
- **具体性**:不说"很棒",说"把弧形积木稳稳地卡进了凹槽"
- **画面感**:描述作品细节,让家长能想象出画面
- **克制感**:不用"天才""最棒"等夸张词,真诚即可
- **时间模糊化**:不用精确分钟数,用自然时段描述
**禁用词汇**:宝贝、小天才、最棒、无敌、超级厉害、完美、套话("在今天的课堂上""通过本次活动")、比较性语言("比其他小朋友"
**禁用词汇**:宝贝、小天才、最棒、无敌、超级厉害、完美、套话("在本节课的课堂上""通过本次活动")、比较性语言("比其他小朋友"
**推荐表达**
- 姓名使用:优先小名/昵称,其次去姓称名(如"昕乔"
- 具体动作:"试了三次终于搭稳了底座"
- 过程描述:"一开始想搭高塔,后来改成了小房子"
**时间描述规范(幼儿版)**
| 速记 | 输出表述 | 说明 |
|------|---------|------|
| `gj5` | 开始阶段先观察了一会儿 | 不用"5分钟" |
| `zx15` | 能安静地玩一阵子 | 托班/小班适用 |
| `zx30` | 专注投入了挺长时间 | 中班/大班适用 |
| `zx45` | 几乎整节课都很投入 | 表现很好时使用 |
### 3.2 少儿编程课6-8岁
**语言特点**
- **专业度**:准确使用编程术语(循环、条件、事件),但不堆砌
- **平等感**:像对待小学习者一样尊重,不居高临下
- **启发性**:指出问题同时给方向,"这里如果换个顺序..."
- **实在感**:不夸大"编程改变命运",而是聊"今天解决了什么问题"
- **实在感**:不夸大"编程改变命运",而是聊"本节课解决了什么问题"
- **过程可视化**:描述调试过程、思维转变、尝试次数
**禁用词汇**:小天才、未来的程序员、最聪明、秒杀同龄人、套话("在人工智能时代""培养计算思维")、夸大("掌握了编程的核心奥秘"
**推荐表达**
- 技术描述:"用'如果碰到边缘就反弹'解决了角色飞出屏幕的问题"
- 过程记录:"先试了三次循环发现次数不够改成了重复10次"
- 调试细节:"第一次方向写反了,检查代码后发现并修正"
- 思维变化:"遇到bug没有直接问老师先试着改了几个参数看效果"
**时间描述规范(小学低年级)**
| 速记 | 输出表述 | 说明 |
|------|---------|------|
| `zx30` | 专注投入约30分钟 | 可用相对精确时间 |
| `调试3次` | 调试了3次花了大约10分钟 | 描述调试过程 |
| `sb2` | 试了2次后成功 | 强调尝试过程 |
### 3.3 机器人竞赛课8-10岁
@@ -92,6 +129,7 @@
- **专业性**准确描述技术细节传感器校准、PID调速、机械臂力矩
- **成长视角**:把失败当作数据收集,把胜利当作阶段成果
- **团队意识**:强调分工配合,不只突出个人
- **数据驱动**:用具体数字说话(成功率、时间、参数)
**禁用词汇**:天才、大神、无敌、秒杀、碾压、套话("友谊第一比赛第二""胜不骄败不馁")、空洞("展现了良好的精神风貌"
@@ -99,6 +137,16 @@
- 技术描述:"超声波传感器检测距离30cm时启动机械臂"
- 战术分析:"选择了先拿近处资源块的策略,放弃了远处的"
- 复盘语言:"翻车的原因是重心偏高,下次可以..."
- 数据记录:"校准后巡线成功率从60%提升到85%"
- 效率对比:"排查时间从平均3分钟缩短到1.5分钟"
**时间描述规范(小学高年级)**
| 速记 | 输出表述 | 说明 |
|------|---------|------|
| `zx30` | 专注投入约30分钟 | 精确时间 |
| `成功率60→85%` | 成功率从60%提升到85% | 数据对比 |
| `调试3次` | 经过3次调试共用时10分钟 | 详细过程 |
| `排查3分钟` | 排查时间约3分钟 | 效率描述 |
---
@@ -125,7 +173,7 @@
| 开心兴奋 | 😊/🌟 | 情绪积极、喜欢这节课 |
| 合作互助 | 🤝 | 帮助同伴、团队协作 |
| 家庭延伸 | 🏠 | 课后建议 |
| 技术编程 | ⚙️/🤖 | SPIKE/AI03课程 |
| 技术编程 | ⚙️/🤖 | SPIKE/AICODE03课程 |
### 4.3 Emoji位置
@@ -137,7 +185,7 @@
**第2段分散插入示例**
```
互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐💪,第三块开始能自己完成✨。和上周比,今天结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟。
互锁的方法听懂了,实际操作时前两块需要老师扶着手指对齐💪,第三块开始能自己完成✨。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟。
```
**规则**
@@ -169,9 +217,9 @@
- 突出兴趣:用孩子感兴趣的比喻或场景
**示例**
- "今天认识了'互锁结构',像拼图一样把积木交错叠在一起,搭好的墙不容易倒。"
- "今天接触了'重复执行'(循环),用它让小鸟持续扇翅膀,不用重复写很多次一样的代码。"
- "今天训练了颜色传感器的巡线校准,包括白值/黑值重新标定和阈值调整。"
- "本节课认识了'互锁结构',像拼图一样把积木交错叠在一起,搭好的墙不容易倒。"
- "本节课接触了'重复执行'(循环),用它让小鸟持续扇翅膀,不用重复写很多次一样的代码。"
- "本节课训练了颜色传感器的巡线校准,包括白值/黑值重新标定和阈值调整。"
### 5.2 掌握程度第2段前半
@@ -190,23 +238,35 @@
### 5.4 成长亮点第2段后半
**写什么**与之前课程相比的进步,或本次的突出表现
**写什么**本节课展现出的进步或突出表现(**避免使用"和之前相比"、"和两周前相比"等直接对比句式**
**写法**
- 纵向对比:"上次搭到一半就放弃,今天坚持到完成"
- 思维变化:"以前直接问老师,今天先试着自己改参数看效果"
- 习惯养成:"每次试车前都检查螺丝松紧,之前经常忘"
- **直接描述进步**"本节课坚持到最后完成,没有中途放弃"
- **突出当下表现**"本节课遇到困难先试着自己改参数看效果,再寻求帮助"
- **强调习惯养成**"本节课每次试车前都主动检查螺丝松紧,非常细心"
- **展现思维成长**"本节课能清晰描述问题,而不是只说'不会'"
**❌ 避免使用**
- "和上周相比,本节课..."
- "和两周前相比,本节课..."
- "和之前相比,本节课..."
**✅ 推荐表达**
- "本节课展现出了..."
- "本节课能独立..."
- "本节课主动..."
- "本节课坚持..."
### 5.5 课后建议第3段
**写什么**:家长可以在家配合的具体活动
**写法**
- 可操作:不说"多练习",说"用筷子夹豆子"
- 关联课程:"在家可以用乐高重复今天的互锁结构"
- 关联课程:"在家可以用乐高重复本节课的互锁结构"
- 尊重家庭:用"可以试试看"而非"必须"
---
## 六、输入丰富度评估算法
## 六、输入丰富度评估算法v4.6 优化版)
### 6.1 评估维度与分值
@@ -217,51 +277,72 @@
| **纵向对比** | 0-2分 | 提及之前表现+1分有明确对比+1分 | "比上周"=1分"比上周主动多了"=2分 |
| **精彩瞬间** | 0-2分 | 有突破性行为/创新/社交互动 | "第一次主动帮助别人"=2分 |
| **技术细节** | 0-1分 | 有具体数字/参数/步骤 | "调整了3次"、"设了5次循环" = 1分 |
| **思维过程** | 0-2分 | 描述思考/决策/排查过程 | "先检查了...再发现..."=2分 |
| **具体数据** | 0-2分 | 有时间/次数/百分比等数据 | "调试了3次用了8分钟"=2分 |
**满分**10
**满分**14
### 6.2 版本选择决策矩阵
### 6.2 版本选择决策矩阵v4.6 更新)
| 总分 | 输出版本 | 字数范围 |
|:----:|:-------:|:-------:|
| 0-3分 | **精简版** | 180-220字 |
| 4-6分 | **标准版** | 220-280字 |
| 7-10分 | **详细版** | 280-350字 |
| 总分 | 输出版本 | 字数范围 | 结构 |
|:----:|:-------:|:-------:|:----:|
| 0-4分 | **精简版** | 180-220字 | 3段 |
| 5-8分 | **标准版** | 220-300字 | 3段 |
| 9-14分 | **详细版** | 300-400字 | 3-4段 |
### 6.3 评估示例
**v4.6 优化说明**
- 新增"思维过程"和"具体数据"两个维度,鼓励描述学生的思考过程
- 详细版支持4段式结构允许更充分的细节展开
- AI 基于学生画像和历史数据自动补充细节,老师输入简洁也能得到丰富输出
### 6.3 评估示例v4.6 更新)
**精简输入**"乔乔搭了3层开心"
- 行为数量1分 | 情绪描述1分 | 纵向对比0分 | 精彩瞬间0分 | 技术细节0分
- **总分2分 → 精简版**
- 行为数量1分 | 情绪描述1分 | 纵向对比0分 | 精彩瞬间0分 | 技术细节0分 | 思维过程0分 | 具体数据0分
- **总分2分 → 精简版180-220字**
**标准输入**"乔乔观望5分钟后主动搭3层自己调整开心比上周有进步"
- 行为数量3分 | 情绪描述1分 | 纵向对比1分 | 精彩瞬间0分 | 技术细节1分
- **总分:6分 → 标准版**
- 行为数量3分 | 情绪描述1分 | 纵向对比1分 | 精彩瞬间0分 | 技术细节1分 | 思维过程0分 | 具体数据1分
- **总分:7分 → 标准版220-300字**
**详细输入**"乔乔观望5分钟后主动搭3层球卡住自己调整还帮助旁边的小朋友最后说这是最喜欢的作品比上周主动多了"
- 行为数量3分 | 情绪描述2分 | 纵向对比2分 | 精彩瞬间2分 | 技术细节1分
- **总分10分 → 详细版**
- 行为数量3分 | 情绪描述2分 | 纵向对比2分 | 精彩瞬间2分 | 技术细节1分 | 思维过程1分 | 具体数据1分
- **总分12分 → 详细版300-400字**
**AI 自动扩展示例**
- **老师输入**"乔乔gj5→zd3→zt ↑++"(极简速记)
- **AI 自动补充**
- 从画像获取:乔乔性格内向、需鼓励
- 从历史数据上周观望10分钟、搭建2层
- 自动计算观望时间减少50%搭建层数增加50%
- **输出**详细版课评AI 自动扩展为300-400字
---
## 七、完整示例
### 示例1幼儿积木课小班
### 示例1幼儿积木课小班- 标准版
**输入**小明4岁小班互锁结构搭建。专注度3分开始时需要老师引导后半段独立完成最后自己加了装饰。
**输出**
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固🔍
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固,不容易倒🔍
本节课小明对房子主题很感兴趣,搭建环节专注投入约30分钟💪。互锁的方法听懂了实际操作时前两块需要老师扶着手指对齐,第三块开始能自己完成✨。和上周比,本节课结构倒了没有发脾气,而是拆开重新观察了一下底座平不平,这个调整值得注意🌟
本节课小明对房子主题表现出浓厚兴趣,搭建环节一直很投入💪。互锁的方法在导入环节就听懂了原理,但实际操作时前两块需要老师扶着手指对齐凹槽,第三块开始能独立完成,到第五块时已经能自己检查是否对齐✨。结构第一次倒了是因为底座不平,小明没有像以前那样直接推倒重来,而是拆开重新观察底座,发现左边比右边低,调整后重新搭建,这个情绪调节和问题解决能力比两周前有明显提升🌟
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的概念🏠
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的互锁概念🏠
---
*字数:198字 | 段落3段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
*字数:258字 | 段落3段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
### 示例2少儿编程课小学二年级
**改进点**
- 增加过程细节第2块→第3块→第5块的进步阶梯
- 增加思维描述(发现左边比右边低)
- 增加纵向对比(两周前的情绪调节能力)
- 保持时间模糊化("一直很投入"而非"30分钟"
### 示例2少儿编程课小学二年级- 详细版
**输入**李想8岁学习了循环和条件判断程序调试了三次才成功最后自己加了一个开始按钮。
@@ -269,24 +350,39 @@
李想本节课学习了"重复执行"(循环)和"如果碰到颜色就..."(条件判断),用这两个概念做了一个小猫走迷宫的游戏💡
循环的作用理解了,第一次把循环次数设成3次小猫走得不够远改成10次后正常条件判断一开始方向写反了检查代码后发现并修正💪。导入环节对迷宫游戏很感兴趣,实践环节专注完成代码搭建,最后分享环节能说出循环的作用,本节课的编程目标顺利达成✨。和上周相比,本节课会主动给代码分区域摆放(运动放一起、外观放一起),这个整理习惯有助于后续写更复杂的程序📈
本节课李想对迷宫游戏表现出持续兴趣搭建环节专注投入约35分钟全程没有分心💪。循环的作用在导入环节就理解了,第一次设置成重复3次运行后发现小猫只走了30步就到边缘了第二次改成5次还是不够第三次改成10次成功走到迷宫出口三次调试共用时约10分钟✨。条件判断一开始方向写反了写的是"如果碰到边缘就停止"而不是"反弹"),李想没有直接问老师,而是先检查代码块的颜色和文字发现逻辑不对后自己修正💡。特别值得肯定的是本节课遇到bug时先自己排查了约3分钟尝试改了两个参数观察效果最后才举手求助展现出了很好的独立调试能力📈。分享环节能清晰说出"循环就是重复做一样的事",概念掌握扎实🎯
回家后可以试试给游戏加一个"开始"按钮,点击后小猫才动。需要用到"当角色被点击"事件,可以预习一下。下周我们继续🏠
---
*字数218字 | 段落3段 | Emoji4第1段1个/第2段2个/第3段1个第2段分散在段内*
*字数298字 | 段落3段 | Emoji5第1段1个/第2段3个/第3段1个第2段分散在段内*
### 示例3机器人竞赛课小学四年级
**改进点**
- 增加调试过程细节3次调试的具体参数变化
- 增加错误描述("碰到边缘就停止"vs"反弹"
- 增加排查过程(检查颜色和文字)
- 增加时间数据35分钟、10分钟、3分钟
- 增加概念复述(验证理解程度)
### 示例3机器人竞赛课小学四年级- 详细版
**输入**王浩10岁训练了巡线校准和新任务策略对抗练习输了但会复盘。
**输出**
王浩本节课训练了颜色传感器的巡线校准(重新标定白/黑值)和新任务策略(先近后远、分段计时),主要解决之前巡线误判和策略执行拖沓的问题⚙️
王浩本节课系统训练了颜色传感器的巡线校准和新任务策略优化,核心解决之前巡线误判(黑线识别成白色)和策略执行拖沓(近处资源块拿取超时)的问题⚙️
校准后巡线成功率从上次60%提升到85%,新策略执行不够果断,计划"前30秒拿近处"实际用了45秒💪。导入环节对竞技策略话题很感兴趣实操训练专注完成巡线调试复盘环节能分析出问题原因本节课的训练目标顺利达成✨。和两周前相比,遇到程序异常时不再直接重试,而是先分析可能原因(传感器/参数/结构),有针对性调整,调试效率明显提高📈
巡线校准环节王浩重新标定了白值从原来的45调整到38和黑值从原来的12调整到8校准后巡线成功率从上次60%10次测试成功6次提升到85%20次测试成功17次误判率明显下降💪。新策略执行环节计划"前30秒拿近处3个资源块"实际用了45秒只拿到2个分析原因是机械臂展开角度偏大导致夹取时需要二次调整下次可以优化展开角度到35度试试✨。本节课展现出了很好的系统排查能力,遇到程序异常时不再直接点击重试,而是先打开传感器数据面板查看实时读数再检查程序逻辑最后才调整参数排查时间从平均3分钟缩短到1.5分钟调试效率提升50%📈
周末可以用模拟器测试几种不同的时间分配方案20+100、30+90、40+80记录哪种得分更高,下周带数据来讨论策略优化🏠
周末建议用模拟器测试三种时间分配方案20+100、30+90、40+80每种方案跑5次记录平均得分带数据来讨论策略优化🏠
---
*字数226字 | 段落3段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
*字数298字 | 段落3段 | Emoji4个第1段1个/第2段2个/第3段1个第2段分散在段内*
**改进点**
- 增加具体参数白值45→38黑值12→8
- 增加测试数据20次测试成功17次
- 增加问题分析(机械臂展开角度偏大)
- 增加解决方案优化到35度
- 增加效率对比3分钟→1.5分钟提升50%
- 增加可执行的课后任务三种方案每种5次