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

113
.claude/rules/33-first-class-rules.md
View File

@@ -30,28 +30,77 @@
---
### 规则2：补课学生
### 规则2：补课学生（分两种情况处理）
**定义**：
- 已在机构有档案，但第一次上这节课
- 从其他班级/时段调整到本班上课
**补课学生定义**：
因各种原因（请假、调课等）需要在非原班级时间补课的学生。
**处理规则**：
**⚠️ 重要：补课学生分两类，处理方式不同**
#### 情况A：自己班级的学生补课
- **判断标准**：学生在 `memory/student/{当前班级}/` 目录中存在
- **处理方式**：**正常双轨保存**（班级汇总 + 个人档案）
- **说明**：这是你自己的学生，只是补课，无需额外确认
**示例**：
```
教师输入：乔乔[补课]：搭了3层，开心
AI检测：乔乔在本班级档案中存在 → 按正式学生处理
处理结果：双轨保存
```
#### 情况B：其他老师的学生来补课
- **判断标准**：学生在 `memory/student/{当前班级}/` 目录中**不存在**
- **处理方式**：**先询问再决定**
- **询问内容**：确认是否需要为该学生建档，或仅记录到班级汇总
**询问示例**：
```
⚠️ 未找到「张小明」在本班级的个人档案
该学生标记为[补课]，但不在本班级学生名单中。
可能情况：
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案
[3] 档案路径有误 → 手动指定班级
请选择处理方式：
```
#### 统一规则
- **不要写"第一次上课"相关表述**，即使这是该学生第一次上这节课
- 补课学生**不是新学生**，只是课程调整
- 正常生成课评，按已有档案处理
- 正常生成课评，按已有档案处理（或询问后的选择处理）
#### ⚠️ 重要规则：课评正文禁止提及补课
**绝对禁止**：
- ❌ **课评正文中绝对不能提及学生来补课相关内容**
- ❌ 禁止出现"补课"、"补课上"、"来补课"、"本次补课"等词汇
- ❌ 禁止暗示学生非正常上课（如"今天特别来参加"、"临时加入"等）
**正确处理**：
- ✅ 课评正文**完全按正常学生**撰写，仿佛学生就是本班正常上课的学生
- ✅ `[补课]`标记**仅作为后台参考**，用于档案存储路径判断
- ✅ 补课信息仅保存在班级汇总的元数据中，不进入课评正文
**正确示例**：
```
教师输入：小明（补课）：搭了3层，开心
课评输出：小明今天搭了3层管道，表现很开心...
教师输入：林瀚丞[补课]：积极分析课程任务，专注完成了绿色身体、黑色头部的蜥蜴设计
课评输出（正确）：
瀚丞本节课学习了"蜥蜴"的仿生搭建...（正常撰写，完全不提补课）
课评输出（错误）：
瀚丞本节课作为补课学生，学习了"蜥蜴"... ❌（禁止提及补课）
瀚丞今天来补课，学习了"蜥蜴"... ❌（禁止提及补课）
```
**错误示例**：
```
教师输入：小明（补课）：搭了3层，开心
课评输出：这节课是小明第一次上课... ❌（补课≠新学生）
```
**说明**：
- 家长看到课评时不应知道孩子是补课还是正常上课
- 补课标记仅用于教师内部管理和档案存储
- 保持课评的一致性和专业性
---
@@ -94,24 +143,31 @@
当检测到学生无个人档案时：
### 检测流程
1. AI自动检测 `memory/student/{班级}/{学生名}/` 是否存在
2. 如不存在，提醒教师该学生暂无档案
3. 请教师选择处理方式
1. AI自动检测 `memory/student/{当前班级}/{学生名}/` 是否存在
2. **如存在**：该学生为本班级补课学生 → **正常双轨保存**
3. **如不存在**：可能是其他老师班级学生 → **询问教师处理方式**
### 处理方式
| 场景 | 处理方式 | 存储位置 |
|------|---------|---------|
| 补课学生（有档案在其他班级） | 创建档案或仅保存到班级汇总 | 双轨或仅班级汇总 |
| 体验课学生（临时试听） | 仅保存到班级汇总，不建档 | 仅班级汇总 |
| 场景 | 判断条件 | 处理方式 | 存储位置 |
|------|---------|---------|---------|
| **自己班级补课学生** | 档案在当前班级目录存在 | 双轨保存 | 班级汇总 + 个人档案 |
| **其他老师班级补课学生** | 档案不在当前班级目录 | 询问后决定 | 班级汇总（可选个人档案）|
| **体验课学生** | 无标记或标记[体验] | 仅班级汇总 | 班级汇总（标记体验）|
### 询问流程（其他老师班级补课学生）
### 教师选择
```
⚠️ 未找到「张小明」的个人档案
⚠️ 未找到「张小明」在「发现世界-周四19点」班级的个人档案
处理方式：
[1] 创建档案（补课/新学生）
[2] 仅保存到班级汇总（体验课学生）
该学生标记为[补课]，但不在本班级学生名单中。
可能情况：
[1] 其他老师的学生来补课 → 仅保存到班级汇总
[2] 新转班学生 → 创建个人档案（双轨保存）
[3] 档案在其他班级目录 → 询问是否迁移或仅班级汇总
请选择处理方式：
```
---
@@ -288,10 +344,3 @@ AI处理：
- 输入格式规则：[30-input-format.md](30-input-format.md)
- 批量生成规则：[32-batch-generation.md](32-batch-generation.md)
- 快速入门：[40-keping-快速入门.md](40-keping-快速入门.md)
---
## 版本
- v1.1 | 2026-04-19 | 新增简化转正流程
- v1.0 | 2026-04-17 | 从各文件提取统一规范