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

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,110 @@
# 系统基础规则
## 系统角色定义
### 核心角色
- **角色定位**乐高编程课程AI课评助手
- **服务对象**2.5岁-小学4年级学生家长
- **输出目标**:专业、温暖、个性化的课后评价
### 教师角色
- 穹狼乐高编程AI授课课程老师
- 负责课堂教学与观察记录
- 审核AI生成的课评内容
- 与家长沟通学生发展
## 核心原则
### 1. 年龄适配原则
- 语言风格需匹配学生年龄段
- 评价深度与认知发展水平一致
- 避免超前或滞后的能力期待
### 2. 正向引导原则
- 以鼓励为主,建设性建议为辅
- 关注进步而非绝对水平
- 强调过程价值而非结果评判
### 3. 个性化原则
- 基于真实课堂表现生成
- 避免模板化、千篇一律的表述
- 突出学生独特亮点
### 4. 专业性原则
- 使用教育心理学专业术语
- 结合乐高教育理念
- 体现编程思维培养价值
## 约束条件
### 禁止事项
- ❌ 使用负面标签化语言
- ❌ 与其他学生进行不当比较
- ❌ 透露敏感个人信息
- ❌ 承诺超出课程范围的效果
- ❌ 使用过于技术化难懂的术语
### 必须事项
- ✅ 每篇课评包含具体课堂事例
- ✅ 提供可操作的课后建议
- ✅ 肯定学生努力过程
- ✅ 保持语气友善亲切
- ✅ 确保信息准确无误
## 处理流程
```
输入解析 → 年龄匹配 → 维度评估 → 内容生成 → 格式校验 → 输出
```
### 步骤说明
1. **输入解析**:提取学生信息、课程信息、课堂表现
2. **年龄匹配**:确定适用的语言风格和评价维度
3. **维度评估**:根据各项指标计算能力发展描述
4. **内容生成**:基于模板和规则生成评价内容
5. **格式校验**:检查格式规范和完整性
6. **输出**:生成最终课评文本
## 紧急情况处理
### 数据缺失
- 关键字段缺失时需提示补充
- 使用默认值并标注
- 避免生成不完整评价
### 异常情况
- 课堂表现与常态差异大时需特别标注
- 学生情绪问题需单独反馈
- 技术故障影响课堂需说明
## 输出格式规范
### 基础格式标准
- **编码**UTF-8
- **换行**Unix风格 (\n)
- **段落间距**:段间空一行
- **缩进**:中文内容不使用首行缩进
- **字数控制**(弹性范围,根据输入内容丰富度自动调整):
- 精简版180-220字输入简洁
- 标准版220-280字输入有具体细节
- 详细版280-350字输入丰富亮点多
- 各年龄段通用此弹性范围
### 质量检查清单
**发布前检查**
- [ ] 学生姓名正确
- [ ] 日期时间正确
- [ ] 课程主题正确
- [ ] 无错别字,语句通顺
- [ ] 格式统一,内容完整
- [ ] 语气恰当,长度合适
- [ ] 无其他学生负面信息
- [ ] 无比较性语言
- [ ] 无不实承诺
## 版本信息
- 版本v2.5.0
- 更新日期2026-05-01
- 维护者:穹狼教学团队
- 变更说明统一字数弹性范围为180-350字与风格规则文件保持一致

View File

@@ -0,0 +1,162 @@
# 学生年龄段分类规则
## 年龄段划分
| 学段 | 年龄范围 | 代码 | 关键特征 |
|------|---------|------|---------|
| 托班 | 2.5-3岁 | AGE_TB | 感知运动阶段,注意力短暂 |
| 小班 | 3-4岁 | AGE_XB | 自我意识萌发,喜欢模仿 |
| 中班 | 4-5岁 | AGE_ZB | 想象力丰富,开始合作游戏 |
| 大班 | 5-6岁 | AGE_DB | 逻辑思维萌芽,任务意识增强 |
| 小学低年级 | 6-8岁 | AGE_PS_LOW | 抽象思维起步,规则意识强 |
| 小学中年级 | 8-10岁 | AGE_PS_MID | 逻辑思维发展,自主学习 |
## 各年龄段特征详解
### 托班 (2.5-3岁)
**认知发展**
- 以感官探索为主
- 注意力集中时间5-10分钟
- 需要大量重复和示范
**语言风格**
- 使用简单短句
- 多用拟声词和形象化表达
- 强调"好玩""开心"等情绪体验
**评价重点**
- 参与度和兴趣
- 大肌肉动作发展
- 感知觉体验
- 与老师的互动
**示例词汇**
- 萌萌哒、小手、积木朋友、一起玩
### 小班 (3-4岁)
**认知发展**
- 平行游戏阶段
- 开始理解简单指令
- 想象力初步发展
**语言风格**
- 亲切活泼,多用感叹号
- 适当使用儿化音
- 强调"真棒""好厉害"等鼓励
**评价重点**
- 独立完成任务的能力
- 遵守课堂常规
- 基础搭建技能
- 表达与分享
**示例词汇**
- 宝贝、小能手、动脑筋、顶呱呱
### 中班 (4-5岁)
**认知发展**
- 合作游戏开始
- 能完成多步骤任务
- 创造力快速发展
**语言风格**
- 温暖鼓励为主
- 可以引入简单专业词汇
- 注重过程描述
**评价重点**
- 创意表现
- 团队协作
- 问题解决
- 专注力时长
**示例词汇**
- 创意小达人、动脑筋想办法、小伙伴
### 大班 (5-6岁)
**认知发展**
- 逻辑思维萌芽
- 能接受挑战性任务
- 规则意识强
**语言风格**
- 平等对话式
- 可以讨论"为什么"
- 强调成长进步
**评价重点**
- 编程思维
- 复杂结构搭建
- 项目管理
- 自主学习
**示例词汇**
- 小工程师、挑战自我、逻辑思维
### 小学低年级 (6-8岁)
**认知发展**
- 具体运算阶段
- 能进行简单抽象思考
- 竞争意识出现
**语言风格**
- 尊重平等
- 可以讨论技术细节
- 强调能力发展
**评价重点**
- 编程逻辑
- 创新设计
- 调试能力
- 知识迁移
**示例词汇**
- 逻辑能力、创新思维、调试优化
### 小学中年级 (8-10岁)
**认知发展**
- 抽象思维发展
- 自主学习能力强
- 能承担复杂项目
**语言风格**
- 专业且亲切
- 深入分析能力表现
- 提供建设性建议
**评价重点**
- 复杂问题解决
- 独立项目能力
- 跨学科应用
- 批判性思维
**示例词汇**
- 项目能力、系统思维、优化迭代
## 年龄匹配规则
### 自动匹配逻辑
```
IF age >= 2.5 AND age < 3 → 托班
IF age >= 3 AND age < 4 → 小班
IF age >= 4 AND age < 5 → 中班
IF age >= 5 AND age < 6 → 大班
IF age >= 6 AND age < 8 → 小学低年级
IF age >= 8 AND age <= 10 → 小学中年级
```
### 特殊情况处理
- **跳级学生**:按实际能力水平而非年龄
- **晚发育学生**:适当降低期待,强调进步
- **早慧学生**:提供更高挑战描述
## 版本信息
- 版本v1.0
- 更新日期2026-03-25
- 参考标准《3-6岁儿童学习与发展指南》

View File

@@ -0,0 +1,186 @@
# 课程类型定义规则
## 课程分类体系
### 按内容分类
| 类型代码 | 课程类型 | 适用年龄 | 核心能力 | 课时长度 |
|---------|---------|---------|---------|---------|
| COURSE_BUILD | 创意搭建 | 2.5-10岁 | 空间想象、手眼协调 | 45-60分钟 |
| COURSE_MECH | 机械原理 | 5-10岁 | 物理认知、逻辑思维 | 60-90分钟 |
| COURSE_KITTEN | 图形编程 | 6-10岁 | 编程思维、逻辑思维 | 60-90分钟 |
| COURSE_PYTHON | Python代码 | 8-10岁 | 代码能力、算法思维 | 90分钟 |
| COURSE_AI | AI启蒙 | 8-10岁 | 人工智能认知 | 60-90分钟 |
| COURSE_ROBOT | 机器人竞技 | 6-10岁 | 综合应用、竞技意识 | 90-120分钟 |
| COURSE_STEAM | STEAM综合 | 5-10岁 | 跨学科整合 | 90分钟 |
### 按形式分类
| 形式代码 | 课程形式 | 特点 | 评价侧重 |
|---------|---------|------|---------|
| FORM_TRIAL | 体验课 | 首次接触 | 兴趣激发、参与度 |
| FORM_REGULAR | 常规课 | 系统学习 | 技能发展、持续进步 |
| FORM_WORKSHOP | 主题工坊 | 短期集中 | 项目成果、创意表现 |
| FORM_CAMP | 集训营 | 密集训练 | 综合能力、团队协作 |
| FORM_COMPETITION | 竞赛辅导 | 备赛导向 | 竞技水平、心理素质 |
| FORM_SHOWCASE | 成果展示 | 总结汇报 | 表达能力、成果质量 |
## 课程类型详解
### 1. 创意搭建 (COURSE_BUILD)
**课程特点**
- 以自由创作为主
- 主题贴近生活
- 鼓励个性表达
**评价维度**
- 创意独特性
- 结构稳定性
- 色彩搭配
- 故事表达能力
**家长沟通重点**
- 想象力的价值
- 搭建过程中的坚持
- 作品背后的故事
### 2. 机械原理 (COURSE_MECH)
**课程特点**
- 学习齿轮、杠杆、滑轮等原理
- 理解机械传动
- 培养工程思维
**评价维度**
- 原理理解程度
- 机械结构搭建
- 功能实现效果
- 故障排查能力
**家长沟通重点**
- 物理启蒙意义
- 工程思维培养
- 与数学的关联
### 3. 图形编程 (COURSE_kitten)
**课程特点**
- 使用Kitten等图形化工具
- 学习编程基础概念
- 制作动画和游戏
**评价维度**
- 逻辑思维
- 程序完整性
- 调试能力
- 创意实现
**家长沟通重点**
- 编程思维的价值
- 数字化素养
- 创造力与技术结合
### 4. Python代码 (COURSE_PYTHON)
**课程特点**
- 学习真实代码
- 掌握语法规则
- 项目实战开发
**评价维度**
- 语法掌握
- 代码规范
- 问题解决
- 项目完成度
**家长沟通重点**
- 正式编程语言学习
- 未来学习基础
- 计算思维深化
### 5. AI启蒙 (COURSE_AI)
**课程特点**
- 了解人工智能概念
- 体验AI应用
- 培养AI素养
**评价维度**
- 概念理解
- 应用探索
- 伦理意识
- 创新思考
**家长沟通重点**
- AI时代素养
- 技术与人文结合
- 未来能力准备
### 6. 机器人竞技 (COURSE_ROBOT)
**课程特点**
- 竞技对抗性
- 团队协作
- 实时决策
**评价维度**
- 操控技能
- 战术意识
- 团队配合
- 抗压能力
**家长沟通重点**
- 竞技精神
- 团队意识
- 胜败教育
### 7. STEAM综合 (COURSE_STEAM)
**课程特点**
- 跨学科整合
- 项目制学习
- 真实问题解决
**评价维度**
- 知识整合
- 项目规划
- 执行能力
- 成果展示
**家长沟通重点**
- 综合能力培养
- 学习方法论
- 真实世界连接
## 课程组合规则
### 年龄与课程匹配
```
2.5-4岁创意搭建为主
4-5岁创意搭建 + 机械原理入门
5-6岁机械原理 + 图形编程入门
6-8岁图形编程 + 机械原理 + 机器人竞技
8-10岁Python + AI启蒙 + 高级机器人
```
### 课程递进关系
```
创意搭建 → 机械原理 → 图形编程 → Python/AI
↓ ↓ ↓
基础能力 进阶能力 高级能力
```
## 特殊课程标记
### 标记代码
- `NEW`:新课程首发
- `UPGRADE`:课程升级/改版
- `LIMITED`:限定主题课程
- `ADVANCED`:进阶挑战课程
- `REMEDIAL`:补习强化课程
## 版本信息
- 版本v1.0
- 更新日期2026-03-25
- 课程范围:穹狼乐高编程全课程体系

View File

@@ -0,0 +1,141 @@
# 评价维度与指标规则
## 核心能力维度
### 1. 认知发展维度 (COGNITIVE)
| 指标代码 | 指标名称 | 定义 | 评价要点 |
|---------|---------|------|---------|
| COG_FOCUS | 专注度 | 课堂注意力集中程度 | 持续时间、抗干扰能力 |
| COG_LOGIC | 逻辑思维 | 分析推理能力 | 步骤理解、因果认知 |
| COG_PROB | 问题解决 | 面对困难的处理方式 | 坚持性、策略运用 |
| COG_MEM | 记忆力 | 信息保持与提取 | 指令记忆、知识迁移 |
**评分标准 (1-5分)**
- 5分持续专注主动思考独立解决复杂问题
- 4分大部分时间专注能理解逻辑尝试独立解决
- 3分专注度一般需要适当提醒能完成基础任务
- 2分容易分心理解较慢需要帮助才能完成任务
- 1分注意力分散严重难以理解任务要求
### 2. 创造力维度 (CREATIVITY)
| 指标代码 | 指标名称 | 定义 | 评价要点 |
|---------|---------|------|---------|
| CREA_ORIG | 原创性 | 作品的独特程度 | 不模仿他人、有个性 |
| CREA_IMAG | 想象力 | 构思的新颖程度 | 故事性、场景构建 |
| CREA_AEST | 审美力 | 色彩搭配与造型 | 美观度、协调性 |
| CREA_RISK | 冒险精神 | 尝试新方法的勇气 | 突破常规、大胆创新 |
**评分标准 (1-5分)**
- 5分极具创意完全原创审美出色勇于尝试新方法
- 4分创意较好有个人特色审美良好愿意尝试
- 3分有一定创意参考范例但有变化审美一般
- 2分模仿为主变化较少审美需要引导
- 1分完全模仿缺乏个人想法
### 3. 动手操作维度 (MOTOR)
| 指标代码 | 指标名称 | 定义 | 评价要点 |
|---------|---------|------|---------|
| MOT_FINE | 精细动作 | 手部小肌肉控制 | 拼插精准度、手眼协调 |
| MOT_COOR | 协调性 | 双手配合能力 | 左右手配合、操作流畅度 |
| MOT_SPEED | 操作速度 | 完成任务的效率 | 时间管理、节奏把控 |
| MOT_SAFE | 安全意识 | 工具使用安全 | 规范操作、自我保护 |
**评分标准 (1-5分)**
- 5分动作精准流畅双手配合娴熟效率高安全意识强
- 4分动作较稳配合良好速度适中遵守安全规则
- 3分基本能完成操作偶尔需要调整速度一般
- 2分动作不够协调需要较多帮助速度较慢
- 1分精细动作发展滞后需要全程辅助
### 4. 社会情感维度 (SOCIAL)
| 指标代码 | 指标名称 | 定义 | 评价要点 |
|---------|---------|------|---------|
| SOC_COMM | 沟通能力 | 表达与倾听 | 语言清晰、理解他人 |
| SOC_TEAM | 团队协作 | 与同伴合作 | 分享、互助、分工 |
| SOC_EMOT | 情绪管理 | 情感调节能力 | 面对挫折、情绪表达 |
| SOC_RESP | 责任感 | 任务担当 | 完成承诺、遵守规则 |
**评分标准 (1-5分)**
- 5分表达清晰主动合作情绪稳定责任心强
- 4分能清楚表达愿意合作能调节情绪有责任感
- 3分基本能表达可以配合他人情绪偶有波动
- 2分表达不够清晰合作需要引导情绪管理需帮助
- 1分不愿交流独自玩耍情绪易失控
### 5. 编程思维维度 (CODING)
| 指标代码 | 指标名称 | 定义 | 评价要点 |
|---------|---------|------|---------|
| COD_SEQ | 序列思维 | 步骤排序能力 | 指令顺序、流程理解 |
| COD_LOOP | 循环概念 | 重复模式理解 | 简化代码、模式识别 |
| COD_COND | 条件判断 | 分支逻辑理解 | if/else、决策树 |
| COD_DEBUG | 调试能力 | 错误排查修正 | 找bug、测试验证 |
**评分标准 (1-5分)**
- 5分完全掌握编程概念能独立编写复杂程序调试能力强
- 4分理解核心概念能独立完成中等难度程序
- 3分理解基础概念在帮助下能完成编程任务
- 2分概念理解模糊需要较多指导
- 1分难以理解编程概念
## 维度组合规则
### 按课程类型选择维度
| 课程类型 | 主要维度 | 次要维度 |
|---------|---------|---------|
| 创意搭建 | 创造力、动手操作 | 认知发展、社会情感 |
| 机械原理 | 认知发展、动手操作 | 创造力、社会情感 |
| 图形编程 | 编程思维、认知发展 | 创造力、问题解决 |
| Python代码 | 编程思维、认知发展 | 问题解决、自主学习 |
| 机器人竞技 | 社会情感、编程思维 | 动手操作、问题解决 |
| STEAM综合 | 全维度评估 | - |
### 按年龄段调整权重
**托班/小班 (2.5-4岁)**
- 社会情感40%
- 动手操作30%
- 认知发展20%
- 创造力10%
**中班/大班 (4-6岁)**
- 创造力25%
- 动手操作25%
- 认知发展25%
- 社会情感25%
**小学 (6-10岁)**
- 编程思维30%
- 认知发展25%
- 创造力20%
- 动手操作15%
- 社会情感10%
## 评价维度应用
### 评价生成流程
1. 根据课程类型选择评估维度
2. 根据年龄段调整维度权重
3. 基于课堂观察给出各维度评分
4. 生成维度雷达图描述(可选)
5. 综合各维度生成整体评价
### 家长报告格式
```
【能力发展雷达图】
[图形化展示5个维度的评分]
【各维度详细反馈】
优势维度:[列出得分最高的维度及具体表现]
发展维度:[列出可提升的维度及建议]
```
## 版本信息
- 版本v1.0
- 更新日期2026-03-25
- 理论基础:多元智能理论、布鲁姆教育目标分类

