ClassFeedback/.claude/rules/90-archive/70-common-structures.md

> ⚠️ **本文件已归档**：内容已合并至核心规则文件，此处仅作历史备份。请勿直接引用本文件，请使用 `.claude/rules/` 下的核心规则。

# 通用结构规范

> 统一文档中重复定义的结构规则，避免多处维护导致不一致

---

## 一、三段式结构规范（全年龄段统一）

> **适用**：幼儿积木课、少儿编程课、机器人竞赛课

### 段落结构

| 段落 | 内容 | 字数范围 | 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分
- 技术细节：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*  
*更新内容：新增输入丰富度评估算法、内容重复度检查规则*