# RAG

**Repository Path**: hexuhzao/rag

## Basic Information

- **Project Name**: RAG
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-30
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek智能对话系统

一个基于DeepSeek API的智能对话应用，包含美观的Vue前端界面和Flask后端服务。

## 功能特点

- 💬 **智能对话**：与DeepSeek AI模型进行交互对话
- 🧠 **思考过程可视化**：查看AI的思考过程
- 💾 **会话管理**：创建、切换、删除多个会话
- 🎨 **美观界面**：现代化的聊天界面设计
- 📱 **响应式布局**：适配各种屏幕尺寸
- 🎛️ **模型选择**：支持多种DeepSeek模型
- 📊 **Token统计**：显示每次对话的Token消耗

## 技术栈

- **前端**：Vue 3 + Vite + Element Plus + Axios
- **后端**：Python + Flask + OpenAI SDK

## 快速开始

### 前提条件

- Node.js (v14+) 和 npm
- Python 3.7+
- DeepSeek API 密钥（从[阿里云百炼](https://dashscope.aliyuncs.com/)获取）

### 安装后端依赖

```bash
# 使用pip安装依赖
pip install -r requirements.txt
```

### 安装前端依赖

```bash
# 使用npm安装依赖
npm install
```

### 配置API密钥

在项目根目录创建 `.env` 文件，并添加您的DeepSeek API密钥：

```env
DASHSCOPE_API_KEY=您的API密钥
```

### 运行项目

#### 1. 启动后端服务

```bash
python DeepSeekAPI.py
```

后端服务将在 `http://localhost:5000` 启动。

#### 2. 启动前端服务

在另一个终端窗口中运行：

```bash
npm run dev
```

前端服务将在 `http://localhost:3000` 启动。

### 构建前端项目

如果需要部署，可以构建前端项目：

```bash
npm run build
```

构建后的文件将生成在 `dist` 目录中。

## API接口说明

### 聊天接口

- **URL**: `/api/chat`
- **方法**: `POST`
- **请求体**: 
  ```json
  {
    "message": "您的问题",
    "session_id": "会话ID",
    "model": "模型名称"
  }
  ```
- **响应**: 
  ```json
  {
    "response": "AI的回复",
    "reasoning": "AI的思考过程",
    "usage": {
      "prompt_tokens": 提示Token数量,
      "completion_tokens": 回复Token数量,
      "total_tokens": 总Token数量
    }
  }
  ```

### 其他接口

- **创建新会话**: `POST /api/new_session`
- **清除历史记录**: `POST /api/clear_history`
- **获取模型列表**: `GET /api/models`
- **健康检查**: `GET /api/health`

## 开发说明

- 前端代码位于 `src` 目录
- 后端代码位于 `DeepSeekAPI.py`
- Vite配置位于 `vite.config.js`
- 项目使用代理配置将 `/api` 请求转发到后端服务

## 注意事项

- 默认使用的是示例API密钥，在实际使用中请替换为您自己的密钥
- 开发环境中后端服务使用Flask内置服务器，生产环境请使用gunicorn或uwsgi等WSGI服务器
- 会话数据存储在浏览器的localStorage中，清除浏览器数据会导致会话丢失
- 部分模型可能不支持思考模式功能

## License

MIT