228 lines
8.4 KiB
Markdown
228 lines
8.4 KiB
Markdown
---
|
||
name: keping-simplified
|
||
description: 超级简化版课评生成器！只需输入 "/课评" 即可启动，表单直连提交，AI自动检测并生成。为穹狼乐高编程设计。
|
||
version: 5.1.0
|
||
author: 穹狼教学团队
|
||
---
|
||
|
||
# keping-simplified — 超级简化版课评生成器
|
||
|
||
## 🚀 核心特点
|
||
|
||
**超级简单！一键启动！**
|
||
- 只需输入 `/课评` 即可启动，无需记住一堆命令
|
||
- 启动即显示当前周数+班级选择
|
||
- 自动匹配课程主题（基于学期周数映射表）
|
||
- 本地网页表单：学生状态快捷选择 + 速记输入 + 进度条
|
||
- **直连提交**：表单直接 POST 到本地服务器，无需复制粘贴
|
||
- AI 自动检测信号文件 → 生成课评 → 双轨保存
|
||
- 完成后自动清理临时数据
|
||
|
||
---
|
||
|
||
## 📋 完整工作流程
|
||
|
||
### 第一步：启动（只需一个命令！）
|
||
```
|
||
用户输入：/课评
|
||
```
|
||
立即执行以下操作：
|
||
1. ✅ 计算当前周数（基于3月2日开学）
|
||
2. ✅ 显示当天对应周几的班级列表
|
||
3. ✅ 自动匹配每个班级的当周课程主题
|
||
|
||
---
|
||
|
||
### 第二步：班级选择
|
||
```
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
🎯 选择班级 | 第X周 YYYY-MM-DD
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
可选班级：
|
||
[1] 发现世界-周四19点（DISC-011 鳄鱼）
|
||
[2] Wed创造世界-周六1030（CREATE-011 推磨机器人）
|
||
[3] AICODE03小Q周六1400（AICODE03-011 AI文档写作）
|
||
[4] SPIKE02-周日1030（SPIKE-011 摩天轮）
|
||
[5] 手动输入班级名称
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
用户选择班级后，系统自动：
|
||
1. 启动本地表单服务器（`python src/form_server.py`）
|
||
2. 读取该班级目录，加载学生名单和画像
|
||
3. 匹配当周课程主题（从学期周数映射表）
|
||
|
||
---
|
||
|
||
### 第三步：打开网页表单 + 直连提交
|
||
```
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
🖥️ 表单服务器已启动！
|
||
👉 http://localhost:8088/form?class=发现世界-周四19点&week=11&course=DISC-011&theme=鳄鱼&date=2026-05-16
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
**表单已自动填入：班级、周数、日期、课程主题、学生名单（含画像摘要）**
|
||
|
||
用户在浏览器中：
|
||
1. 为每位学生选择状态（出勤/请假/补课/体验）
|
||
2. 填写课堂表现（支持速记符号）
|
||
3. 点击「🚀 提交并保存」
|
||
4. 看到「✅ 提交成功」→ 可关闭页面
|
||
|
||
**数据自动 POST 到本地服务器 → 保存为 JSON → 写入信号文件**
|
||
|
||
**表单预览**：
|
||
```
|
||
┌──────────────────────────────────────────┐
|
||
│ 📝 课评填写表单 - 发现世界-周四19点 │
|
||
│ 第11周 · DISC-011 鳄鱼 · 2026-05-16 │
|
||
├──────────────────────────────────────────┤
|
||
│ 📊 填写进度：3/6 · █████░░ 50% │
|
||
├──────────────────────────────────────────┤
|
||
│ ┌─梁昕乔───────────────────────┐ │
|
||
│ │ 📋 性格内向，需鼓励... │ │
|
||
│ │ [出勤] [请假] [补课] [体验] │ │
|
||
│ │ 表现：____________________ │ │
|
||
│ │ (速记提示：gj=观望、zd=主动) │ │
|
||
│ └──────────────────────────────┘ │
|
||
│ ┌─钟昀昊───────────────────────┐ │
|
||
│ │ [出勤] [请假] [补课] [体验] │ │
|
||
│ │ 表现：____________________ │ │
|
||
│ └──────────────────────────────┘ │
|
||
│ ┌─+ 添加临时学生──────────────┐ │
|
||
│ │ 姓名：____ 状态：[补课/体验] │ │
|
||
│ └──────────────────────────────┘ │
|
||
├──────────────────────────────────────────┤
|
||
│ [🚀 提交并保存] │
|
||
└──────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 第四步：AI 自动检测 → 生成并保存
|
||
```
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
🔔 检测到表单提交 | 发现世界-周四19点 | DISC-011 鳄鱼
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
[1/3] 生成梁昕乔课评... ✅ 已保存
|
||
[2/3] 生成钟昀昊课评... ✅ 已保存
|
||
[3/3] 生成林瀚丞课评... ✅ 已保存
|
||
📝 其他学生请假，不生成课评
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
✅ 全部完成！已保存 3 人 | 请假 2 人
|
||
🗑️ 已清理临时数据文件
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
点击「提交」后：
|
||
1. ✅ 数据自动 POST 到本地服务器
|
||
2. ✅ 服务器保存为 `.claude/.tmp/evaluation_input_{班级}.json`
|
||
3. ✅ 写入信号文件 `EVALUATION_READY.txt`
|
||
4. ✅ AI 检测到信号，读取 JSON 数据
|
||
5. ✅ 批量生成所有学生课评（180-350字三段式）
|
||
6. ✅ 自动保存到标准路径（双轨）
|
||
7. ✅ 清理临时数据文件
|
||
|
||
---
|
||
|
||
## 📋 课评生成规则
|
||
|
||
### 学生状态处理
|
||
- **出勤** → 正常生成课评，保存到 `feedback/`
|
||
- **请假** → 仅生成请假记录 `(请假).md`
|
||
- **补课** → 保存到 `补课/feedback/`
|
||
- **体验** → 保存到 `补课/feedback/`
|
||
|
||
### 三段式结构（固定不变）
|
||
```
|
||
第1段（30-55字）：课程知识点，末尾1个emoji
|
||
第2段（100-220字，弹性）：掌握+环节+亮点，1-3个emoji分散插入
|
||
第3段（30-55字）：课后建议，末尾1个emoji
|
||
```
|
||
|
||
### 称呼规则
|
||
- 优先用小名/昵称
|
||
- 其次用去姓称名
|
||
- 单字名叠字化
|
||
|
||
### Emoji规则
|
||
- 第1段：🔍 💡 ⚙️（根据课程类型）
|
||
- 第2段：💪 ✨ 📈 🎯（根据亮点）
|
||
- 第3段：🏠 🔧（根据建议）
|
||
|
||
---
|
||
|
||
## 💾 自动保存规则
|
||
|
||
### 文件路径（课评规范V1.0标准）
|
||
```
|
||
.claude/memory/class/{班级}/
|
||
├── summaries/YYYYMMDD_{课程编号}_{班级反馈}.md
|
||
├── {学生}/
|
||
│ └── feedback/YYYYMMDD_{课程编号}_{课次}.md
|
||
└──补课/{学生}/
|
||
└── feedback/YYYYMMDD_{课程编号}.md
|
||
```
|
||
|
||
### 无需确认，自动保存！
|
||
课评生成后立即保存，无需教师点击确认。
|
||
|
||
---
|
||
|
||
## 📊 速记符号对照表
|
||
|
||
| 速记 | 含义 |
|
||
|------|------|
|
||
| gj# | 观望#分钟 |
|
||
| zd# | 主动搭#层 |
|
||
| zt | 自己调整 |
|
||
| wb | 完成 |
|
||
| ↑ | 开心 |
|
||
| → | 稳定 |
|
||
| ++ | 比上周进步 |
|
||
| -- | 需关注 |
|
||
|
||
---
|
||
|
||
## 📝 触发方式
|
||
|
||
**主触发词：**
|
||
- `/课评` → 启动超级简化流程
|
||
- `/keping-simple` → 别名
|
||
|
||
**不触发其他技能：**
|
||
- 不要触发 `keping-advanced` 或 `keping-optimizer`
|
||
|
||
---
|
||
|
||
## ⚙️ 关键配置
|
||
|
||
### 学期周数计算基准
|
||
- 开学日期：2026年3月2日
|
||
- 周数公式：Floor((当天-3月2日)/7) +1
|
||
|
||
### 班级目录路径
|
||
```
|
||
.claude/memory/class/{班级名称}/
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 质量检查清单
|
||
- [ ] 字数：180-350（根据输入丰富度）
|
||
- [ ] 三段式结构完整
|
||
- [ ] Emoji位置正确（段末/分散插入）
|
||
- [ ] 称呼正确（不用全名）
|
||
- [ ] 无周数显示（正文）
|
||
- [ ] 路径符合课评规范V1.0
|
||
|
||
---
|
||
|
||
*版本：v5.1.0（表单直连提交）*
|
||
*维护者：穹狼教学团队*
|
||
*最后更新：2026-05-20*
|