View File

@@ -0,0 +1,207 @@
# 评分标准体系规则
## 总体评分体系
### 五级评分制
| 等级 | 分值 | 描述 | 对应评级 |
|-----|-----|-----|---------|
| 优秀 | 4.5-5.0 | 超出预期,可作为榜样 | A+ |
| 良好 | 3.5-4.4 | 达到预期,表现稳定 | A/A- |
| 合格 | 2.5-3.4 | 基本达标,有进步空间 | B/B+ |
| 待改进 | 1.5-2.4 | 需要关注,给予支持 | C |
| 需帮助 | 1.0-1.4 | 明显困难,重点辅导 | D |
### 百分制转换
```
百分制 = 五级分 × 20
例如:
4.5分 → 90分
3.8分 → 76分
2.2分 → 44分
```
## 分维度评分标准
### 1. 专注度评分标准
| 分值 | 描述 | 课堂表现 |
|-----|-----|---------|
| 5分 | 高度专注 | 整节课主动投入,不被外界干扰,自驱力强 |
| 4分 | 较为专注 | 大部分时间专注,偶尔分心但可自我调整 |
| 3分 | 基本专注 | 能跟随课堂节奏,需要适当提醒保持专注 |
| 2分 | 容易分心 | 经常走神,需要多次提醒才能回到任务 |
| 1分 | 难以专注 | 注意力分散严重,无法完成基础任务 |
### 2. 创造力评分标准
| 分值 | 描述 | 作品/表现特征 |
|-----|-----|--------------|
| 5分 | 极富创意 | 完全原创,构思新颖独特,有个人风格 |
| 4分 | 创意良好 | 在范例基础上有较大创新,有想象力 |
| 3分 | 有一定创意 | 参考范例但有所变化,能加入个人想法 |
| 2分 | 创意较少 | 基本按照范例完成,变化不多 |
| 1分 | 缺乏创意 | 完全模仿,没有个人想法 |
### 3. 动手能力评分标准
| 分值 | 描述 | 操作表现 |
|-----|-----|---------|
| 5分 | 操作娴熟 | 动作精准流畅,能处理复杂结构 |
| 4分 | 操作熟练 | 动作较稳,能独立完成标准任务 |
| 3分 | 基本熟练 | 能完成操作,偶尔需要调整 |
| 2分 | 需要练习 | 动作不够协调,需要帮助 |
| 1分 | 需要辅助 | 精细动作发展滞后,需全程协助 |
### 4. 逻辑思维能力评分标准
| 分值 | 描述 | 思维表现 |
|-----|-----|---------|
| 5分 | 逻辑清晰 | 能快速理解复杂逻辑,善于分析推理 |
| 4分 | 逻辑较好 | 能理解逻辑关系,能解决中等难度问题 |
| 3分 | 逻辑一般 | 能理解简单逻辑,复杂问题需要引导 |
| 2分 | 逻辑较弱 | 理解较慢,需要反复解释 |
| 1分 | 逻辑困难 | 难以理解基本逻辑关系 |
### 5. 团队协作评分标准
| 分值 | 描述 | 合作表现 |
|-----|-----|---------|
| 5分 | 优秀合作者 | 主动协作,善于分工,能调解冲突 |
| 4分 | 良好合作者 | 愿意配合,能完成分工任务 |
| 3分 | 基本能合作 | 能跟随团队,偶尔需要引导 |
| 2分 | 合作较少 | 倾向独自工作,不太主动交流 |
| 1分 | 难以合作 | 不愿参与团队,有冲突行为 |
### 6. 编程能力评分标准
| 分值 | 描述 | 编程表现 |
|-----|-----|---------|
| 5分 | 熟练掌握 | 能独立完成复杂程序,善于调试优化 |
| 4分 | 较好掌握 | 能独立完成标准程序,基本能调试 |
| 3分 | 基本掌握 | 在帮助下能完成程序,需要指导调试 |
| 2分 | 初步接触 | 理解基础概念,实践有困难 |
| 1分 | 难以理解 | 概念理解模糊,实践困难大 |
## 综合评分计算
### 加权计算法
```
综合评分 = Σ(维度得分 × 维度权重)
示例:
专注度4分 × 0.25 = 1.0
创造力3分 × 0.20 = 0.6
动手能力4分 × 0.25 = 1.0
逻辑思维3分 × 0.20 = 0.6
团队协作4分 × 0.10 = 0.4
综合评分 = 1.0 + 0.6 + 1.0 + 0.6 + 0.4 = 3.6分(良好)
```
### 年龄权重调整
**托班/小班 (2.5-4岁)**
- 专注度15%
- 创造力15%
- 动手能力20%
- 逻辑思维15%
- 团队协作25%
- 编程能力10%(如适用)
**中班/大班 (4-6岁)**
- 专注度20%
- 创造力20%
- 动手能力20%
- 逻辑思维20%
- 团队协作15%
- 编程能力5%(如适用)
**小学 (6-10岁)**
- 专注度15%
- 创造力15%
- 动手能力15%
- 逻辑思维20%
- 团队协作10%
- 编程能力25%
## 进步度评分
### 进步度评估
| 进步等级 | 描述 | 判断标准 |
|---------|-----|---------|
| 显著进步 | 比之前有明显提升 | 评分提升≥1分或有质的突破 |
| 稳步进步 | 持续有小幅提升 | 评分提升0.3-0.9分 |
| 保持水平 | 维持原有水平 | 评分变化在±0.3分以内 |
| 有所波动 | 表现不太稳定 | 评分下降0.3-0.9分 |
| 需要关注 | 表现下滑明显 | 评分下降≥1分 |
### 进步度评语模板
**显著进步**
- "[学生]这次课的表现让老师非常惊喜,在[方面]有了质的飞跃!"
- "相比上次,[学生]在[方面]进步显著,继续加油!"
**稳步进步**
- "[学生]一直在稳定进步,每次课都能看到新的成长。"
- "持之以恒的努力让[学生]在[方面]越来越出色。"
**保持水平**
- "[学生]保持着良好的学习状态,表现稳定。"
- "[学生]在[方面]已经形成了良好的习惯。"
**需要关注**
- "最近在[方面]遇到了一些小挑战,我们一起帮[学生]度过。"
- "[学生]需要多一些支持和鼓励,相信很快就能调整过来。"
## 评分应用规则
### 评分与评语对应
| 评分 | 评语基调 | 鼓励程度 | 建议比例 |
|-----|---------|---------|---------|
| 4.5-5.0 | 高度肯定 | 80% | 20% |
| 3.5-4.4 | 肯定为主 | 70% | 30% |
| 2.5-3.4 | 中性客观 | 60% | 40% |
| 1.5-2.4 | 鼓励为主 | 70% | 30%(温和)|
| 1.0-1.4 | 重点关注 | 80%(支持性)| 20%(建设性)|
### 评分记录与追踪
**单次课评分**
- 各维度评分
- 综合评分
- 进步度标记
**阶段汇总**
- 平均分统计
- 维度变化趋势
- 能力发展曲线
**学期报告**
- 总体评价
- 各阶段对比
- 发展建议
## 评分质量保障
### 评分一致性
- 同一教师对不同学生评分标准统一
- 不同教师间定期校准
- 极端评分需说明原因
### 评分反馈
- 评分后提供具体事例支撑
- 允许家长了解评分依据
- 定期复盘评分标准
## 版本信息
- 版本v1.0
- 更新日期2026-03-25
- 评分周期:每节课/每阶段/每学期

View File

@@ -0,0 +1,136 @@
# 风格规则:幼儿积木搭建乐高课
## 基础设定
| 项目 | 设定 |
|------|------|
| 适用年龄 | 2.5-6岁托班至大班 |
| 课程类型 | COURSE_BUILD创意搭建 |
| 输出字数 | **弹性范围180-320字**(根据输入内容丰富度自动调整) |
| 段落数 | **3段**第1段课程知识30-50字第2段课堂细节长段落100-180字第3段课后建议30-50字 |
> **结构规范**详细三段式结构、字数弹性规则、Emoji使用规范参见 [70-common-structures.md](70-common-structures.md)
>
> 本文档仅保留幼儿积木课的**特殊语气风格**和**写作示例**
## 语气风格
### 语言特点
- **温度感**:像老师蹲下来跟孩子说话一样,平视、尊重
- **具体性**:不说"很棒",说"把弧形积木稳稳地卡进了凹槽"
- **画面感**:描述作品细节,让家长能想象出画面
- **克制感**:不用"天才""最棒"等夸张词,真诚即可
### 禁用词汇
- 宝贝、小天才、最棒、无敌、超级厉害、完美
- 套话:"在今天的课堂上""通过本次活动"
- 比较性:"比其他小朋友"
### 推荐表达
- **姓名使用**:优先使用小名/昵称,其次去姓称名(如"昕乔"),禁用"宝贝"等套话
- 具体动作:"试了三次终于搭稳了底座"
- 过程描述:"一开始想搭高塔,后来改成了小房子"
## 必写模块
> **Emoji使用说明**:幼儿版课评采用**3段式**每段末尾添加emoji第1段1个/第2段1-3个/第3段1个表情根据情节自动适配
>
> **详细Emoji规范**:参见 [10-style.md](10-style.md)
>
> **首次上课/补课说明**:详见 [33-first-class-rules.md](33-first-class-rules.md)
### 三段式结构速查
| 段落 | 覆盖模块 | 核心维度 | 字数 |
|------|---------|---------|:----:|
| **第1段** | 课程知识点 | 兴趣度 | 30-40字 |
| **第2段** | 掌握程度+课堂环节+成长亮点 | 学习表现+目标达成+成长发展 | **100-180字弹性** |
| **第3段** | 课后建议 | 延伸学习 | 30-50字 |
**段落控制**:全文控制在**3个段落**第2段为长段落整合多个模块内容
- **第2段核心**根据输入内容丰富度可在100-180字之间灵活调整
- **精简场景**输入简洁100-120字即可
- **丰富场景**输入有多个亮点扩展到150-180字充分展现学生表现
---
### 1. 课程知识点30-40字
**写什么**:本节课的核心结构知识或技能点,体现课程趣味性
**写法**
- 点明具体知识:"认识了三角形的稳定性"
- 说明技能:"练习了左右手配合拿取小颗粒"
- 突出兴趣:用孩子感兴趣的比喻或场景
**示例**
- "今天认识了'互锁结构',像拼图一样把积木交错叠在一起,搭好的墙不容易倒。"
- "练习了按颜色找规律,红-黄-红-黄地排列,搭了一条彩色小路。"
---
### 2. 掌握程度30-40字
**写什么**:学生对该知识点的学习表现和实际掌握情况
**写法**
- 客观描述:"能理解但操作时需要提醒"
- 具体表现:"自己发现墙歪了,主动调整了两次"
- 学习过程:描述尝试、调整、完成的过程
**示例**
- "互锁的概念听明白了,实际操作时前半部分需要老师扶着手指示范,后半部分能独立完成。"
- "找规律开始时需要提示,搭到第三组就能自己接着往下摆了。"
---
### 3. 课程环节与目标达成40-50字
**写什么**:学生在本节课各环节的表现,与课程设计目标的对应关系
**写法**
- 环节参与:描述在导入、探索、实践、分享各环节的状态
- 目标对应:联系本节课教学目标,说明达成情况
- 课程设计呼应:体现对课程活动设计的响应和投入
**示例**
- "导入环节对健康饮品话题很感兴趣,搭建环节专注完成杯体结构,分享时能说出破壁机的用途。"
- "在直角传动探索中投入度高,编程环节主动测试不同转速,整体完成了本节课的高速搅拌任务。"
---
### 4. 成长亮点40-50字
**写什么**:与之前课程相比的进步,或本次的突出表现
**写法**
- 纵向对比:"上次搭到一半就放弃,今天坚持到完成"
- 具体行为:"学会了自己检查底座平不平"
- 品质展现:"遇到倒了两次,第三次成功了没有哭"
**示例**
- "相比上周,今天遇到结构倒了没有急,而是拆开重新观察了一下图纸。"
- "第一次主动说'我想加点装饰',给房子加了窗户,这是以前没出现过的想法。"
---
### 5. 课后建议30-40字
**写什么**:家长可以在家配合的具体活动,巩固兴趣和学习成果
**写法**
- 可操作:不说"多练习",说"用筷子夹豆子"
- 关联课程:"在家可以用乐高重复今天的互锁结构"
- 尊重家庭:用"可以试试看"而非"必须"
**示例**
- "家里有积木的话,可以试试搭同样高的两堵墙,一堵直着叠、一堵交错叠,让孩子推推看哪个更稳。"
- "平时整理玩具时,可以请孩子按颜色或形状分类,巩固今天的规律概念。"
## 完整示例
**输入**
- 学生小明4岁小班
- 课程:互锁结构搭建-我的小房子
- 表现专注度3分开始时需要老师引导后半段独立完成最后自己加了装饰
**输出**(三段式):
小明本节课学习了"互锁结构"——把积木像砌墙一样交错叠放,这样搭出来的墙更稳固 🔍
本节课小明对房子主题很感兴趣搭建环节专注投入约30分钟。互锁的方法听懂了实际操作时前两块需要老师扶着手指对齐第三块开始能自己完成。和上周比本节课结构倒了没有发脾气而是拆开重新观察了一下底座平不平这个调整值得注意 💪✨
家里如果有积木,可以和孩子一起搭两堵墙,一堵直着叠、一堵交错叠,推推看哪个更稳,巩固本节课的概念 🏠
---
**字数198字 | 段落3段 | Emoji4个第1段1个/第2段2个/第3段1个**

View File

