# helloAI

**Repository Path**: menglinjie/hello-ai

## Basic Information

- **Project Name**: helloAI
- **Description**: 一个简单的AI调用聊天助手
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Hello-AI 智能聊天应用

A lightweight AI chat application built with Spring Boot and Java, featuring both synchronous and streaming chat capabilities.

## 项目简介

Hello-AI 是一个基于 Spring Boot 框架开发的智能聊天应用，集成了 AI 对话功能，支持流式响应（SSE）和普通请求两种模式。项目采用前后端分离架构，前端提供简洁的 Web 界面，后端 RESTful API 可供其他客户端调用。

## 技术栈

- **后端框架**: Spring Boot
- **编程语言**: Java
- **前端**: HTML + JavaScript
- **AI 集成**: ChatClient (AI 聊天客户端)
- **配置**: Spring YAML 配置

## 核心功能

### 1. 流式聊天 (`/chat/stream`)
- 支持 Server-Sent Events (SSE) 流式输出
- 返回 MIME 类型: `text/event-stream`
- 实时显示 AI 生成的回答

### 2. 普通聊天 (`/chat`)
- 同步返回完整的对话结果
- 适合需要完整响应的场景

### 3. 会话管理
- 支持自定义会话 ID (`sessionId` 参数)
- 默认会话 ID 为 `default`
- 每个会话保持独立的聊天记忆

### 4. 跨域支持
- 内置 CORS 配置，支持跨域请求

## 快速开始

### 环境要求

- JDK 8 或更高版本
- Maven 3.x

### 构建与运行

```bash
# 打包项目
mvn clean package

# 运行应用
mvn spring-boot:run
```

应用默认运行在 `http://localhost:8080`

### 前端访问

直接访问首页: `http://localhost:8080/

## API 接口

| 方法 | 路径 | 参数 | 说明 |
|------|------|------|------|
| GET | `/chat/stream` | `message`, `sessionId`(可选) | 流式聊天接口 |
| GET | `/chat` | `message`, `sessionId`(可选) | 普通聊天接口 |

### 请求示例

```
GET /chat/stream?message=你好&sessionId=user123
GET /chat?message=今天天气怎么样
```

## 配置说明

配置文件位于 `src/main/resources/application.yml`，可配置项包括：

- 服务器端口
- AI 客户端参数
- 日志级别等

## 项目结构

```
src/
├── main/
│   ├── java/com/ailearning/helloai/
│   │   ├── ChatApplication.java       # Spring Boot 启动类
│   │   ├── config/
│   │   │   └── CorsConfig.java       # 跨域配置
│   │   └── controller/
│   │       └── ChatController.java    # 聊天控制器
│   └── resources/
│       ├── application.yml           # 应用配置
│       └── static/index.html        # 前端页面
```

## 使用许可

本项目仅供学习和个人研究使用，请勿用于商业目的。