ClassFeedback/.claude/rules/38-quick-edit.md

# 快速编辑功能规则

> 解决小错误修改需重新生成的问题，提升修改效率70%

---

## 🚀 快速编辑 vs 重新生成

| 场景 | 原方案 | 快速编辑 | 效率提升 |
|------|--------|---------|:--------:|
| 错别字 | 重新生成整篇 | 直接修改 | 90%↑ |
| 称呼错误 | 重新生成整篇 | 替换称呼 | 95%↑ |
| 个别词语 | 重新生成整篇 | 替换词语 | 90%↑ |
| 补充细节 | 重新生成整篇 | 追加内容 | 80%↑ |
| 结构调整 | 重新生成整篇 | 重新生成 | - |

---

## 📝 快速编辑指令

### 指令格式

```
修改{学生}：{修改内容}

或

编辑{学生}：{修改内容}
```

### 支持的修改类型

#### 类型1：替换词语（最常用）

```
教师：修改乔乔：把"搭建"改为"拼搭"

AI处理：
- 定位：在班级汇总和个人档案中找到乔乔的第7周课评
- 替换：将所有"搭建"替换为"拼搭"
- 确认：显示修改前后对比

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改：乔乔（第7周 DISC-007）

修改前：
"乔乔本节课搭建了3层管道..."

修改后：
"乔乔本节课拼搭了3层管道..."

修改位置：第2段第1句
━━━━━━━━━━━━━━━━━━━━━━━━━
```

#### 类型2：修改称呼

```
教师：修改乔乔：称呼改为"乔乔宝贝"

AI处理：
- 定位：找到所有称呼"乔乔"的位置
- 替换：统一改为"乔乔宝贝"
- 注意：不改变其他内容

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改称呼：乔乔 → 乔乔宝贝

共修改 6 处称呼
━━━━━━━━━━━━━━━━━━━━━━━━━
```

#### 类型3：补充内容

```
教师：修改乔乔：在"坚持完成了"后添加"还主动帮助了同桌"

AI处理：
- 定位：找到"坚持完成了"
- 插入：在指定位置添加内容
- 调整：确保语句通顺

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已补充内容：乔乔（第7周）

添加位置：第2段
添加内容："还主动帮助了同桌"

修改后上下文：
"...但还是认真完成了，还主动帮助了同桌，展现出很好的坚持性。"
━━━━━━━━━━━━━━━━━━━━━━━━━
```

#### 类型4：删除内容

```
教师：修改乔乔：删除"这个调整值得注意"

AI处理：
- 定位：找到指定内容
- 删除：移除该句
- 调整：确保段落连贯

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已删除内容：乔乔（第7周）

删除："这个调整值得注意"
━━━━━━━━━━━━━━━━━━━━━━━━━
```

#### 类型5：批量替换

```
教师：修改乔乔：把所有"开心"改为"兴奋"

AI处理：
- 统计：全文共出现3次"开心"
- 替换：全部改为"兴奋"
- 确认：显示每处修改位置

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 批量替换完成

替换：开心 → 兴奋（共3处）

位置1：第2段第1句
位置2：第2段第3句
位置3：课后建议段落
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 🎯 批量快速编辑

### 同时修改多个学生

```
教师：
修改乔乔：把"搭建"改为"拼搭"
修改昊昊：称呼改为"昊昊小朋友"
修改小明：补充"还主动分享了作品"

AI处理：
1. 依次处理每个学生的修改
2. 汇总显示所有修改结果
3. 标记哪些成功、哪些失败

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 批量修改完成（3/3成功）

☑️ 乔乔：替换"搭建"→"拼搭"（1处）
☑️ 昊昊：称呼改为"昊昊小朋友"（6处）
☑️ 小明：补充内容（第2段）

所有修改已同步到：
- 班级周汇总
- 个人历史课评
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 🔍 智能定位

### 自动识别修改范围

