初始化课评系统仓库:包含规则配置、学生档案、课程教案、班级汇总

This commit is contained in:
qiuyan
2026-05-08 14:15:00 +08:00
commit 16af260a11
300 changed files with 30338 additions and 0 deletions

View File

@@ -0,0 +1,271 @@
# 通用结构规范
> 统一文档中重复定义的结构规则,避免多处维护导致不一致
---
## 一、三段式结构规范(全年龄段统一)
> **适用**:幼儿积木课、少儿编程课、机器人竞赛课
### 段落结构
| 段落 | 内容 | 字数范围 | Emoji |
|------|------|:--------:|:-----:|
| **第1段** | 课程知识点 | 30-55字 | 1个🔍/💡/⚙️根据内容) |
| **第2段** | 课堂细节(掌握程度+课程环节+成长亮点)| **100-220字弹性** | 1-3个根据情节自动适配 |
| **第3段** | 课后建议 | 30-55字 | 1个🏠/🔧根据内容) |
### 字数弹性规则
| 输入类型 | 字数范围 | 触发条件 |
|:-------:|:-------:|:---------|
| **精简版** | 180-220字 | 输入简洁,仅包含基本行为描述 |
| **标准版** | 220-280字 | 输入有具体细节或1-2个亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
### 各年龄段字数调整
| 年龄段 | 基准字数 | 调整说明 |
|--------|:-------:|:---------|
| 托班2.5-3岁| 精简版下限 | 可减少20-30字 |
| 小班3-4岁| 标准版 | 按标准范围 |
| 中班4-5岁| 标准版 | 按标准范围 |
| 大班5-6岁| 标准版上限 | 可增加10-20字 |
| 一年级6-7岁| 标准版下限 | 按标准范围下限 |
| 四年级9-10岁| 详细版上限 | 可至350字 |
---
## 二、Emoji使用规则
### 2.1 基本原则
| 项目 | 规则 |
|------|------|
| **位置** | 每段末尾,段落中间不出现 |
| **第1段** | 1个🔍/💡/⚙️根据课程主题) |
| **第2段** | 1-3个根据情节自动适配 |
| **第3段** | 1个🏠/🔧根据建议内容) |
| **总计** | **3-5个**,灵活不固定 |
| **禁止** | 段落中间、连续多个、负面表情(😡😤💢) |
### 2.2 表情适配指南
| 段落 | 内容 | 推荐表情 | 适配场景 |
|------|------|:-------:|---------|
| 第1段 | 课程知识点 | 🔍/💡/⚙️ | 🔍探索新知识/💡有启发/⚙️技术课 |
| 第2段 | 课堂细节 | 1-3个 | 💪努力/✨亮点/📈进步/🌟突破/😊开心/🤝合作 |
| 第3段 | 课后建议 | 🏠/🔧 | 🏠家庭活动/🔧技术准备 |
### 2.3 各年龄段风格对照
| 年龄段 | 风格特点 | 示例 |
|--------|---------|------|
| **幼儿2.5-6岁** | 温暖活泼 | 🔍 💪✨ 🏠 |
| **小学6-10岁** | 简洁专业 | 💡 📈 🏠 |
### 2.4 第2段表情使用说明
**第2段可根据情节使用1-3个表情**,自然分隔不同亮点:
- **1个表情**:基础描述,无明显亮点
- **2个表情**有1-2个亮点如努力+进步)
- **3个表情**:精彩瞬间多、多个亮点(如💪✨📈努力+亮点+进步)
**示例**
```
第2段有2个亮点努力和突破
...这个坚持值得肯定 💪✨
第2段有3个亮点努力、进步、开心
...调试效率明显提高 💪📈😊
```
---
## 三、跨班级补课处理流程(自动版)
### 定义
学生档案在A班来B班补课B班为当前班级
### 归属规则
**以补课班级B班的周数为准**
### 处理流程图(自动版)
```
检测到[补课]标记
检查当前班级档案
┌───┴───┐
▼ ▼
存在 不存在
│ │
▼ ▼
双轨保存 搜索其他班级
(本班补课) │
┌──┴──┐
▼ ▼
存在 不存在
│ │
▼ ▼
自动跨班级 询问
双轨保存 建档
```
### 自动跨班级双轨保存
当检测到学生档案在其他班级存在时,**自动执行**
1. ✅ 保存到补课班级B班周汇总
2. ✅ 追加到原班级A班个人历史课评记录.md
3. ✅ 在原班级档案中标注"【跨班级补课】本节课程在B班第X周完成"
**无需询问,自动完成**
### 存储位置对照
| 场景 | 班级汇总 | 个人档案 |
|------|---------|---------|
| 本班补课 | ✅ 当前班级 | ✅ 当前班级 |
| 跨班级补课 | ✅ 补课班级 | ✅ 原班级(自动追加,标注补课信息)|
| 完全无档案 | ✅ 当前班级 | ❌ 不保存(或询问后创建)|
### 课评正文规范
- **绝对禁止**:提及"补课"、"跨班级"、"临时加入"等词汇
- **正确处理**:完全按正常学生撰写,仿佛就是本班学生
---
## 四、引用说明
各风格规则文件引用本规范:
- [20-style-building.md](20-style-building.md) - 幼儿积木搭建
- [21-style-coding.md](21-style-coding.md) - 少儿编程入门
- [22-style-robotics.md](22-style-robotics.md) - 机器人竞赛
- [50-output-format-preschool.md](50-output-format-preschool.md) - 学龄前输出格式
- [51-output-format-elementary.md](51-output-format-elementary.md) - 小学输出格式
---
## 五、输入丰富度评估算法
### 评估维度与分值
| 维度 | 分值 | 判定标准 | 示例 |
|------|:----:|---------|------|
| **行为数量** | 0-3分 | 每1个独立行为+1分 | 观望、搭建、调整 = 3分 |
| **情绪描述** | 0-2分 | 有情绪词+1分有具体程度+1分 | "开心"=1分"特别开心"=2分 |
| **纵向对比** | 0-2分 | 提及之前表现+1分有明确对比+1分 | "比上周"=1分"比上周主动多了"=2分 |
| **精彩瞬间** | 0-2分 | 有突破性行为/创新/社交互动 | "第一次主动帮助别人"=2分 |
| **技术细节** | 0-1分 | 有具体数字/参数/步骤 | "调整了3次"、"设了5次循环" = 1分 |
**满分**10分
### 版本选择决策矩阵
| 总分 | 输出版本 | 字数范围 | 说明 |
|:----:|:-------:|:-------:|:----:|
| 0-3分 | **精简版** | 180-220字 | 基础描述,简洁明了 |
| 4-6分 | **标准版** | 220-280字 | 有具体细节,充分展现 |
| 7-10分 | **详细版** | 280-350字 | 精彩瞬间多,全面记录 |
### 边界值处理规则
**219字算精简版还是标准版**
```
判定逻辑:
1. 先按输入丰富度评分确定目标版本
2. 生成内容时,在目标版本字数范围内灵活调整
3. 边界值如219字优先按「向下取整」原则
- 219字 → 精简版180-220字范围
- 221字 → 标准版220-280字范围
例外如果输入评分为6分标准版门槛但生成内容恰好219字
→ 允许扩展到221字确保进入标准版范围
```
**字数偏差处理**
- 生成字数与目标范围偏差>10%时,自动调整段落长度
- 偏差>20%时,提示教师确认
### 评估示例
**示例1精简输入**
```
输入乔乔搭了3层开心
评估:
- 行为数量1搭建= 1分
- 情绪描述1开心= 1分
- 纵向对比0 = 0分
- 精彩瞬间0 = 0分
- 技术细节0 = 0分
总分2分 → 精简版180-220字
```
**示例2标准输入**
```
输入乔乔观望5分钟后搭了3层自己调整高度开心比上周有进步
评估:
- 行为数量3观望、搭建、调整= 3分
- 情绪描述1开心= 1分
- 纵向对比1比上周= 1分
- 精彩瞬间0 = 0分
- 技术细节15分钟、3层= 1分
总分6分 → 标准版220-280字
```
**示例3详细输入**
```
输入乔乔观望5分钟后主动搭3层球卡住自己调整还帮助旁边的小朋友
最后说这是最喜欢的作品比上周主动多了上周观望10分钟才开始
评估:
- 行为数量4观望、搭建、调整、帮助= 3分上限
- 情绪描述2最喜欢= 2分
- 纵向对比2比上周+具体对比)= 2分
- 精彩瞬间2主动帮助别人+情感表达)= 2分
- 技术细节15分钟、3层、10分钟= 1分
总分10分 → 详细版280-350字
```
---
## 六、内容重复度检查规则
### 重复度计算方式
**适用于**:批量生成时检查多个课评之间的重复度
```
重复度 = (相同句子数 + 相似句子数×0.5) / 总句子数 × 100%
```
| 重复度 | 状态 | 处理 |
|:------:|:----:|:----:|
| 0-30% | ✅ 正常 | 无需处理 |
| 31-50% | ⚠️ 轻度重复 | 提示「建议差异化开头」 |
| 51-70% | ⚠️ 中度重复 | 强制要求修改至少2处 |
| >70% | ❌ 高度重复 | 禁止批量发送,需逐条修改 |
### 判定标准
**相同句子**完全一致或仅改动学生姓名≥80%相似)
**相似句子**句式结构相同仅关键词不同50-80%相似)
### 批量生成时的差异化策略
| 学生类型 | 强制差异化项 |
|----------|-------------|
| 谨慎型 | 开头句式、参与勇气描述 |
| 活跃型 | 开头句式、专注力描述 |
| 进步型 | 纵向对比具体表现 |
| 补课型 | 融入过程描述 |
| 体验型 | 首次尝试描述 |
---
*版本v1.1*
*更新日期2026-05-01*
*更新内容:新增输入丰富度评估算法、内容重复度检查规则*