# AIChatAssistant

**Repository Path**: Gurid/ai-chat-assistant

## Basic Information

- **Project Name**: AIChatAssistant
- **Description**: 基于Java和DeepSeek的大模型应用
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-03-03
- **Last Updated**: 2025-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 AI Chat Assistant

[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.3.8-brightgreen)](https://spring.io/)
[![LangChain4j](https://img.shields.io/badge/LangChain4j-0.36.2-blue)](https://github.com/langchain4j/langchain4j)
[![License](https://img.shields.io/badge/License-MIT-orange)](LICENSE)

基于Spring Boot + LangChain4j构建的智能对话系统，集成DeepSeek大语言模型，提供安全可靠的实时聊天服务。

![Chat](./picture/chat.png)

## 🌟 核心特性

### 🚀 关键技术栈
| 类别         | 技术组件                                                     |
| ------------ | ------------------------------------------------------------ |
| **后端框架** | Spring Boot 3.3.8，Spring Security，WebSocket，Spring Data JPA |
| **AI集成**   | LangChain4j 0.36.2，DeepSeek API，Ollama本地模型部署         |
| **前端技术** | Thymeleaf 3.1，Bootstrap 5.3，Vanilla JavaScript             |
| **数据库**   | H2 (开发环境)，MySQL 8.0 (生产环境)                          |
| **安全认证** | JWT令牌认证，BCrypt密码加密，请求限流                        |
| **运维支持** | Docker容器化，Actuator健康检查                               |

### ✨ 功能亮点
- **智能对话引擎**
  - 支持流式/非流式双模式响应
  - 上下文感知的多轮对话管理
  - 敏感词过滤与内容安全机制
  - 基于LRU缓存的热点问题快速响应

- **企业级安全架构**
  ```java
  // JWT认证示例
  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
      http
          .addFilterBefore(jwtFilter(), UsernamePasswordAuthenticationFilter.class)
          .authorizeRequests()
              .antMatchers("/api/**").authenticated()
              .anyRequest().permitAll();
  }
  ```

## 🛠 快速开始

### 环境要求

- JDK 17+
- Maven 3.9+
- Docker 20.10+
- Ollama 0.1.25+

### 本地部署

1. 克隆仓库

   ```bash
   git clone https://gitee.com/Gurid/ai-chat-assistant.git
   ```

2. 配置模型服务

   ```bash
   ollama run deepseek-r1:14b
   ollama serve
   ```

3. 启动应用

   ```bash
   mvn spring-boot:run -Dspring-boot.run.profiles=dev
   ```

## 📚 架构设计

### 系统架构图

```mermaid

graph TD
    A[客户端] --> C[Spring Boot应用]
    C --> D[Ollama服务]
    C --> E[MySQL数据库]
    D --> G[DeepSeek模型]
```

### 核心流程

1. **认证授权流程**

  ```mermaid
   sequenceDiagram
       用户->>前端: 提交凭证
       前端->>后端: POST /login
       后端->>数据库: 验证用户
       后端-->>前端: 返回JWT
       前端->>用户: 存储Token
  ```

2. **消息处理流程**

   ```mermaid
   sequenceDiagram
       用户->>前端: 输入消息
       前端->>后端: WebSocket /chat
       后端->>AI引擎: 流式请求
       AI引擎-->>后端: 分块响应
       后端-->>前端: 实时推送
       前端->>用户: 展示消息
   ```