初始化课评系统仓库:包含规则配置、学生档案、课程教案、班级汇总

This commit is contained in:
qiuyan
2026-05-08 14:15:00 +08:00
commit 16af260a11
300 changed files with 30338 additions and 0 deletions

View File

@@ -0,0 +1,424 @@
# 快捷输入格式规则 v4.0(优化版)
> 核心理念:**说人话就行**AI自动理解语境、补充细节、规整格式
>
> 本次优化:新增速记符号系统、标记驱动处理、会话上下文记忆
---
## 🎯 黄金法则
1. **有姓名** → AI知道是谁
2. **有行为** → AI知道做了什么
3. **其他随意** → AI自动补充
**支持**:口语化、碎片化、无序化、语音转文字
---
## ⚡ 速记符号系统(新增)
### 行为速记
| 速记 | 全称 | 使用场景 | 示例 |
|------|------|----------|------|
| `gj` | 观望 | `gj5` = 观望5分钟 | gj3→zd |
| `zd` | 主动 | `zd3` = 主动搭3层 | zd2→wb |
| `zt` | 自己调整 | 球卡住时自己调整 | zd→zt |
| `wb` | 完成 | 独立完成搭建 | zx→wb |
| `mr` | 融入 | 融入小组活动 | mr→hz |
| `zx` | 专注 | 专注完成任务 | zx15专注15分钟 |
| `sb` | 失败→调整 | 失败后调整再尝试 | sb2失败2次后成功 |
| `ts` | 探索 | 主动探索新玩法 | ts5探索5分钟 |
| `cz` | 创造 | 创造性搭建/设计 | cz33种创意方案 |
| `wt` | 提问 | 主动提问 | wt3提问3次 |
| `hz` | 合作 | 与同伴合作 | hz→完成 |
| `fx` | 分享 | 分享想法/作品 | fx→kx |
| `ms` | 模仿 | 模仿老师/同学 | ms→zt模仿后自己调整 |
| `tq` | 求助 | 主动求助老师 | tq→zd求助后主动尝试 |
### 情绪速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `↑` / `kx` | 开心/积极 | 情绪↑ 或 kx |
| `→` / `wd` | 稳定/平和 | 情绪→ 或 wd |
| `↓` / `fd` | 烦躁/低落 | 情绪↓ 或 fd |
| `~` / `bd` | 波动 | 情绪~ 或 bd |
| `↑↑` / `kc` | 非常开心/兴奋 | 发现新玩法时↑↑ |
| `→→` / `wa` | 非常稳定/沉浸 | 全程→→ |
| `gd` | 孤独/独自玩 | 偏好gd |
| `jl` | 焦虑/紧张 | 新主题时jl |
### 社交互动速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `hz` | 合作 | hz完成合作完成 |
| `fx` | 分享 | fx想法分享想法 |
| `jy` | 建议给同伴 | jy→接受 |
| `bd` | 被带动 | bd→参与 |
| `zl` | 孤立/独自 | zl→专注 |
| `cq` | 冲突/争执 | cq→解决 |
### 编程/技术速记适合SPIKE/AI03
| 速记 | 全称 | 使用场景 | 示例 |
|------|------|----------|------|
| `bc` | 编程 | 编写程序 | bc→ts编程后调试 |
| `ts` | 调试 | 测试并调整 | ts3调试3次 |
| `cx` | 创新/优化 | 改进原有方案 | cx→效果更好 |
| `fx` | 分析 | 分析问题 | fx→解决 |
| `cw` | 错误/bug | 发现错误 | cw→fx→修正 |
| `sy` | 实验 | 尝试不同方案 | sy3实验3种方案 |
### 对比速记
| 速记 | 含义 | 示例 |
|------|------|------|
| `++` / `!` | 比上周进步 | 比上周++ |
| `=` / `0` | 和之前一样 | 和之前= |
| `--` / `?` | 需关注 | 需-- |
| `new` | 新学生/首次 | 标记首次上课 |
| `↑+` | 情绪好转 | 从↓到→到↑+ |
| `↓-` | 状态下滑 | 本周↓- |
### 速记组合示例
**基础组合**
```
输入: 乔乔gj5→zd3→zt ↑++
展开: 乔乔观望5分钟后主动搭3层自己调整开心比上周进步
输入: 昊昊慢热→zd3→反复调 →
展开: 昊昊慢热主动搭3层反复调整情绪稳定
输入: 小强:频换玩法 wb↓--
展开: 小强频繁换玩法,未完成,情绪烦躁,需关注
```
**扩展组合(新增)**
```
输入: 丞丞ts5→cz2→wt3 ↑↑
展开: 丞丞探索5分钟创造了2种方案主动提问3次非常兴奋
输入: 一栩bc→ts3→cx ↑+
展开: 一栩编程后调试3次然后优化了方案情绪好转
输入: 小鱼gj3→tq→zd→wb →
展开: 小鱼观望3分钟求助老师后主动尝试最终完成情绪稳定
输入: 昊昊hz→jy→fx想法 ↑
展开: 昊昊与同伴合作,给同伴建议,分享自己的想法,开心
输入: 佳兴zx20→cz3→fx作品 ↑↑
展开: 佳兴专注20分钟创造了3种设计分享作品非常开心
```
### 速记与自然语言混用规则
**优先级**:速记符号 > 自然语言描述
| 场景 | 示例 | 处理方式 |
|------|------|---------|
| 无冲突 | `gj5→主动搭3层` | 正常解析 |
| 时间冲突 | `gj5→观望了一会儿` | 以 `gj5`5分钟为准「观望了一会儿」作为补充描述 |
| 行为冲突 | `zd3→搭了5层` | 以 `zd3`3层为准数值冲突时提示确认 |
| 顺序标记 | `gj5→zd3→观望了很久` | 速记按序解析,自然语言作为过程描述填充到对应节点 |
**解析流程**
```
1. 提取所有速记符号
2. 按→顺序排列行为序列
3. 自然语言作为过程描述填充到对应节点
4. 冲突时以速记数值为准
```
**示例**
```
输入乔乔gj5→观望了一会儿→zd3→搭了挺高
解析结果:
- 行为序列观望5分钟 → 主动搭3层
- 过程描述「观望了一会儿」补充gj5「搭了挺高」补充zd3
- 输出乔乔观望了5分钟一会儿然后主动搭了3层挺高的结构
```
**冲突警告**:当速记与自然语言数值差异明显时(如`zd3→搭了8层`),提示确认:
```
⚠️ 数值差异提醒
速记zd3主动搭3层
描述:"搭了8层"
是否以速记为准?[是] [以描述为准8层] [手动修改]
```
---
## 🏷️ 标记驱动处理(新增)
**使用标记快速指定学生类型,无需中断流程**
| 标记 | 含义 | 处理方式 | 保存位置 |
|------|------|----------|----------|
| 无标记 | 正式学生 | 双轨保存 | 班级汇总+个人档案 |
| `[补课]` | 补课学生 | 自动检测档案位置,跨班级自动双轨保存 | 班级汇总+个人档案(含跨班级自动保存)|
| `[体验]` | 体验课学生 | 仅班级汇总 | 班级汇总(标记体验) |
| `[缺课]` | 今天缺席 | 记录缺席 | 班级汇总(标记缺课) |
| `[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层→反复调整
情绪:稳定
输出字数约200字精简版
```
### 示例3详细输入 → 详细输出
```
输入乔乔今天开始观望了5分钟后来主动搭了3层管道球卡住的时候自己调整高度还帮助旁边的小朋友一起搭最后完成作品特别开心说这是她最喜欢的作品。比上周主动多了上周观望了10分钟才开始。
AI解析
学生:乔乔
行为观望5分钟→主动搭3层→自己调整→帮助同伴
情绪:开心(特别开心)
对比比上周进步上周观望10分钟
亮点:主动帮助同伴、表达情感、纵向对比明显
输出字数约280字详细版
```
---
## 📏 课评字数弹性规则
### 核心理念
**输入越丰富 → 课评越详细**
课评字数不再固定为200字而是根据你输入的内容丰富度自动调整
| 输入类型 | 示例 | 输出字数 | 说明 |
|---------|------|---------|------|
| **精简输入** | "搭了3层开心" | 180-220字 | 基础描述,简洁明了 |
| **标准输入** | "观望5分钟后主动搭3层自己调整还帮助同伴" | 220-280字 | 有具体细节或亮点,充分展现 |
| **详细输入** | "观望5分钟→主动搭3层→自己调整→帮助同伴→说这是最喜欢的作品→比上周主动多了" | 280-350字 | 精彩瞬间多,全面记录 |
### 给教师的建议
1. **简单记录 → 简洁课评**
- 适合:常规课堂、表现平稳
- 输入:简要描述行为即可
2. **详细描述 → 丰富课评**
- 适合:有亮点、有突破、有情感瞬间
- 输入尽可能多描述细节AI会充分展开
3. **不用担心字数**
- 描述得多 ≠ 啰嗦
- AI会智能整合保持可读性
- 家长更喜欢看到孩子具体的成长瞬间
---
### 示例4批量混合标记
```
输入:
周四19点 DISC-007
乔乔gj5→zd3→zt ↑++
昊昊慢热→zd3→反复调 →
张小明[体验]搭了3层开心
```
---
## 📦 存储规则
存储流程和学生类型处理规则详见 [CLAUDE.md 存储双轨制](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)。
**简要说明**
- 正式学生:双轨保存(班级汇总 + 个人档案)
- `[补课]`学生:
- 当前班级档案存在 → 双轨保存(本班补课)
- 其他班级档案存在 → **自动跨班级双轨保存**(无需询问)
- 任何班级都不存在 → 询问处理方式
- `[体验]`学生:仅班级汇总
- `[缺课]`学生:仅记录缺席
### 跨班级补课说明
**场景**学生档案在A班如"发现世界-周四19点"来B班如"发现世界-周六09点")补课
**自动处理方式**
- **检测到跨班级补课** → **自动双轨保存**
- ✅ 课评保存到B班补课班级的周汇总
- ✅ 课评追加到A班原班级的个人历史课评记录.md标注"【跨班级补课】本节课程在B班完成"
- **无需询问,自动完成**
**手动调整**(如需改变默认行为):
- 输入 `仅班级汇总 {学生名}` → 仅保存到补课班级,不追加到原档案
- 输入 `创建新档案 {学生名}` → 在补课班级创建新档案,原档案保留
### ⚠️ 重要:课评正文禁止提及补课
**无论学生是否标记为`[补课]`,课评正文中绝对不能提及补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课(如"今天特别来参加"、"临时加入"、"从其他班级过来"等)
- ❌ 禁止在课评正文中区分"本班学生"和"补课学生"
**正确处理**
-`[补课]`标记**仅用于后台档案管理**,课评正文**完全按正常学生**撰写
- ✅ 课评开头直接写"XX本节课学习了..."**不加任何特殊说明**
- ✅ 补课信息仅保存在班级汇总元数据中,不进入课评正文
**示例**
```
教师输入:李小红[补课]搭了3层专注完成
课评输出(正确):
小红本节课学习了"旋转飞机",认识了游乐园旋转设施的中心轴结构...
课评输出(错误):
小红本节课作为补课学生,学习了"旋转飞机"... ❌(禁止提及补课)
小红今天来补课,学习了"旋转飞机"... ❌(禁止提及补课)
```
---
## 📞 常见问题
**Q速记符号记不住怎么办**
A不用记直接用自然语言描述AI一样能理解。速记是给熟练用户的可选提速方式。
**Q忘记打标记怎么办**
AAI会检测档案自动判断。有档案=正式学生,无档案=提示选择[补课]/[体验]。
**Q标记可以组合吗**
A可以`张小明[体验][new]`表示体验课新学生。
**Q上下文记忆持续多久**
A一次会话内有效。换班级时重新指定即可。
---
*核心理念用最自然的方式记录让AI处理格式*