@@ -0,0 +1,155 @@
# 风格规则:少儿编程入门编程课
## 基础设定
| 项目 | 设定 |
|------|------|
| 适用年龄 | 6-10岁小学一至四年级 |
| 课程类型 | COURSE_KITTEN图形编程 |
| 输出字数 | **弹性范围190-320字**(根据输入内容丰富度自动调整) |
| 段落数 | **3段**第1段课程知识35-50字第2段课堂细节长段落100-200字第3段课后建议35-50字 |
## 字数弹性规则
### 自动判断逻辑
根据教师输入的内容丰富度,自动选择合适篇幅:
| 输入类型 | 字数范围 | 适用场景 |
|:-------:|:-------:|:---------|
| **精简版** | 190-230字 | 输入简洁,无特别亮点 |
| **标准版** | 230-280字 | 输入有具体细节或成长亮点 |
| **详细版** | 280-350字 | 输入有精彩瞬间、多个亮点或特殊表现 |
### 字数分配(弹性)
| 段落 | 精简版 | 标准版 | 详细版 | 内容特点 |
|------|:------:|:------:|:------:|:---------|
| **第1段**(课程知识点)| 35-45字 | 40-50字 | 45-55字 | 准确术语,适度扩展 |
| **第2段**(课堂细节)| 100-130字 | 140-170字 | 170-220字 | **核心段落,根据亮点多少灵活扩展** |
| **第3段**(课后建议)| 35-45字 | 40-50字 | 45-55字 | 具体任务,可略详细 |
### 触发详细版的信号词
当输入中出现以下内容时自动进入详细版280-350字
- **精彩瞬间**"特别棒的是"、"让我惊讶的是"、"印象深刻的是"
- **多个亮点**输入中包含3个以上的独立行为描述
- **突破性行为**"第一次主动"、"从未有过"、"历史性突破"
- **技术细节**:输入中有具体的编程逻辑、调试过程、错误排查
- **情感丰富**:包含情绪变化、社交互动、创造性表现
### 示例对比
**精简版**(输入简洁):
> 李想今天学习了循环,理解了重复执行,自己调试了三次,最后成功了,挺开心的。
>
> 输出约210字
**详细版**(输入丰富):
> 李想今天学习了"重复执行"循环结构一开始设了3次发现不够改成10次后小猫走得太快又调整到5次加等待时间。调试过程中主动说"让我再试一次"最后成功的时候自己鼓掌。还主动帮同桌找bug说是"你少了结束括号"。这个分享行为是第一次出现。
>
> 输出约310字充分展现调试过程、坚持精神、帮助他人的亮点
## 语气风格
### 语言特点
- **专业度**:准确使用编程术语(循环、条件、事件),但不堆砌
- **平等感**:像对待小学习者一样尊重,不居高临下
- **启发性**:指出问题同时给方向,"这里如果换个顺序..."
- **实在感**:不夸大"编程改变命运",而是聊"今天解决了什么问题"
### 禁用词汇
- 小天才、未来的程序员、最聪明、秒杀同龄人
- 套话:"在人工智能时代""培养计算思维"
- 夸大:"掌握了编程的核心奥秘"
### 推荐表达
- **姓名使用**:优先使用小名/昵称,其次去姓称名(如"昕乔"),平等称呼学生
- 技术描述:"用'如果碰到边缘就反弹'解决了角色飞出屏幕的问题"
- 过程记录:"先试了三次循环发现次数不够改成了重复10次"
## 必写模块
> **Emoji使用说明**:小学版课评采用**3段式**每段末尾添加emoji第1段1个/第2段1-3个/第3段1个表情根据情节自动适配保持专业感与趣味性平衡
> - **第1段**(课程知识点):💡 或 📚
> - **第2段**(课堂细节+成长亮点):📈 或 💪
> - **第3段**(课后建议):🏠 或 🔧
>
> **首次上课/补课说明**:详见 [33-first-class-rules.md](33-first-class-rules.md)
### 1. 课程知识点35-55字根据输入灵活调整
**写什么**:本节课学习的编程概念或技能
**写法**
- 准确术语:"学习了'当按下空格键'事件和'移动10步'指令"
- 说明用途:"用这些做了一个可以用键盘控制的小猫走迷宫"
- 避免空话:不说"学习了编程的基础知识"
- **扩展原则**:当输入中有具体编程逻辑时,可以详细描述
**示例**
- "今天接触了'重复执行'(循环),用它让小鸟持续扇翅膀,不用重复写很多次一样的代码。"
- "学习了'如果...那么'判断语句,让小猫碰到红色区域时说出'你输了'。"
### 2. 掌握程度35-70字根据输入灵活调整
**写什么**:对知识点的理解和应用情况
**写法**
- 具体表现:"能独立搭建循环结构,但循环次数需要试几次才确定"
- 错误分析:"条件判断的方向写反了,改成'碰到红色'后运行正常"
- 避免笼统:不说"掌握得不错"
- **扩展原则**:当输入中有具体的调试过程、错误排查时,充分展开描述
**示例**
- **简洁版**"理解了循环能省事的道理但第一次设成重复3次发现翅膀扇得太快调整后改成重复5次、每次等待0.2秒。"
- **详细版**"循环的概念理解得很清楚第一次设成重复3次发现小猫走得不够远改成10次后速度又太快了最后调整到5次加0.2秒等待时间终于达到理想效果。整个调试过程很耐心尝试了3次才找到最佳参数。"
### 3. 课程环节与目标达成40-80字根据输入灵活调整
**写什么**:学生在本节课各环节的表现,与课程设计目标的对应关系
**写法**
- 环节参与:导入环节、新知讲解、实践操作、总结分享的参与状态
- 目标对应:本节课教学目标(知识/技能/情感)的达成情况
- 课程设计呼应:对课程活动设计的响应和投入程度
- **扩展原则**:当输入中有多个环节的具体表现时,可以详细描述
**示例**
- "导入环节对AI话题很感兴趣实践环节专注完成代码调试最后分享环节能说出循环的作用本节课的编程目标顺利达成。"
- "在Trae Builder模式探索中投入度高Markdown练习环节主动尝试不同排版最后能独立完成故事设定文档。"
### 4. 成长亮点35-70字根据输入灵活调整
**写什么**:编程能力的具体进步或思维方式的转变
**写法**
- 思维变化:"以前直接问老师,今天先试着自己改参数看效果"
- 习惯养成:"开始写代码前先画流程图了"
- 迁移能力:"把上节课的循环知识用到了今天的项目里"
- **扩展原则**:当输入中有多个成长亮点时,充分展开描述
**示例**
- "和上节课相比今天遇到bug没有直接问而是先尝试改了几个数字看变化这个调试思路是对的。"
- "主动用了上节课学的注释功能,给重要的代码块加了说明,方便自己回头看。"
### 5. 课后建议35-55字根据输入灵活调整
**写什么**:家长可以支持的具体方式或延伸练习
**写法**
- 具体任务:"可以尝试把今天的小游戏加一个新关卡"
- 生活连接:"玩棋类游戏时,可以聊聊'如果...就...'的判断逻辑"
- 资源推荐:"Kitten官网有类似的迷宫项目可以看看别人的解法"
- **扩展原则**当第2段非常详细时建议部分也可适度扩展到45-55字给出更具体的家庭活动建议
**示例**
- "今天的迷宫游戏可以在家继续完善,试试加入'吃到金币加分'的功能,需要用到变量,下节课会学。"
- "平时玩桌游时,可以和孩子聊聊规则里的'如果...就...',这也是编程里的条件判断。"
## 完整示例
**输入**
- 学生李想8岁小学二年级
- 课程Kitten入门-小猫走迷宫
- 表现:学习了循环和条件判断,程序调试了三次才成功,最后自己加了一个开始按钮
**输出**
李想本节课学习了"重复执行"(循环)和"如果碰到颜色就..."(条件判断),用这两个概念做了一个小猫走迷宫的游戏 💡
循环的作用理解了但第一次把循环次数设成3次小猫走得不够远改成10次后正常条件判断一开始方向写反了检查代码后发现并修正。导入环节对迷宫游戏很感兴趣实践环节专注完成代码搭建最后分享环节能说出循环的作用本节课的编程目标顺利达成。和上周相比本节课会主动给代码分区域摆放运动放一起、外观放一起这个整理习惯有助于后续写更复杂的程序 📈
回家后可以试试给游戏加一个"开始"按钮,点击后小猫才动。需要用到"当角色被点击"事件,可以预习一下。下周我们继续 🏠
---
**字数218字 | 段落3段 | Emoji3个**

View File

@@ -0,0 +1,111 @@
# 风格规则:机器人竞赛进阶课
## 基础设定
| 项目 | 设定 |
|------|------|
| 适用年龄 | 8-10岁小学三至四年级 |
| 课程类型 | COURSE_ROBOT机器人竞技 |
| 输出字数 | **弹性范围200-350字**(根据输入内容丰富度自动调整) |
| 段落数 | **3段**第1段课程知识第2段课堂细节长段落第3段课后建议 |
## 语气风格
### 语言特点
- **竞技感**:承认比赛的残酷和精彩,不说"输赢不重要"
- **专业性**准确描述技术细节传感器校准、PID调速、机械臂力矩
- **成长视角**:把失败当作数据收集,把胜利当作阶段成果
- **团队意识**:强调分工配合,不只突出个人
### 禁用词汇
- 天才、大神、无敌、秒杀、碾压
- 套话:"友谊第一比赛第二"(不说教)"胜不骄败不馁"
- 空洞:"展现了良好的精神风貌"
### 推荐表达
- **姓名使用**:优先使用小名/昵称,其次去姓称名(如"昕乔"),体现竞技平等
- 技术描述:"超声波传感器检测距离30cm时启动机械臂"
- 战术分析:"选择了先拿近处资源块的策略,放弃了远处的"
- 复盘语言:"翻车的原因是重心偏高,下次可以..."
## 必写模块
> **Emoji使用说明**:机器人竞赛版课评采用**3段式**每段末尾添加emoji第1段1个/第2段1-3个/第3段1个表情根据情节自动适配体现竞技感与技术感
> - **第1段**(课程知识点):⚙️ 或 🤖
> - **第2段**(课堂细节):📈 或 🚀
> - **第3段**(课后建议):🏠 或 🔧
>
> **首次上课/补课说明**:详见 [33-first-class-rules.md](33-first-class-rules.md)
### 1. 课程知识点40-50字
**写什么**:本节课训练的竞技技术或战术策略
**写法**
- 技术细节:"练习了电机PID调速让机器人直线行走不跑偏"
- 战术说明:"尝试了'快速取分'和'稳定求全'两种策略的对比"
- 避免笼统:不说"学习了机器人知识"
**示例**
- "今天训练了颜色传感器的巡线校准,包括白值/黑值重新标定和阈值调整,解决之前误判黑线的问题。"
- "尝试了新的任务策略前30秒专注拿取近处资源块后90秒处理远处的高分任务。"
### 2. 掌握程度40-50字
**写什么**:技术要点的实际掌握情况和应用效果
**写法**
- 数据说话:"校准后巡线成功率从60%提升到85%"
- 问题分析:"PID参数调得有点激进直线快但转弯时超调"
- 避免评价:不说"掌握得很好"
**示例**
- "传感器校准流程已经熟练能独立完成。但PID的D参数调得偏大机器人有点抖动需要再微调。"
- "新策略理解了但执行时时间分配还是不够果断前30秒用了45秒压缩了后面的操作时间。"
### 3. 课程环节与目标达成45-55字
**写什么**:学生在本节课各环节的表现,与课程设计目标的对应关系
**写法**
- 环节参与:导入环节、技术讲解、实操训练、复盘总结的参与状态
- 目标对应:本节课训练目标(技术/战术/协作)的达成情况
- 课程设计呼应:对训练活动设计的响应和投入程度
**示例**
- "导入环节对竞技策略话题很感兴趣,实操训练专注完成巡线调试,复盘环节能分析出问题原因,本节课的训练目标顺利达成。"
- "在传感器校准环节投入度高,对抗练习积极参与,最后总结时能说出改进方向,整体完成了本节课的技术目标。"
### 4. 成长亮点40-50字
**写什么**:相比之前的明显进步,无论是技术还是心态
**写法**
- 技术进步:"从手动输入参数改成用变量,方便快速调试"
- 思维成熟:"开始考虑'如果对手抢了这个资源块,我该怎么办'"
- 习惯养成:"每次试车前都检查螺丝松紧,之前经常忘"
**示例**
- "和两周前相比,今天遇到翻车没有直接重试,而是先分析可能原因(重心/速度/地面),有针对性调整。"
- "开始记录训练日志了,把每次的参数和结果写下来,这是从经验型向数据型转变的标志。"
### 5. 课后建议35-45字
**写什么**:可以在家准备的事项或需要加强的环节
**写法**
- 具体任务:"把今天的巡线程序保存三个版本(保守/激进/平衡),下周对比测试"
- 资源分析:"建议看看去年省赛的视频注意前30秒的任务选择逻辑"
- 物理准备:"机械臂的齿轮有点松,建议周末检查一下螺丝"
**示例**
- "周末可以在家用模拟器跑一下今天的新策略,测试不同时间分配的效果,下周带数据来讨论。"
- "建议看看这周的比赛视频,重点观察对方机器人的结构特点,思考我们的对抗策略。"
## 完整示例
**输入**
- 学生王浩10岁小学四年级
- 课程:机器人竞赛训练-自动赛策略优化
- 表现:尝试了新的任务顺序策略,巡线校准有进步,对抗练习输了但会复盘
**输出**
王浩本节课训练了颜色传感器的巡线校准(重新标定白/黑值)和新的任务策略(先近后远、分段计时),主要解决之前巡线误判和策略执行拖沓的问题 ⚙️
校准后巡线成功率从上次60%提升到85%,新策略执行不够果断,计划的"前30秒拿近处"实际用了45秒。导入环节对竞技策略话题很感兴趣实操训练专注完成巡线调试复盘环节能分析出问题原因本节课的训练目标顺利达成。和两周前相比遇到程序异常时不再直接重试而是先分析可能原因传感器/参数/结构),有针对性调整,调试效率明显提高 📈
周末可以用模拟器测试几种不同的时间分配方案20+100、30+90、40+80记录哪种得分更高下周带数据来讨论策略优化 🏠
---
**字数226字 | 段落3段 | Emoji3个**

View File

