xiaoq/ClassFeedback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
- 新增36-shorthand-learning.md：速记符号阶梯学习指南
- 新增37-status-panel.md：课评状态管理面板
- 新增38-quick-edit.md：快速编辑功能规则
- 更新40-keping-快速入门.md：优化快速入门指南v3.0
- 新增CHANGELOG.md：版本变更日志
- 更新第7周、第8周班级汇总文件
- 规范化学生档案存储
- 完善补课/体验学生处理逻辑
This commit is contained in:
小Q
2026-04-25 20:56:12 +08:00
parent 4810387dab
commit dcf1049b92
60 changed files with 2391 additions and 1569 deletions
Download Patch File Download Diff File Expand all files Collapse all files

152
.claude/rules/32-batch-generation.md
View File

@@ -6,7 +6,7 @@
---
## 🚀 批量生成流程（优化后）
## 🚀 批量生成流程
```
输入表格 → AI并行解析每个学生 → 预加载课程/档案 →
@@ -14,13 +14,7 @@
批量展示 → 教师一键确认 → 自动双轨保存
```
### 效率对比
| 环节 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 生成方式 | 顺序生成 | 并行生成 | 速度↑ |
| 确认次数 | 每人1次 | 批量1次 | 效率↑↑ |
| 保存操作 | 手动双轨 | 自动保存 | 便捷↑ |
> **核心优势**：8人课评从15-20分钟缩短至**3-5分钟**（效率提升75%）
---
@@ -80,22 +74,14 @@ DISC-007 发现世界-周四19点
✅ 张小明[体验] 192字 体验学生
✅ 李小红[补课] 201字 补课学生
【档案状态】
✓ 乔乔：有档案 → 双轨保存
✓ 昊昊：有档案 → 双轨保存
⚠ 张小明[体验]：仅班级汇总
⚠ 李小红[补课]：询问是否建档
【批量操作】
[全部发送] [逐个查看] [标记修改] [取消]
━━━━━━━━━━━━━━━━━━━━━━━
```
### 智能分级确认（新增）
**自动通过条件**（同时满足）：
- ✅ 学生有完整档案
- ✅ 字数180-220字范围内
- ✅ 字数在弹性范围内
- ✅ 无敏感词/异常表述
- ✅ 情绪描述合理
@@ -108,35 +94,16 @@ DISC-007 发现世界-周四19点
---
## 🔍 自动质量检查（新增）
## 🔍 自动质量检查
### 检查维度
```
━━━━━━━━━━━━━━━━━━━━━━━
🔍 质量检查报告
━━━━━━━━━━━━━━━━━━━━━━━
✅ 字数检查
全部符合180-220字范围
⚠️ 重复检查
3份课评开头都使用了"今天"
建议差异化：
- 乔乔→"很高兴看到乔乔..."
- 昊昊→"昊昊今天一如既往..."
- 小强→"这节课小强..."
✅ 差异化检查
5份课评侧重点各不相同
⚠️ 待关注项
小强：情绪从"兴奋"转为"烦躁"
建议：课评中增加情绪引导建议
[一键优化] [忽略继续] [查看详情]
━━━━━━━━━━━━━━━━━━━━━━━
```
| 检查项 | 描述 |
|--------|------|
| 字数检查 | 是否符合弹性范围（180-350字） |
| 重复检查 | 开头句式是否差异化 |
| 差异化检查 | 各课评侧重点是否不同 |
| 待关注项 | 特殊情绪/行为标记 |
### 差异化策略
@@ -152,64 +119,51 @@ DISC-007 发现世界-周四19点
**2. 侧重点差异化**
```
同一节课：DISC-007 旋转飞机
乔乔（谨慎型）→ 侧重：参与度和勇气
"今天能主动尝试侧面连接结构..."
昊昊（熟练型）→ 侧重：创意和拓展
"不仅完成基础旋转结构，还自己设计了..."
小强（困难型）→ 侧重：过程价值
"虽然最后没有完成作品，但前15分钟的探索..."
```
同一节课，不同学生类型侧重不同：
- **谨慎型** → 参与度和勇气
- **熟练型** → 创意和拓展
- **困难型** → 过程价值
**3. 建议差异化**
```
乔乔（参与少）：在家可以用纸筒做简单旋转玩具
昊昊（能力强）：可以尝试用不同材料做对比实验
小强（坚持短）：可以从5分钟小目标开始练习专注
```
根据学生能力推荐不同课后活动：
- **参与少**：在家可以用纸筒做简单旋转玩具
- **能力强**：可以尝试用不同材料做对比实验
- **坚持短**：可以从5分钟小目标开始练习专注
---
## 📦 存储流程（优化后）
### 自动保存机制
```
生成课评 → 自动保存到班级周汇总（待确认状态）
↓
教师确认 → 自动双轨保存 → 发送家长
↓
┌─────────┴─────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
(标记已确认) (追加新记录)
```
### 存储路径
| 位置 | 路径 | 说明 |
|------|------|------|
| 班级周汇总 | `memory/class-evaluation-summary/第7周/发现世界-周四19点.md` | 全班汇总，含确认状态 |
| 班级周汇总 | `memory/class-evaluation-summary/第X周/{班级}.md` | 全班汇总，含确认状态 |
| 个人档案 | `memory/student/{班级}/{学生}/历史课评记录.md` | 个人完整轨迹 |
> 完整存储规则和学生类型处理详见 [CLAUDE.md](../../CLAUDE.md) 和 [33-first-class-rules.md](33-first-class-rules.md)
---
## 🏷️ 特殊情况批量处理
### 标记速查
| 标记 | 处理方式 | 保存位置 |
|------|----------|----------|
| `[补课]` | 生成后询问是否建档 | 班级汇总+（可选）个人档案 |
| 标记 | 处理逻辑 | 保存位置 |
|------|---------|---------|
| `[补课]` | **检查当前班级档案** → 存在则双轨，不存在则询问 | 班级汇总+（可选）个人档案 |
| `[体验]` | 仅班级汇总，不询问 | 仅班级汇总（标记体验） |
| `[缺课]` | 记录缺席，不生成课评 | 班级汇总（标记缺课） |
| `[new]` | 创建新档案，双轨保存 | 班级汇总+个人档案 |
**[补课]处理详细逻辑**：
1. 检查 `memory/student/{当前班级}/{学生名}/`
2. 如存在 → 该学生为本班补课 → 双轨保存
3. 如不存在 → 可能为其他班级补课 → 询问处理方式
- [1] 其他老师班级学生 → 仅班级汇总
- [2] 新转班学生 → 创建档案
### 批量处理示例
```
@@ -223,9 +177,9 @@ DISC-007 发现世界-周四19点
5. 王大力[缺课]
AI处理：
✓ 乔乔、昊昊：正常生成，双轨保存
⚠ 张小明[体验]：生成标记为"体验学生"
⚠ 李小红[补课]：生成后询问"是否为李小红创建档案？"
✓ 乔乔、昊昊：正常生成，双轨保存（正式学生）
⚠ 张小明[体验]：生成标记为"体验学生"，仅班级汇总
⚠ 李小红[补课]：检查档案 → 存在则双轨，不存在则询问
✓ 王大力[缺课]：记录"王大力：缺课"，不生成课评
```
@@ -243,49 +197,27 @@ AI处理：
昊昊：慢热
```
### 2. 快捷键输入（设想）
### 2. 语音批量录入
```
输入模板：
gj# = 观望#分钟
zd# = 主动搭#层
zt = 自己调整
示例：
输入：乔乔：gj5zd3zt↑
识别：乔乔观望5分钟后主动搭3层，自己调整，开心
```
### 3. 语音批量录入
```
语音："乔乔观望5分钟主动搭3层开心...
昊昊慢热搭3层稳定...
张小明体验课搭3层开心"
AI自动分段生成5份课评
```
语音输入多学生表现，AI自动分段生成课评。
---
## 📊 批量生成检查清单
### 生成前检查
- [ ] 班级信息正确（或已在上下文中）
- [ ] 学生姓名无遗漏
- [ ] 标记使用正确（[补课]/[体验]/[缺课]）
### 生成后检查
- [ ] 全部学生课评已生成
- [ ] 字数符合要求（180-220字）
- [ ] 字数符合弹性范围
- [ ] 开头句式差异化
- [ ] 建议内容个性化
- [ ] 特殊学生已标记
### 发送前检查
- [ ] 内容准确无误
- [ ] 称呼正确（小名/去姓）
- [ ] 补课/体验学生处理完毕
@@ -323,14 +255,4 @@ Step 5: 自动保存并发送
---
## 版本历史
| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| **v2.0** | **2026-04-19** | **优化版**：新增并行生成、智能分级确认、自动质量检查 |
| v1.1 | 2026-04-16 | 新增补课/体验学生批量处理说明 |
| v1.0 | 2026-03-25 | 初始版本 |
---
*核心理念：批量不批量，千人千面不打折*