# chat-base

**Repository Path**: codingee/chat-base

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IM Tool 项目说明

这是一个基于 Spring Boot 和 React 的即时通讯工具，使用 SSE (Server-Sent Events) 实现消息流式发送。

## 技术栈

- 后端：Spring Boot 2.0.4, Java 8, SSE
- 前端：React 19.2.0, Vite

## 环境要求

### 后端环境
- Java 8 JDK
- Maven

### 前端环境
- Node.js 18+
- npm 9+

## 安装步骤

### 1. 后端安装

```bash
# 进入后端目录
cd /Users/wucj/Downloads/project/chat-base

# 安装依赖
./mvnw install

# 启动后端服务
./mvnw spring-boot:run
```

### 2. 前端安装

#### Mac Intel 设备

1. **安装 Node.js**
   - 方法 1: 使用 Homebrew
     ```bash
     brew install node
     ```
   - 方法 2: 从官网下载安装包
     - 访问 https://nodejs.org/en/download/
     - 下载 macOS 安装包并安装

2. **验证安装**
   ```bash
   node -v
   npm -v
   ```

3. **安装项目依赖**
   ```bash
   # 进入前端目录
   cd /Users/wucj/Downloads/project/chat-base/im-client

   # 安装依赖
   npm install
   ```

4. **启动前端服务**
   ```bash
   npm run dev
   ```

#### Mac M3 设备

1. **安装 Node.js**
   - 方法 1: 使用 Homebrew
     ```bash
     # 确保 Homebrew 是最新版本
     brew update
     
     # 安装 Node.js
     brew install node
     ```
   - 方法 2: 从官网下载安装包
     - 访问 https://nodejs.org/en/download/
     - 下载 macOS ARM64 安装包并安装

2. **验证安装**
   ```bash
   node -v
   npm -v
   ```

3. **安装项目依赖**
   ```bash
   # 进入前端目录
   cd /Users/wucj/Downloads/project/chat-base/im-client

   # 安装依赖
   npm install
   ```

4. **启动前端服务**
   ```bash
   npm run dev
   ```

## 运行项目

1. **启动后端服务**
   - 后端服务运行在：http://localhost:8080

2. **启动前端服务**
   - 前端服务运行在：http://localhost:5174

3. **访问应用**
   - 打开浏览器，访问 http://localhost:5174

## 功能说明

- **GET 方法**：通过 GET 请求发送消息
- **POST 方法**：通过 POST 请求发送消息
- **流式响应**：后端采用流式方式响应消息，每次最多返回3个汉字，模拟大模型响应
- **SSE 连接**：使用 SSE 实现实时消息推送，超时时间设置为60秒

## 注意事项

- 确保端口 8080（后端）和 5174（前端）没有被占用
- 如果端口被占用，可以在相应的配置文件中修改端口号
- 首次启动可能需要较长时间下载依赖

## 故障排查

1. **端口被占用**
   - 查找占用端口的进程
     ```bash
     lsof -i :8080
     ```
   - 终止占用端口的进程
     ```bash
     kill <PID>
     ```

2. **依赖安装失败**
   - 清理 npm 缓存
     ```bash
     npm cache clean --force
     ```
   - 重新安装依赖
     ```bash
     npm install
     ```

3. **SSE 连接失败**
   - 检查后端服务是否正常运行
   - 检查网络连接
   - 查看浏览器控制台是否有错误信息