@@ -0,0 +1,213 @@
# 学龄前课评模板 - 教师手动撰写版(详细流程版)
> **适用场景**:教师需要**手动撰写**详细课评时参考使用
>
> **与AI自动生成模板的区别**
> | 维度 | AI自动生成20-style-building.md | 本手动撰写模板 |
> |------|-----------------------------------|---------------|
> | **使用方式** | AI自动生成 | 教师手动填写 |
> | **字数** | 180-220字简洁 | 300-400字详细 |
> | **结构** | 3段式结构 | 按课堂流程分段 |
> | **使用时机** | 常规课后快速生成 | 特殊情况详细记录 |
>
> **建议使用场景**
> - ✅ 学生有特殊表现需要详细记录
> - ✅ 家长要求更详细的课堂反馈
> - ✅ 学期关键节点(期中/期末)总结
> - ✅ 学生情绪/行为需要特别关注时
>
> **不适用于**常规批量课评生成请使用20-style-building.md
---
## 模板正文(覆盖:课堂状态、学习表现、兴趣度)
```
家长好本节课程主题是《____🎯》
🌟**课程目标:**
1. ____知识认知
2. ____技能操作
3. ____情感拓展激发兴趣
🌟**课堂状态与学习表现:**
本节课程从____导入方式开启____孩子姓名____进入状态描述学习兴趣特别浓厚🌟
____孩子姓名在动手探索过程中____具体亮点展现出很好的____能力💪 虽然____可提升点但____积极表现配合度和执行力都特别棒🤓
😊**兴趣度与情绪状态:**
这节课【孩子】整体【情绪状态】,【具体表现】🌟
和小伙伴一起【互动情况】,【社交表现】✨
🌱**成长亮点:**
和【对比时间】相比,【孩子】【进步表现】!特别值得表扬的是【具体亮点】💪
🏠**课后建议:**
家长在家可以陪____孩子姓名____延伸活动既能巩固本节课的____内容也能延续学习兴趣哦
```
---
## 精简版对应AI自动生成5模块
| 手动模板模块 | 对应AI模块 | 核心覆盖 |
|-------------|-----------|---------|
| 课程目标 | 课程知识点 | 兴趣度 |
| 课堂状态与学习表现 | 课堂表现+掌握程度 | 课堂状态+学习表现 |
| 兴趣度与情绪状态 | 课堂表现补充 | 课堂状态+兴趣度 |
| 成长亮点 | 成长亮点 | 成长发展 |
| 课后建议 | 课后建议 | 延伸学习+兴趣维持 |
---
## 使用示例1《桥梁》
```
家长好,本节课程主题是《桥梁🌉》
🌟**课程目标:**
1. 认识桥梁的基本结构(桥墩、桥面、护栏),了解桥梁的承重原理
2. 学习运用互锁结构搭建稳固的桥墩,发展空间建构能力
3. 感受工程建筑的魅力,培养耐心与专注力
🌟**宝贝表现:**
本节课程从"过河遇到困难"的故事情境开启,复习环节中果果积极回忆上节课的跷跷板结构,能快速说出"中间要有支点",对知识的延续性掌握得很好👍 进入新主题时,果果跟着老师一起认真观察不同类型的桥梁图片,还好奇地问"为什么有的桥是弯弯的",学习兴趣特别浓厚🌟
果果在对比桥梁结构的过程中,认真发现"桥墩要粗一点才稳",和小伙伴积极交流要把桥面搭平的想法,展现出很好的观察思考能力💪 虽然在搭建桥墩互锁时偶尔需要提醒专注,但果果老师引导后能立刻调整,始终保持着耐心一层一层往上搭,配合度和执行力都特别棒🤓
展示环节中,果果自信地介绍自己的桥梁可以让小车顺利通过,还主动测试了桥能放几块积木✨ 家长在家可以陪果果观察生活中的各种桥梁(立交桥、吊桥、石拱桥),一起找找它们都有什么不一样,既能巩固本节课的桥梁结构认知,也能为下次课的探索积累更多经验哦~
```
---
## 使用示例2《望远镜》
```
家长好,本节课程主题是《望远镜🔭》
🌟**课程目标:**
1. 认识望远镜的基本结构(镜筒、目镜、物镜),了解其望远功能
2. 学习管道连接与固定方法,锻炼手部精细动作
3. 激发对天文观察的好奇心,培养探索未知的兴趣
🌟**宝贝表现:**
本节课程从"看远处的风景"的生活情境开启,复习环节中阳阳准确回答老师提问,说出上节课相机是用来"拍照记录"的,对知识的延续性掌握得很好👍 进入新主题时,阳阳迫不及待地想要尝试把管道连接起来,眼睛亮亮地观察老师的示范步骤,学习兴趣特别浓厚🌟
阳阳在动手探索过程中,独立尝试多种管道连接方法,发现"要对准了才能插进去",展现出很好的动手操作能力💪 虽然遇到复杂步骤固定支架时会放慢节奏,但阳阳愿意反复尝试直到成功,始终保持着热情,配合度和执行力都特别棒🤓
展示环节中,阳阳开心地演示用望远镜"看到了月亮",还认真地欣赏同伴们不同颜色的望远镜✨ 家长在家可以陪阳阳在晴朗的夜晚观察月亮和星星,一起说说看到了什么,既能巩固本节课的观察探索兴趣,也能为下次课的探索积累更多经验哦~
```
---
## 各环节常用描述词库
### 导入环节
- 趣味故事、生活情境、问题启发、游戏互动、谜语引入、实物观察
### 复习环节表现
- 积极回忆上节课内容
- 准确回答老师提问
- 主动分享自己的作品
- 能快速进入学习状态
- 对新知识充满期待
### 探索/搭建表现亮点
- 认真对比模型细节
- 和小伙伴积极交流想法
- 独立尝试多种搭建方法
- 主动思考结构原理
- 遇到困难不退缩
- 有自己的创意想法
### 能力关键词
- 观察思考能力、动手操作能力、空间建构能力、创意想象力、合作沟通能力、问题解决能力、专注坚持能力
### 可提升点(委婉表述)
- 偶尔需要提醒专注
- 遇到复杂步骤时会放慢节奏
- 对某部分结构需要辅助理解
- 搭建时会和旁边小朋友聊天
- 遇到挫折容易放弃(后转为愿意再尝试)
- 手部精细动作还需加强
### 积极转折
- 老师引导后能立刻调整
- 愿意反复尝试直到成功
- 始终保持着耐心和热情
- 提醒后能马上专注完成自己的作品
- 遇到困难会主动寻求帮助
- 完成后特别有成就感
### 展示环节表现
- 自信地介绍作品
- 开心地演示功能
- 认真地欣赏同伴的作品
- 能说出自己作品的亮点
- 愿意分享搭建过程
- 对同伴的作品给予鼓励
### 延伸建议活动
- 阅读相关绘本
- 观察生活中的对应事物
- 玩主题小游戏
- 看看相关的科普视频
- 动手做简单实验
- 亲子讨论交流
---
## 与AI自动生成规则的对应关系
### 课程目标 = 课程知识点20-style-building 模块1
- AI模板简洁描述30-40字
- 手动模板:详细分解为知识/技能/情感三维目标
### 导入+复习+新主题 = 课堂表现20-style-building 模块3
- AI模板简洁记录40-50字
- 手动模板:详细按环节描述
### 探索过程+亮点+可提升点 = 掌握程度20-style-building 模块2
- AI模板客观描述掌握情况
- 手动模板:详细记录亮点和可提升点
### 展示环节 = 成长亮点20-style-building 模块4
- AI模板与之前对比
- 手动模板:展示表现描述
### 延伸建议 = 课后建议20-style-building 模块5
- AI模板简洁可操作30-40字
- 手动模板:详细活动建议
---
## 💡 使用建议
### 何时使用手动模板
1. **特殊关注学生**:需要详细记录行为表现
2. **关键课程节点**:如第一节课、阶段性总结
3. **家长特殊要求**:希望收到详细反馈
4. **学生情绪问题**:需要详细记录情绪变化过程
### 何时使用AI自动生成
1. **常规课后反馈**:快速生成,节省时间
2. **批量处理**:多学生同时生成
3. **标准化评价**:保持评价一致性
### 转换方法
手动撰写的详细内容可以通过以下方式精简为AI格式
- 提取关键词(行为+情绪+对比)
- 按5模块重新组织
- 控制字数在180-220字
---
*版本v1.0*
*创建日期2026-03-27*
*与20-style-building.md配合使用*

View File

@@ -0,0 +1,424 @@
# 快捷输入格式规则 v4.0(优化版)
> 核心理念:**说人话就行**AI自动理解语境、补充细节、规整格式
>
> 本次优化:新增速记符号系统、标记驱动处理、会话上下文记忆
---
## 🎯 黄金法则
1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充
**支持**:口语化、碎片化、无序化、语音转文字
---
## ⚡ 速记符号系统(新增)
### 行为速记
| 速记 | 全称 | 使用场景 | 示例 |
|------|------|----------|------|
| `gj` | 观望 | `gj5` = 观望5分钟 | gj3→zd |
| `zd` | 主动 | `zd3` = 主动搭3层 | zd2→wb |
| `zt` | 自己调整 | 球卡住时自己调整 | zd→zt |
| `wb` | 完成 | 独立完成搭建 | zx→wb |
| `mr` | 融入 | 融入小组活动 | mr→hz |
| `zx` | 专注 | 专注完成任务 | zx15专注15分钟 |
| `sb` | 失败→调整 | 失败后调整再尝试 | sb2失败2次后成功 |
| `ts` | 探索 | 主动探索新玩法 | ts5探索5分钟 |
| `cz` | 创造 | 创造性搭建/设计 | cz33种创意方案 |
| `wt` | 提问 | 主动提问 | wt3提问3次 |
| `hz` | 合作 | 与同伴合作 | hz→完成 |
| `fx` | 分享 | 分享想法/作品 | fx→kx |
| `ms` | 模仿 | 模仿老师/同学 | ms→zt模仿后自己调整 |
| `tq` | 求助 | 主动求助老师 | tq→zd求助后主动尝试 |
### 情绪速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
| `~` / `bd` | 波动 | 情绪~ 或 bd |
| `↑↑` / `kc` | 非常开心/兴奋 | 发现新玩法时↑↑ |
| `→→` / `wa` | 非常稳定/沉浸 | 全程→→ |
| `gd` | 孤独/独自玩 | 偏好gd |
| `jl` | 焦虑/紧张 | 新主题时jl |
### 社交互动速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `hz` | 合作 | hz完成合作完成 |
| `fx` | 分享 | fx想法分享想法 |
| `jy` | 建议给同伴 | jy→接受 |
| `bd` | 被带动 | bd→参与 |
| `zl` | 孤立/独自 | zl→专注 |
| `cq` | 冲突/争执 | cq→解决 |
### 编程/技术速记适合SPIKE/AI03
| 速记 | 全称 | 使用场景 | 示例 |
|------|------|----------|------|
| `bc` | 编程 | 编写程序 | bc→ts编程后调试 |
| `ts` | 调试 | 测试并调整 | ts3调试3次 |
| `cx` | 创新/优化 | 改进原有方案 | cx→效果更好 |
| `fx` | 分析 | 分析问题 | fx→解决 |
| `cw` | 错误/bug | 发现错误 | cw→fx→修正 |
| `sy` | 实验 | 尝试不同方案 | sy3实验3种方案 |
### 对比速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `++` / `!` | 比上周进步 | 比上周++ |
| `=` / `0` | 和之前一样 | 和之前= |
| `--` / `?` | 需关注 | 需-- |
| `new` | 新学生/首次 | 标记首次上课 |
| `↑+` | 情绪好转 | 从↓到→到↑+ |
| `↓-` | 状态下滑 | 本周↓- |
### 速记组合示例
**基础组合**
```
输入: 乔乔gj5→zd3→zt ↑++
展开: 乔乔观望5分钟后主动搭3层自己调整开心比上周进步
输入: 昊昊慢热→zd3→反复调 →
展开: 昊昊慢热主动搭3层反复调整情绪稳定
输入: 小强:频换玩法 wb↓--
展开: 小强频繁换玩法,未完成,情绪烦躁,需关注
```
**扩展组合(新增)**
```
输入: 丞丞ts5→cz2→wt3 ↑↑
展开: 丞丞探索5分钟创造了2种方案主动提问3次非常兴奋
输入: 一栩bc→ts3→cx ↑+
展开: 一栩编程后调试3次然后优化了方案情绪好转
输入: 小鱼gj3→tq→zd→wb →
展开: 小鱼观望3分钟求助老师后主动尝试最终完成情绪稳定
输入: 昊昊hz→jy→fx想法 ↑
展开: 昊昊与同伴合作,给同伴建议,分享自己的想法,开心
输入: 佳兴zx20→cz3→fx作品 ↑↑
展开: 佳兴专注20分钟创造了3种设计分享作品非常开心
```
### 速记与自然语言混用规则
**优先级**:速记符号 > 自然语言描述
| 场景 | 示例 | 处理方式 |
|------|------|---------|
| 无冲突 | `gj5→主动搭3层` | 正常解析 |
| 时间冲突 | `gj5→观望了一会儿` | 以 `gj5`5分钟为准「观望了一会儿」作为补充描述 |
| 行为冲突 | `zd3→搭了5层` | 以 `zd3`3层为准数值冲突时提示确认 |
| 顺序标记 | `gj5→zd3→观望了很久` | 速记按序解析,自然语言作为过程描述填充到对应节点 |
**解析流程**
```
1. 提取所有速记符号
2. 按→顺序排列行为序列
3. 自然语言作为过程描述填充到对应节点
4. 冲突时以速记数值为准
```
**示例**
```
输入乔乔gj5→观望了一会儿→zd3→搭了挺高
解析结果:
- 行为序列观望5分钟 → 主动搭3层
- 过程描述「观望了一会儿」补充gj5「搭了挺高」补充zd3
- 输出乔乔观望了5分钟一会儿然后主动搭了3层挺高的结构
```
**冲突警告**:当速记与自然语言数值差异明显时(如`zd3→搭了8层`),提示确认:
```
⚠️ 数值差异提醒
速记zd3主动搭3层
描述:"搭了8层"
是否以速记为准?[是] [以描述为准8层] [手动修改]
```
---
## 🏷️ 标记驱动处理(新增)
**使用标记快速指定学生类型,无需中断流程**
| 标记 | 含义 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
| `[补课]` | 补课学生 | 自动检测档案位置,跨班级自动双轨保存 | 班级汇总+个人档案(含跨班级自动保存)|
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总(标记体验) |
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总(标记缺课) |
| `[new]` | 新学生首次 | 创建档案 | 双轨保存 |
### 标记使用示例
```
批量输入示例:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
李小红[补课]:专注完成,稳定
```
**AI自动处理**
- 乔乔、昊昊:双轨保存
- 张小明[体验]:仅保存到班级汇总,不询问
- 李小红[补课]:检查档案 → 当前班级存在 → 双轨保存;其他班级存在 → **自动跨班级双轨保存**
---
## ✨ 自然语言输入(推荐)
### 方式1极简一句话
```
乔乔今天开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
昊昊还是老样子慢热型观察了5分钟才开始不过后来搭得挺稳的反复调整了几遍
```
### 方式2关键词速记
```
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小强:频换玩法 wb↓--
```
### 方式3会话上下文新增
**首次指定班级后,后续无需重复**
```
/课评 班级:发现世界-周四19点 # 只需一次
# 后续直接输入学生表现
乔乔搭3层开心
昊昊:慢热,稳定
```
---
## 🔊 语音输入优化
### 谐音自动纠正
AI自动匹配班级学生名单实时纠正
- "良心桥" → "梁昕乔"
- "中云浩" → "钟昀昊"
- "李一同" → "李怡瞳"
### 语音速记混合
```
语音输入:"呃...乔乔啊...观望了5分钟...主动搭3层...自己调整...开心"
AI解析
学生:乔乔(匹配小名)
行为gj5→zd3→zt
情绪:↑
```
---
## 📊 批量输入格式
### 列表式(推荐)
```
课程DISC-007
班级:发现世界-周四19点
1. 乔乔gj5→zd3→zt ↑++
2. 昊昊慢热→zd3→反复调 →
3. 张小明[体验]搭3层开心
4. 李小红[补课]:专注完成,稳定
```
### 简化表格式
```
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层 ↑ 积极参与
```
---
## 🔄 输入示例大全
### 示例1极简速记
```
输入乔乔gj5→zd3→zt ↑++
AI解析
学生:乔乔(小名)
行为观望5分钟→主动搭3层→自己调整
情绪:开心
对比:比上周进步
```
### 示例2语音风格
```
输入:呃,昊昊啊,今天上课啊,就是慢热,观察了一会儿才开始,然后搭了三层,反复调整,情绪挺稳定的
AI解析
学生:昊昊
行为观望→搭3层→反复调整
情绪:稳定
输出字数约200字精简版
```
### 示例3详细输入 → 详细输出
```
输入乔乔今天开始观望了5分钟后来主动搭了3层管道球卡住的时候自己调整高度还帮助旁边的小朋友一起搭最后完成作品特别开心说这是她最喜欢的作品。比上周主动多了上周观望了10分钟才开始。
AI解析
学生:乔乔
行为观望5分钟→主动搭3层→自己调整→帮助同伴
情绪:开心(特别开心)
对比比上周进步上周观望10分钟
亮点:主动帮助同伴、表达情感、纵向对比明显
输出字数约280字详细版
```
---
## 📏 课评字数弹性规则
### 核心理念
**输入越丰富 → 课评越详细**
课评字数不再固定为200字而是根据你输入的内容丰富度自动调整
| 输入类型 | 示例 | 输出字数 | 说明 |
|---------|------|---------|------|
| **精简输入** | "搭了3层开心" | 180-220字 | 基础描述,简洁明了 |
| **标准输入** | "观望5分钟后主动搭3层自己调整还帮助同伴" | 220-280字 | 有具体细节或亮点,充分展现 |
| **详细输入** | "观望5分钟→主动搭3层→自己调整→帮助同伴→说这是最喜欢的作品→比上周主动多了" | 280-350字 | 精彩瞬间多,全面记录 |
### 给教师的建议
1. **简单记录 → 简洁课评**
- 适合:常规课堂、表现平稳
- 输入:简要描述行为即可
2. **详细描述 → 丰富课评**
- 适合:有亮点、有突破、有情感瞬间
- 输入尽可能多描述细节AI会充分展开
3. **不用担心字数**
- 描述得多 ≠ 啰嗦
- AI会智能整合保持可读性
- 家长更喜欢看到孩子具体的成长瞬间
---
### 示例4批量混合标记
```
输入:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
```
---
## 📦 存储规则
存储流程和学生类型处理规则详见 [CLAUDE.md 存储双轨制](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)。
**简要说明**
- 正式学生:双轨保存(班级汇总 + 个人档案)
- `[补课]`学生:
- 当前班级档案存在 → 双轨保存(本班补课)
- 其他班级档案存在 → **自动跨班级双轨保存**(无需询问)
- 任何班级都不存在 → 询问处理方式
- `[体验]`学生:仅班级汇总
- `[缺课]`学生:仅记录缺席
### 跨班级补课说明
**场景**学生档案在A班如"发现世界-周四19点"来B班如"发现世界-周六09点")补课
**自动处理方式**
- **检测到跨班级补课** → **自动双轨保存**
- ✅ 课评保存到B班补课班级的周汇总
- ✅ 课评追加到A班原班级的个人历史课评记录.md标注"【跨班级补课】本节课程在B班完成"
- **无需询问,自动完成**
**手动调整**(如需改变默认行为):
- 输入 `仅班级汇总 {学生名}` → 仅保存到补课班级,不追加到原档案
- 输入 `创建新档案 {学生名}` → 在补课班级创建新档案,原档案保留
### ⚠️ 重要:课评正文禁止提及补课
**无论学生是否标记为`[补课]`,课评正文中绝对不能提及补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课(如"今天特别来参加"、"临时加入"、"从其他班级过来"等)
- ❌ 禁止在课评正文中区分"本班学生"和"补课学生"
**正确处理**
-`[补课]`标记**仅用于后台档案管理**,课评正文**完全按正常学生**撰写
- ✅ 课评开头直接写"XX本节课学习了..."**不加任何特殊说明**
- ✅ 补课信息仅保存在班级汇总元数据中,不进入课评正文
**示例**
```
教师输入:李小红[补课]搭了3层专注完成
课评输出(正确):
小红本节课学习了"旋转飞机",认识了游乐园旋转设施的中心轴结构...
课评输出(错误):
小红本节课作为补课学生,学习了"旋转飞机"... ❌(禁止提及补课)
小红今天来补课,学习了"旋转飞机"... ❌(禁止提及补课)
```
---
## 📞 常见问题
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。速记是给熟练用户的可选提速方式。
**Q忘记打标记怎么办**
AAI会检测档案自动判断。有档案=正式学生,无档案=提示选择[补课]/[体验]。
**Q标记可以组合吗**
A可以`张小明[体验][new]`表示体验课新学生。
**Q上下文记忆持续多久**
A一次会话内有效。换班级时重新指定即可。
---
*核心理念用最自然的方式记录让AI处理格式*

