更新课评系统代码

2026-06-02 23:01:58 +08:00
parent f8c4b6174f
commit cd05b8a5a7
45 changed files with 8260 additions and 345 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,7 +1,11 @@
 # 穹狼乐高编程AI课评生成系统

 > 为2.5岁-小学4年级学生自动生成个性化课程评价
-> 版本：v4.0（课评规范同步版）| 规则文件：9个核心文件 + 20个归档规则
+> 版本：v4.5.1（AICODE03课程更新）| 规则文件：9个核心文件 + 20个归档规则
+> 
+> **课程匹配规则**：根据当周日期自动匹配课程主题（基于学期周数映射表），不参考上节课进度
+> 
+> **v4.5 表单直连**：网页表单直接 POST 到本地服务器（`src/form_server.py`），AI 检测信号文件自动处理，彻底取消复制粘贴步骤
 > 
 > **合规说明**：本仓库已同步 [课评规范V1.0](课评规范V1.0.md) 全部要求，包括课程编号规范、目录结构规范、课评文件命名规范、课评完成率统计规则。确保自动统计系统可正确识别到课评。
 > 
@@ -192,6 +196,30 @@ classfeedback/

 ## 处理流程

+### 模式一：交互式模式（推荐）
+
+> 适用于所有上课日（周一~周日），以下以周六为例
+
+```
+/周六（或 /今天）→ 展示班级列表（含当周课程主题）→ 选择班级
+                                                    ↓
+                                         启动本地表单服务器 + 自动匹配当周课程
+                                                    ↓
+                                         打开浏览器表单 → 填写 → 点击「提交并保存」
+                                                    ↓
+                                         数据 POST 到服务器 → 保存 JSON + 信号文件
+                                                    ↓
+                                         AI 检测信号 → 读取 JSON → 批量生成 → 双轨保存
+                                                    ↓
+                                         🗑️ 清理临时数据 → 完成
+```
+
+> **课程匹配说明**：系统根据当前日期计算学期周数，直接匹配当周课程主题（如第11周→DISC-011 蜥蜴），不参考上节课进度。除非教师特别说明补课，否则一律使用当周标准课程主题。
+
+> 友好的多轮对话引导，支持 `/周几` 快速索引 + Form-First 网页表单（含进度条、填写状态、一键复制、补课/体验学生区）。详见 [20-workflow.md 第14节](.claude/rules/20-workflow.md)
+
+### 模式二：批量输入模式
+
 ```
 教师极简输入 → AI解析 → 生成个性化课评 → 【自动双轨保存】
                                                    ↓
@@ -238,6 +266,15 @@ classfeedback/

 ### 快捷指令

+#### 模式选择
+| 指令 | 功能 |
+|:-----|:-----|
+| **`/周几`** | **按上课日快速索引（推荐）**，如 `/周六`、`/周日`、`/周四` |
+| `/今天` | 自动判断当天星期几，启动交互式流程 |
+| `/交互式` | 启用交互式课评生成模式（默认，Form-First 网页表单） |
+| `/批量` | 启用批量输入模式（一次性输入所有学生） |
+
+#### 课评操作
 | 指令 | 功能 |
 |:-----|:-----|
 | `查看出勤` | 查看本周各班级出勤（读取汇总头部） |
@@ -248,6 +285,10 @@ classfeedback/

 ## 版本历史

+- **v4.5.1** | 2026-05-20 | AICODE03课程全面更新：同步最新教学大纲（AI原理、大作家系列、个人主页、俄罗斯方块、涂鸦PK、Skills入门等1-20周完整课程）
+- **v4.5** | 2026-05-20 | 表单直连提交：网页表单直接 POST 到本地服务器（`src/form_server.py`），AI 检测信号文件自动生成课评，彻底取消复制粘贴步骤；新增临时数据清理机制
+- **v4.4** | 2026-05-16 | Form-First 交互式流程优化：课程进度自动推演（改为根据当周日期匹配课程主题，不参考上节课进度）、默认网页表单（Form-First）、表单直连提交、新增项目记忆文件
+- **v4.3** | 2026-05-16 | 交互式流程优化：新增 `/周几` 快速索引指令；B模式分开展示学生 + 独立输入区 + 快捷标记按钮（请假/体验/补课/出勤）
 - **v4.0** | 2026-05-14 | 同步课评规范V1.0：新增课程编号规范（CSP/AICODE）、新目录结构（`.claude/memory/class/`）、文件命名规范（`YYYYMMDD_课程编号-课次.md`）、课评完成率统计规则
 - **v3.1** | 2026-05-05 | 简化保存流程：删除"待确认"状态，改为"生成即双轨保存"；出勤嵌入班级汇总
 - **v2.5** | 2026-05-01 | 统一字数弹性范围180-350字