AI 校园学习陪伴助手

嵌入大模型智能体 · 课程记忆 · 错题闭环 · 番茄钟 · 硬件联动

加载中…

一屏看清学习状态（数字卡片可直接点击跳转到对应模块）；在下方直接添加「待复习任务」， 或用番茄钟保持专注，到点可联动 ESP32 声光提醒。

📝 待复习任务 可直接增删

    🍅 番茄钟专注

    25:00
    准备开始一段专注时光

    开始专注时向 ESP32 推送「专注灯常亮」；结束自动记录专注时长并下发休息提醒。

    最近专注记录

    ⚡ 当前为内置演示模式（知识库可直接回答计算机/高数高频考点）；接入真实大模型可获得结合课件的精准解答。 接入文心一言 / Kimi →

    以「数学 → 高等数学上册」为例：选定教材与章节，一键生成带答案解析的自测题、 复习总结、专题文章、学习资料清单与可视化思维导图。无密钥时由内置学科知识库生成； 接入文心一言 / Kimi 等模型后自动叠加 AI 生成内容。

    就绪：默认教材「高等数学上册」，未配置密钥时使用内置知识库。

    一、自测题 含标准答案与解析

    二、复习总结

    三、专题文章与学习资料

    四、知识思维导图

    点击「思维导图」或「一键生成全套」查看。

    粘贴课件 / 笔记文字（或语音输入），一键提炼知识点并生成复习考点提纲。

    贴入题目，采用「引导式讲解」：先给思路与分步推导，不直接甩答案。

    天

    为当前课程上传学习资料，智能体将绑定该课程上下文；切换课程自动切换记忆。

    上传文件（.txt / .md / .docx）

    📄 点击选择文件，或把文件拖到这里
    单文件 ≤ 2MB，自动提取文字存入当前课程记忆，不上传原件

    已上传资料

    录入错题 → 智能体分析错因 → 生成同类变式题，形成学习闭环。

    错题列表

    可选加分项：ESP32 开发板与 Web 系统双向联动（下行提醒 + 上行状态轮询）。

    硬件交互点清单（本系统全部硬件触点）

    #交互点方向 / 接口硬件表现
    1复习任务到点提醒 已有 服务端每 30s 扫描 → POST {ESP32}/remind LED 亮 + 蜂鸣器响 1.5s
    2手动测试提醒 已有 POST /api/hardware/test → /remind 同上，用于答辩现场演示
    3番茄钟到点提醒 新增 POST /api/focus/sessions → /remind 专注完成时声光提醒休息
    4专注状态灯 新增 POST /api/focus/state → POST {ESP32}/focus 专注中 LED 常亮，结束熄灭
    5学习状态看板（上行轮询）新增 ESP32 定时 GET /api/hardware/status OLED / 串口显示待复习数、待掌握错题数、专注状态
    6通用消息下发（预留） esp32.notify_esp32(task, message) 可扩展每日打卡、考试倒计时提醒

    开发板状态看板（与 ESP32 轮询到的一致）

    
      
    注：需将 ESP32_ENDPOINT 配置为开发板地址（见 README 与 docs/硬件交互说明.md）。未配置时上述接口返回明确原因，不影响主体功能。
    
    
    

    
    
    
      
    外观（深色 / 浅色 / 主题色）
    
      
    默认「跟随系统」：系统切深色时网站自动切换，也可在此固定模式；主题色即时生效并本地保存。
    
      
    
        
        
        
      
    
      
    

      
    模型接入：文心一言 / Kimi / 自定义端点（填完立即生效，无需重启）
    
      
    拿到 API Key 后在此填写即可切换模型；配置只保存在服务端本地数据库，
        列表只显示掩码。未配置密钥时自动使用内置演示模式，功能不中断。
        自建系统也可直接调用 POST /api/agent/credentials 与 POST /api/agent/complete。
    
      
    
        
        
        
        
        
        
        
    
          
          
          
          
        
    
        
    未执行任何操作。
    
      
    

      
    已接入模型状态（点击可切换当前智能体）
    
      
    

      
    常用接入参数速查
    
      
    # 文心一言·千帆 v2（推荐，只需 API Key）
provider=qianfan  model=ernie-4.5-8k
base_url=https://qianfan.baidubce.com/v2/chat/completions

# 文心一言·旧版 WenxinWorkshop（需 API Key + Secret Key）
provider=qianfan  model=ernie-3.5-8k
token_url=https://aip.baidubce.com/oauth/2.0/token
base_url=https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions

# Kimi
provider=moonshot  model=moonshot-v1-8k
base_url=https://api.moonshot.cn/v1/chat/completions

# 命令行等价调用
curl -X POST /api/agent/credentials -H "Content-Type: application/json" \
  -d '{"provider":"moonshot","api_key":"sk-xxx","model":"moonshot-v1-8k","activate":true}'
    
      
    环境变量配置（可选，优先级低于上面的运行时配置）
    
      
    在项目根目录创建 .env 文件：
ACTIVE_PROVIDER=demo
QIANFAN_API_KEY=xxx / QIANFAN_SECRET_KEY=xxx
MOONSHOT_API_KEY=xxx
OPENAI_API_KEY=xxx
CLAUDE_API_KEY=xxx
CUSTOM_API_KEY=xxx / CUSTOM_BASE_URL=xxx / CUSTOM_MODEL=xxx
ESP32_ENDPOINT=http://开发板IP