# 快捷输入格式规则 v4.0（优化版）

> 核心理念：**说人话就行**，AI自动理解语境、补充细节、规整格式
> 
> 本次优化：新增速记符号系统、标记驱动处理、会话上下文记忆

---

## 🎯 黄金法则

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

**支持**：口语化、碎片化、无序化、语音转文字

---

## ⚡ 速记符号系统（新增）

### 行为速记

| 速记 | 全称 | 使用场景 |
|------|------|----------|
| `gj` | 观望 | `gj5` = 观望5分钟 |
| `zd` | 主动 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 球卡住时自己调整 |
| `wb` | 完成 | 独立完成搭建 |
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `sb` | 失败→调整 | 失败后调整再尝试 |

### 情绪速记

| 速记 | 含义 | 示例 |
|------|------|------|
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
| `~` / `bd` | 波动 | 情绪~ 或 bd |

### 对比速记

| 速记 | 含义 | 示例 |
|------|------|------|
| `++` / `!` | 比上周进步 | 比上周++ |
| `=` / `0` | 和之前一样 | 和之前= |
| `--` / `?` | 需关注 | 需-- |
| `new` | 新学生/首次 | 标记首次上课 |

### 速记组合示例

```
输入：  乔乔：gj5→zd3→zt ↑++
展开：  乔乔观望5分钟后主动搭3层，自己调整，开心，比上周进步

输入：  昊昊：慢热→zd3→反复调 →
展开：  昊昊慢热，主动搭3层，反复调整，情绪稳定

输入：  小强：频换玩法 wb↓--
展开：  小强频繁换玩法，未完成，情绪烦躁，需关注
```

---

## 🏷️ 标记驱动处理（新增）

**使用标记快速指定学生类型，无需中断流程**

| 标记 | 含义 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
| `[补课]` | 补课学生 | 询问是否建档 | 先班级汇总 |
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总（标记体验） |
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总（标记缺课） |
| `[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层→反复调整
  情绪：稳定
```

### 示例3：批量混合标记

```
输入：
周四19点 DISC-007

乔乔：gj5→zd3→zt ↑++
昊昊：慢热→zd3→反复调 →
张小明[体验]：搭了3层，开心
```

---

## 📦 存储流程（优化后）

```
教师输入 → AI解析 → 预加载档案 → 生成课评 → 自动保存班级汇总 → 展示给教师
                                                              ↓
教师确认/修改 ← 一键发送 ← 自动保存个人档案 ← 教师点击发送
```

### 自动保存规则

| 学生类型 | 班级周汇总 | 个人档案 | 教师操作 |
|----------|-----------|----------|----------|
| 正式学生 | ✅ 自动保存 | ✅ 确认后保存 | 查看→发送 |
| [补课] | ✅ 自动保存 | ❓ 询问后决定 | 查看→选择→发送 |
| [体验] | ✅ 自动保存（标记） | ❌ 不保存 | 查看→发送 |
| [缺课] | ✅ 记录缺席 | ❌ 不生成 | 无 |

---

## 📞 常见问题

**Q：速记符号记不住怎么办？**  
A：不用记！直接用自然语言描述，AI一样能理解。速记是给熟练用户的可选提速方式。

**Q：忘记打标记怎么办？**  
A：AI会检测档案自动判断。有档案=正式学生，无档案=提示选择[补课]/[体验]。

**Q：标记可以组合吗？**  
A：可以！`张小明[体验][new]`表示体验课新学生。

**Q：上下文记忆持续多久？**  
A：一次会话内有效。换班级时重新指定即可。

---

## 版本历史

| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v4.0** | **2026-04-19** | **优化版**：新增速记符号系统、标记驱动处理、会话上下文记忆 |
| v3.2 | 2026-04-16 | 新增补课/体验学生处理说明 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性，支持任意自然语言输入 |

---

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