Files

2026-06-02 23:01:58 +08:00

8.4 KiB

Raw Blame History

name, description, version, author

name	description	version	author
keping-simplified	超级简化版课评生成器！只需输入 "/课评" 即可启动，表单直连提交，AI自动检测并生成。为穹狼乐高编程设计。	5.1.0	穹狼教学团队

keping-simplified — 超级简化版课评生成器

🚀 核心特点

超级简单！一键启动！

只需输入 /课评 即可启动，无需记住一堆命令
启动即显示当前周数+班级选择
自动匹配课程主题（基于学期周数映射表）
本地网页表单：学生状态快捷选择 + 速记输入 + 进度条
直连提交：表单直接 POST 到本地服务器，无需复制粘贴
AI 自动检测信号文件 → 生成课评 → 双轨保存
完成后自动清理临时数据

📋 完整工作流程

第一步：启动（只需一个命令！）

用户输入：/课评

立即执行以下操作：

✅ 计算当前周数（基于3月2日开学）
✅ 显示当天对应周几的班级列表
✅ 自动匹配每个班级的当周课程主题

第二步：班级选择

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 选择班级 | 第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] 手动输入班级名称

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

用户选择班级后，系统自动：

启动本地表单服务器（python src/form_server.py）
读取该班级目录，加载学生名单和画像
匹配当周课程主题（从学期周数映射表）

第三步：打开网页表单 + 直连提交

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🖥️ 表单服务器已启动！
👉 http://localhost:8088/form?class=发现世界-周四19点&week=11&course=DISC-011&theme=鳄鱼&date=2026-05-16
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

表单已自动填入：班级、周数、日期、课程主题、学生名单（含画像摘要）

用户在浏览器中：

为每位学生选择状态（出勤/请假/补课/体验）
填写课堂表现（支持速记符号）
点击「🚀 提交并保存」
看到「✅ 提交成功」→ 可关闭页面

数据自动 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 人
🗑️ 已清理临时数据文件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

点击「提交」后：

✅ 数据自动 POST 到本地服务器
✅ 服务器保存为 .claude/.tmp/evaluation_input_{班级}.json
✅ 写入信号文件 EVALUATION_READY.txt
✅ AI 检测到信号，读取 JSON 数据
✅ 批量生成所有学生课评（180-350字三段式）
✅ 自动保存到标准路径（双轨）
✅ 清理临时数据文件

📋 课评生成规则

学生状态处理

出勤 → 正常生成课评，保存到 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

8.4 KiB Raw Blame History Unescape Escape