优化课评系统：新增速记符号、状态面板、快速编辑功能
- 新增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:
@@ -4,212 +4,30 @@
|
||||
|
||||
---
|
||||
|
||||
## 🎛️ 状态面板设计
|
||||
## 📊 状态类型
|
||||
|
||||
### 面板位置
|
||||
|
||||
在`memory/class-evaluation-summary/第X周/{班级}.md`文件顶部，插入状态管理面板：
|
||||
|
||||
```markdown
|
||||
---
|
||||
|
||||
## 📊 本周课评状态面板
|
||||
|
||||
> 最后更新：{时间} | 当前操作员：{教师名}
|
||||
|
||||
### 快速统计
|
||||
|
||||
| 指标 | 数值 | 状态 |
|
||||
|------|:----:|:----:|
|
||||
| 应到人数 | {X}人 | - |
|
||||
| **实到人数** | **{Y}人** | ✅ |
|
||||
| 已确认 | {Z}人 | ☑️ |
|
||||
| 待确认 | {W}人 | ⏳ |
|
||||
| 待生成 | {V}人 | ⏸️ |
|
||||
| 缺勤 | {U}人 | 🚫 |
|
||||
| **课评完成率** | **{XX}%** | {进度条} |
|
||||
|
||||
### 操作快捷入口
|
||||
|
||||
| 操作 | 指令 | 说明 |
|
||||
|------|------|------|
|
||||
| 一键确认全部 | `[确认全部]` | 确认所有待确认课评 |
|
||||
| 查看待确认 | `[查看待确认]` | 只显示待确认学生 |
|
||||
| 生成缺勤 | `[标记缺勤]` | 为未到学生记录缺勤 |
|
||||
| 更新状态 | `[刷新]` | 重新计算统计数据 |
|
||||
|
||||
---
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 学生状态明细表
|
||||
|
||||
在学生列表部分，使用交互式状态表：
|
||||
|
||||
```markdown
|
||||
### 学生状态明细
|
||||
|
||||
| 序号 | 学生 | 状态 | 生成时间 | 确认时间 | 操作 |
|
||||
|:----:|:-----|:----:|:--------:|:--------:|:----:|
|
||||
| 1 | 乔乔 | ☑️ 已确认 | 16:00 | 16:05 | [查看] [修改] |
|
||||
| 2 | 昊昊 | ⏳ 待确认 | 16:02 | - | [确认] [修改] [删除] |
|
||||
| 3 | 小明 | ⏸️ 待生成 | - | - | [输入表现] [标记缺勤] |
|
||||
| 4 | 小红 | 🚫 缺勤 | - | - | [补录] |
|
||||
|
||||
**图例**：
|
||||
- ☑️ 已确认 - 已审核通过，已双轨保存
|
||||
- ⏳ 待确认 - 已生成，等待教师确认
|
||||
- ⏸️ 待生成 - 教师未输入表现
|
||||
- 🚫 缺勤 - 学生未到校
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔔 自动提醒机制
|
||||
|
||||
### 提醒触发条件
|
||||
|
||||
| 场景 | 触发时间 | 提醒内容 |
|
||||
|------|---------|---------|
|
||||
| 批量生成后未确认 | 5分钟后 | "您有{X}份课评待确认" |
|
||||
| 课评生成后1小时 | 1小时后 | "{学生}的课评还未确认，是否遗忘？" |
|
||||
| 当日结束 | 22:00 | "今日有{X}份待确认课评，建议处理" |
|
||||
| 跨周提醒 | 下周一 | "上周有{X}份未确认课评，请尽快处理" |
|
||||
|
||||
### 提醒展示格式
|
||||
|
||||
```
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
⏰ 课评状态提醒
|
||||
|
||||
您当前有 3份课评待确认：
|
||||
|
||||
1. 昊昊（发现世界-周四19点）- 生成于16:02
|
||||
2. 小明（发现世界-周四19点）- 生成于16:05
|
||||
3. 小红（Wedo-周六1030）- 生成于昨天
|
||||
|
||||
[一键全部确认] [查看详情] [忽略]
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
```
|
||||
| 状态 | 图标 | 说明 |
|
||||
|:----:|:----:|:-----|
|
||||
| 已确认 | ☑️ | 已审核通过，已双轨保存 |
|
||||
| 待确认 | ⏳ | 已生成，等待教师确认 |
|
||||
| 待生成 | ⏸️ | 教师未输入表现 |
|
||||
| 缺勤 | 🚫 | 学生未到校 |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 状态流转规则
|
||||
|
||||
### 状态流转图
|
||||
|
||||
```
|
||||
教师输入表现
|
||||
↓
|
||||
┌───────────────┐
|
||||
标记缺勤 →│ 待生成 │← 取消缺勤
|
||||
└───────┬───────┘
|
||||
↓ AI生成课评
|
||||
┌───────────────┐
|
||||
教师确认 →│ 待确认 │← 教师修改
|
||||
└───────┬───────┘
|
||||
↓ 教师确认
|
||||
┌───────────────┐
|
||||
│ 已确认 │
|
||||
└───────┬───────┘
|
||||
↓ 自动双轨保存
|
||||
┌───────────────┐
|
||||
查看/修改 →│ 已保存 │
|
||||
└───────────────┘
|
||||
```
|
||||
|
||||
### 操作指令对照表
|
||||
|
||||
| 当前状态 | 教师操作 | 新状态 | 效果 |
|
||||
|:--------:|---------|:------:|:-----|
|
||||
| 待生成 | 输入表现 | 待确认 | 生成课评 |
|
||||
| 待生成 | 标记缺勤 | 缺勤 | 记录缺勤 |
|
||||
| 待确认 | 回复"确认" | 已确认 | 双轨保存 |
|
||||
| 待确认 | 回复"修改：XXX" | 待确认 | 重新生成 |
|
||||
| 待确认 | 点击[确认] | 已确认 | 双轨保存 |
|
||||
| 已确认 | 回复"修改：XXX" | 已确认 | 更新内容 |
|
||||
| 缺勤 | 补录表现 | 待确认 | 生成课评 |
|
||||
|
||||
---
|
||||
|
||||
## 📱 快速操作示例
|
||||
|
||||
### 场景1：一键确认全部
|
||||
|
||||
```
|
||||
教师：确认全部
|
||||
|
||||
AI：
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
✅ 已确认 3份课评
|
||||
|
||||
☑️ 昊昊 - 发现世界-周四19点 - DISC-007
|
||||
☑️ 小明 - 发现世界-周四19点 - DISC-007
|
||||
☑️ 小红 - Wedo-周六1030 - CREATE-007
|
||||
|
||||
已自动双轨保存到：
|
||||
- 班级周汇总
|
||||
- 个人历史课评
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
```
|
||||
|
||||
### 场景2：批量查看待确认
|
||||
|
||||
```
|
||||
教师：查看待确认
|
||||
|
||||
AI：
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
⏳ 待确认课评列表（3份）
|
||||
|
||||
【发现世界-周四19点 - DISC-007】
|
||||
1. 昊昊
|
||||
生成时间：16:02
|
||||
字数：205字
|
||||
[确认] [查看] [修改]
|
||||
|
||||
2. 小明
|
||||
生成时间：16:05
|
||||
字数：198字
|
||||
[确认] [查看] [修改]
|
||||
|
||||
【Wedo-周六1030 - CREATE-007】
|
||||
3. 小红
|
||||
生成时间：昨天
|
||||
字数：210字
|
||||
[确认] [查看] [修改]
|
||||
|
||||
[一键全部确认]
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
```
|
||||
|
||||
### 场景3：单个学生快速操作
|
||||
|
||||
```
|
||||
教师：确认昊昊
|
||||
|
||||
AI：
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
☑️ 已确认：昊昊（发现世界-周四19点）
|
||||
|
||||
课评内容预览：
|
||||
"昊昊本节课学习了..."
|
||||
|
||||
已保存到：
|
||||
- 班级周汇总：第7周/发现世界-周四19点.md
|
||||
- 个人档案：student/发现世界-周四19点/昊昊/历史课评记录.md
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
教师输入表现 → 待确认 → 教师确认 → 已确认 → 自动双轨保存
|
||||
↓ ↑
|
||||
标记缺勤 修改后重新生成
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 数据持久化
|
||||
## 📋 班级汇总文件格式
|
||||
|
||||
### 状态存储位置
|
||||
|
||||
状态信息保存在班级汇总文件的YAML Frontmatter中：
|
||||
在`memory/class-evaluation-summary/第X周/{班级}.md`文件顶部添加状态面板：
|
||||
|
||||
```markdown
|
||||
---
|
||||
@@ -225,31 +43,34 @@ status:
|
||||
students:
|
||||
- name: 乔乔
|
||||
status: confirmed
|
||||
generated_at: "16:00"
|
||||
confirmed_at: "16:05"
|
||||
- name: 昊昊
|
||||
status: pending
|
||||
generated_at: "16:02"
|
||||
confirmed_at: null
|
||||
---
|
||||
|
||||
# 发现世界-周四19点 第7周汇总
|
||||
...
|
||||
## 本周课评状态
|
||||
|
||||
| 学生 | 状态 | 操作 |
|
||||
|:-----|:----:|:----:|
|
||||
| 乔乔 | ☑️ 已确认 | [查看] [修改] |
|
||||
| 昊昊 | ⏳ 待确认 | [确认] [修改] |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ 实施检查清单
|
||||
## 🔔 操作指令
|
||||
|
||||
- [ ] 在班级汇总模板中添加状态面板
|
||||
- [ ] 实现"一键确认全部"功能
|
||||
- [ ] 实现"查看待确认"过滤功能
|
||||
- [ ] 配置自动提醒（5分钟、1小时、当日结束）
|
||||
- [ ] 在文件Frontmatter中添加状态元数据
|
||||
- [ ] 测试状态流转是否正常
|
||||
| 教师输入 | 功能 |
|
||||
|:---------|:-----|
|
||||
| `确认全部` | 一键确认所有待确认课评 |
|
||||
| `查看待确认` | 只显示待确认学生 |
|
||||
| `确认{学生}` | 确认单个学生课评 |
|
||||
| `修改{学生}：XXX` | 修改指定学生课评内容 |
|
||||
|
||||
---
|
||||
|
||||
*版本：v1.0*
|
||||
*更新日期：2026-04-19*
|
||||
*配套文件：32-batch-generation.md*
|
||||
## 📊 数据持久化
|
||||
|
||||
状态信息保存在班级汇总文件的YAML Frontmatter中，便于：
|
||||
- 快速统计课评完成情况
|
||||
- 追踪学生课评状态变化
|
||||
- 支持批量操作
|
||||
|
||||
Reference in New Issue
Block a user