优化课评系统:新增速记符号、状态面板、快速编辑功能

- 新增36-shorthand-learning.md:速记符号阶梯学习指南
- 新增37-status-panel.md:课评状态管理面板
- 新增38-quick-edit.md:快速编辑功能规则
- 新增班级学期总览模板和成长时间线模板
- 更新多条规则文件优化课评生成流程
- 补充第7周班级汇总和学生档案数据
This commit is contained in:
2026-04-19 19:24:09 +08:00
parent c04f1d18a6
commit 4810387dab
73 changed files with 4070 additions and 898 deletions

View File

@@ -1,450 +1,248 @@
# 快捷输入格式规则 v3.0
# 快捷输入格式规则 v4.0(优化版)
> 支持更灵活的输入方式,适应课后快速记录场景
> 核心理念:**说人话就行**AI自动理解语境、补充细节、规整格式
>
> 本次优化:新增速记符号系统、标记驱动处理、会话上下文记忆
---
## 🎯 输入原则(新版)
## 🎯 黄金法则
**极简输入AI智能理解**
- 教师只需提供**关键词**和**关键事实**
- AI自动理解语境、补充细节、规整格式
- 支持**口语化、碎片化、无序化**输入
- 接受**语音转文字、手写速记、随手记录**
- **自动纠正谐音姓名**(如"良心桥"→"梁昕乔"
1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充
**核心目标**让教师以最自然的方式记录AI负责后续整理
**支持**口语化、碎片化、无序化、语音转文字
---
## 🔊 语音输入特别说明
## ⚡ 速记符号系统(新增)
### 谐音姓名自动纠正
### 行为速记
**问题**:语音输入时姓名可能被识别为谐音
- "梁昕乔" → "良心桥"、"亮新巧"
- "钟昀昊" → "中云浩"、"钟运好"
- "张宇" → "章鱼"、"张瑜"
| 速记 | 全称 | 使用场景 |
|------|------|----------|
| `gj` | 观望 | `gj5` = 观望5分钟 |
| `zd` | 主动 | `zd3` = 主动搭3层 |
| `zt` | 自己调整 | 球卡住时自己调整 |
| `wb` | 完成 | 独立完成搭建 |
| `mr` | 融入 | 融入小组活动 |
| `zx` | 专注 | 专注完成任务 |
| `sb` | 失败→调整 | 失败后调整再尝试 |
**解决**AI自动匹配班级学生名单进行纠正
- 高相似度(>90%):自动纠正,不打扰
- 中相似度70-90%):生成前提示确认
- 低相似度(<70%):要求重新输入
### 情绪速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
| `~` / `bd` | 波动 | 情绪~ 或 bd |
### 对比速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `++` / `!` | 比上周进步 | 比上周++ |
| `=` / `0` | 和之前一样 | 和之前= |
| `--` / `?` | 需关注 | 需-- |
| `new` | 新学生/首次 | 标记首次上课 |
### 速记组合示例
**示例**
```
教师语音输入:"良心桥今天搭了三层"
AI处理
1. 识别疑似姓名"良心桥"
2. 匹配班级名单梁昕乔相似度100%
3. 自动纠正为"梁昕乔"
4. 查询画像小名:"乔乔"
5. 课评输出:"乔乔今天搭了三层..."
输入: 乔乔gj5→zd3→zt ↑++
展开: 乔乔观望5分钟后主动搭3层自己调整开心比上周进步
输入: 昊昊慢热→zd3→反复调 →
展开: 昊昊慢热主动搭3层反复调整情绪稳定
输入: 小强:频换玩法 wb↓--
展开: 小强频繁换玩法,未完成,情绪烦躁,需关注
```
---
## ✨ 支持的输入方式
## 🏷️ 标记驱动处理(新增)
### 方式1极简一句话最自由
**使用标记快速指定学生类型,无需中断流程**
**特点**任意格式AI自动解析
| 标记 | 含义 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
| `[补课]` | 补课学生 | 询问是否建档 | 先班级汇总 |
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总(标记体验) |
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总(标记缺课) |
| `[new]` | 新学生首次 | 创建档案 | 双轨保存 |
### 标记使用示例
**示例1**:口语化
```
小明今天开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
批量输入示例:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
李小红[补课]:专注完成,稳定
```
**示例2**碎片化
**AI自动处理**
- 乔乔、昊昊:双轨保存
- 张小明[体验]:仅保存到班级汇总,不询问
- 李小红[补课]:生成后询问是否建档
---
## ✨ 自然语言输入(推荐)
### 方式1极简一句话
```
梁昕乔 快速启动 搭3层 自己加装饰 情绪好 创意突出
乔乔今天开始不敢碰,后来主动搭了三层,球卡住自己调高度,挺稳定的,比上周主动多了
昊昊还是老样子慢热型观察了5分钟才开始不过后来搭得挺稳的反复调整了几遍
```
**示例3**:无序关键词
### 方式2关键词速记
```
观望5分钟主动尝试自己调整情绪稳定比上周好小明
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
小强:频换玩法 wb↓--
```
**示例4**:语音转文字风格
### 方式3会话上下文新增
**首次指定班级后,后续无需重复**
```
呃...钟昀昊啊,今天上课啊,就是慢热,观察了一会儿才开始,然后搭了三层,反复调整,情绪挺稳定的
/课评 班级:发现世界-周四19点 # 只需一次
# 后续直接输入学生表现
乔乔搭3层开心
昊昊:慢热,稳定
```
---
### 方式2自然对话式推荐
## 🔊 语音输入优化
**特点**:像和同事聊天一样描述
### 谐音自动纠正
AI自动匹配班级学生名单实时纠正
- "良心桥" → "梁昕乔"
- "中云浩" → "钟昀昊"
- "李一同" → "李怡瞳"
### 语音速记混合
**示例**
```
今天梁昕乔表现挺好的一上课就进入状态了搭了3层还自己加了装饰情绪很开心和之前一样主动
语音输入:"呃...乔乔啊...观望了5分钟...主动搭3层...自己调整...开心"
钟昀昊呢还是老样子慢热型观察了5分钟才开始不过后来搭得挺稳的反复调整了几遍最后完成了
```
**AI自动识别**
- 学生姓名(梁昕乔、钟昀昊)
- 关键行为快速启动、搭3层、加装饰
- 情绪状态(开心、稳定)
- 对比信息(和之前一样)
---
### 方式3列表速记半结构化
**特点**:无序列表,无需严格格式
**示例1**:简单列表
```
- 小明
- 开始不敢碰管道
- 后来主动搭3层
- 球卡住自己调整
- 情绪稳定
- 比上周进步
```
**示例2**:混合关键词
```
小明观望→主动→3层→调整稳定比上周好
小红全程专注5层+弯管,开心,帮助旁边人
小强:换玩法多,没完成,兴奋转烦躁,需引导
AI解析
学生:乔乔(匹配小名)
行为gj5→zd3→zt
情绪:↑
```
---
### 方式4表格简化版批量
## 📊 批量输入格式
**特点**:极简表格,不要求对齐
### 列表式(推荐)
**示例**
```
小明 观望5分钟 搭3层 自己调 稳定 比上周好
小红 全程专注 5层加弯管 开心 帮助人
小强 换玩法 没完成 烦躁 需引导
豆豆 独自玩球 没搭 开心 社交需引导
课程DISC-007
班级:发现世界-周四19点
1. 乔乔gj5→zd3→zt ↑++
2. 昊昊慢热→zd3→反复调 →
3. 张小明[体验]搭3层开心
4. 李小红[补课]:专注完成,稳定
```
**AI自动转换**为规整表格
### 简化表格式
---
### 方式5分段描述详细
**特点**:按时间/环节分段,自由描述
**示例**
```
【小明】
导入阶段:坐着看其他小朋友玩
探索阶段第6分钟开始尝试
搭建阶段能搭3层直管
调整阶段:球卡住自己调高度
情绪:整体稳定
亮点:比上周主动多了
乔乔 gj5→zd3→zt ↑ ++
昊昊 慢热→zd3→反复调 → 渐入佳境
小明[体验] 搭3层 ↑ 积极参与
```
---
### 方式6极简符号速记专业用户
**特点**:用符号快速编码
**符号对照**
```
→ 表示行为发展/时间线
+ 表示正面/进步
- 表示需关注/问题
↑ 表示情绪积极
↓ 表示情绪消极
? 表示疑问/不确定
! 表示亮点/惊喜
```
**示例**
```
小明观望5m → 主动3层 → 自调 ↑ + 比上周!
小红:专注全程 → 5层+弯管 ↑↑ + 助人!
小强:频换玩法 → 未完成 ↓ 需引导
```
---
## 🔍 AI智能解析规则
### 自动识别要素
| 要素 | AI识别方式 | 示例 |
|------|-----------|------|
| **学生姓名** | 首词/大写/冒号前 | "小明"、"梁昕乔" |
| **关键行为** | 动词+数量/结果 | "搭3层"、"自己调" |
| **情绪状态** | 情绪词/表情描述 | "开心"、"稳定"、"烦躁" |
| **对比信息** | 时间词+比较 | "比上周"、"和之前" |
| **课程信息** | 上下文/历史记录 | 自动推断 |
### 模糊匹配
**行为词模糊匹配**
| 教师输入 | AI理解 | 标准输出 |
|---------|-------|---------|
| 不敢碰/不敢动/犹豫 | 观望型 | "开始有些犹豫" |
| 主动/积极/马上 | 主动型 | "主动尝试" |
| 自己弄/自己搞/自己调 | 自主解决 | "自己调整" |
| 搭了3层/做了三层/堆了3个 | 完成3层 | "搭了3层" |
**情绪词模糊匹配**
| 教师输入 | AI理解 |
|---------|-------|
| 开心/高兴/笑/兴奋 | 积极情绪 |
| 稳定/平静/正常 | 平稳情绪 |
| 低落/不开心/烦躁 | 消极情绪 |
| 先好后差/开始可以后来不行 | 情绪波动 |
---
## 💡 输入优化建议
### 最少有效信息
只需提供:
1. **学生姓名**(必须)
2. **一个关键行为**(必须)
AI会自动
- 匹配课程信息
- 推断情绪状态
- 对比历史表现
- 生成完整课评
**极简示例**
```
小明主动搭了3层
```
AI输出
```
小明今天学习了互锁结构能主动尝试并搭了3层...
[基于画像的完整课评]
```
### 推荐信息量
| 场景 | 建议输入 | 效果 |
|------|---------|------|
| **最省时间** | 姓名+1个行为 | 自动生成 |
| **常规记录** | 姓名+2-3个行为+情绪 | 个性化强 |
| **重点关注** | 姓名+详细表现+对比 | 深度定制 |
---
## 🚫 不推荐的输入方式
虽然系统会尽力理解,但以下方式可能影响质量:
| 不推荐 | 原因 | 建议替代 |
|-------|------|---------|
| 纯数字代码 | 无上下文 | 加姓名或关键词 |
| 过于省略 | 信息不足 | 至少一个行为 |
| 完全乱序 | 难以解析 | 大致按时间顺序 |
| 错别字过多 | 理解困难 | 常用拼音即可 |
---
## 🔄 输入示例大全
### 示例1口语化输入(推荐)
### 示例1极简速记
**教师输入**
```
呃,小明啊,今天上课一开始不敢碰,就坐着看,后来我看他开始动了,搭了大概三层吧,然后那个球卡住了,他就自己调了一下高度,情绪还挺稳定的,比上周好一些,上周是完全不敢碰的
输入乔乔gj5→zd3→zt ↑++
AI解析
学生:乔乔(小名)
行为观望5分钟→主动搭3层→自己调整
情绪:开心
对比:比上周进步
```
**AI解析结果**
- 学生:小明
- 行为观望→主动搭3层→自己调整
- 情绪:稳定
- 对比:比上周进步(上周完全不敢碰)
### 示例2语音风格
---
### 示例2碎片化输入
**教师输入**
```
梁昕乔 快速启动 3层 加装饰 开心 和之前一样
输入:呃,昊昊啊,今天上课啊,就是慢热,观察了一会儿才开始,然后搭了三层,反复调整,情绪挺稳定的
AI解析
学生:昊昊
行为观望→搭3层→反复调整
情绪:稳定
```
**AI解析结果**
- 学生:梁昕乔
- 行为快速启动→搭3层→加装饰
- 情绪:开心
- 对比:和之前一样
### 示例3批量混合标记
---
### 示例3无序关键词
**教师输入**
```
稳定自己调整观望5分钟主动尝试比上周好小明
```
输入:
周四19点 DISC-007
**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]
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
```
---
## 🎯 与旧版对比
| 维度 | 旧版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
教师输入 → AI解析 → 预加载档案 → 生成课评 → 自动保存班级汇总 → 展示给教师
教师确认/修改 ← 一键发送 ← 自动保存个人档案 ← 教师点击发送
```
### 使用场景
### 自动保存规则
- **班级周汇总**:周回顾、备课参考、批量发送家长群
- **个人历史课评**:一对一家长沟通、学期总结、成长档案
| 学生类型 | 班级周汇总 | 个人档案 | 教师操作 |
|----------|-----------|----------|----------|
| 正式学生 | ✅ 自动保存 | ✅ 确认后保存 | 查看→发送 |
| [补课] | ✅ 自动保存 | ❓ 询问后决定 | 查看→选择→发送 |
| [体验] | ✅ 自动保存(标记) | ❌ 不保存 | 查看→发送 |
| [缺课] | ✅ 记录缺席 | ❌ 不生成 | 无 |
---
## 📞 常见问题
### Q我写得乱AI能懂吗
**A**只要包含姓名和关键行为AI会自动理解并规整
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。速记是给熟练用户的可选提速方式
### Q语音转文字很多错别字怎么办
**A**没关系AI能根据上下文推断。关键是发音清晰的动词和名词
**Q忘记打标记怎么办**
AAI会检测档案自动判断。有档案=正式学生,无档案=提示选择[补课]/[体验]
### Q忘记写课程信息怎么办
**A**AI会从历史记录或上下文中自动推断
**Q标记可以组合吗**
A可以`张小明[体验][new]`表示体验课新学生
### Q批量输入需要严格对齐吗
**A**不需要用空格或制表符分隔即可AI会自动整理
### Q补课/体验学生怎么处理?
**A**:详见 [33-first-class-rules.md](33-first-class-rules.md) 新学生与补课学生处理规则。
### Q体验课学生不想建档怎么办
**A**:直接回复「跳过」或「仅保存到班级汇总」。课评会保存在 `class-evaluation-summary/第X周/{班级}.md` 中,标记为体验学生,不影响后续正式学员的档案管理。
**Q上下文记忆持续多久**
A一次会话内有效。换班级时重新指定即可
---
@@ -452,12 +250,10 @@ AI输出
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| v3.2 | 2026-04-16 | **新增补课/体验学生处理说明**:说明无档案学生的检测、提醒和可选保存方式 |
| v3.1 | 2026-04-15 | **新增双轨存储说明**:确认后同时保存到班级周汇总和个人历史课评,便于集中查看和追踪成长 |
| **v4.0** | **2026-04-19** | **优化版**:新增速记符号系统、标记驱动处理、会话上下文记忆 |
| v3.2 | 2026-04-16 | 新增补课/体验学生处理说明 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性,支持任意自然语言输入 |
| v2.0 | 2026-03-26 | 新增单个/批量生成方式 |
| v1.0 | 2026-03-25 | 初始版本5种固定格式 |
---
*新版本核心理念用最自然的方式记录让AI处理格式*
*核心理念用最自然的方式记录让AI处理格式*