# 快捷输入格式规则 v3.0

> 支持更灵活的输入方式，适应课后快速记录场景

---

## 🎯 输入原则（新版）

**极简输入，AI智能理解**
- 教师只需提供**关键词**和**关键事实**
- AI自动理解语境、补充细节、规整格式
- 支持**口语化、碎片化、无序化**输入
- 接受**语音转文字、手写速记、随手记录**
- **自动纠正谐音姓名**（如"良心桥"→"梁昕乔"）

**核心目标**：让教师以最自然的方式记录，AI负责后续整理

---

## 🔊 语音输入特别说明

### 谐音姓名自动纠正

**问题**：语音输入时姓名可能被识别为谐音
- "梁昕乔" → "良心桥"、"亮新巧"
- "钟昀昊" → "中云浩"、"钟运好"
- "张宇" → "章鱼"、"张瑜"

**解决**：AI自动匹配班级学生名单进行纠正
- 高相似度（>90%）：自动纠正，不打扰
- 中相似度（70-90%）：生成前提示确认
- 低相似度（<70%）：要求重新输入

**示例**：
```
教师语音输入："良心桥今天搭了三层"
AI处理：
  1. 识别疑似姓名"良心桥"
  2. 匹配班级名单：梁昕乔（相似度100%）
  3. 自动纠正为"梁昕乔"
  4. 查询画像小名："乔乔"
  5. 课评输出："乔乔今天搭了三层..."
```

---

## ✨ 支持的输入方式

### 方式1：极简一句话（最自由）

**特点**：任意格式，AI自动解析

**示例1**：口语化
```
小明今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
```

**示例2**：碎片化
```
梁昕乔 快速启动 搭3层 自己加装饰 情绪好 创意突出
```

**示例3**：无序关键词
```
观望5分钟，主动尝试，自己调整，情绪稳定，比上周好，小明
```

**示例4**：语音转文字风格
```
呃...钟昀昊啊，今天上课啊，就是慢热，观察了一会儿才开始，然后搭了三层，反复调整，情绪挺稳定的
```

---

### 方式2：自然对话式（推荐）

**特点**：像和同事聊天一样描述

**示例**：
```
今天梁昕乔表现挺好的，一上课就进入状态了，搭了3层还自己加了装饰，情绪很开心，和之前一样主动

钟昀昊呢，还是老样子，慢热型，观察了5分钟才开始，不过后来搭得挺稳的，反复调整了几遍，最后完成了
```

**AI自动识别**：
- 学生姓名（梁昕乔、钟昀昊）
- 关键行为（快速启动、搭3层、加装饰）
- 情绪状态（开心、稳定）
- 对比信息（和之前一样）

---

### 方式3：列表速记（半结构化）

**特点**：无序列表，无需严格格式

**示例1**：简单列表
```
- 小明
- 开始不敢碰管道
- 后来主动搭3层
- 球卡住自己调整
- 情绪稳定
- 比上周进步
```

**示例2**：混合关键词
```
小明：观望→主动→3层→调整，稳定，比上周好

小红：全程专注，5层+弯管，开心，帮助旁边人

小强：换玩法多，没完成，兴奋转烦躁，需引导
```

---

### 方式4：表格简化版（批量）

**特点**：极简表格，不要求对齐

**示例**：
```
小明 观望5分钟 搭3层 自己调 稳定 比上周好
小红 全程专注 5层加弯管 开心 帮助人
小强 换玩法 没完成 烦躁 需引导
豆豆 独自玩球 没搭 开心 社交需引导
```

**AI自动转换**为规整表格

---

### 方式5：分段描述（详细）

**特点**：按时间/环节分段，自由描述

**示例**：
```
【小明】
导入阶段：坐着看其他小朋友玩
探索阶段：第6分钟开始尝试
搭建阶段：能搭3层直管
调整阶段：球卡住自己调高度
情绪：整体稳定
亮点：比上周主动多了
```

---

### 方式6：极简符号速记（专业用户）

**特点**：用符号快速编码

**符号对照**：
```
→ 表示行为发展/时间线
+ 表示正面/进步
- 表示需关注/问题
↑ 表示情绪积极
↓ 表示情绪消极
? 表示疑问/不确定
! 表示亮点/惊喜
```