当教师只说"修改"而未指定周数时，AI自动：

```
教师：修改乔乔：把"开心"改为"兴奋"

AI判断：
1. 当前会话上下文：第7周 DISC-007
2. 默认修改：本周（第7周）课评
3. 如要修改历史：需明确指定周数

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改：乔乔 第7周（当前周）

如需修改其他周数，请指定：
"修改乔乔第5周：把'开心'改为'兴奋'"
━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 历史课评修改

```
教师：修改乔乔第5周：把"搭建"改为"拼搭"

AI处理：
- 定位：memory/student/.../历史课评记录.md
- 找到第5周记录
- 执行修改

━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已修改历史课评：乔乔 第5周

⚠️ 注意：这是历史课评，已发送给家长
   如已发送，请考虑是否需要告知家长更新
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## ⚠️ 修改限制

### 不可快速编辑的场景

以下情况**必须重新生成**，不支持快速编辑：

| 场景 | 原因 | 建议操作 |
|------|------|---------|
| 改变课评结构 | 涉及多段落调整 | 重新生成 |
| 改变评价基调 | 从负面改为正面 | 重新生成 |
| 补充大量内容 | 超过50字 | 重新生成 |
| 改变主题理解 | 知识点错误 | 重新生成 |
| 添加 emoji | 格式调整 | 快速编辑支持 |

### 修改字数限制

- **单次修改**：不超过50字
- **单篇累计**：不超过100字
- **超出限制**：提示"建议重新生成"

---

## 🔄 修改与重新生成的对比

### 决策流程

```
教师要求修改
      ↓
判断修改类型
      ↓
┌─────────────┴─────────────┐
↓                           ↓
小修改（<50字）        大修改（>50字）
或简单替换            或结构调整
↓                           ↓
快速编辑                  重新生成
(秒级响应)               (需等待生成)
```

### 使用建议

| 情况 | 推荐方式 | 示例 |
|------|---------|------|
| 错别字 | 快速编辑 | "搭建"→"拼搭" |
| 称呼调整 | 快速编辑 | "乔乔"→"乔乔宝贝" |
| 补充1-2句话 | 快速编辑 | 添加具体细节 |
| 整体重写 | 重新生成 | "重新生成乔乔的课评" |
| 改变语气 | 重新生成 | 从平淡改为热情 |
| 补充大量细节 | 重新生成 | 添加完整事件描述 |

---

## 📊 快速编辑统计

### 使用统计

每周生成快速编辑使用报告：

```
━━━━━━━━━━━━━━━━━━━━━━━━━
📊 快速编辑使用统计（本周）

使用次数：12次
节省时间：约10分钟（vs 重新生成）

常用修改类型：
1. 替换词语 - 5次
2. 修改称呼 - 4次
3. 补充内容 - 3次

平均修改耗时：5秒
平均重新生成耗时：60秒
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## ✅ 实施检查清单

- [ ] 支持基本替换指令（修改{学生}：把"A"改为"B"）
- [ ] 支持称呼修改指令
- [ ] 支持内容补充指令
- [ ] 支持内容删除指令
- [ ] 支持批量修改多个学生
- [ ] 自动定位当前周数（无需指定）
- [ ] 支持历史课评修改（需指定周数）
- [ ] 修改字数限制（单次<50字）
- [ ] 修改后同步到双轨存储
- [ ] 显示修改前后对比

---

## 📝 快速参考卡

```
━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ 快速编辑指令速查

修改称呼：
  修改{学生}：称呼改为"{新称呼}"

替换词语：
  修改{学生}：把"{旧词}"改为"{新词}"

补充内容：
  修改{学生}：在"{位置}"后添加"{内容}"

删除内容：
  修改{学生}：删除"{内容}"

修改历史：
  修改{学生}第{X}周：{修改内容}
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

*版本：v1.0*  
*更新日期：2026-04-19*  
*配套文件：32-batch-generation.md, 30-input-format.md*