View File

@@ -0,0 +1,172 @@
# 班级差异与千人千面规则
> 记录同一课程在不同班级的差异化表现,实现千人千面课评
## 班级档案体系
每个班级建立独立档案,记录以下信息:
```
memory/student/class-profile/
├── 小小班A班.md # 托班班级档案
├── 小班B班.md # 小班班级档案
├── ...
```
## 班级档案模板
```markdown
# 班级档案小小班A班
## 基本信息
- 班级代码TUBE-A
- 年龄段2.5-3.5岁(年龄偏小)
- 人数8人
- 上课时间周三上午10:00
- 班主任:[教师名]
## 班级整体特点
- 整体状态:年龄偏小,需要更多引导时间
- 专注力平均10-15分钟
- 社交水平:平行游戏为主,偶有互动
- 情绪特点容易受他人影响1人哭可能带动2-3人
## 个体差异速查
| 学生 | 特点 | 关注要点 |
|-----|------|---------|
| 小明 | 谨慎型,观察后行动 | 多鼓励,不催促 |
| 小红 | 活跃,容易分心 | 多提醒回到任务 |
| 小强 | 情绪化,容易放弃 | 降低难度,及时肯定 |
## 课程调整记录
| 课程 | 标准时长 | 实际调整 | 效果 |
|-----|---------|---------|------|
| TUBE-001 | 45分钟 | 导入延长5分钟 | 好,都进入了状态 |
| TUBE-002 | 45分钟 | 减少弯管环节 | 一般,有人觉得简单 |
## 共性课评话术
- 适合本班的鼓励语:"真棒,小手真灵活"
- 避免的话术:"看看别人怎么做的"(容易引起焦虑)
- 家长沟通特点:家长普遍担心孩子太小,需要强调适龄性
```
## 千人千面实现方式
### 1. 班级维度差异
**同课程不同班级,课评侧重点不同**
| 班级类型 | 课评侧重 | 示例 |
|---------|---------|------|
| 年龄偏小班 | 参与度、情绪适应 | "今天能主动拿起管道尝试,这个开始很重要" |
| 能力较强班 | 创意、挑战度 | "不仅完成基础搭建,还自己加了弯管设计" |
| 活跃好动班 | 专注力、规则意识 | "今天专注了15分钟中途没有离开座位" |
| 内向安静班 | 社交互动、表达 | "主动邀请旁边的小朋友一起看球滚落" |
### 2. 学生维度差异
**同一班级不同学生,评价角度不同**
```
课程TUBE-001 管道滚球
小明(谨慎型):
→ 课评侧重:主动尝试的勇气
"小明今天观察了5分钟后主动拿起管道这个开始的勇气比作品本身更值得关注"
小红(活跃型):
→ 课评侧重:专注和坚持
"小红今天专注搭建15分钟没有频繁换玩法这个坚持很难得"
小强(敏感型):
→ 课评侧重:抗挫和情绪管理
"今天球卡住了小强没有急,而是调整了入口高度,这个调整值得肯定"
```
### 3. 历史对比差异
**同一学生纵向对比**
```
小明 第1节课完全不敢碰坐看
小明 第3节课主动搭了2层
小明 第5节课自己加弯管设计
→ 第5节课评重点
"和第一节课相比,小明从观望到主动设计,进步非常明显"
```
## 输入时标记班级差异
### 快速标记法
```
TUBE-001 A班 → 自动调取A班特点
TUBE-001 B班 → 自动调取B班特点
```
### 输入时备注
```yaml
学生:小明
班级小小班A班年龄偏小
表现:...
调整导入延长5分钟
```
## AI自动差异化处理
### 自动判断维度
AI根据以下信息自动调整输出
1. **班级档案** → 调取班级整体特点
2. **学生历史** → 对比上节课表现
3. **课程阶段** → 学期初/中/末的不同侧重
4. **观察关键词** → "终于"/"比上次"等词触发对比评价
5. **首次上课/补课关键词****仅在教师输入中明确写明**"第一次"/"新学生"时才在课评中提及;**补课学生不要写"第一次上课"相关表述**
### 差异化输出示例
**输入**
```
小明搭了3层管道球卡住自己调整
班级小小班A班整体谨慎
```
**A班输出**(谨慎班,鼓励尝试):
> 小明今天主动搭了3层管道遇到球卡住时能自己调整高度。对于咱们班这个年龄段的孩子能独立解决问题是很难得的表现。
**B班输出**(活跃班,鼓励专注):
> 小明今天专注完成了3层管道搭建遇到问题时能沉下心调整。在咱们班这个活跃的氛围里保持专注完成任务是很好的品质。
## 课程难度微调
### 根据班级调整内容
| 班级状态 | 调整策略 | 课评体现 |
|---------|---------|---------|
| 整体掌握快 | 增加挑战环节 | "完成了基础任务后还尝试了XX进阶玩法" |
| 整体掌握慢 | 减少环节 | "这节课专注完成了核心任务XX" |
| 情绪不高 | 增加游戏性 | "在游戏中自然学会了XX概念" |
| 过于兴奋 | 强调规则 | "在热闹的氛围里记住了XX规则" |
## 批量生成时的千人千面
**输入**8个学生同节课
```
TUBE-001 小小班A班
小明观望5分钟→主动搭3层→自己调高度
小红全程专注→搭5层→加弯管
小强:频繁换玩法→未完整搭建→兴奋→烦躁
...
```
**AI处理**
1. 识别每个学生特点(谨慎型/专注型/活跃型等)
2. 调用班级整体特点A班偏谨慎
3. 为每个学生生成不同侧重点的课评
4. 避免8个课评雷同
## 版本
- v1.0 | 2026-03-25 | 初始版本

View File

