# learn-helper

**Repository Path**: richard15/learn-helper

## Basic Information

- **Project Name**: learn-helper
- **Description**: 用 AI 来辅助学习的卡片系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-15
- **Last Updated**: 2025-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 知识卡片学习系统

## 项目概述

知识卡片学习系统是一个帮助用户高效学习和记忆知识点的应用程序。用户可以上传文档，系统会自动解析文档内容，生成知识卡片，并提供练习题和学习进度跟踪功能。

## 阿里云通义千问 Qwen-Long 模型集成

本系统集成了阿里云通义千问 Qwen-Long 大语言模型，实现了以下智能功能：

1. **智能文档结构提取**：自动识别文档的章节结构，比传统方法更准确
2. **智能知识卡片生成**：根据文档内容智能生成知识卡片，包括标题、内容、关键词和难度级别
3. **文档摘要生成**：使用通义千问模型生成文档的摘要内容

### 配置通义千问 API

1. 在 `backend` 目录下创建 `.env` 文件
2. 添加以下环境变量：

```
ALIBABA_QWEN_API_KEY=your_alibaba_qwen_api_key
```

3. 从阿里云通义千问控制台获取 API 密钥：https://bailian.console.aliyun.com/

## 项目结构

- `frontend/`: Vue.js 前端应用
- `backend/`: Node.js Express 后端 API
- `e2e-tests/`: 端到端测试

## 主要功能

- 用户注册和登录
- 文档上传和管理
- 知识卡片生成和查看
- 练习题生成和完成
- 学习进度跟踪
- 书签和笔记功能

## 技术栈

### 前端
- Vue.js
- Vuex (状态管理)
- Vue Router
- Axios (HTTP 客户端)

### 后端
- Node.js
- Express
- MongoDB (数据库)
- Mongoose (ODM)
- JWT (身份验证)
- 阿里云通义千问 API (AI 模型)

## 安装和运行

### 后端

```bash
cd backend
npm install
npm run dev
```

### 前端

```bash
cd frontend
npm install
npm run dev
```

## API 文档

详细的 API 文档请参见 `backend/README.md`。

## 通义千问 Qwen-Long 模型使用示例

### 文档结构提取

```javascript
// 使用通义千问 Qwen-Long 模型提取文档结构
const structure = await DocumentParser.extractStructureWithAI(content);
```

### 知识卡片生成

```javascript
// 使用通义千问 Qwen-Long 模型生成知识卡片
const cards = await CardGenerator.processChapterContentWithAI(content, chapterTitle, documentId);
```

### 文档摘要生成

```javascript
// 使用通义千问 Qwen-Long 模型生成文档摘要
const response = await AiModelService.parseWithQwenLong(content, {
  task: 'summarize',
  temperature: 0.3,
  max_tokens: 1000
});
```

## 许可证

[MIT](LICENSE)