# 课评优化工具速查卡

## 一、核心优化功能

| 功能 | 说明 | 使用场景 |
|------|------|---------|
| **三级备份** | 防止数据丢失，主文件+备份+bak文件 | 所有保存操作自动执行 |
| **自动补全** | 日期、课程编号、课次自动填入 | 教师只需输入学生表现 |
| **路径自动创建** | 自动创建不存在的目录 | 首次保存新学生/新班级 |
| **速记补全** | 输入过程中实时提示速记含义 | 快速输入时 |
| **实时校验** | 保存前检查规范，提前发现问题 | 生成完成后 |
| **智能预加载** | 根据时间自动预加载当天班级 | 开始工作时 |

---

## 二、速记符号表

### 核心符号（必记）
| 符号 | 含义 | 完整描述 |
|------|------|---------|
| `gj` | 观望 | gj5=观望5分钟 |
| `zd` | 主动搭 | zd3=主动搭3层 |
| `zt` | 自己调整 | 球卡住时自己调整高度 |
| `wb` | 完成 | 独立完成搭建 |
| `↑` | 开心/积极 | 情绪良好 |
| `→` | 稳定/平和 | 情绪稳定 |
| `++` | 比上周进步 | 表现更好 |

### 扩展符号
| 符号 | 含义 | 完整描述 |
|------|------|---------|
| `zx` | 专注 | zx15=专注15分钟 |
| `sb` | 失败后调整 | sb2=失败2次后成功 |
| `ts` | 探索 | ts5=探索5分钟 |
| `cz` | 创造 | cz3=3种创意方案 |
| `wt` | 提问 | wt3=提问3次 |
| `hz` | 合作 | 合作完成 |
| `fx` | 分享 | 分享想法/作品 |

---

## 三、快捷指令

### 班级选择
| 指令 | 功能 |
|------|------|
| **`/周几`** | **按上课日快速索引（推荐）**，如 `/周六`、`/周日` |
| `/今天` | 自动判断当天星期几，选择对应班级 |
| `/本周` | 选择本周班级列表 |
| `/班级 {班级名}` | 手动选择指定班级 |

### 模板工具
| 指令 | 功能 |
|------|------|
| `/模板 {班级}` | 加载班级学生名单模板 |
| `/空模板` | 创建空模板 |

### 批量操作
| 指令 | 功能 |
|------|------|
| `/批量修改 {查找}→{替换}` | 批量替换课评内容 |
| `/批量添加 {内容}` | 批量在课评结尾添加内容 |

### 数据恢复
| 指令 | 功能 |
|------|------|
| `/恢复 {学生}` | 恢复该学生的备份 |
| `/恢复备份` | 恢复最近一次备份 |
| `/清理备份` | 清理过期备份文件 |

### 校验检查
| 指令 | 功能 |
|------|------|
| `/检查` | 检查本周课评是否符合规范 |
| `/检查 {班级}` | 检查指定班级课评 |

### 保存与补存
| 指令 | 功能 |
|------|------|
| `/补存` | 尝试重新保存失败的课评 |
| `/学生 {姓名}` | 查看学生档案和历史课评 |

### 修复工具
| 指令 | 功能 |
|------|------|
| `/修复` | 处理待修复列表中的项目 |

---

## 四、规范检查要点

### 课程编号规范
| 错误 | 正确 |
|------|------|
| C++ | CSP |
| AI03 | AICODE03 |
| AI编程 | AICODE |

### 日期格式
- ✅ 正确：20260516
- ❌ 错误：2026/05/16、5月16日、05/16

### 文件命名
- ✅ 正确：20260516_DISC-011.md
- ❌ 错误：5月16日课评.md、第11周课评.md

### 禁用词汇（课评正文）
- ❌ 补课、来补课、作为补课学生
- ❌ 第一次上课（除非教师明确说明）
- ❌ C++、AI编程（使用标准编号）

---

## 五、备份与恢复

### 备份位置
```
主文件：.claude/memory/class/{班级}/{学生}/feedback/YYYYMMDD_课程编号-课次.md
备份文件：.claude/.backup/YYYYMMDD_HHMMSS_{学生}.md
旧文件备份：原文件路径.md.bak
```

### 恢复流程
1. 输入 `/恢复 {学生姓名}`
2. 从列出的备份版本中选择
3. 确认恢复

---

## 六、待修复列表

### 位置
```
.claude/.tasks/fix-list-YYYYMMDD.md
```

### 查看与修复
```
指令：/修复
→ 展示待修复列表
→ 逐个处理或批量自动修复
```

---

## 七、完整工作流程示例

### 高效课后流程

```
1. 打开系统
   └─ /周六（或 /今天）→ 自动加载发现世界-周六09点

2. 加载学生模板
   └─ /模板 周四19点 → 显示学生名单

3. 速记输入（自动补全）
   └─ 乔乔：gj5→zd3→zt ↑ ++
      系统提示：gj5→zd3→zt ↑++

4. 生成课评
   └─ 并行生成 → 实时保存一份一份

5. 自动校验
   └─ ✅ 全部通过 ⚠️ 或 警告提示

6. 保存完成
   └─ 三级备份同时保存 ✅

7. 查看待修复
   └─ /修复 处理未完成项目
```

---

## 八、常见问题

### Q: 备份会占用空间吗？
A: 自动保留最近7天备份，每月1号备份长期保留，自动清理超过时间的备份。

### Q: 速记符号记不住怎么办？
A: 不用记住，输入时系统会自动提示含义，按Tab键可自动补全。

### Q: 校验警告可以跳过吗？
A: 可以，警告不阻塞保存，但会记录在待修复列表，后续可集中处理。

### Q: 目录不存在怎么办？
A: 系统会自动逐级创建完整目录结构，无需手动操作。

---

## 九、情绪符号对照表

| 符号 | 含义 | 对应表述 |
|------|------|---------|
| `↑` | 开心/积极/投入 | 开心、投入、积极、热情、参与度高 |
| `→` | 稳定/平和/正常 | 稳定、平和、正常、专注、认真 |
| `↓` | 低落/烦躁 | 低落、烦躁、不开心、需要关注 |
| `~` | 波动/反复 | 情绪波动、反复不定 |
| `++` | 进步/提升 | 比上周好、进步明显、状态提升 |
| `↑↑` | 非常开心/兴奋 | 特别开心、非常投入、状态极佳 |
| `↓↓` | 特别低落/需要关注 | 非常低落、需要关注、情绪不好 |
| `gd` | 孤独/独自玩 | 喜欢独自玩、独自活动 |
| `jl` | 焦虑/紧张/不安 | 紧张、焦虑、不安 |

---

## 十、示例速记组合

```
乔乔：gj5→zd3→zt ↑++ → 观望5分钟→主动搭3层→自己调整，开心，比上周进步
昊昊：慢热→zd3→反复调 → → 慢热，主动搭3层，反复调整，稳定
小明：专注15→完成→分享→合作 ↔ 专注15分钟→完成→分享→合作
```

---

*速查卡版本：v1.0.0*
*最后更新：2026-05-16*