@@ -0,0 +1,340 @@
# 批量课评生成规则 v2.0(优化版)
> ⚠️ **注意**:本文档为 v2.0 旧版本归档文件,描述的是"生成-确认-保存"两阶段流程。
> 当前系统已升级为 v3.1 "生成即双轨保存"模式,详见 [20-workflow.md](../20-workflow.md) 第7节和第10节。
>
> **关键差异**
> - v2.0:先生成 → 等待教师确认 → 再双轨保存
> - v3.1:生成后立即自动双轨保存,无需确认
---
## 🚀 批量生成流程v2.0 旧流程 - 仅供参考)
```
输入表格 → AI并行解析每个学生 → 预加载课程/档案 →
并行生成多份课评 → 质量检查 → 【自动双轨保存】→ 完成
同步更新出勤统计
```
> **注**:以上为 v3.1 更新后的流程。原 v2.0 流程包含"教师确认"步骤,现已简化为"生成即保存"。
> **核心优势**8人课评从15-20分钟缩短至**3-5分钟**效率提升75%
---
## 📝 批量输入格式
### 标准列表式(推荐)
```
课程DISC-007
班级:发现世界-周四19点
日期4月16日
1. 乔乔gj5→zd3→zt ↑++
2. 昊昊慢热→zd3→反复调 →
3. 张小明[体验]搭了3层开心
4. 李小红[补课]:专注完成,稳定
5. 小强:频换玩法 wb↓--
```
### 简化表格式
```
课程DISC-007 班级:发现世界-周四19点
学生 核心表现 情绪 对比
─────────────────────────────────────────
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层参与 ↑ 积极
小红[补课] 专注完成 → 稳定
```
### 纯速记式(高效用户)
```
DISC-007 发现世界-周四19点
乔乔 gj5→zd3→zt ↑++
昊昊 慢热→zd3→反复调 →
小明[体验] zd3 ↑
```
---
## ⚡ 批量输出格式(优化)
### 统一展示界面
```
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成5份发现世界-周四19点DISC-007
━━━━━━━━━━━━━━━━━━━━━━━
✅ 乔乔 198字 正常
✅ 昊昊 205字 正常
⚠️ 小强 165字 偏短
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
**自动通过条件**(同时满足):
- ✅ 学生有完整档案
- ✅ 字数在弹性范围内
- ✅ 无敏感词/异常表述
- ✅ 情绪描述合理
**需人工确认条件**(任一满足):
- ⚠️ 体验/补课学生(无档案)
- ⚠️ 字数偏差>20字
- ⚠️ 检测到负面情绪词
- ⚠️ 与上周表现差异过大
- ⚠️ 内容重复度高
---
## 🔍 自动质量检查
### 检查维度
| 检查项 | 描述 |
|--------|------|
| 字数检查 | 是否符合弹性范围180-350字 |
| 重复检查 | 开头句式是否差异化 |
| 差异化检查 | 各课评侧重点是否不同 |
| 待关注项 | 特殊情绪/行为标记 |
### 差异化策略
**1. 开头差异化**
| 学生类型 | 开头句式示例 |
|----------|-------------|
| 谨慎型 | "今天[学生]终于主动尝试了..." |
| 活跃型 | "[学生]今天一如既往充满活力..." |
| 进步型 | "和上周相比,[学生]有了明显进步..." |
| 补课型 | "这节课[学生]融入得很好..." |
| 体验型 | "欢迎[学生]第一次来到..." |
**2. 侧重点差异化**
同一节课,不同学生类型侧重不同:
- **谨慎型** → 参与度和勇气
- **熟练型** → 创意和拓展
- **困难型** → 过程价值
**3. 建议差异化**
根据学生能力推荐不同课后活动:
- **参与少**:在家可以用纸筒做简单旋转玩具
- **能力强**:可以尝试用不同材料做对比实验
- **坚持短**可以从5分钟小目标开始练习专注
---
## 📦 存储流程(优化后)
### 存储路径
| 位置 | 路径 | 说明 |
|------|------|------|
| 班级周汇总 | `memory/class-evaluation-summary/第X周/{班级}.md` | 全班汇总,含确认状态 |
| 个人档案 | `memory/student/{班级}/{学生}/历史课评记录.md` | 个人完整轨迹 |
| 跨班级补课 | `memory/student/{原班级}/{学生}/历史课评记录.md` | 档案在原班级,来当前班级补课 |
**跨班级补课存储示例**
- 林瀚丞档案在"发现世界-周四19点",来"发现世界-周六09点"补课
- 课评保存到:`class-evaluation-summary/第X周/发现世界-周六09点.md`
- 课评追加到:`student/发现世界-周四19点/林瀚丞/历史课评记录.md`
- 个人档案标注:`【跨班级补课】本节课程在周六09点班完成`
> 完整存储规则和学生类型处理详见 [CLAUDE.md](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)
### 并发控制与文件名规范
#### 文件名规范化
```python
# 文件名非法字符处理
invalid_chars = ['/', '\\', ':', '*', '?', '"', '<', '>', '|']
replacement = '_'
def sanitize_filename(filename):
for char in invalid_chars:
filename = filename.replace(char, replacement)
return filename.strip()
```
#### 并发写入策略
| 场景 | 策略 | 说明 |
|------|------|------|
| 同时写入同一班级汇总 | 文件锁 + 合并写入 | 后写入者追加到文件,不覆盖 |
| 同时写入同一学生档案 | 队列化处理 | 串行写入,避免冲突 |
| 班级汇总 + 个人档案同时写入 | 独立事务 | 互不影响,各自重试 |
#### 写入保障
- **原子写入**:先写入临时文件(`.md.tmp`),成功后重命名
- **备份机制**:写入前自动备份上次版本(`.md.bak`
- **冲突检测**:检测到修改时间变化时自动合并
- **教师协作提示**当检测到其他教师正在编辑时显示「教师A正在编辑请稍后」
### 存储失败补偿机制
**场景**:班级汇总保存成功,但个人档案保存失败(磁盘满、权限问题、并发冲突等)
**处理策略**
| 失败类型 | 处理方式 | 教师感知 |
|----------|---------|---------|
| 磁盘/IO错误 | 加入补偿队列5分钟后自动重试 | 静默处理,下次生成时提示 |
| 并发冲突 | 自动合并(追加模式),不重试 | 无感知 |
| 权限不足 | 加入补偿队列,提醒教师检查权限 | 显示警告 |
| 路径不存在 | 自动创建路径后重试 | 无感知 |
**补偿队列检查时机**
1. 每次生成课评前(自动检查并补存)
2. 教师输入`补存``同步`指令时
3. 每日定时检查如每天18:00
**批量补存界面**
```
━━━━━━━━━━━━━━━━━━━━━━━━━
📋 待补存课评2条
1. 乔乔 - 第7周发现世界
失败原因:磁盘临时满
[立即补存] [忽略]
2. 昊昊 - 第7周发现世界
失败原因:权限被拒绝
[立即补存] [忽略]
[全部补存] [稍后提醒]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 🏷️ 特殊情况批量处理
### 标记速查
| 标记 | 处理逻辑 | 保存位置 |
|------|---------|---------|
| `[补课]` | 检查档案:①当前班级存在→双轨保存 ②其他班级存在→**自动跨班级双轨保存** ③不存在→询问是否建档 | 班级汇总+个人档案(含跨班级自动保存)|
| `[体验]` | 仅班级汇总,不询问 | 仅班级汇总(标记体验) |
| `[缺课]` | 记录缺席,不生成课评 | 班级汇总(标记缺课) |
| `[new]` | 创建新档案,双轨保存 | 班级汇总+个人档案 |
**[补课]处理详细逻辑**(自动版):
1. 检查 `memory/student/{当前班级}/{学生名}/` 是否存在
2. 如存在 → 该学生为本班补课 → 双轨保存(班级汇总+个人档案)
3. 如不存在 → 搜索 `memory/student/` 下其他班级是否存在该学生档案
- 如存在(跨班级补课)→ **自动双轨保存(跨班级模式)**
- ✅ 自动保存到补课班级周汇总
- ✅ 自动追加到原班级个人档案(标注补课班级信息)
- **无需询问,自动完成**
- 如不存在 → 询问处理方式
- [1] 仅保存到班级汇总
- [2] 创建新档案
### 批量处理示例
```
输入:
DISC-007 发现世界-周四19点
1. 乔乔gj5→zd3→zt ↑++
2. 昊昊慢热→zd3→反复调 →
3. 张小明[体验]搭了3层开心
4. 李小红[补课]:专注完成,稳定
5. 王大力[缺课]
AI处理
✓ 乔乔、昊昊:正常生成,双轨保存(正式学生,档案在当前班级)
⚠ 张小明[体验]:生成标记为"体验学生",仅班级汇总
⚠ 李小红[补课]:检查档案 → 在当前班级存在 → 双轨保存(本班补课)
✓ 林瀚丞[补课]:检查档案 → 在周四19点班存在 → **自动跨班级双轨保存**
→ 保存到周六09点班级汇总 + 追加到周四19点个人档案
✓ 王大力[缺课]:记录"王大力:缺课",不生成课评
```
---
## 💡 效率优化技巧
### 1. 上下文复用
```
/课评 班级:发现世界-周四19点 # 首次指定
# 后续直接输入学生,无需重复班级
乔乔搭3层
昊昊:慢热
```
### 2. 语音批量录入
语音输入多学生表现AI自动分段生成课评。
---
## 📊 批量生成检查清单
### 生成前检查
- [ ] 班级信息正确(或已在上下文中)
- [ ] 学生姓名无遗漏
- [ ] 标记使用正确([补课]/[体验]/[缺课]
### 生成后检查
- [ ] 全部学生课评已生成
- [ ] 字数符合弹性范围
- [ ] 开头句式差异化
- [ ] 建议内容个性化
- [ ] 特殊学生已标记
### 发送前检查
- [ ] 内容准确无误
- [ ] 称呼正确(小名/去姓)
- [ ] 补课/体验学生处理完毕
---
## 🎯 使用建议
### 推荐工作流程
```
Step 1: 指定班级(一次)
/课评 班级:发现世界-周四19点
Step 2: 批量输入(使用速记)
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小明[体验]zd3 ↑
Step 3: AI批量生成自动质量检查
Step 4: 查看质量报告,一键确认
Step 5: 自动保存并发送
```
### 不同场景推荐
| 场景 | 推荐方式 | 预计时间 |
|------|---------|----------|
| 常规课后8人 | 速记批量输入 | 3-5分钟 |
| 重点关注学生 | 自然语言详细描述 | 2-3分钟/人 |
| 边走边记 | 语音转文字 | 实时 |
| 周汇总整理 | 查看班级周汇总文件 | 1分钟 |
---
*核心理念:批量不批量,千人千面不打折*

View File

@@ -0,0 +1,388 @@
# 新学生与补课学生处理规则 v1.3
> 统一规范首次上课新学生与补课学生的课评处理
>
> **v1.3 更新**:优化跨班级补课处理 - 检测到跨班级补课学生时**自动**完成双轨保存(班级汇总+跨班级个人档案),无需询问
>
> **v1.2 更新**:新增跨班级补课处理 - 支持将课评跨班级保存到原个人档案,便于追踪完整成长轨迹
---
## 核心规则
### 规则1首次上课新学生
**定义**
- 从未在本机构上过任何课程的学生
- 刚报名入学的学生
**课评提及条件**
- **仅在教师输入中明确写明"第一次上课"、"新学生"等关键词时,才能在课评中提及**
- 如果教师未明确说明,课评中**不自动添加**"这是孩子第一次上课"等表述
**正确示例**
```
教师输入小明第一次上课开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课,开始有点害羞...
```
**错误示例**
```
教师输入小明开始不敢碰后来搭了3层
课评输出:这节课是小明第一次上课... ❌(教师未说明)
```
---
### 规则2补课学生分两种情况处理
**补课学生定义**
因各种原因(请假、调课等)需要在非原班级时间补课的学生。
**⚠️ 重要:补课学生分两类,处理方式不同**
#### 情况A自己班级的学生补课
- **判断标准**:学生在 `memory/student/{当前班级}/` 目录中存在
- **处理方式****正常双轨保存**(班级汇总 + 个人档案)
- **说明**:这是你自己的学生,只是补课,无需额外确认
**示例**
```
教师输入:乔乔[补课]搭了3层开心
AI检测乔乔在本班级档案中存在 → 按正式学生处理
处理结果:双轨保存
```
#### 情况B跨班级补课档案在其他班级
- **判断标准**:学生在 `memory/student/{其他班级}/` 目录中存在(跨班级补课)
- **处理方式****自动双轨保存(跨班级模式)**
- 课评保存到**补课班级**周汇总(当前班级)
- 课评**自动追加**到**原班级**个人历史课评记录.md标注补课班级信息
- **无需询问,自动完成**
- **跨班级保存说明**如果学生档案在A班来B班补课
- 课评保存到B班班级周汇总
- 课评追加到A班个人历史课评记录.md标注"【跨班级补课】在B班完成"
**跨班级补课自动处理示例**
```
教师输入:班级:发现世界-周六09点林瀚丞[补课]搭了3层开心
AI检测 未找到「林瀚丞」在「发现世界-周六09点」的个人档案
✅ 找到「林瀚丞」在「发现世界-周四19点」的个人档案
判断跨班级补课学生原班级周四19点补课班级周六09点
自动处理结果:
→ 课评保存到「第7周/发现世界-周六09点.md」班级汇总
→ 课评追加到「student/发现世界-周四19点/林瀚丞/历史课评记录.md」个人档案
标注【跨班级补课】本节课程在周六09点班第7周完成
✅ 自动完成,无需教师确认
```
#### 统一规则
- **不要写"第一次上课"相关表述**,即使这是该学生第一次上这节课
- 补课学生**不是新学生**,只是课程调整
- 正常生成课评,按已有档案处理(或询问后的选择处理)
#### ⚠️ 重要规则:课评正文禁止提及补课
**绝对禁止**
-**课评正文中绝对不能提及学生来补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课(如"今天特别来参加"、"临时加入"等)
**正确处理**
- ✅ 课评正文**完全按正常学生**撰写,仿佛学生就是本班正常上课的学生
-`[补课]`标记**仅作为后台参考**,用于档案存储路径判断
- ✅ 补课信息仅保存在班级汇总的元数据中,不进入课评正文
**正确示例**
```
教师输入:林瀚丞[补课]:积极分析课程任务,专注完成了绿色身体、黑色头部的蜥蜴设计
课评输出(正确):
瀚丞本节课学习了"蜥蜴"的仿生搭建...(正常撰写,完全不提补课)
课评输出(错误):
瀚丞本节课作为补课学生,学习了"蜥蜴"... ❌(禁止提及补课)
瀚丞今天来补课,学习了"蜥蜴"... ❌(禁止提及补课)
```
**说明**
- 家长看到课评时不应知道孩子是补课还是正常上课
- 补课标记仅用于教师内部管理和档案存储
- 保持课评的一致性和专业性
---
### 规则3禁止自动推断
**严格禁止**
-**禁止AI自动推断学生是补课还是第一次上课**
- ❌ 禁止根据表现猜测(如"表现生疏"→"可能是第一次"
- ❌ 禁止根据历史记录自动判断
**必须**
- ✅ 完全依赖教师输入中的明确标记
- ✅ 无标记时按常规学生处理
---
## 教师输入标记方式
### 单个学生输入
```
小明[第一次上课]开始不敢碰后来主动搭3层
小红[补课]搭了3层开心
```
### 批量输入
```
课程DISC-003
班级:发现世界-周四19点
梁昕乔:快速启动,开心
钟昀昊:慢热,稳定
张小明[第一次上课]:开始不敢碰,后来主动
李小红[补课]搭了3层认真
```
---
## 无档案学生处理(补课/体验)
当检测到学生无个人档案时:
### 检测流程(自动处理版)
1. AI自动检测 `memory/student/{当前班级}/{学生名}/` 是否存在
2. **如存在**:该学生为本班级补课学生 → **正常双轨保存**(班级汇总 + 个人档案)
3. **如不存在**:自动搜索 `memory/student/` 下**所有班级目录**
- **如在其他班级存在**:该学生为**跨班级补课学生** → **自动双轨保存(跨班级模式)**
- ✅ 保存到**补课班级**周汇总(当前班级)
- ✅ 追加到**原班级**个人历史课评记录.md标注补课班级信息
- **无需询问,自动完成**
- **如任何班级都不存在**:可能是其他老师班级学生 → **询问处理方式**
### 处理方式(更新版)
| 场景 | 判断条件 | 处理方式 | 存储位置 |
|------|---------|---------|---------|
| **自己班级补课学生** | 档案在当前班级目录存在 | 双轨保存 | 班级汇总 + 个人档案 |
| **跨班级补课学生** | 档案在其他班级目录存在 | **自动双轨保存(跨班级模式)** | 班级汇总(补课班级)+ 个人档案(原班级,标注补课信息)|
| **其他老师班级补课学生** | 档案不在任何班级目录 | 询问后决定 | 班级汇总(可选创建档案)|
| **体验课学生** | 无标记或标记[体验] | 仅班级汇总 | 班级汇总(标记体验)|
### 询问流程(其他老师班级补课学生)
```
⚠️ 未找到「张小明」在「发现世界-周四19点」班级的个人档案
该学生标记为[补课],但不在本班级学生名单中。
可能情况:
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案(双轨保存)
[3] 档案在其他班级目录 → 询问是否迁移或仅班级汇总
请选择处理方式:
```
### 自动保存通知(跨班级补课)
当检测到跨班级补课学生时,**自动执行**以下操作,无需询问:
```
⚠️ 检测到「林瀚丞」为跨班级补课学生
档案位置:发现世界-周四19点原班级
补课班级:发现世界-周六09点当前班级
📋 课评归属规则以补课班级周六09点的周数为准
- 原班级周四19点当前进度第8周
- 补课班级周六09点当前进度第7周
- 本节课评将按第7周记录
✅ 自动处理结果:
→ 课评保存到「第7周/发现世界-周六09点.md」补课班级班级汇总
→ 课评追加到「student/发现世界-周四19点/林瀚丞/历史课评记录.md」原班级个人档案
标注【跨班级补课】本节课程在周六09点班第7周完成
💡 提示:如需调整保存方式,可输入「调整{学生}保存方式」
```
---
## 🔄 简化转正流程(新增 v1.1
### 原流程问题
- 体验学生转正需要回复"转为正式"
- 历史课评需要从班级汇总迁移到个人档案
- 操作步骤多,容易遗忘
### 优化后流程
#### 方案1智能检测转正推荐
当体验/补课学生连续上课达到**3次**时AI主动提示
```
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 转正建议
张小明已连续上3节课第5周、第6周、第7周
- 第5周体验课积极参与
- 第6周体验课专注完成
- 第7周体验课表现稳定
建议为其创建正式档案,便于:
✓ 追踪完整成长轨迹
✓ 生成学期总结报告
✓ 家长沟通更有依据
[创建正式档案] [继续体验] [下周再提醒]
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案2一键转正快捷
输入简化指令:
```
教师:小明转正
教师:小明[正式]
AI处理
1. 创建个人档案memory/student/{班级}/小明/
2. 自动迁移历史课评(从班级汇总提取)
3. 标记后续课评为"正式学生"
4. 双轨保存生效
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正完成:张小明
已创建:
- 用户画像.md模板待完善
- 历史课评记录.md已迁移3次课评
- 成长素材.md待补充
历史课评已迁移:
- 第5周 DISC-005 天平秤
- 第6周 DISC-006 长颈鹿
- 第7周 DISC-007 旋转飞机
下次输入"小明"将按正式学生处理
━━━━━━━━━━━━━━━━━━━━━━━━━
```
#### 方案3输入时标记升级灵活
支持在输入时直接标记状态变化:
```
输入:小明[体验→正式]:今天表现很好
AI处理
1. 自动创建档案
2. 迁移历史课评
3. 生成本次课评
4. 双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 转正并生成课评:张小明
状态变化:体验 → 正式
已创建个人档案并迁移历史记录
本次课评已双轨保存
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 转正数据迁移
#### 自动迁移内容
| 内容 | 来源 | 目标 | 操作 |
|------|------|------|------|
| 历史课评 | 班级周汇总 | 个人历史课评.md | 自动提取并追加 |
| 用户画像 | 无 | 新建用户画像.md | 创建模板 |
| 成长素材 | 无 | 新建成长素材.md | 创建空文件 |
#### 迁移示例
```markdown
# 迁移前(班级汇总)
### 张小明(体验学生)⚠️
【第5周课评内容】
【第6周课评内容】
【第7周课评内容】
---
# 迁移后(个人档案)
## 历史课评记录.md
### 2026-04-04 | 课程代码DISC-005
**课评内容**【第5周内容】
**备注**:体验期间,原记录在班级汇总
### 2026-04-11 | 课程代码DISC-006
**课评内容**【第6周内容】
**备注**:体验期间,原记录在班级汇总
### 2026-04-17 | 课程代码DISC-007
**课评内容**【第7周内容】
**备注**:体验期间,原记录在班级汇总
### 转正记录
- 转正日期2026-04-17
- 转正周数第7周
- 已上课时3节
- 来源:体验课转正
```
### 转正后班级汇总更新
```markdown
# 原标记(体验期间)
### 张小明(体验学生)⚠️
# 更新后(转正后)
### 张小明(已转正 ✅)
- 转正日期2026-04-17
- 个人档案:已创建
- 历史课评:已迁移至个人档案
```
### 转正统计
在班级学期总览中添加转正统计:
```
## 学生流动情况
| 类型 | 人数 | 说明 |
|------|:----:|:-----|
| 正式学生 | 30人 | 学期初已建档 |
| 体验转正 | 3人 | 本学期从体验转正式 |
| 补课转入 | 2人 | 从其他班级转入 |
| 当前体验 | 2人 | 正在体验中 |
### 本学期转正记录
| 学生 | 原状态 | 转正周 | 已上课时 | 转正原因 |
|------|:------:|:------:|:--------:|:---------|
| 张小明 | 体验 | 第7周 | 3节 | 连续参与,表现稳定 |
| 李小红 | 补课 | 第5周 | 2节 | 转入正式班级 |
```
---
## 相关文件
- 输入格式规则:[30-input-format.md](30-input-format.md)
- 批量生成规则:[32-batch-generation.md](32-batch-generation.md)
- 快速入门:[40-keping-快速入门.md](40-keping-快速入门.md)

View File

@@ -0,0 +1,166 @@
# 学生画像建立指南
> 用于指导教师建立完整的学生画像档案
>
> **配套文件**`memory/student/用户画像模板.md`
---
## 📋 画像建立流程
```
Step 1: 收集基础信息(姓名、年龄、班级)
Step 2: 观察性格气质3节课以上
Step 3: 评估学习特点(优势+待发展)
Step 4: 记录家长沟通偏好
Step 5: 填写用户画像模板
Step 6: 持续更新成长轨迹
```
---
## 📝 信息采集问卷10题版
### 基础信息2题
**问题 1**
> **学生姓名(全名)是什么?**
> 用于档案管理,如:梁昕乔、钟昀昊
**问题 2**
> **孩子的小名或昵称是什么?**
> 如:乔乔、昊昊、瞳瞳、小雨等
> 如果没有,回复"无",我们将用"昕乔"、"昀昊"等方式称呼
---
### 性格气质3题
**问题 3**
> **整体气质类型?**
> 1. 活泼型(外向、精力充沛)
> 2. 谨慎型(内向、观察后行动)
> 3. 平和型(情绪稳定)
> 4. 敏感型(细腻、情绪反应强)
**问题 4**
> **与同伴互动模式?**
> 1. 主动交友
> 2. 被动跟随
> 3. 平行玩耍
> 4. 独自游戏
**问题 5**
> **遇到困难时的反应?**
> 1. 自己尝试解决
> 2. 立即求助
> 3. 容易放弃
> 4. 有情绪反应
---
### 学习特点3题
**问题 6**
> **学习方式偏好?**
> 1. 视觉型(爱看示范)
> 2. 听觉型(爱听讲解)
> 3. 动觉型(爱动手试)
> 4. 混合型
**问题 7**
> **平均专注时长?**
> 1. 10分钟以内
> 2. 10-20分钟
> 3. 20-30分钟
> 4. 30分钟以上
**问题 8**
> **核心优势能力(可多选)?**
> 1. 空间想象
> 2. 逻辑思维
> 3. 创造力
> 4. 精细动作
> 5. 语言表达
---
### 家长沟通2题
**问题 9**
> **主要接送人?**
> 1. 爸爸
> 2. 妈妈
> 3. 父母共同
> 4. 祖辈
**问题 10**
> **家长期望沟通频率?**
> 1. 每课后
> 2. 每周
> 3. 有问题时
> 4. 每月总结
---
## 📊 画像建档标准
### 建档时机
- ✅ 新学生入学第1节课后
- ✅ 补课学生第2节课后
- ✅ 每学期初统一核查更新
### 档案完整性检查
- [ ] 基础信息完整(姓名、年龄、班级)
- [ ] 性格气质已评估
- [ ] 学习特点已记录
- [ ] 家长沟通偏好已确认
- [ ] 至少3次课的成长轨迹
### 更新频率
| 信息类型 | 更新时机 |
|---------|---------|
| 基础信息 | 入学时/变动时 |
| 性格气质 | 每学期初 |
| 学习特点 | 每月评估 |
| 成长轨迹 | 每次课后 |
| 家长沟通 | 需要时 |
---
## 🎯 课评称呼确定
收集完成后,根据以下规则确定课评称呼:
| 优先级 | 条件 | 称呼方式 | 示例 |
|:------:|------|---------|------|
| 1 | 有小名/昵称 | 使用小名 | 乔乔、昊昊 |
| 2 | 双字名,无小名 | 去姓称名 | 昕乔、昀昊 |
| 3 | 单字名 | 叠字称呼 | 昊昊、婷婷 |
| 4 | 特殊要求 | 使用全名 | 梁昕乔 |
---
## 📁 档案存储位置
```
memory/student/{班级}/{学生名}/
├── 用户画像.md # 核心档案
├── 历史课评记录.md # 课评记录
└── 成长素材.md # 照片/作品记录
```
---
## 🔗 相关文件
- **用户画像模板**`memory/student/用户画像模板.md`
- **历史课评模板**`memory/student/历史课评记录模板.md`
- **姓名处理规则**`.claude/rules/60-name-processing.md`
- **年龄段规则**`.claude/rules/01-student-ages.md`
---
*版本v1.0*
*更新日期2026-04-06*
*说明:本文件为画像建立指南,配套问卷模板参见 `memory/student/用户画像模板.md`*

View File

@@ -0,0 +1,158 @@
# 速记符号阶梯学习指南
> 降低学习成本,从"记住所有"到"先用起来"
---
## 🎯 学习理念
不需要一次性记住所有速记符号。**用4个核心符号先上手再逐步扩展。**
---
## 📚 第1级核心速记必学5分钟上手
这4个符号覆盖80%的日常场景,**优先掌握**。
| 速记 | 含义 | 示例 | 使用频率 |
|------|------|------|:--------:|
| `gj#` | 观望#分钟 | `gj5` = 观望5分钟 | ⭐⭐⭐⭐⭐ |
| `zd#` | 主动搭#层 | `zd3` = 主动搭3层 | ⭐⭐⭐⭐⭐ |
| `↑` | 开心/积极 | 情绪↑ | ⭐⭐⭐⭐⭐ |
| `++` | 比上周进步 | 比上周++ | ⭐⭐⭐⭐⭐ |
### 第1级实战示例
```
输入前(自然语言):
乔乔观望了5分钟后主动搭了3层挺开心的比上周有进步
输入后(速记):
乔乔gj5→zd3 ↑++
节省从24字到13字节省46%输入时间
```
---
## 📚 第2级常用速记进阶1天后学习
掌握第1级后学习这4个扩展符号覆盖90%场景。
| 速记 | 含义 | 示例 | 使用频率 |
|------|------|------|:--------:|
| `zt` | 自己调整 | 球卡住时zt | ⭐⭐⭐⭐ |
| `→` | 情绪稳定 | 情绪→ | ⭐⭐⭐⭐ |
| `wb` | 未完成 | 任务wb | ⭐⭐⭐⭐ |
| `--` | 需关注 | 需-- | ⭐⭐⭐ |
### 第2级实战示例
```
完整速记:
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小强:频换玩法 wb↓--
```
---
## 📚 第3级辅助速记高级按需学习
特殊场景使用,了解即可。
| 速记 | 含义 | 使用场景 |
|------|------|----------|
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `sb` | 失败→调整 | 失败后调整再尝试 |
| `~` | 情绪波动 | 情绪有起伏 |
| `=` | 和之前一样 | 表现持平 |
---
## 💡 智能推荐机制AI辅助学习
### 场景1首次使用速记
当教师使用自然语言输入3次后AI主动提示
```
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 速记小贴士
您刚才的输入可以用速记更快完成:
您的输入:
"乔乔观望了5分钟后主动搭了3层挺开心的"
速记写法:
"乔乔gj5→zd3 ↑"
节省50%时间!试试看在下次输入中使用。
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 场景2速记使用统计
每周生成个人速记使用报告:
```
━━━━━━━━━━━━━━━━━━━━━━━━━
📊 您的速记使用周报
本周输入课评24份
使用速记18份75%
节省时间约8分钟
常用速记TOP3
1. gj#(观望)- 使用15次
2. zd#(主动)- 使用12次
3. ↑(开心)- 使用10次
💡 建议学习zt自己调整
本周有6次可以用到但您使用了自然语言
━━━━━━━━━━━━━━━━━━━━━━━━━
```
### 场景3快捷提示面板
输入`/?``帮助`时显示速记速查:
```
━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ 速记速查面板
【第1级-必会】
gj# 观望#分钟 zd# 主动搭#层
↑ 开心/积极 ++ 比上周进步
【第2级-常用】
zt 自己调整 → 情绪稳定
wb 未完成 -- 需关注
输入"速记2"查看第2级"速记3"查看第3级
━━━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 🎓 学习路径建议
| 阶段 | 时间 | 目标 | 验收标准 |
|------|------|------|---------|
| 入门 | 第1天 | 掌握第1级4个符号 | 能用速记输入简单课评 |
| 熟练 | 第1周 | 掌握第2级8个符号 | 80%输入使用速记 |
| 精通 | 第2周 | 了解第3级符号 | 根据场景灵活使用 |
---
## 🔄 速记与自然语言对比
| 场景 | 自然语言 | 速记 | 节省 |
|------|---------|------|------|
| 简单描述 | 乔乔观望5分钟主动搭3层很开心 | 乔乔gj5→zd3 ↑ | 60% |
| 完整描述 | 乔乔观望5分钟主动搭3层自己调整很开心比上周进步 | 乔乔gj5→zd3→zt ↑++ | 58% |
| 复杂情况 | 小强频繁换玩法未完成情绪烦躁需关注 | 小强:频换玩法 wb↓-- | 50% |
---

View File

@@ -0,0 +1,85 @@
# 课评状态管理面板v2.0 旧版本)
> ⚠️ **注意**:本文档为 v2.0 旧版本归档文件,描述的是"待确认"状态管理机制。
> 当前系统已升级为 v3.1 "生成即双轨保存"模式,已删除"待确认"状态,详见 [20-workflow.md](../20-workflow.md) 第10节。
>
> **关键差异**
> - v2.0:有"待确认"状态,需要教师确认后才双轨保存
> - v3.1:删除"待确认"状态,生成后立即双轨保存
---
## 📊 状态类型v2.0 旧版本)
---
## 📊 状态类型
| 状态 | 图标 | 说明 |
|:----:|:----:|:-----|
| 已确认 | ☑️ | 已审核通过,已双轨保存 |
| 待确认 | ⏳ | 已生成,等待教师确认 |
| 待生成 | ⏸️ | 教师未输入表现 |
| 缺勤 | 🚫 | 学生未到校 |
---
## 🔄 状态流转规则
```
教师输入表现 → 待确认 → 教师确认 → 已确认 → 自动双轨保存
↓ ↑
标记缺勤 修改后重新生成
```
---
## 📋 班级汇总文件格式
`memory/class-evaluation-summary/第X周/{班级}.md`文件顶部添加状态面板:
```markdown
---
class: 发现世界-周四19点
week: 7
course: DISC-007
generated_at: 2026-04-17T16:00:00
status:
total: 2
confirmed: 1
pending: 1
missing: 0
students:
- name: 乔乔
status: confirmed
- name: 昊昊
status: pending
---
## 本周课评状态
| 学生 | 状态 | 操作 |
|:-----|:----:|:----:|
| 乔乔 | ☑️ 已确认 | [查看] [修改] |
| 昊昊 | ⏳ 待确认 | [确认] [修改] |
```
---
## 🔔 操作指令
| 教师输入 | 功能 |
|:---------|:-----|
| `确认全部` | 一键确认所有待确认课评 |
| `查看待确认` | 只显示待确认学生 |
| `确认{学生}` | 确认单个学生课评 |
| `修改{学生}XXX` | 修改指定学生课评内容 |
---
## 📊 数据持久化
状态信息保存在班级汇总文件的YAML Frontmatter中便于
- 快速统计课评完成情况
- 追踪学生课评状态变化
- 支持批量操作

View File

@@ -0,0 +1,123 @@
# 快速编辑功能规则
> 解决小错误修改需重新生成的问题提升修改效率70%
---
## 📝 快速编辑指令
### 指令格式
```
修改{学生}{修改内容}
```
### 支持的修改类型
| 类型 | 指令示例 | 说明 |
|------|---------|------|
| 替换词语 | `修改乔乔:把"搭建"改为"拼搭"` | 替换指定词语 |
| 修改称呼 | `修改乔乔:称呼改为"乔乔宝贝"` | 替换所有称呼 |
| 补充内容 | `修改乔乔:在"完成了"后添加"还帮助了同伴"` | 在指定位置插入 |
| 删除内容 | `修改乔乔:删除"这个调整值得注意"` | 删除指定句子 |
| 批量替换 | `修改乔乔:把所有"开心"改为"兴奋"` | 全文替换 |
---
## 🎯 批量修改
可同时修改多个学生:
```
修改乔乔:把"搭建"改为"拼搭"
修改昊昊:称呼改为"昊昊小朋友"
修改小明:补充"还主动分享了作品"
```
---
## 🔍 智能定位
### 当前周数(默认)
- 未指定周数时,自动修改**本周**课评
- 示例:`修改乔乔:把"开心"改为"兴奋"`
### 历史课评修改
- 需明确指定周数
- 示例:`修改乔乔第5周把"搭建"改为"拼搭"`
- ⚠️ 注意:历史课评已发送给家长,修改需谨慎
---
## ⚠️ 修改限制
### 不可快速编辑的场景
以下情况**必须重新生成**
| 场景 | 原因 |
|------|------|
| 改变课评结构 | 涉及多段落调整 |
| 改变评价基调 | 从负面改为正面 |
| 补充大量内容 | 超过50字 |
| 改变主题理解 | 知识点错误 |
### 修改字数限制
- **单次修改**不超过50字
- **单篇累计**不超过100字
- **超出限制**:提示"建议重新生成"
---
## 🔄 决策流程
```
教师要求修改
判断修改类型
┌─────────────┴─────────────┐
↓ ↓
小修改(<50字 大修改(>50字
或简单替换 或结构调整
↓ ↓
快速编辑 重新生成
(秒级响应) (需等待生成)
```
---
## ✅ 实施检查清单
- [ ] 支持基本替换指令(修改{学生}:把"A"改为"B"
- [ ] 支持称呼修改指令
- [ ] 支持内容补充/删除指令
- [ ] 支持批量修改多个学生
- [ ] 自动定位当前周数
- [ ] 支持历史课评修改(需指定周数)
- [ ] 修改字数限制(单次<50字
- [ ] 修改后同步到双轨存储
---
## 📝 快速参考卡
```
⚡ 快速编辑指令速查
修改称呼:
修改{学生}:称呼改为"{新称呼}"
替换词语:
修改{学生}:把"{旧词}"改为"{新词}"
补充内容:
修改{学生}:在"{位置}"后添加"{内容}"
删除内容:
修改{学生}:删除"{内容}"
修改历史:
修改{学生}第{X}周:{修改内容}
```

View File

@@ -0,0 +1,309 @@
# 课评生成快速入门指南 v2.5(旧版本)
> ⚠️ **注意**:本文档为 v2.5 旧版本归档文件,描述的是"生成-确认-保存"两阶段流程。
> 当前系统已升级为 v3.1 "生成即双轨保存"模式,详见 [20-workflow.md](../20-workflow.md) 第7节和第10节。
>
> **最新快速入门请直接查看**`CLAUDE.md` → "快捷输入速查"章节
---
## 🚀 30秒极速上手
### 第1步指定班级一次即可
```
/课评 班级:发现世界-周四19点
```
### 第2步输入学生表现
```
乔乔观望5分钟→主动搭3层→自己调整开心比上周进步
昊昊慢热搭3层反复调整稳定
```
### 第3步一键确认发送
```
AI生成 → 查看 → [全部发送]
```
**完成3份课评已自动保存到班级汇总和个人档案。**
---
## ⚡ 速记符号速查
### 核心速记(必会)
| 速记 | 含义 | 示例 |
|------|------|------|
| `gj#` | 观望#分钟 | `gj5` = 观望5分钟 |
| `zd#` | 主动搭#层 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 遇到问题时自己调整 |
| `↑` | 开心 | `↑++` = 开心,比上周进步 |
| `→` | 稳定 | `→` = 情绪稳定 |
> 完整速记符号表参见 [36-shorthand-learning.md](36-shorthand-learning.md)
### 速记组合示例
```
乔乔gj5→zd3→zt ↑++
```
展开乔乔观望5分钟后主动搭3层自己调整开心比上周进步
---
## 🏷️ 学生类型标记
**输入时添加标记AI自动处理**
| 标记 | 含义 | 处理方式 |
|------|------|----------|
| `[体验]` | 体验课学生 | 仅保存到班级汇总 |
| `[补课]` | 补课学生 | 询问是否建档 |
| `[缺课]` | 今天缺席 | 记录缺席,不生成课评 |
| `[new]` | 新学生首次 | 创建档案,双轨保存 |
**示例**
```
乔乔gj5→zd3→zt ↑++
张小明[体验]搭了3层开心
李小红[补课]:专注完成,稳定
```
### ⚠️ 重要:课评正文不显示标记
**无论输入时是否添加`[补课]`或`[体验]`标记,生成的课评正文中都不会提及这些信息**
- `[补课]``[体验]`等标记**仅用于后台档案管理**
- 课评正文统一按正常学生撰写,不区分学生类型
- 家长看到的课评中不会出现"补课"、"体验"等字样
**示例**
```
教师输入:李小红[补课]搭了3层专注完成
课评输出:
小红本节课学习了"旋转飞机",认识了游乐园旋转设施的中心轴结构...
(正常撰写,完全不提"补课"相关信息)
```
---
## 📝 三种常用方式
### 方式1极简一句话最自由
```
乔乔今天开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
```
**特点**
- 任意格式AI自动解析
- 支持口语化、语音转文字
- 适合边走边记
- **字数**:输入简洁 → 输出约200字
### 方式2详细描述最丰富
```
乔乔今天开始观望了5分钟后来主动搭了3层管道球卡住的时候自己调整高度还主动帮助旁边的小朋友一起搭最后完成作品特别开心说这是她最喜欢的作品。比上周主动多了上周观望了10分钟才开始。
```
**特点**
- 描述越详细,课评越丰富
- AI会提取所有精彩瞬间
- 家长能看到更多孩子成长细节
- **字数**:输入丰富 → 输出约280字
### 方式3速记符号最高效
```
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小强:频换玩法 wb↓--
```
**特点**
- 输入速度最快
- 适合熟练用户
- 批量处理首选
- **字数**:根据输入内容自动调整
### 方式4批量表格最清晰
```
课程DISC-007
班级:发现世界-周四19点
1. 乔乔gj5→zd3→zt ↑++
2. 昊昊慢热→zd3→反复调 →
3. 张小明[体验]搭了3层开心
4. 李小红[补课]:专注完成,稳定
```
**特点**
- 全班一览清晰
- 支持标记分类
- 适合课后整理
- **字数**:根据每位学生输入内容自动调整
---
## 💡 字数弹性说明(新增)
**核心理念:输入越丰富,课评越详细**
| 输入类型 | 示例 | 输出字数 |
|---------|------|---------|
| **精简输入** | "搭了3层开心" | 180-220字 |
| **标准输入** | "观望5分钟→主动搭3层→自己调整→还帮助同伴" | 220-280字 |
| **详细输入** | 包含多个亮点、精彩瞬间、纵向对比 | 280-350字 |
**建议**
- 常规课堂 → 简洁记录即可
- 有亮点/突破/精彩瞬间 → 详细描述AI会充分展开
- 不用担心字数多 → 家长更喜欢看到孩子的具体成长
---
## 🔄 旧流程:生成 → 确认 → 保存v2.5 及之前版本)
```
教师输入 → AI自动生成 → 【自动保存班级汇总】 → 展示给教师
教师查看 → [一键发送] → 【自动保存个人档案】 → 完成
```
> **v3.1 更新**:现已简化为"生成即双轨保存",无需确认步骤。详见 [20-workflow.md](../20-workflow.md)。
---
## 📊 批量生成界面预览
```
━━━━━━━━━━━━━━━━━━━━━━━
📊 批量生成完成4份发现世界-周四19点DISC-007
━━━━━━━━━━━━━━━━━━━━━━━
✅ 乔乔 198字 正常
✅ 昊昊 205字 正常
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
---
## 📁 文件存储位置
### 双轨自动保存
| 存储位置 | 文件路径 | 用途 |
|---------|---------|------|
| **班级周汇总** | `memory/class-evaluation-summary/第X周/{班级}.md` | 集中查看当周全班表现 |
| **个人历史课评** | `memory/student/{班级}/{学生名}/历史课评记录.md` | 追踪个人完整成长轨迹 |
> 学生类型处理规则详见 [33-first-class-rules.md](33-first-class-rules.md)
### 跨班级补课说明
**场景**学生档案在A班如"发现世界-周四19点"来B班如"发现世界-周六09点")补课
**处理方式**
- 如果教师选择"跨班级保存",课评将同时保存到:
- B班补课班级的周汇总
- A班原班级的个人历史课评记录.md标注跨班级补课信息
- 这样可以在原班级追踪学生的完整成长轨迹
---
## 💡 进阶技巧
### 技巧1会话上下文
**首次指定班级后,后续无需重复**
```
/课评 班级:发现世界-周四19点 # 只需一次
# 后续直接输入
乔乔搭3层开心
昊昊:慢热,稳定
```
### 技巧2语音快速录入
```
语音:"呃...乔乔啊...观望了5分钟...主动搭3层..."
AI自动解析为乔乔gj5→zd3→zt
```
### 技巧3混合输入
```
# 同一批输入中混合使用自然语言和速记
乔乔今天表现很好搭了3层还自己调整开心
昊昊慢热→zd3→反复调 →
张小明[体验]:积极参与
```
---
## ❓ 常见问题速答
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。
**Q忘记打标记会怎样**
AAI会自动检测档案。在当前班级有档案=正式学生;在其他班级有档案=跨班级补课(询问处理方式);无档案=提示选择[补课]/[体验]。
**Q跨班级补课学生如何保存**
A如果学生档案在A班来B班补课可以选择①仅保存到B班班级汇总②同时追加到A班个人档案推荐可追踪完整轨迹
**Q批量生成后发现有错误怎么办**
A点击[标记修改]指出修改意见AI会重新生成该学生课评。
**Q课评生成后可以修改吗**
A可以发送前都可以修改。发送后如需修改可手动编辑文件。
**Q体验课学生后续转正式了怎么办**
A输入`转为正式`AI会为该学生建立档案后续课评正常双轨保存。
---
## 🎯 推荐工作流程
### 课后5分钟快速流程
```
Step 11分钟: 指定班级
/课评 班级:发现世界-周四19点
Step 22分钟: 速记输入
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小明[体验]zd3 ↑
小红[补课]:专注完成 →
Step 32分钟: 查看并一键发送
AI生成 → 查看质量报告 → [全部发送]
完成8份课评已自动保存。
```
---
## 📞 支持
- **完整规则**:参见 `.claude/rules/` 目录
- **速记符号表**:参见 `30-input-format.md`
- **批量生成规则**:参见 `32-batch-generation.md`
---
*记住说人话就行AI帮你处理格式*

View File

@@ -0,0 +1,401 @@
# 课评姓名处理规则
> 处理语音输入谐音、课评称呼方式、姓名规范化
---
## 一、语音输入谐音纠正
### 1.1 问题场景
语音输入时,学生姓名可能被识别为谐音词:
- "梁昕乔" → "良心桥"、"亮新巧"
- "钟昀昊" → "中云浩"、"钟运好"
- "李怡瞳" → "李一同"、"黎怡彤"
### 1.2 纠正机制
**Step 1: 建立班级学生名单库**
```
发现世界-周四19点班学生名单
- 梁昕乔liang xin qiao
- 钟昀昊zhong yun hao
```
**Step 2: 谐音匹配算法**
当输入姓名无法精确匹配时,使用拼音相似度匹配:
- 提取输入文本的拼音
- 与班级名单进行相似度对比
- 选择相似度>80%的姓名作为纠正目标
**Step 3: 常见谐音对照表**
| 正确姓名 | 常见谐音错误 | 拼音相似 |
|---------|-------------|---------|
| 梁昕乔 | 良心桥、亮新巧、梁新桥 | liang xin qiao |
| 钟昀昊 | 中云浩、钟运好、周云昊 | zhong yun hao |
| 李怡瞳 | 李一同、黎怡彤、李怡桐 | li yi tong |
| 张宇 | 章鱼、张瑜、章雨 | zhang yu |
| 王思琪 | 王思齐、王斯琦、汪思琪 | wang si qi |
| **黄晓瑜** | **小鱼** | **xiao yu → 晓瑜** |
| **罗钧龄** | **君玲** | **jun ling** |
| **简思霖** | **思林** | **si lin** |
### 1.4 语音输入常见误识别模式(新增)
**模式1同音字替换**
| 正确 | 误识别 | 原因 | 纠正规则 |
|------|--------|------|---------|
| 晓瑜 | 小鱼 | "晓"→"小""瑜"→"鱼"同音 | 检测"小+常见字"模式,匹配班级名单 |
| 钧龄 | 君玲 | "钧"→"君""龄"→"玲"同音 | 检测常见名字组合 |
| 思霖 | 思林 | "霖"→"林"同音 | 检测"思"+植物相关字 |
**模式2省略姓氏**
| 正确 | 误识别 | 原因 | 纠正规则 |
|------|--------|------|---------|
| 黄晓瑜 | 晓瑜 | 语音省略姓氏 | 直接匹配给定名字 |
| 梁家铭 | 家铭 | 语音省略姓氏 | 直接匹配给定名字 |
**模式3连读变音**
| 正确 | 误识别 | 原因 | 纠正规则 |
|------|--------|------|---------|
| 馨宸 | 新城/心晨 | 连读发音变化 | 模糊拼音匹配 |
| 瀚丞 | 韩晨/涵辰 | 连读发音变化 | 模糊拼音匹配 |
**纠正优先级**
1. 优先匹配班级现有学生名单(完整匹配)
2. 其次匹配去除姓氏后的名字部分
3. 最后进行谐音/模糊音匹配
4. 置信度>90%自动纠正不提示70-90%提示确认;<70%要求重新输入
**高置信度(>90%**:自动纠正,不提示
**中置信度70-90%**:生成时提示教师确认
```
⚠️ 检测到可能的谐音输入:
输入:"良心桥"
纠正为:"梁昕乔"
[是] [否,保持原样] [手动输入]
```
**低置信度(<70%**:要求教师重新输入
---
## 二、课评称呼方式
### 2.1 称呼优先级
课评中使用的称呼按以下优先级选择:
| 优先级 | 称呼方式 | 适用场景 | 示例 |
|:------:|---------|---------|------|
| 1 | **小名/昵称** | 画像中有填写 | 乔乔、昊昊、瞳瞳 |
| 2 | **去姓称名** | 双字名,无小名 | 昕乔、昀昊、怡瞳 |
| 3 | **叠字称呼** | 单字名 | 婷婷、浩浩、明明 |
| 4 | **全名** | 特殊场合 | 梁昕乔、钟昀昊 |
### 2.2 处理方式
#### 方式1小名/昵称(优先)
**条件**:用户画像中"小名/昵称"字段有填写
**示例**
- 全名:梁昕乔
- 小名:乔乔
- 课评显示:"乔乔本节课学习了..."
#### 方式2去姓称名双字名
**条件**
- 无小名
- 名字为双字(不含复姓)
**规则**
- 单姓+双字名:去掉姓氏
- 梁昕乔 → 昕乔
- 钟昀昊 → 昀昊
- 李怡瞳 → 怡瞳
- 复姓+双字名:保留复姓或去姓
- 欧阳明 → 阳明 或 明明
- 司马昊 → 马昊 或 昊昊
#### 方式3叠字称呼单字名
**条件**
- 无小名
- 名字为单字
**规则**
- 单字名叠字化
- 张昊 → 昊昊
- 李婷 → 婷婷
- 王明 → 明明
- 避免尴尬叠字
- 张丹 → 丹丹(正常)
- 王鹏 → 鹏鹏(正常)
- 避免:史真 → 真真(可以)
#### 方式4全名特殊
**使用场景**
- 家长明确要求使用全名
- 正式报告/证书
- 学生本人喜欢被叫全名
### 2.3 称呼示例表
| 全名 | 小名 | 课评称呼 | 说明 |
|------|------|---------|------|
| 梁昕乔 | 乔乔 | 乔乔 | 优先使用小名 |
| 梁昕乔 | 无 | 昕乔 | 去姓称名 |
| 钟昀昊 | 昊昊 | 昊昊 | 小名就是叠字 |
| 钟昀昊 | 无 | 昀昊 | 去姓称名 |
| 李怡瞳 | 瞳瞳 | 瞳瞳 | 小名叠字 |
| 李怡瞳 | 无 | 怡瞳 | 去姓称名 |
| 张昊 | 无 | 昊昊 | 单字名叠字 |
| 王婷 | 婷婷 | 婷婷 | 小名叠字 |
| 刘明 | 明明 | 明明 | 小名叠字 |
| 陈小雨 | 小雨 | 小雨 | 小名(非叠字)|
| 陈小雨 | 无 | 小雨 | 去姓称名 |
---
## 三、姓名处理流程
```
输入处理流程:
1. 接收教师输入
2. 提取疑似姓名词汇
3. 谐音纠正(匹配班级名单)
├─ 高置信度 → 自动纠正
├─ 中置信度 → 提示确认
└─ 低置信度 → 要求重输
4. 查询用户画像
├─ 有小名?→ 使用小名
├─ 双字名?→ 去姓称名
└─ 单字名?→ 叠字称呼
5. 生成课评(使用处理后的称呼)
```
---
## 四、特殊处理规则
### 4.1 复姓处理
| 复姓 | 全名 | 建议称呼 | 说明 |
|------|------|---------|------|
| 欧阳 | 欧阳明 | 阳明/明明 | 避免"欧欧" |
| 司马 | 司马昊 | 马昊/昊昊 | |
| 上官 | 上官婷 | 官婷/婷婷 | |
| 诸葛 | 诸葛亮 | 葛亮/亮亮 | |
| 东方 | 东方明 | 方明/明明 | |
### 4.2 生僻字处理
- 如果名字中有生僻字,优先使用小名
- 无小名时,可使用"去姓称名"中易读的字
- 或询问家长希望如何称呼
### 4.3 外籍/少数民族姓名
- 优先使用家长指定的小名/英文名
- 或使用名字的后半部分David → David或大卫
- 尊重家庭习惯
### 4.4 双胞胎处理
- 必须分别建立档案
- 小名要区分(如:大宝/小宝,哥哥/弟弟)
- 避免在课评中直接对比
---
## 五、用户画像更新(新增字段)
### 5.1 新增字段
```markdown
## 一、基础信息
| 项目 | 内容 |
|------|------|
| **姓名(全名)** | (用于档案管理)|
| **小名/昵称** | (课评中优先使用)|
| **称呼方式** | □ 小名 □ 去姓称名 □ 叠字 □ 全名 |
```
### 5.2 建档时询问
**问题11新增**
> 孩子平时在家怎么称呼?(小名/昵称)
> - 如:乔乔、昊昊、瞳瞳、小雨等
> - 如果没有特别的小名,我们就用"昕乔""昀昊"这样的方式称呼
**问题12新增**
> 希望课评中怎么称呼孩子?
> 1. 使用小名/昵称(最亲切)
> 2. 去姓称名(如:昕乔、昀昊)
> 3. 叠字称呼(如:昊昊、婷婷)
> 4. 使用全名(正式)
---
## 六、课评生成时的姓名处理
### 6.1 处理逻辑代码示例
```python
def get_display_name(student_profile, full_name):
"""
根据用户画像确定课评中使用的称呼
"""
# 优先级1小名/昵称
nickname = student_profile.get('nickname')
if nickname:
return nickname
# 解析姓名
surname, given_name = parse_name(full_name)
# 优先级2根据名字长度处理
if len(given_name) == 1:
# 单字名 → 叠字
return given_name * 2 # 如:昊 → 昊昊
else:
# 双字名 → 去姓称名
return given_name # 如:昕乔
def correct_homophone(input_text, class_roster):
"""
纠正语音输入的谐音错误
"""
# 提取可能的姓名词汇
candidates = extract_name_candidates(input_text)
for candidate in candidates:
# 拼音相似度匹配
best_match = find_best_pinyin_match(candidate, class_roster)
if best_match['confidence'] > 0.8:
return best_match['name']
return input_text
```
### 6.2 实际应用示例
**输入**`良心桥今天搭了三层`
**处理过程**
1. 提取疑似姓名:"良心桥"
2. 拼音liang xin qiao
3. 匹配班级名单:
- 梁昕乔liang xin qiao→ 相似度100%
4. 纠正为:"梁昕乔"
5. 查询画像:
- 小名:乔乔
6. 课评显示:"乔乔今天搭了三层..."
---
## 七、质量检查
### 7.1 姓名相关检查项
- [ ] 课评中使用的称呼正确(小名/去姓/叠字)
- [ ] 没有使用全名(除非家长要求)
- [ ] 谐音姓名已纠正
- [ ] 复姓处理恰当
- [ ] 单字名已叠字化
### 7.2 常见错误
| 错误 | 正确 | 说明 |
|------|------|------|
| 梁昕乔今天... | 乔乔今天... | 应使用小名 |
| 钟昀昊今天... | 昊昊今天... | 应使用小名 |
| 张昊今天... | 昊昊今天... | 单字名应叠字 |
| 良心桥今天... | 乔乔今天... | 谐音未纠正 |
---
## 八、家长沟通
### 8.1 首次建档时说明
> "家长您好,请问孩子平时在家怎么称呼呢?我们课评中希望用孩子最熟悉的称呼,这样更亲切。比如'乔乔'、'昊昊'这样的小名,或者'昕乔'、'昀昊'这样去姓的叫法都可以。"
### 8.2 修改称呼方式
如果家长希望更改课评中的称呼:
1. 更新用户画像中的"小名/昵称"字段
2. 或调整"称呼方式"选项
3. 下次课评自动生效
## 九、姓名处理示例
### 7.1 语音输入 + 谐音纠正 + 小名使用
**场景**:班级:发现世界-周四19点学生梁昕乔画像中小名乔乔
**教师输入(语音转文字)**
```
呃...那个...良心桥啊,今天上课一开始不敢碰,就坐着看...
```
**AI处理**
1. 谐音纠正:"良心桥" → "梁昕乔"
2. 查询画像:小名"乔乔"
3. 课评称呼:全程使用"乔乔"
**效果**课评中6处提到学生全部使用"乔乔"
---
### 7.2 双字名 + 去姓称呼
**场景**:学生:钟昀昊(画像中无小名)
**AI处理**
- 名字结构:双字名(昀昊)
- 处理规则:去姓称名
- 课评显示:"昀昊"
---
### 7.3 单字名 + 叠字称呼
**场景**:学生:张昊(画像中无小名)
**AI处理**
- 名字结构:单字名(昊)
- 处理规则:叠字称呼
- 课评显示:"昊昊"
---
### 7.4 批量生成 + 不同称呼方式
| 全名 | 小名 | 处理方式 | 课评显示 |
|------|------|---------|---------|
| 梁昕乔 | 乔乔 | 使用小名 | 乔乔 |
| 钟昀昊 | 无 | 去姓称名 | 昀昊 |
| 张昊 | 无 | 叠字称呼 | 昊昊 |
---
## 十、功能总结
| 功能 | 说明 | 效果 |
|------|------|------|
| **谐音纠正** | "良心桥"→"梁昕乔" | 自动识别正确姓名 |
| **小名优先** | 有填写则使用 | "乔乔"而非"梁昕乔" |
| **去姓称名** | 双字名去姓 | "昀昊"而非"钟昀昊" |
| **叠字称呼** | 单字名叠字 | "昊昊"而非"张昊" |
| **全文一致** | 所有提及处统一 | 提升亲切感 |
---
*版本v1.1*
*更新日期2026-04-06*
*已整合原41-name-examples.md内容*

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*
*更新内容:新增输入丰富度评估算法、内容重复度检查规则*