**示例**：
```
小明：观望5m → 主动3层 → 自调 ↑ + 比上周!
小红：专注全程 → 5层+弯管 ↑↑ + 助人!
小强：频换玩法 → 未完成 ↓ 需引导
```

---

## 🔍 AI智能解析规则

### 自动识别要素

| 要素 | AI识别方式 | 示例 |
|------|-----------|------|
| **学生姓名** | 首词/大写/冒号前 | "小明"、"梁昕乔" |
| **关键行为** | 动词+数量/结果 | "搭3层"、"自己调" |
| **情绪状态** | 情绪词/表情描述 | "开心"、"稳定"、"烦躁" |
| **对比信息** | 时间词+比较 | "比上周"、"和之前" |
| **课程信息** | 上下文/历史记录 | 自动推断 |

### 模糊匹配

**行为词模糊匹配**：
| 教师输入 | AI理解 | 标准输出 |
|---------|-------|---------|
| 不敢碰/不敢动/犹豫 | 观望型 | "开始有些犹豫" |
| 主动/积极/马上 | 主动型 | "主动尝试" |
| 自己弄/自己搞/自己调 | 自主解决 | "自己调整" |
| 搭了3层/做了三层/堆了3个 | 完成3层 | "搭了3层" |

**情绪词模糊匹配**：
| 教师输入 | AI理解 |
|---------|-------|
| 开心/高兴/笑/兴奋 | 积极情绪 |
| 稳定/平静/正常 | 平稳情绪 |
| 低落/不开心/烦躁 | 消极情绪 |
| 先好后差/开始可以后来不行 | 情绪波动 |

---

## 💡 输入优化建议

### 最少有效信息

只需提供：
1. **学生姓名**（必须）
2. **一个关键行为**（必须）

AI会自动：
- 匹配课程信息
- 推断情绪状态
- 对比历史表现
- 生成完整课评

**极简示例**：
```
小明：主动搭了3层
```

AI输出：
```
小明今天学习了互锁结构，能主动尝试并搭了3层...
[基于画像的完整课评]
```

### 推荐信息量

| 场景 | 建议输入 | 效果 |
|------|---------|------|
| **最省时间** | 姓名+1个行为 | 自动生成 |
| **常规记录** | 姓名+2-3个行为+情绪 | 个性化强 |
| **重点关注** | 姓名+详细表现+对比 | 深度定制 |

---

## 🚫 不推荐的输入方式

虽然系统会尽力理解，但以下方式可能影响质量：

| 不推荐 | 原因 | 建议替代 |
|-------|------|---------|
| 纯数字代码 | 无上下文 | 加姓名或关键词 |
| 过于省略 | 信息不足 | 至少一个行为 |
| 完全乱序 | 难以解析 | 大致按时间顺序 |
| 错别字过多 | 理解困难 | 常用拼音即可 |

---

## 🔄 输入示例大全

### 示例1：口语化输入（推荐）

**教师输入**：
```
呃，小明啊，今天上课一开始不敢碰，就坐着看，后来我看他开始动了，搭了大概三层吧，然后那个球卡住了，他就自己调了一下高度，情绪还挺稳定的，比上周好一些，上周是完全不敢碰的
```

**AI解析结果**：
- 学生：小明
- 行为：观望→主动搭3层→自己调整
- 情绪：稳定
- 对比：比上周进步（上周完全不敢碰）

---

### 示例2：碎片化输入

**教师输入**：
```
梁昕乔 快速启动 3层 加装饰 开心 和之前一样
```

**AI解析结果**：
- 学生：梁昕乔
- 行为：快速启动→搭3层→加装饰
- 情绪：开心
- 对比：和之前一样

---

### 示例3：无序关键词

**教师输入**：
```
稳定，自己调整，观望5分钟，主动尝试，比上周好，小明
```

**AI解析结果**：
- 学生：小明
- 行为：观望5分钟→主动尝试→自己调整
- 情绪：稳定
- 对比：比上周好

---

### 示例4：批量简化

**教师输入**：
```
周四19点 DISC-003

小明 观望5分 搭3层 自调 稳定 比上周好
昕乔 快速 3层 加装饰 开心 一样
昀昊 慢热 3层 反复调 稳定 渐入佳境
```

**AI解析结果**：
自动识别为批量模式，生成3份课评

---

### 示例5：详细描述

