# learning-ai

**Repository Path**: skyorblue/learning-ai

## Basic Information

- **Project Name**: learning-ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Leaning-AI (志恒学习平台)

## 项目概述

Leaning-AI 是一个智能学习平台，集成了 AI 代理功能，提供个性化学习计划、课程管理、题库系统等功能。

## 技术栈

- 后端: Flask, Flask-RESTful, SQLAlchemy, JWT, Redis, MySQL
- 前端: Vue 3 + TypeScript + Vite + Tailwind CSS + DaisyUI
- AI代理: Mini Agent Framework (支持 Anthropic/OpenAI)
- 其他: MCP (Model Context Protocol)

## 项目结构

```
leaning-ai/
├── server/                 # 后端服务
│   ├── mini_agent/        # AI代理框架
│   ├── routes/            # API路由
│   ├── utils/             # 工具函数
│   └── models.py          # 数据库模型
├── web/                    # 前端应用
│   ├── src/               # 源代码目录
│   │   ├── components/    # Vue组件
│   │   ├── pages/         # 页面
│   │   ├── router/        # 路由
│   │   ├── stores/        # Pinia状态管理
│   │   ├── services/      # API服务
│   │   ├── constants/     # 常量定义
│   │   ├── assets/        # 静态资源
│   │   ├── composables/   # Vue 3 组合式函数
│   │   ├── lib/           # 工具库
│   │   ├── types/         # TypeScript 类型定义
│   │   ├── utils/         # 通用工具函数
│   │   ├── App.vue        # 根组件
│   │   └── main.ts        # 入口文件
│   ├── public/            # 公共资源
│   ├── index.html         # HTML模板
│   ├── package.json       # 项目依赖
│   ├── vite.config.ts     # Vite 配置
│   └── tsconfig.json      # TypeScript 配置
├── test/                   # 测试脚本目录
├── uploads/                # 文件上传目录
├── docker/                 # Docker 配置
└── .env.example           # 环境变量模板
```

## 启动命令

### 开发环境启动

#### 后端启动
```bash
cd server
uv run start
```
或直接运行：
```bash
cd server
python app.py
```
后端服务将在 `http://localhost:5002` 启动

#### 前端启动
```bash
cd web
npm run dev
```
前端开发服务器将在 `http://localhost:5173` 启动（或其他可用端口）

## 核心功能

- 课程管理：创建、编辑、删除课程和章节
- 题库系统：管理题目、选项和解析
- 学习计划：AI 生成个性化学习计划
- 学习记录：跟踪学习进度和成果
- 智能对话：与 AI 代理进行学习相关的对话
- 管理后台：用户管理、数据分析、Redis 管理

## 部署

项目支持 Docker 部署，详细配置请参考 [AGENTS.md](file:///Users/liyue/Documents/leaning-ai/AGENTS.md) 文件。

## 联系方式

如有问题，请查阅各模块的 README 或相关文档。