Admin1013

cicada-ai

0
0
0
Python
public
View on GitHub

🦗 知了(Cicada) AI学习助手

以学生画像为核心，基于知识点掌握程度，提供个性化学习路径与方法的AI学习助手。

欢迎有兴趣的小伙伴一起参与开发！ 🎉

📋 项目简介

知了(Cicada)是一款面向中小学生的AI学习助手，核心理念：

  • 以学生为中心 - 通过学生画像追踪每个学生的独特学习情况
  • 以掌握为目标 - 不追求刷题数量，而是追求知识点的真正掌握
  • 以AI为助力 - 用AI技术提供个性化讲解和学习建议

核心算法

算法 用途
BKT (贝叶斯知识追踪) 计算知识点掌握度
遗忘曲线 预测最佳复习时间
知识图谱 规划学习路径

✨ 功能特性

  • 📸 拍照批改 - 手写题目识别与自动批改
  • 🧠 个性化讲解 - 基于学生画像生成针对性讲解
  • 🎯 学习路径 - 基于目标规划学习顺序
  • 📊 进度追踪 - BKT算法计算知识点掌握度
  • 🔔 复习提醒 - 基于遗忘曲线推送复习

🛠️ 技术栈

  • 后端: Python 3.10+
  • LLM: DeepSeek V4
  • 图片识别: Qwen2.5-VL
  • 数据存储: 飞书Base
  • 向量数据库: LanceDB
  • Bot: 飞书Bot

🚀 快速开始

# 1. 克隆仓库
git clone https://github.com/Admin1013/cicada-ai.git
cd cicada-ai

# 2. 安装依赖
pip install -r requirements.txt

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env 填入你的API密钥

# 4. 运行
python src/main.py

📁 项目结构

cicada-ai/
├── README.md                 # 项目说明
├── requirements.txt          # Python依赖
├── .env.example              # 环境变量模板
├── config/
│   └── settings.py           # 配置文件
├── src/
│   ├── main.py               # 主入口
│   ├── bot/
│   │   └── feishu_bot.py     # 飞书Bot
│   ├── ocr/
│   │   └── recognizer.py     # 图片识别
│   ├── bkt/
│   │   └── algorithm.py      # BKT算法
│   ├── ai/
│   │   └── explainer.py      # 讲解生成
│   └── storage/
│       └── feishu_base.py    # 飞书Base操作
├── data/
│   └── knowledge_graph.json  # 知识图谱
└── tests/                    # 测试

🗄️ 数据库设计

使用飞书Base存储，共6张表：

表格 用途
知识点库 128个知识点，含难度、章节、前置关系
题目库 165道题目，含题型、难度、关联知识点
学生画像 学生信息、能力评估、学习偏好
学习目标 知识点掌握目标、进度追踪
学习记录 做题记录、BKT计算结果
AI对话记录 AI与学生的交互记录

🤝 参与贡献

我们欢迎任何形式的贡献！

贡献方式

  • 🐛 报告Bug - 提交Issue描述问题
  • 💡 功能建议 - 提出新功能想法
  • 📝 完善文档 - 改进README、添加注释
  • 💻 提交代码 - Fork → 修改 → PR

开发流程

# 1. Fork本仓库

# 2. 克隆你的Fork
git clone https://github.com/你的用户名/cicada-ai.git

# 3. 创建功能分支
git checkout -b feature/你的功能名

# 4. 提交修改
git commit -m "添加xxx功能"

# 5. 推送到你的Fork
git push origin feature/你的功能名

# 6. 创建Pull Request

欢迎参与的方向

方向 难度 说明
📸 OCR识别优化 ⭐⭐ 提高手写识别准确率
🧠 BKT算法调优 ⭐⭐⭐ 优化参数、改进算法
💬 Prompt工程 ⭐⭐ 优化AI讲解质量
📊 数据可视化 ⭐⭐ 学习进度图表展示
🧪 测试用例 ⭐ 编写单元测试
📖 文档完善 ⭐ 改进文档和注释

📄 License

MIT License

💬 联系方式

  • GitHub Issues: 提交Issue
  • 飞书交流群: (待创建)

如果这个项目对你有帮助，欢迎Star ⭐ 支持！

v0.3.3[beta]