**教师输入**：
```
【李怡瞳】四年级 AI03
今天学Prompt编写
开始比较慢，观察别人
后来能写简单指令
遇到困难主动问
情绪平和
初学阶段正常
```

**AI解析结果**：
- 学生：李怡瞳
- 年级：四年级
- 课程：AI03
- 行为：观察→写简单指令→主动求助
- 情绪：平和
- 状态：初学阶段

---

## 📝 输入模板速查

### 模板1：最简版
```
[姓名]：[一个行为]
```

### 模板2：常规版
```
[姓名]：[行为1]，[行为2]，[情绪]，[对比]
```

### 模板3：自然版
```
今天[姓名][表现描述]，[情绪]，[对比]
```

### 模板4：批量版
```
课程：[代码]
[姓名1] [表现1] [情绪1]
[姓名2] [表现2] [情绪2]
```

---

## 🎯 与旧版对比

| 维度 | 旧版（v2.0）| 新版（v3.0）|
|------|------------|------------|
| **格式要求** | 较严格 | 非常灵活 |
| **输入方式** | 5种固定格式 | 任意自然语言 |
| **口语支持** | 有限 | 完全支持 |
| **容错性** | 中 | 高 |
| **智能解析** | 关键词匹配 | AI语义理解 |
| **推荐场景** | 规范记录 | 快速随手记 |

---

## ✅ 使用建议

### 不同场景推荐输入方式

| 场景 | 推荐方式 | 示例 |
|------|---------|------|
| **边走边记** | 极简一句话 | "小明搭3层自己调" |
| **语音输入** | 自然对话式 | "小明今天表现很好..." |
| **课后整理** | 列表速记 | "- 小明 - 搭3层 - 开心" |
| **批量生成** | 简化表格 | "小明 搭3层 开心" |
| **重点关注** | 分段描述 | "【小明】导入...探索..." |

### 黄金法则

1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充

**记住**：没有固定格式，说人话就行！

---

## 📦 存储位置（双轨制）

> **新增**：确认后同时保存到两个位置

| 存储位置 | 用途 | 文件路径 |
|---------|------|---------|
| **班级周汇总** | 集中查看当周全班表现 | `memory/class-evaluation-summary/第X周/{班级}.md` |
| **个人历史课评** | 追踪学生完整成长轨迹 | `memory/student/{班级}/{学生名}/历史课评记录.md` |

### 数据流转

```
教师输入 → AI生成 → 【等待确认】 → 确认后双轨保存
                                      ↓
                          ┌──────────┴──────────┐
                          ↓                     ↓
                 班级周汇总.md              个人历史课评.md
```

### 使用场景

- **班级周汇总**：周回顾、备课参考、批量发送家长群
- **个人历史课评**：一对一家长沟通、学期总结、成长档案

---

## 📞 常见问题

### Q：我写得乱，AI能懂吗？
**A**：能！只要包含姓名和关键行为，AI会自动理解并规整。

### Q：语音转文字很多错别字怎么办？
**A**：没关系，AI能根据上下文推断。关键是发音清晰的动词和名词。

### Q：忘记写课程信息怎么办？
**A**：AI会从历史记录或上下文中自动推断。

### Q：批量输入需要严格对齐吗？
**A**：不需要！用空格或制表符分隔即可，AI会自动整理。

### Q：补课/体验学生怎么处理？
**A**：详见 [33-first-class-rules.md](33-first-class-rules.md) 新学生与补课学生处理规则。

### Q：体验课学生不想建档怎么办？
**A**：直接回复「跳过」或「仅保存到班级汇总」。课评会保存在 `class-evaluation-summary/第X周/{班级}.md` 中，标记为体验学生，不影响后续正式学员的档案管理。

---

## 版本历史

| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| v3.2 | 2026-04-16 | **新增补课/体验学生处理说明**：说明无档案学生的检测、提醒和可选保存方式 |
| v3.1 | 2026-04-15 | **新增双轨存储说明**：确认后同时保存到班级周汇总和个人历史课评，便于集中查看和追踪成长 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性，支持任意自然语言输入 |
| v2.0 | 2026-03-26 | 新增单个/批量生成方式 |
| v1.0 | 2026-03-25 | 初始版本，5种固定格式 |

---

*新版本核心理念：用最自然的方式记录，让AI处理格式*