8.8 KiB
8.8 KiB
通用结构规范
统一文档中重复定义的结构规则，避免多处维护导致不一致
一、三段式结构规范（全年龄段统一）
适用：幼儿积木课、少儿编程课、机器人竞赛课
段落结构
| 段落 | 内容 | 字数范围 | 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班）的周数为准
处理流程图（自动版）
检测到[补课]标记
│
▼
检查当前班级档案
│
┌───┴───┐
▼ ▼
存在 不存在
│ │
▼ ▼
双轨保存 搜索其他班级
（本班补课） │
┌──┴──┐
▼ ▼
存在 不存在
│ │
▼ ▼
自动跨班级 询问
双轨保存 建档
自动跨班级双轨保存
当检测到学生档案在其他班级存在时，自动执行：
- ✅ 保存到补课班级（B班）周汇总
- ✅ 追加到原班级（A班）个人历史课评记录.md
- ✅ 在原班级档案中标注"【跨班级补课】本节课程在B班（第X周）完成"
无需询问，自动完成
存储位置对照
| 场景 | 班级汇总 | 个人档案 |
|---|---|---|
| 本班补课 | ✅ 当前班级 | ✅ 当前班级 |
| 跨班级补课 | ✅ 补课班级 | ✅ 原班级（自动追加，标注补课信息） |
| 完全无档案 | ✅ 当前班级 | ❌ 不保存（或询问后创建） |
课评正文规范
- 绝对禁止：提及"补课"、"跨班级"、"临时加入"等词汇
- 正确处理：完全按正常学生撰写，仿佛就是本班学生
四、引用说明
各风格规则文件引用本规范：
- 20-style-building.md - 幼儿积木搭建
- 21-style-coding.md - 少儿编程入门
- 22-style-robotics.md - 机器人竞赛
- 50-output-format-preschool.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分
- 技术细节：1（5分钟、3层）= 1分
总分：6分 → 标准版（220-280字）
示例3：详细输入
输入：乔乔观望5分钟后主动搭3层，球卡住自己调整，还帮助旁边的小朋友，
最后说这是最喜欢的作品，比上周主动多了，上周观望10分钟才开始
评估：
- 行为数量：4（观望、搭建、调整、帮助）= 3分（上限）
- 情绪描述：2（最喜欢）= 2分
- 纵向对比：2（比上周+具体对比）= 2分
- 精彩瞬间：2（主动帮助别人+情感表达）= 2分
- 技术细节：1（5分钟、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
更新内容：新增输入丰富度评估算法、内容重复度检查规则