# AI-classmate

**Repository Path**: 106studio/AI-classmate

## Basic Information

- **Project Name**: AI-classmate
- **Description**: AI学伴
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-17
- **Last Updated**: 2025-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI数学助教 - MVP原型

## 🎯 核心功能
解决小学生数学学习中的核心痛点：**学生解题"卡住"时得不到及时帮助**

## 🔧 技术特性

### 1. 实时学习状态监控
- **笔迹轨迹分析**：记录每一笔的书写时间和位置
- **停顿时间检测**：智能识别学生思考停顿
- **学习阶段识别**：自动判断学生当前处于读题、思考、书写还是检查阶段
- **5秒间隔监控**：默认每5秒进行一次智能分析

### 2. 智能卡顿检测算法
```javascript
// 核心检测逻辑
if (停顿时间 > 5秒 && !已检测到卡住) {
    触发卡住状态检测();
}
if (停顿时间 > 10秒 && 帮助级别 === 0) {
    自动提供帮助();
}
```

### 3. 渐进式帮助系统
五级帮助机制，避免直接给出答案：
- **Level 1**: 轻提示 - "仔细读题，找出关键数字"
- **Level 2**: 引导提示 - "这是一道减法题，想想要用什么运算"  
- **Level 3**: 方法提示 - "用总数减去吃掉的数量"
- **Level 4**: 步骤提示 - "计算：15 - 7 = ?"
- **Level 5**: 知识扩展 - 答对后提供相关知识点讲解

### 4. 智能答案识别
- **最终答案优先**：重点关注学生的最终答案是否正确
- **过程引导**：答案正确时仍可提供步骤完善建议
- **状态更新**：答案正确时立即更新题目状态并停止自动监控
- **继续学习**：答对后可主动获取知识扩展内容

### 5. UI界面优化
- **收缩展开功能**：监控中心和AI助教支持一键收缩/展开
- **默认收缩状态**：启动时界面简洁，需要时自动展开
- **智能触发展开**：AI助教在提供帮助时自动展开
- **护眼设计**：专注度更高的学习环境

## 🚀 如何体验

1. **启动项目**
   ```bash
   # 直接在浏览器中打开 index.html
   open index.html
   ```

2. **体验核心功能**
   - 在画布上尝试写数字或算式
   - 故意停顿5秒以上，观察AI助手的反应
   - 点击"💡"按钮体验渐进式帮助（最多5级）
   - 观察右上角的智能监控中心（可点击标题收缩/展开）
   - 点击🤖头像可收缩/展开AI助教

## 🔍 技术实现亮点

### 智能感知算法
```javascript
// 卡顿检测（优化后的时间参数）
monitorLearningState() {
    // 计算停顿时间
    if (this.pauseStartTime && !this.isDrawing) {
        this.currentPauseTime = Math.floor((now - this.pauseStartTime) / 1000);
    }
    
    // 检测卡住状态（5秒触发）
    if (this.currentPauseTime > 5 && !this.learningState.isStuck) {
        this.detectStuckState();
    }
}
```

### 学习行为分析
- 书写流畅度分析
- 涂改频率统计
- 思考时间模式识别
- 求助频率分析

### AI助手交互
- 温和的介入方式
- 上下文感知的提示
- 情绪关怀功能
- 答对后的知识扩展

### 用户操作状态管理
- **主动操作检测**：识别学生主动提交答案或请求帮助
- **LLM回复控制**：避免用户操作时的AI干扰
- **监控暂停机制**：用户操作后暂停自动监控，书写时重启

## 📊 数据收集维度

### 学习过程数据
- 每道题的解题用时
- 停顿时间分布（5秒精度检测）
- 涂改次数和位置
- 求助时机和频率（5级帮助系统）

### 学习状态指标
- 卡住检测准确率
- 帮助介入时机
- 学生专注度变化
- 学习效果评估
- 答案正确性实时识别

## 🎨 界面设计特点

### 简洁交互设计
- 默认收缩状态，按需展开
- 智能触发展开机制
- 平滑动画过渡效果

### 交互反馈
- 实时状态指示
- 渐进式视觉反馈
- 温和的提醒动画

## 🔮 未来扩展方向

### 技术升级
1. **手写识别**：识别学生具体写了什么 ✅
2. **解题步骤分析**：判断解题思路是否正确 ✅
3. **错误类型分类**：区分概念错误、计算错误等 ✅
4. **个性化学习模型**：为每个学生建立学习档案

### 功能扩展
1. **多学科支持**：语文、英语等其他学科
2. **家校互联**：家长实时了解学习情况
3. **同伴学习**：学生之间的互助功能
4. **游戏化元素**：成就系统、学习伙伴等

## 📈 核心价值体现

### 对学生的价值
- ✅ 及时获得学习帮助，不再因为卡住而放弃
- ✅ 五级渐进式引导，培养独立思考能力
- ✅ 减少学习焦虑，提升学习自信心
- ✅ 答对后获得知识扩展，巩固学习成果

### 对老师的价值
- ✅ 实时了解每个学生的学习状态
- ✅ 精准识别需要帮助的学生
- ✅ 提供个性化教学数据支持
- ✅ 智能答案识别，减少批改工作量

### 对家长的价值
- ✅ 解决家庭作业辅导难题
- ✅ 科学的学习进度反馈
- ✅ 减轻家长辅导压力

---

**这个MVP充分展示了AI在教育场景中的实际应用价值，通过技术手段解决了传统教学中的真实痛点。**