这是一个基于 Spring AI 和 Spring Boot 构建的Web聊天应用程序。项目前端采用HTML、CSS和jQuery,后端集成DeepSeek大模型API,实现了一个支持流式响应和多轮对话记忆的智能聊天机器人。

本项目是一个功能完整的Web聊天应用。用户可以通过简洁的界面与AI进行交互,AI能够联系上下文进行多轮对话。项目后端使用了Spring AI框架,极大地简化了与大语言模型(LLM)的集成和开发过程。

• 后端框架: Spring Boot
• AI 框架: Spring AI
• 语言模型: DeepSeek API
• 前端技术: HTML, CSS, jQuery (JavaScript)
• 构建工具: Maven
• 编程语言: Java 17
• 辅助工具: Lombok

spring_chat_box
├── src
│ ├── main
│ │ ├── java/org/example/spring_chat_box
│ │ │ ├── config
│ │ │ │ └── CommonConfiguration.java // Spring AI 配置类
│ │ │ ├── controller
│ │ │ │ └── ChatController.java // Web API 控制器
│ │ │ ├── model
│ │ │ │ ├── ChatInfo.java // 会话信息模型
│ │ │ │ └── MessageVO.java // 消息视图模型
│ │ │ ├── repository
│ │ │ │ ├── ChatHistoryRepository.java // 会话历史仓库接口
│ │ │ │ └── MemoryChatHistoryRepository.java // 基于内存的实现
│ │ │ └── SpringChatBoxApplication.java // Spring Boot 主应用
│ │ └── resources
│ │ ├── static // 存放前端HTML, CSS, JS文件
│ │ │ ├── index.html
│ │ │ ├── script.js
│ │ │ └── styles.css
│ │ └── application.yml // 配置文件 (API Key等)
└── pom.xml // Maven 配置文件

• ChatController.java: 项目的Web API入口。
  • /stream: 核心接口,接收用户输入(prompt)和会话ID(chatId),通过Flux<String>以流式(SSE)方式将AI的回答实时返回给前端。
  • /getChatIds: 获取所有历史会话的列表。
  • /getChatHistory: 根据会话ID获取具体的聊天记录。
  • /deleteChat: 删除指定的会话历史和记忆。
• CommonConfiguration.java: Spring AI的配置中心。
  • 配置了ChatClient,并设置了全局的系统级prompt(System Prompt),为AI设定了一个默认角色("你是肥波,擅长吹牛皮...")。
  • 配置了InMemoryChatMemory作为会话记忆的存储方案,使得AI能够记住上下文。
  • 通过MessageChatMemoryAdvisor顾问,自动将用户的提问和AI的回答存入会话记忆中。
• MemoryChatHistoryRepository.java: 一个基于内存的LinkedHashMap实现的会话历史记录仓库,用于管理会话列表的标题和ID。

• index.html: 项目的主页面,构建了聊天界面的基本结构,包括左侧的会话列表和右侧的聊天窗口。
• script.js: 前端的核心逻辑。
  • 通过jQuery实现DOM操作和事件绑定。
  • 使用fetch API调用后端的/stream接口,并以流式方式读取和展示AI的回答。
  • 实现了新建会话、加载/切换历史会话、删除会话等功能。
  • 支持解析和渲染AI回答中的LaTeX数学公式(通过MathJax库)。
• styles.css & chat-board.css: 定义了整个聊天界面的样式,实现了现代化的聊天应用外观。

1. 配置API Key:
   • 打开 src/main/resources/application.yml 文件。
   • 将 spring.ai.openai.api-key 的值替换为您自己的DeepSeek API密钥。
2. 运行项目:
   • 确保您的开发环境中已安装Java 17和Maven。
   • 在项目根目录(spring_chat_box)下,执行Maven命令 mvn spring-boot:run 或直接运行 SpringChatBoxApplication.java 类。
3. 访问应用:
   • 项目启动后,默认运行在 16666 端口。
   • 打开浏览器并访问 http://localhost:16666 即可开始使用。