# chat

**Repository Path**: cxk65884/chat

## Basic Information

- **Project Name**: chat
- **Description**: 一个专注于聊天和对话系统的开源项目，支持多平台集成，旨在为开发者提供高效、易用的聊天解决方案。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI对话平台

一个基于Spring Boot + Vue的AI对话平台，集成DeepSeek API。

## 技术栈

**后端:**
- Spring Boot 3.2
- Java 17
- Maven
- Spring WebFlux (WebClient)
- Lombok

**前端:**
- Vue 3
- Vite
- Axios

## 快速开始

### 前置要求
- Java 17+
- Maven 3.6+
- Node.js 16+

### 方式一：一键启动（推荐）

双击运行 `start-all.bat`，会自动启动前后端服务。

### 方式二：分别启动

**启动后端：**
```bash
# Windows
start-backend.bat

# 或手动
cd backend
mvn clean spring-boot:run
```

**启动前端：**
```bash
# Windows
start-frontend.bat

# 或手动
cd frontend
npm install
npm run dev
```

### 配置DeepSeek API Key

打开 `backend/src/main/resources/application.yml`，找到以下配置：

```yaml
deepseek:
  api:
    key: YOUR_API_KEY_HERE  # 替换为你的DeepSeek API Key
```

将 `YOUR_API_KEY_HERE` 替换为你的DeepSeek API Key。

## 功能特性

✅ **多会话管理** - 创建多个对话，每个对话独立管理上下文  
✅ **实时对话** - 与DeepSeek AI进行流式对话  
✅ **会话历史** - 自动保存对话历史，支持上下文理解  
✅ **响应式设计** - 美观的UI界面，良好的用户体验  
✅ **错误处理** - 完善的异常处理和错误提示  

## 项目结构

```
chat/
├── backend/                    # 后端项目
│   ├── src/main/java/
│   │   └── com/ai/chat/
│   │       ├── config/         # 配置类
│   │       ├── controller/     # 控制器
│   │       ├── dto/           # 数据传输对象
│   │       └── service/       # 业务逻辑
│   ├── src/main/resources/
│   │   └── application.yml    # 配置文件
│   └── pom.xml               # Maven配置
├── frontend/                  # 前端项目
│   ├── src/
│   │   ├── App.vue           # 主组件
│   │   ├── main.js           # 入口文件
│   │   └── style.css         # 样式文件
│   ├── index.html            # HTML模板
│   ├── package.json          # 依赖配置
│   └── vite.config.js        # Vite配置
├── start-all.bat             # 一键启动脚本
├── start-backend.bat         # 后端启动脚本
└── start-frontend.bat        # 前端启动脚本
```

## API接口

### 聊天接口

**发送消息**
```http
POST /api/chat/send
Content-Type: application/json

{
  "message": "你好，请介绍一下自己",
  "sessionId": "uuid"  // 可选，不传会自动创建
}
```

**创建新会话**
```http
POST /api/chat/session/new
```

**清除会话**
```http
DELETE /api/chat/session/{sessionId}
```

**获取会话消息数**
```http
GET /api/chat/session/{sessionId}/count
```

## 开发提示

1. **首次运行**需要先安装依赖，脚本会自动处理
2. **API Key** 必须正确配置才能正常使用对话功能
3. **端口占用** 后端默认8080，前端默认3000，如有冲突可修改配置
4. **热重载** 前后端都支持热重载，修改代码后自动刷新

## 常见问题

**Q: 启动失败，提示端口被占用？**  
A: 修改 `application.yml` 中的 `server.port` 或 `vite.config.js` 中的 `server.port`

**Q: 对话没有响应？**  
A: 检查DeepSeek API Key是否正确配置

**Q: 前端跨域问题？**  
A: 项目已配置CORS，确保后端正常运行

## 许可证

MIT License