chore: 移除项目文档和技术交流链接

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,41 @@
+---
+name: 漏洞报告
+about: 报告项目中的Bug或安全问题
+title: '[Bug] '
+labels: 'bug'
+assignees: ''
+---
+
+## 问题描述
+
+简要描述遇到的问题：
+
+## 复现步骤
+
+1.
+2.
+3.
+
+## 期望行为
+
+描述你期望发生的情况：
+
+## 实际行为
+
+描述实际发生的情况：
+
+## 环境信息
+
+| 项目 | 信息 |
+|:---|:---|
+| 操作系统 |  |
+| JDK版本 |  |
+| 项目版本 |  |
+
+## 截图/日志
+
+如有相关信息，请在此粘贴：
+
+## 补充说明
+
+其他补充信息：

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/ISSUE_TEMPLATE/custom.md

@@ -0,0 +1,15 @@
+---
+name: 自定义
+about: 其他问题或讨论
+title: ''
+labels: ''
+assignees: ''
+---
+
+## 描述
+
+请详细描述你的问题或需求：
+
+## 补充信息
+
+如有其他补充，请在此填写：

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,31 @@
+---
+name: 想法建议
+about: 提出新功能建议或改进想法
+title: '[Feature] '
+labels: 'enhancement'
+assignees: ''
+---
+
+## 建议类型
+
+□ 新功能  □ 功能改进  □ 文档完善  □ 其他
+
+## 建议描述
+
+清晰描述你的建议内容：
+
+## 使用场景
+
+描述这个功能在什么场景下会用到：
+
+## 期望效果
+
+描述你期望的效果：
+
+## 参考示例
+
+如有类似的参考实现或产品，请提供链接：
+
+## 补充说明
+
+其他补充信息：

README.md

@@ -1,10 +1,6 @@
-
-
 # RuoYi AI
 
-
-
-<!-- PROJECT SHIELDS -->
+<div align="center">
 
 [![Contributors][contributors-shield]][contributors-url]
 [![Forks][forks-shield]][forks-url]
@@ -13,324 +9,199 @@
 [![MIT License][license-shield]][license-url]
 
 
-<!-- PROJECT LOGO -->
-<br />
-
-
-<img style="text-align: center;" src="image/00.png" alt="Logo" width="150" height="150">
-
-<h3 style="text-align: center;">快速搭建属于自己的 AI 助手平台</h3>
-
-<p style="text-align: center;">
-    全新升级，开箱即用，简单高效
-    <br />
-    <a href="https://doc.pandarobot.chat"><strong>探索本项目的文档 »</strong></a>
-    <br />
-    <br />
-    <a href="https://web.pandarobot.chat">项目预览</a>
-    ·
-    <a href="https://github.com/ageerle/ruoyi-ai/issues">报告Bug</a>
-    ·
-    <a href="https://github.com/ageerle/ruoyi-ai/issues">提出新特性</a>
+<p align="center">
+  <a href="https://trendshift.io/repositories/13209">
+    <img src="https://trendshift.io/api/badge/repositories/13209" alt="GitHub Trending">
+  </a>
 </p>
 
-## 快速启动
 
-### 拉取镜像(最低配置2H2G):
-   ```bash
-     script/deploy/deploy目录下执行: docker-compose up -d
-  ```
+<img src="image/00.png" alt="RuoYi AI Logo" width="120" height="120">
 
-### 通过脚本启动(最低配置4H4G):
-1. 确认系统内已经安装好以下软件
-   - docker
-   - docker-compose
-   - git
-   - unzip
+### 企业级AI助手平台
 
-2. **克隆项目**
-   ```bash
-   git clone https://github.com/ageerle/ruoyi-ai
-   cd ruoyi-ai/script/deploy/one-step-script
-   ```
+*开箱即用的智能AI平台，深度集成 FastGPT、扣子(Coze)、DIFY 等主流AI平台，提供先进的RAG技术、知识图谱、数字人和AI流程编排能力*
 
-3. **启动部署脚本**
+**[🇺🇸 English](README_EN.md)** | **[📖 使用文档](https://doc.pandarobot.chat)** | *
+*[🚀 在线体验](https://web.pandarobot.chat)** | **[🐛 问题反馈](https://github.com/ageerle/ruoyi-ai/issues)** | *
+*[💡 功能建议](https://github.com/ageerle/ruoyi-ai/issues)**
 
-   中文界面部署脚本(拉取gitee仓库)：
-
-   ```bash
-   ./deploy-cn.sh
-   ```
-   按照脚本提示一步步操作,如果是一台新服务器,选择默认配置,直接回车即可。
-   <img src="image/deploy-01.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-
-   耐心等待安装完成...
-
-   英文界面部署脚本(拉取github仓库)：
-   
-   ```bash
-   ./deploy-en.sh
-   ```
-
-4. 如果在执行部署脚本过程中不需要在本地重新构建编译服务软件包以及重新封装容器镜像，则需要在脚本交互提出以下问题时选择D按键进行直接部署，否则就会执行全新的编译构建及容器封装之后再执行部署：
-     ```
-     已将模板文件复制到部署目录。
-     正在使用您的配置更新 .env 文件...
-     已使用您的配置更新 .env 文件。
-     正在使用您的配置更新 docker-compose.yaml 文件...
-     已使用您的配置更新 docker-compose.yaml 文件。
-
-     === 构建或部署选项 ===
-     您想构建新镜像 (B) 还是直接使用现有镜像部署 (D)？[B/d]: 
-     ```
-
-5. **访问应用界面**
-   - 用户界面：`http://your-server-ip:8081`
-   - 管理员界面：`http://your-server-ip:8082`
-
-## 目录
-
-- [系统体验](#系统体验)
-- [源码地址](#源码地址)
-- [配套文档](#项目文档)
-- [核心功能](#核心功能)
-- [项目演示](#项目演示)
-  - [管理端](#管理端)
-  - [用户端](#用户端)
-- [开发环境](#开发环境)
-- [项目结构](#项目结构)
-  - [ruoyi-ai](#ruoyi-ai)
-- [注意事项](#注意事项)
-  - [vben模板](#vben模板)
-- [贡献者](#贡献者)
-  - [如何参与开源项目](#如何参与开源项目)
-- [版本控制](#版本控制)
-- [作者](#作者)
-- [鸣谢](#鸣谢)
-- [技术讨论群](#技术讨论群)
-
-### 系统体验
-- 用户端：https://web.pandarobot.chat
-- 演示账号: demo 密码：demo123
-- 管理端：https://admin.pandarobot.chat
-- 演示账号: admin 密码：admin123
-- 商业版：体验商业版请联系下方小助手获取演示地址（预计6月份上线）。
-
-### 源码地址
-[1]github
-- 前端服务-用户端: https://github.com/ageerle/ruoyi-web
-- 前端服务-管理端: https://github.com/ageerle/ruoyi-admin
-- 后端服务：https://github.com/ageerle/ruoyi-ai
-
-[2]gitcode
-- 前端服务-用户端：https://gitcode.com/ageerle/ruoyi-web
-- 前端服务-管理端:  https://gitcode.com/ageerle/ruoyi-admin
-- 后端服务：https://gitcode.com/ageerle/ruoyi-ai
-
-### 配套文档
-- 配套文档: https://doc.pandarobot.chat
-- 项目部署文档：https://doc.pandarobot.chat/guide/introduction/
-
-### 核心功能与技术亮点
-#### 1. 全栈式开源系统
-- 全套开源系统：提供完整的前端应用、后台管理,基于MIT协议，开箱即用。
-#### 2. 本地化 RAG 方案
--  基于 **Langchain4j** 框架，支持 Milvus/Weaviate/Qdrant 向量库，结合 BGE-large-zh-v1.5 本地向量化模型 实现高效文档检索与知识库构建。
--  支持 本地 LLM 接入，结合私有知识库实现安全可控的问答系统，避免依赖云端服务的隐私风险。
-#### 3. 多模态 AI 引擎与工具集成
--  智能对话：支持 OpenAI GPT-4、Azure、ChatGLM 等主流模型，内置 SSE/WebSocket 协议实现低延迟交互，兼容 **扣子**、**DIFY** 等平台 API 调用。
--  **Spring AI MCP** 支持：通过注解快速定义本地工具，支持调用 MCP 广场 的海量 MCP Server 服务，扩展模型能力边界。
-#### 4. 企业级扩展与商业化支持
--  即时通讯集成：支持对接个人微信、企业微信及微信公众号，实现消息自动回复、用户管理与智能客服。
--  支付系统：集成易支付、微信支付、Stripe 国际信用卡支付，满足商业化场景需求。
-#### 5. 多媒体处理与创新功能
- -  AI 绘画：集成 DALL·E-3、MidJourney、Stable Diffusion，支持文生图、图生图及风格化创作，适用于营销素材生成与创意设计。
- -  PPT 制作：根据文本输入自动生成结构化幻灯片，支持自定义模板(需要使用三方平台 如：文多多)。
-
-### 项目演示
-
-#### mcp支持
-<div style="display: flex; flex-wrap: wrap; gap: 20px; justify-content: center;">
-  <img src="image/mcp-01.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/mcp-02.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/mcp-03.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/mcp-04.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
 </div>
 
+## ✨ 核心亮点
+
+### 智能AI引擎
+
+- **多模型接入**：支持 OpenAI GPT-4、Azure、ChatGLM、通义千问、智谱AI 等主流模型
+- **AI平台集成**：深度集成 **FastGPT**、**扣子(Coze)**、**DIFY** 等主流AI应用平台
+- **Spring AI MCP 集成**：基于模型上下文协议，打造可扩展的AI工具生态系统
+- **实时流式对话**：采用 SSE/WebSocket 技术，提供丝滑的对话体验
+- **AI 编程助手**：内置智能代码分析和项目脚手架生成能力
+
+### AI平台生态集成
+
+- **FastGPT 深度集成**：原生支持 FastGPT API，包括知识库检索、工作流编排和上下文管理
+- **扣子(Coze) 官方SDK**：集成字节跳动扣子平台官方SDK，支持Bot对话和流式响应
+- **DIFY 完整兼容**：使用 DIFY Java Client，支持应用编排、工作流和知识库管理
+- **统一聊天接口**：提供统一的聊天服务接口，支持多平台无缝切换和负载均衡
+
+### 本地化RAG方案
+
+- **私有知识库**：基于 Langchain4j 框架 + BGE-large-zh-v1.5 中文向量模型
+- **多种向量库**：支持 Milvus、Weaviate、Qdrant 等主流向量数据库
+- **数据安全可控**：支持完全本地部署，保护企业数据隐私
+- **灵活模型部署**：兼容 Ollama、vLLM 等本地推理框架
+
+### AI创作工具
+
+- **AI 绘画创作**：深度集成 DALL·E-3、MidJourney、Stable Diffusion
+- **智能PPT生成**：一键将文本内容转换为精美演示文稿
+- **多模态理解**：支持文本、图片、文档等多种格式的智能处理
+
+### 知识图谱与智能编排
+
+- **知识图谱构建**：自动从文档和对话中提取实体关系，构建可视化知识网络
+- **AI 流程编排**：可视化工作流设计器，支持复杂AI任务的编排和自动化执行
+- **数字人交互**：集成数字人形象，提供更自然的人机交互体验
+- **智能推理引擎**：基于知识图谱的智能推理和问答能力
+
+## 🚀 快速体验
+
+### 在线演示
+
+- **用户端体验**：[web.pandarobot.chat](https://web.pandarobot.chat) (账号：admin 密码：admin123)
+- **管理后台**：[admin.pandarobot.chat](https://admin.pandarobot.chat) (账号：admin 密码：admin123)
+
+### 项目源码
+
+| 项目模块     | GitHub 仓库                                             | Gitee 仓库                                             | GitCode 仓库                                             |
+|----------|-------------------------------------------------------|------------------------------------------------------|--------------------------------------------------------|
+| 🔧 后端服务  | [ruoyi-ai](https://github.com/ageerle/ruoyi-ai)       | [ruoyi-ai](https://gitee.com/ageerle/ruoyi-ai)       | [ruoyi-ai](https://gitcode.com/ageerle/ruoyi-ai)       |
+| 🎨 用户前端  | [ruoyi-web](https://github.com/ageerle/ruoyi-web)     | [ruoyi-web](https://gitee.com/ageerle/ruoyi-web)     | [ruoyi-web](https://gitcode.com/ageerle/ruoyi-web)     |
+| 🛠️ 管理后台 | [ruoyi-admin](https://github.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitee.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitcode.com/ageerle/ruoyi-admin) |
+
+### 合作项目
+
+| 项目介绍  |                               GitHub 仓库                                |                             Gitee 仓库                             |
+|:-----:|:----------------------------------------------------------------------:|:----------------------------------------------------------------:|
+| 前端简化版 | [ruoyi-element-ai](https://github.com/element-plus-x/ruoyi-element-ai) | [ruoyi-element-ai](https://gitee.com/he-jiayue/ruoyi-element-ai) |
+
+## 🛠️ 技术架构
+
+### 核心框架
+
+- **后端架构**：Spring Boot 3.4 + Spring AI + Langchain4j
+- **数据存储**：MySQL 8.0 + Redis + 向量数据库（Milvus/Weaviate/Qdrant）
+- **前端技术**：Vue 3 + Vben Admin + Naive UI
+- **安全认证**：Sa-Token + JWT 双重保障
+
+### 系统组件
+
+- **文档处理**：PDF、Word、Excel 解析，图像智能分析  
+- **实时通信**：WebSocket 实时通信，SSE 流式响应  
+- **系统监控**：完善的日志体系、性能监控、服务健康检查  
+
+## 📚 使用文档
+
+想要深入了解安装部署、功能配置和二次开发？
+
+**👉 [完整使用文档](https://doc.pandarobot.chat)**
+
+遇到知识库或 RAG 回答异常问题？
+
+**👉 [RAG 回答异常排查手册](docs/troubleshooting/rag-failures.md)**
+
+---
+
+## 🤝 参与贡献
+
+我们热烈欢迎社区贡献！无论您是资深开发者还是初学者，都可以为项目贡献力量 💪
+
+### 贡献方式
+
+1. **Fork** 项目到您的账户
+2. **创建分支** (`git checkout -b feature/新功能名称`)
+3. **提交代码** (`git commit -m '添加某某功能'`)
+4. **推送分支** (`git push origin feature/新功能名称`)
+5. **发起 Pull Request**
+
+> 💡 **小贴士**：建议将 PR 提交到 GitHub，我们会自动同步到其他代码托管平台
+
+## 📄 开源协议
+
+本项目采用 **MIT 开源协议**，详情请查看 [LICENSE](LICENSE) 文件。
+
+## 🙏 特别鸣谢
+
+感谢以下优秀的开源项目为本项目提供支持：
+
+- [Spring AI Alibaba Copilot](https://github.com/springaialibaba/spring-ai-alibaba-copilot) - 基于spring-ai-alibaba
+  的智能编码助手
+- [Spring AI](https://spring.io/projects/spring-ai) - Spring 官方 AI 集成框架
+- [Langchain4j](https://github.com/langchain4j/langchain4j) - 强大的 Java LLM 开发框架
+- [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus) - 成熟的企业级快速开发框架
+- [Vben Admin](https://github.com/vbenjs/vue-vben-admin) - 现代化的 Vue 后台管理模板
+- [chatgpt-java](https://github.com/Grt1228/chatgpt-java) - 优秀的 ChatGPT Java SDK
+
+## 🌐 生态伙伴
+
+- [PPIO 派欧云](https://ppinfra.com/user/register?invited_by=P8QTUY&utm_source=github_ruoyi-ai) - 提供高性价比的 GPU
+  算力和模型 API 服务
+- [优云智算](https://www.compshare.cn/?ytag=GPU_YY-gh_ruoyi) - 万卡RTX40系GPU+海内外主流模型API服务，秒级响应，按量计费，新客免费用。
+- [胜算云](https://www.shengsuanyun.com/?from=CH_3WG71ZOS) - AI模型算力聚合超市云服务。
+
+## 💬 社区交流
+
+<div align="center">
+
+<table>
+<tr>
+<td align="center">
+<img src="image/wx.png" alt="微信二维码" width="200" height="200"><br>
+<strong>扫码添加作者微信</strong><br>
+<em>邀请进群学习</em>
+</td>
+<td align="center">
+<img src="image/qq.png" alt="QQ群二维码" width="200" height="200"><br>
+<strong>QQ技术交流群</strong><br>
+<em>技术讨论</em>
+</td>
+
+</tr>
+</table>
 
-#### 用户端
-<div style="display: flex; flex-wrap: wrap; gap: 20px; justify-content: center;">
-  <img src="image/08.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/09.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/10.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/11.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
 </div>
 
-#### 管理端
-<div style="display: flex; flex-wrap: wrap; gap: 20px; justify-content: center;">
-  <img src="image/02.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/03.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/04.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-  <img src="image/05.png" alt="drawing" style="width: 600px; height: 300px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
+---
+
+<div align="center">
+
+**[⭐ 点个Star支持一下](https://github.com/ageerle/ruoyi-ai)** • *
+*[🍴 Fork 开始贡献](https://github.com/ageerle/ruoyi-ai/fork)** • **[📚 English](README_EN.md)** • *
+*[📖 查看完整文档](https://doc.pandarobot.chat)**
+
+*用 ❤️ 打造，由 RuoYi AI 开源社区维护*
+
 </div>
 
+<!-- Badge Links -->
 
-### 开发环境
-
-1. jdk 17
-2. mysql 5.7、8.0
-3. redis 版本必须 >= 5.X
-4. maven 3.8+
-5. nodejs 20+ & pnpm
-
-- 附-部署配套视频：https://www.bilibili.com/video/BV1jDXkYWEba
-
-<div>
-  <img src="image/教程搭建.png" alt="drawing" width="600px" height="300px"/>
-</div>
-
-### 项目结构
-- RuoYi-AI
-
-```
-├─ ruoyi-admin                         // 管理模块
-│  └─ RuoYiApplication                 // 启动类
-│  └─ RuoYiServletInitializer          // 容器部署初始化类
-│  └─ resources                        // 资源文件
-│      └─ i18n/messages.properties     // 国际化配置文件
-│      └─ application.yml              // 框架总配置文件
-│      └─ application-dev.yml          // 开发环境配置文件
-│      └─ application-prod.yml         // 生产环境配置文件
-│      └─ banner.txt                   // 框架启动图标
-│      └─ logback-plus.xml             // 日志配置文件
-│      └─ ip2region.xdb                // IP区域地址库
-├─ ruoyi-common                        // 通用模块
-│  └─ ruoyi-common-bom                 // common依赖包管理
-   └─ ruoyi-common-chat                // 聊天模块
-│  └─ ruoyi-common-core                // 核心模块
-│  └─ ruoyi-common-doc                 // 系统接口模块
-│  └─ ruoyi-common-encrypt             // 数据加解密模块
-│  └─ ruoyi-common-excel               // excel模块
-│  └─ ruoyi-common-idempotent          // 幂等功能模块
-│  └─ ruoyi-common-json                // 序列化模块
-│  └─ ruoyi-common-log                 // 日志模块
-│  └─ ruoyi-common-mail                // 邮件模块
-│  └─ ruoyi-common-mybatis             // 数据库模块
-│  └─ ruoyi-common-oss                 // oss服务模块
-│  └─ ruoyi-common-pay                 // 支付模块
-│  └─ ruoyi-common-ratelimiter         // 限流功能模块
-│  └─ ruoyi-common-redis               // 缓存服务模块
-│  └─ ruoyi-common-satoken             // satoken模块
-│  └─ ruoyi-common-security            // 安全模块
-│  └─ ruoyi-common-sensitive           // 脱敏模块
-│  └─ ruoyi-common-sms                 // 短信模块
-│  └─ ruoyi-common-tenant              // 租户模块
-│  └─ ruoyi-common-translation         // 通用翻译模块
-│  └─ ruoyi-common-web                 // web模块
-├─ ruoyi-modules                       // 模块组
-│  └─ ruoyi-demo                       // 演示模块
-│  └─ ruoyi-system                     // 业务模块
-├─ .run                 // 执行脚本文件
-├─ .editorconfig        // 编辑器编码格式配置
-├─ LICENSE              // 开源协议
-├─ pom.xml              // 公共依赖
-├─ README.md            // 框架说明文件
-
-
-```
-
-### 注意事项
-- vben模板
-
-    Q：vben5 的模板默认是没有的吗？
-  
-    A：vben模板是收费的 请联系vben-vue-plus作者获取。
-
-### 版本控制
-
-该项目使用Git进行版本管理。您可以在repository参看当前可用版本。
-
-
-### 版权说明
-
-该项目使用了MIT授权许可，详情请参阅 [LICENSE.txt](https://github.com/ageerle/ruoyi-ai/blob/main/LICENSE)
-
-###  项目现状
-
-目前，项目还处于早期阶段，距离成熟还有很长的路要走。由于个人精力有限，项目的发展速度受到了一定的限制。为了加快项目的进度，我真诚地希望更多人能够参与到项目中来。无论是经验丰富的开发者，还是刚刚入门的小白，我都热烈欢迎你们提交Pull Request（PR）👏👏👏。即使代码修改得很少，或者存在一些错误，都没有关系。我会认真审核每一位贡献者的代码，并和大家一起完善项目⛽️⛽️⛽️。
-
-###  开发计划
-
-| 主题 | 方向                                | 时间节点   | 
-| --- |-----------------------------------|--------| 
-| 前端简化版 | 与element-plus-x框架合作，推出基于该框架的前端简化版 | 2025.5 | 
-| agent2agent | Agent2Agent协议支持                   | 2025.6 | 
-| 流程编排 | 通过可视化界面和灵活的配置方式，快速构建AI应用          | 2025.7 | 
-
-
--  感谢
-
-最后，我要感谢RuoYi-Vue-Plus、chatgpt-java、chatgpt-web-midjourney-proxy等优秀框架。正是因为这些项目的开源和共享，我才能够在这个基础上进行开发，使我们的项目能够取得今天的成果。再次感谢这些项目及其背后的开发者们！
-
-希望更多志同道合的朋友能够加入我们，共同推动这个项目的发展。让我们一起努力，将这个项目打造成一个真正成熟、实用的AI平台！
-
-#### 如何参与开源项目
-
-贡献使开源社区成为一个学习、激励和创造的绝佳场所。你所作的任何贡献，我们都非常感谢！🙏
-
-1. Fork 这个项目
-2. 创建你的功能分支 (`git checkout -b feature/dev`)
-3. 提交你的更改 (`git commit -m 'Add some dev'`)
-4. 推送到分支 (`git push origin feature/dev`)
-5. 打开拉取请求
-6. pr请提交到GitHub上，会定时同步到gitee
-
-#### 项目文档
-1. 项目文档基于vitepress构建
-2. 按照[如何参与开源项目](#如何参与开源项目)拉取https://github.com/ageerle/ruoyi-doc
-3. 安装依赖：npm install
-4. 启动项目：npm run docs:dev
-5. 主页路径：docs/guide/introduction/index.md
-
-### 鸣谢
-- [chatgpt-java](https://github.com/Grt1228/chatgpt-java)
-- [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus)
-- [chatgpt-web-midjourney-proxy](https://github.com/Dooy/chatgpt-web-midjourney-proxy)
-- [Vben Admin](https://github.com/vbenjs/vue-vben-admin)
-- [Naive UI](https://www.naiveui.com)
-
-<!-- links -->
-[your-project-path]:https://github.com/ageerle/ruoyi-ai
 [contributors-shield]: https://img.shields.io/github/contributors/ageerle/ruoyi-ai.svg?style=flat-square
+
 [contributors-url]: https://github.com/ageerle/ruoyi-ai/graphs/contributors
+
 [forks-shield]: https://img.shields.io/github/forks/ageerle/ruoyi-ai.svg?style=flat-square
+
 [forks-url]: https://github.com/ageerle/ruoyi-ai/network/members
+
 [stars-shield]: https://img.shields.io/github/stars/ageerle/ruoyi-ai.svg?style=flat-square
+
 [stars-url]: https://github.com/ageerle/ruoyi-ai/stargazers
+
 [issues-shield]: https://img.shields.io/github/issues/ageerle/ruoyi-ai.svg?style=flat-square
-[issues-url]: https://img.shields.io/github/issues/ageerle/ruoyi-ai.svg
+
+[issues-url]: https://github.com/ageerle/ruoyi-ai/issues
+
 [license-shield]: https://img.shields.io/github/license/ageerle/ruoyi-ai.svg?style=flat-square
-[license-url]: https://github.com/ageerle/ruoyi-ai/blob/master/LICENSE.txt
-[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555
-
-## 🌿 第三方生态
-- [PPIO 派欧云：一键调用高性价比的开源模型 API 和 GPU 容器](https://ppinfra.com/user/register?invited_by=P8QTUY&utm_source=github_ruoyi-ai)
-
-### 附：技术讨论群
-
-#### 技术交流（如需进群请添加小助手）
-<div style="display: flex; flex-wrap: wrap; gap: 20px; justify-content: center;">
- <img src="image/wx.png" alt="drawing" style="width: 400px; height: 400px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-</div>
- 
-
-#### 进群学习
-🏠 小助手wx：ruoyi-ai（加人备注：ruoyi-ai）
-🏠 小助手qq：1603234088 （加人备注：ruoyi-ai）
-
-👏👏👏 ruoyi-ai官方交流群（qq区）
-
-<div style="display: flex; flex-wrap: wrap; gap: 20px; justify-content: center;">
-  <img src="image/qq.png" alt="drawing" style="width: 400px; height: 400px; border: 2px solid #ddd; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"/>
-</div>
 
+[license-url]: https://github.com/ageerle/ruoyi-ai/blob/main/LICENSE

README_EN.md

@@ -0,0 +1,200 @@
+# RuoYi AI
+
+<div align="center">
+
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![MIT License][license-shield]][license-url]
+
+<img src="image/00.png" alt="RuoYi AI Logo" width="120" height="120">
+
+### Enterprise-Grade AI Assistant Platform
+
+*Production-ready AI platform with deep integration of FastGPT, Coze, DIFY, featuring advanced RAG technology, knowledge
+graphs, digital humans, and AI workflow orchestration*
+
+**[📖 中文文档](README.md)** | **[📚 Documentation](https://doc.pandarobot.chat)** | *
+*[🚀 Live Demo](https://web.pandarobot.chat)** | **[🐛 Report Bug](https://github.com/ageerle/ruoyi-ai/issues)** | *
+*[💡 Request Feature](https://github.com/ageerle/ruoyi-ai/issues)**
+
+</div>
+
+## ✨ Key Features
+
+### 🤖 Advanced AI Engine
+
+- **Multi-Model Support**: OpenAI GPT-4, Azure, ChatGLM, Qwen, ZhipuAI
+- **AI Platform Integration**: Deep integration with **FastGPT**, **Coze**, **DIFY** and other leading AI platforms
+- **Spring AI MCP Integration**: Extensible tool ecosystem with Model Context Protocol
+- **Streaming Chat**: Real-time SSE/WebSocket communication
+- **AI Copilot**: Intelligent code analysis and project scaffolding
+
+### 🌟 AI Platform Ecosystem
+
+- **FastGPT Deep Integration**: Native FastGPT API support with knowledge base retrieval, workflow orchestration and
+  context management
+- **Coze Official SDK**: Integration with ByteDance Coze platform official SDK, supporting Bot conversations and
+  streaming responses
+- **DIFY Full Compatibility**: Using DIFY Java Client for app orchestration, workflows and knowledge base management
+- **Unified Chat Interface**: Standardized chat service interface supporting seamless platform switching and load
+  balancing
+
+### 🧠 Enterprise RAG Solution
+
+- **Local Knowledge Base**: Langchain4j + BGE-large-zh-v1.5 embeddings
+- **Vector Database Support**: Milvus, Weaviate, Qdrant
+- **Privacy-First**: On-premise deployment with local LLM support
+- **Ollama & vLLM Compatible**: Flexible model deployment options
+
+### 🎨 Creative AI Tools
+
+- **AI Art Generation**: DALL·E-3, MidJourney, Stable Diffusion integration
+- **PPT Creation**: Automated slide generation from text input
+- **Multi-Modal Processing**: Text, image, and document understanding
+
+### 🧩 Knowledge Graph & Intelligent Orchestration
+
+- **Knowledge Graph Construction**: Automatically extract entities and relationships from documents and conversations to
+  build visual knowledge networks
+- **AI Workflow Orchestration**: Visual workflow designer supporting complex AI task orchestration and automated
+  execution
+- **Digital Human Interaction**: Integrated digital human avatars for more natural human-computer interaction
+- **Intelligent Reasoning Engine**: Knowledge graph-based intelligent reasoning and Q&A capabilities
+
+## 🚀 Quick Start
+
+### Live Demo
+
+- **User Portal**: [web.pandarobot.chat](https://web.pandarobot.chat) (demo/demo123)
+- **Admin Panel**: [admin.pandarobot.chat](https://admin.pandarobot.chat) (admin/admin123)
+
+### Source Code
+
+| Component      | GitHub                                                | Gitee                                                | GitCode                                                |
+|----------------|-------------------------------------------------------|------------------------------------------------------|--------------------------------------------------------|
+| Backend API    | [ruoyi-ai](https://github.com/ageerle/ruoyi-ai)       | [ruoyi-ai](https://gitee.com/ageerle/ruoyi-ai)       | [ruoyi-ai](https://gitcode.com/ageerle/ruoyi-ai)       |
+| User Frontend  | [ruoyi-web](https://github.com/ageerle/ruoyi-web)     | [ruoyi-web](https://gitee.com/ageerle/ruoyi-web)     | [ruoyi-web](https://gitcode.com/ageerle/ruoyi-web)     |
+| Admin Frontend | [ruoyi-admin](https://github.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitee.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitcode.com/ageerle/ruoyi-admin) |
+
+### Collaborative Projects
+
+| Project Description |                           GitHub Repository                            |                         Gitee Repository                         |
+|:-------------------:|:----------------------------------------------------------------------:|:----------------------------------------------------------------:|
+| Simplified Frontend | [ruoyi-element-ai](https://github.com/element-plus-x/ruoyi-element-ai) | [ruoyi-element-ai](https://gitee.com/he-jiayue/ruoyi-element-ai) |
+
+## 🛠️ Tech Stack
+
+### Core Framework
+
+- **Backend**: Spring Boot 3.4, Spring AI, Langchain4j
+- **Database**: MySQL 8.0, Redis, Vector Databases (Milvus/Weaviate/Qdrant)
+- **Frontend**: Vue 3, Vben Admin, Naive UI
+- **Authentication**: Sa-Token, JWT
+
+### System Components
+
+- **File Processing**: PDF, Word, Excel parsing, intelligent image analysis
+- **Real-time Communication**: WebSocket real-time communication, SSE streaming
+- **System Monitoring**: Comprehensive logging, performance monitoring, health checks
+
+## 📚 Documentation
+
+For detailed setup, configuration, and development guides, visit our comprehensive documentation:
+
+**[📖 Official Documentation](https://doc.pandarobot.chat)**
+
+## 🤝 Contributing
+
+We welcome contributions from developers of all skill levels! Whether you're fixing bugs, adding features, or improving
+documentation, your help is appreciated.
+
+### How to Contribute
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+*Please submit PRs to GitHub - they will be synchronized to other platforms automatically.*
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+Special thanks to these amazing open source projects:
+
+- [Spring AI Alibaba Copilot](https://github.com/springaialibaba/spring-ai-alibaba-copilot) - Intelligent coding
+  assistant based on spring-ai-alibaba with MCP protocol integration for project analysis and code generation
+- [Spring AI](https://spring.io/projects/spring-ai) - Spring's AI integration framework
+- [Langchain4j](https://github.com/langchain4j/langchain4j) - Java LLM framework
+- [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus) - Enterprise development framework
+- [Vben Admin](https://github.com/vbenjs/vue-vben-admin) - Vue admin template
+- [chatgpt-java](https://github.com/Grt1228/chatgpt-java) - ChatGPT Java SDK
+
+## 🌐 Ecosystem Partners
+
+- [PPIO Cloud](https://ppinfra.com/user/register?invited_by=P8QTUY&utm_source=github_ruoyi-ai) - Cost-effective GPU
+  containers and model APIs
+
+## 💬 Community
+
+<div align="center">
+
+<table>
+<tr>
+<td align="center">
+<img src="image/wx.png" alt="WeChat" width="200" height="200"><br>
+<strong>Add Author WeChat</strong><br>
+<em>Scan to join learning group</em>
+</td>
+<td align="center">
+<img src="image/qq.png" alt="QQ Group" width="200" height="200"><br>
+<strong>QQ Group</strong><br>
+<em>Technical discussion</em>
+</td>
+</tr>
+</table>
+
+</div>
+
+---
+
+<div align="center">
+
+**[⭐ Star this repo](https://github.com/ageerle/ruoyi-ai)** • **[🍴 Fork it](https://github.com/ageerle/ruoyi-ai/fork)
+** • **[📖 中文文档](README.md)** • **[📚 Documentation](https://doc.pandarobot.chat)**
+
+*Built with ❤️ by the RuoYi AI community*
+
+</div>
+
+<!-- Badge Links -->
+
+[contributors-shield]: https://img.shields.io/github/contributors/ageerle/ruoyi-ai.svg?style=flat-square
+
+[contributors-url]: https://github.com/ageerle/ruoyi-ai/graphs/contributors
+
+[forks-shield]: https://img.shields.io/github/forks/ageerle/ruoyi-ai.svg?style=flat-square
+
+[forks-url]: https://github.com/ageerle/ruoyi-ai/network/members
+
+[stars-shield]: https://img.shields.io/github/stars/ageerle/ruoyi-ai.svg?style=flat-square
+
+[stars-url]: https://github.com/ageerle/ruoyi-ai/stargazers
+
+[issues-shield]: https://img.shields.io/github/issues/ageerle/ruoyi-ai.svg?style=flat-square
+
+[issues-url]: https://github.com/ageerle/ruoyi-ai/issues
+
+[license-shield]: https://img.shields.io/github/license/ageerle/ruoyi-ai.svg?style=flat-square
+
+[license-url]: https://github.com/ageerle/ruoyi-ai/blob/main/LICENSE
+
+
+
+

docs/RuoYi-AI 后端部署教程（Docker 部署版）.md

@@ -0,0 +1,222 @@
+## RuoYi-AI 后端部署教程（Docker 部署版）
+
+### 一、前置条件
+
+在部署前，请确保系统已满足以下条件：
+
+#### ✅ 系统环境要求
+
+- 操作系统：Linux / MacOS（推荐 Linux 服务器）
+- CPU：4 核以上
+- 内存：≥ 4GB
+- 磁盘空间：≥ 10GB（建议 20GB+）
+
+#### ✅ 已安装软件
+
+- **Docker**
+- **Docker Compose**
+
+验证命令是否可用：
+
+```
+docker -v
+docker compose version
+```
+
+若无输出或提示“command not found”，请先安装 Docker 及 Compose。
+
+------
+
+### 二、目录结构配置
+
+#### 1️⃣ 创建部署目录
+
+在目标服务器执行以下命令：
+
+```
+# 第一级目录
+mkdir /ruoyi-ai
+cd /ruoyi-ai
+
+# 第二级目录
+mkdir deploy
+cd deploy
+
+# 第三级目录
+mkdir data mysql-init
+
+# 第四级目录
+mkdir logs minio minio-config mysql redis weaviate
+```
+
+> 💡 `data` 目录用于挂载容器运行期间生成的数据文件。
+
+最终目录结构示例：
+
+```
+/ruoyi-ai
+ └── deploy
+     ├── data/
+     ├── mysql-init/
+     ├── logs/
+     ├── minio/
+     ├── minio-config/
+     ├── mysql/
+     ├── redis/
+     ├── weaviate/
+```
+
+------
+
+### 三、上传配置文件
+
+将以下配置文件上传到 `/ruoyi-ai/deploy` 目录：
+
+- `docker-compose.yaml`
+- `.env`
+- `ruoyi-ai.sql`
+- `Dockerfile`
+
+> 📂 这些文件在项目目录 `/script/deploy/deploy` 下。
+> 上传后请检查文件路径是否与上方目录结构一致。
+
+------
+
+### 四、构建 Jar 包
+
+1. 打开 IDEA 或其他构建工具
+2. 选择 **Maven 构建配置**，勾选 `prod` 环境，取消 `dev` 环境
+3. 点击 `package` 进行打包
+4. **注意：** 在构建前请将 `application-prod.yml` 拖入
+   `ruoyi-admin/src/main/resources` 目录中
+
+构建完成后会在：
+
+```
+ruoyi-admin/target/ruoyi-admin.jar
+```
+
+生成打包文件。
+
+------
+
+### 五、上传 Jar 包至服务器
+
+将生成的 `ruoyi-admin.jar` 上传到服务器 `/ruoyi-ai/deploy` 目录下。
+确保与 `Dockerfile` 同目录。
+
+------
+
+### 六、构建 Docker 镜像
+
+`Dockerfile` 内容如下：
+
+```
+FROM openjdk:17-jdk
+
+RUN mkdir -p /ruoyi/server/logs \
+    /ruoyi/server/temp
+
+WORKDIR /ruoyi/server
+COPY ruoyi-admin.jar ruoyi-admin.jar
+
+ENTRYPOINT ["java","-jar","ruoyi-admin.jar"]
+```
+
+在 `/ruoyi-ai/deploy` 目录执行以下命令：
+
+```
+# 构建镜像
+docker build -t ruoyi-ai-backend:v20251013 .
+
+# 查看镜像是否构建成功
+docker image ls
+```
+
+然后在 `docker-compose.yaml` 文件中，将对应服务的镜像名修改为：
+
+```
+image: ruoyi-ai-backend:v20251013
+```
+
+------
+
+### 七、启动容器服务
+
+在启动前请确认：
+
+- `.env` 中端口号、数据库密码、环境变量已正确配置
+- `docker-compose.yaml` 中 MySQL 的端口已开放（用于导入数据）
+
+如示例：
+
+```
+ports:
+  - "3306:3306"
+```
+
+#### 启动命令：
+
+```
+cd /ruoyi-ai/deploy
+docker compose up -d
+```
+
+#### 查看运行状态：
+
+```
+docker compose ps
+```
+
+#### 查看日志：
+
+```
+docker logs -f <容器名称>
+```
+
+> ⚠️ 初次启动时可仅运行 `ruoyi-admin`（后端）模块，将前端 `ruoyi-web` 服务暂时注释，确认后端服务正常后再启用前端容器。
+
+------
+
+### 八、数据库初始化
+
+启动 MySQL 容器后，执行以下操作：
+
+```
+docker exec -it <mysql_container_name> bash
+mysql -uroot -p
+source /docker-entrypoint-initdb.d/ruoyi-ai.sql;
+```
+
+或手动在客户端中导入 `/ruoyi-ai/deploy/ruoyi-ai.sql` 文件。
+
+------
+
+### 九、常用 Docker 命令
+
+| 功能        | 命令                                |
+|-----------|-----------------------------------|
+| 查看容器状态    | `docker ps -a`                    |
+| 查看日志      | `docker logs -f <容器名>`            |
+| 停止服务      | `docker compose down`             |
+| 重启服务      | `docker compose restart`          |
+| 重新构建镜像    | `docker compose build --no-cache` |
+| 清理无用镜像/容器 | `docker system prune -a`          |
+
+------
+
+### 🔍 十、部署验证
+
+1. 检查容器是否全部启动成功：
+
+   ```
+   docker compose ps
+   ```
+
+2. 访问后端接口：
+
+   ```
+   http://<服务器IP>:<后端端口>
+   ```
+
+3. 检查日志输出无异常。

docs/troubleshooting/rag-failures.md

@@ -0,0 +1,352 @@
+<a id="top"></a>
+
+# RAG 常见故障排查（16 问题清单）
+
+当知识库已经接入，系统也能正常回答，但结果仍然出现命中错误、引用旧内容、推理漂移、跨轮次失忆，或部署后表面可用但实际异常时，最常见的问题不是“模型不行”，而是**不同层的故障被混在一起处理**。
+
+这份页面不重新发明一套新方法。  
+它直接使用一份固定的 **16 问题清单** 作为排查主轴，让你先把问题标到正确的 **No.X**，再决定下一步查哪里、改哪里，而不是一次性乱改检索、模型、切块、会话和部署配置。
+
+这份清单的核心目的只有一个：
+
+**先把问题放进正确的故障域，再做修复。**
+
+快速导航：  
+[这页怎么用](#how-to-use) | [标签说明](#legend) | [常见症状入口](#symptoms) | [16 问题清单](#map16) | [按层排查](#by-layer) |
+
+---
+
+<a id="how-to-use"></a>
+
+## 一、这页怎么用
+
+这不是一篇“从头到尾照着做”的传统教程。  
+它更像一张固定的 RAG 故障地图，作用是先帮助你**判断故障属于哪一种类型**。
+
+建议按下面顺序使用：
+
+### 1. 先看现象，不要先改配置
+
+先回答两个问题：
+
+1. 你看到的故障，最像哪一种症状
+2. 这个故障更像发生在输入检索层、推理层、状态层，还是部署层
+
+在还没判断层级之前，不要先一起改这些东西：
+
+- 检索条数
+- 切块大小
+- 会话配置
+- 模型参数
+- 部署顺序
+- 依赖服务
+
+如果先全部一起动，问题通常只会更难定位。
+
+### 2. 先给问题打上 No.X 标签
+
+这份页面最重要的动作，不是“立刻修好”，而是先做一件小事：
+
+**给当前问题贴上最接近的 No.X。**
+
+例如：
+
+- 检索结果看起来相似，但其实答非所问，先看 `No.1` 或 `No.5`
+- 切块是对的，但结论还是错，先看 `No.2`
+- 系统回答很自信，但没有根据，先看 `No.4`
+- 刚部署完就炸，先看 `No.14` 到 `No.16`
+
+### 3. 一次只排一个故障域
+
+同一个表面现象，背后可能是不同层的问题。  
+例如“答案不对”既可能是：
+
+- `No.1` 检索漂移
+- `No.2` 理解塌陷
+- `No.4` 自信乱答
+- `No.8` 根本看不到错误路径
+
+所以这张表的用法不是“多选全改”，而是：
+
+**先挑最接近的一项，优先验证这一项是否成立。**
+
+[返回顶部](#top) | [下一节：标签说明](#legend)
+
+---
+
+<a id="legend"></a>
+
+## 二、标签说明
+
+这份 16 问题清单本身已经带有层级 / 标签结构。  
+这些标签不是装饰，而是用来帮助你快速判断故障发生在哪一层。
+
+### 1. 层级标签
+
+- `[IN]`：输入与检索  
+  输入、切块、召回、语义匹配、可见性问题
+
+- `[RE]`：推理与规划  
+  理解、推理、归纳、逻辑链、抽象处理问题
+
+- `[ST]`：状态与上下文  
+  会话、记忆、上下文连续性、多代理状态问题
+
+- `[OP]`：基础设施与部署  
+  启动顺序、依赖就绪、部署锁死、预部署状态问题
+
+### 2. `{OBS}` 标签
+
+带 `{OBS}` 的项，通常都和“**你是否看得见问题是怎么坏掉的**”有关。  
+它们往往不是单纯回答错误，而是：
+
+- 错误路径不可见
+- 漂移过程不可见
+- 状态熔化过程不可见
+- 多代理覆盖过程不可见
+
+所以一旦你发现“我知道结果错，但我根本看不到它是怎么错的”，通常就已经很接近 `{OBS}` 类问题了。
+
+### 3. 为什么要保留这些标签
+
+因为同样叫“答错了”，实际含义完全不同。
+
+例如：
+
+- `[IN]` 的答错，常常是**拿错材料**
+- `[RE]` 的答错，常常是**拿对材料但理解错**
+- `[ST]` 的答错，常常是**前文断掉、状态漂移**
+- `[OP]` 的答错，常常是**系统根本没在完整状态下运行**
+
+如果不先分层，就会掉进典型的 RAG 地狱：  
+表面在改答案，实际上在盲修。
+
+[返回顶部](#top) | [下一节：常见症状入口](#symptoms)
+
+---
+
+<a id="symptoms"></a>
+
+## 三、常见症状入口
+
+如果你现在还不知道该从哪一项开始，就先从症状入口反查。
+
+### 1. 检索返回了错误内容，或看起来相关但其实不回答问题
+
+这类问题最常见的是：  
+“有命中，但命中的不是该用的内容。”
+
+优先看：
+
+- [No.1](#no1) `幻觉与切块漂移`
+- [No.5](#no5) `语义 ≠ 向量嵌入`
+- [No.8](#no8) `调试是一个黑箱`
+
+### 2. 切块本身是对的，但最终答案还是错的
+
+这类问题不是简单没检索到，而是后面那层坏了。
+
+优先看：
+
+- [No.2](#no2) `解释塌陷`
+- [No.4](#no4) `虚张声势 / 过度自信`
+- [No.6](#no6) `逻辑塌陷与恢复`
+
+### 3. 多步任务一开始正常，后面越来越偏
+
+这类问题通常不是单点错误，而是中途漂移或熔化。
+
+优先看：
+
+- [No.3](#no3) `长推理链`
+- [No.6](#no6) `逻辑塌陷与恢复`
+- [No.9](#no9) `熵塌陷`
+
+### 4. 多轮对话后开始失忆，跨轮次接不上
+
+这类问题一般已经进入状态层。
+
+优先看：
+
+- [No.7](#no7) `跨会话记忆断裂`
+- [No.9](#no9) `熵塌陷`
+- [No.13](#no13) `多代理混乱`
+
+### 5. 遇到抽象、逻辑、规则、符号关系就崩
+
+这类问题通常不是检索空，而是推理结构扛不住。
+
+优先看：
+
+- [No.11](#no11) `符号塌陷`
+- [No.12](#no12) `哲学递归`
+
+### 6. 你根本不知道错在哪一层，只知道结果不对
+
+这类问题先不要乱调参数。  
+先解决“不可见”的问题。
+
+优先看：
+
+- [No.8](#no8) `调试是一个黑箱`
+
+### 7. 刚部署完最容易炸，首轮调用异常，重启后偶尔恢复
+
+这类问题通常不在答案逻辑，而在部署状态。
+
+优先看：
+
+- [No.14](#no14) `引导启动顺序`
+- [No.15](#no15) `部署死锁`
+- [No.16](#no16) `预部署塌陷`
+
+[返回顶部](#top) | [下一节：16 问题清单](#map16)
+
+---
+
+<a id="map16"></a>
+
+## 四、16 问题清单（固定主表）
+
+下面这 16 项按固定顺序使用。  
+不要先重组，不要先混类，先判断最接近哪一个 **No.X**。
+
+| # | 问题域（含层级/标签） | 会坏在哪里 |
+|---|---|---|
+| <a id="no1"></a> 1 | `[IN] 幻觉与切块漂移 {OBS}` | 检索返回错误/无关内容 |
+| <a id="no2"></a> 2 | `[RE] 解释塌陷` | 切块是对的，逻辑是错的 |
+| <a id="no3"></a> 3 | `[RE] 长推理链 {OBS}` | 在多步任务中逐步漂移 |
+| <a id="no4"></a> 4 | `[RE] 虚张声势 / 过度自信` | 自信但没有根据的回答 |
+| <a id="no5"></a> 5 | `[IN] 语义 ≠ 向量嵌入 {OBS}` | 余弦匹配 ≠ 真实语义 |
+| <a id="no6"></a> 6 | `[RE] 逻辑塌陷与恢复 {OBS}` | 走入死胡同，需要受控重置 |
+| <a id="no7"></a> 7 | `[ST] 跨会话记忆断裂` | 线索丢失，没有连续性 |
+| <a id="no8"></a> 8 | `[IN] 调试是一个黑箱 {OBS}` | 看不到故障路径 |
+| <a id="no9"></a> 9 | `[ST] 熵塌陷` | 注意力熔化，输出失去连贯性 |
+| <a id="no10"></a> 10 | `[RE] 创造力冻结` | 平直、字面化输出 |
+| <a id="no11"></a> 11 | `[RE] 符号塌陷` | 抽象/逻辑性提示词失效 |
+| <a id="no12"></a> 12 | `[RE] 哲学递归` | 自我引用循环、悖论陷阱 |
+| <a id="no13"></a> 13 | `[ST] 多代理混乱 {OBS}` | 代理互相覆盖或使逻辑错位 |
+| <a id="no14"></a> 14 | `[OP] 引导启动顺序` | 依赖未就绪时服务先启动 |
+| <a id="no15"></a> 15 | `[OP] 部署死锁` | 基础设施中的循环等待 |
+| <a id="no16"></a> 16 | `[OP] 预部署塌陷 {OBS}` | 首次调用时版本错配 / 缺少密钥 |
+
+这张表是主表。  
+如果你时间很少，只做一件事也行：
+
+**先从这 16 项里选出最接近的一项。**
+
+[返回顶部](#top) | [下一节：按层排查](#by-layer)
+
+---
+
+<a id="by-layer"></a>
+
+## 五、按层排查：不要改错层
+
+这一节不重写 16 项，只是告诉你：  
+当你已经选到某个 No.X 时，第一眼应该优先查哪一层。
+
+### A. `[IN]` 层：先确认你拿到的是不是对的材料
+
+对应编号：
+
+- [No.1](#no1)
+- [No.5](#no5)
+- [No.8](#no8)
+
+这层最常见的误判是：
+
+“我以为系统理解错了，其实它一开始就拿错了东西。”
+
+如果你命中了弱相关片段、表面相似文本、错误切块，后面推理再强也没用。  
+所以 `[IN]` 层优先看的是：
+
+1. 原始召回内容到底是什么
+2. 命中的片段是否只是“相似”，而不是“正确”
+3. 你是否能看到检索过程，还是整个过程像黑箱
+
+这层如果没先排好，后面的推理诊断通常会失真。
+
+### B. `[RE]` 层：材料可能是对的，但系统用错了
+
+对应编号：
+
+- [No.2](#no2)
+- [No.3](#no3)
+- [No.4](#no4)
+- [No.6](#no6)
+- [No.10](#no10)
+- [No.11](#no11)
+- [No.12](#no12)
+
+这层最常见的误判是：
+
+“我以为是检索坏了，其实是后面理解、归纳、逻辑链坏了。”
+
+例如：
+
+- 切块是对的，但结论错了 → 常见是 `No.2`
+- 多步任务中途开始偏 → 常见是 `No.3`
+- 回答很笃定，但完全站不住 → 常见是 `No.4`
+- 遇到抽象规则就崩 → 常见是 `No.11`
+- 陷入循环解释 → 常见是 `No.12`
+
+如果 `[IN]` 层已经基本没问题，答案还是不对，就应该优先回到 `[RE]` 层判断是哪一种塌陷。
+
+### C. `[ST]` 层：单轮正常，不代表状态层正常
+
+对应编号：
+
+- [No.7](#no7)
+- [No.9](#no9)
+- [No.13](#no13)
+
+这层最常见的误判是：
+
+“单轮看起来还行，所以我以为系统没问题。”
+
+其实很多 RAG 地狱不是单轮错误，而是：
+
+- 多轮之后前文断掉
+- 上下文越来越乱
+- 多角色、多代理之间互相覆盖
+
+如果你发现：
+
+- 第一轮没事，后面越来越歪
+- 切换角色后前面的约束消失
+- 多个步骤之间状态彼此污染
+
+那就不要再只盯着检索条数了，应该直接回到 `[ST]` 层看 `No.7 / No.9 / No.13`。
+
+### D. `[OP]` 层：别把部署问题误诊成回答问题
+
+对应编号：
+
+- [No.14](#no14)
+- [No.15](#no15)
+- [No.16](#no16)
+
+这层最常见的误判是：
+
+“答案不稳定，所以我先去调模型或检索。”
+
+但如果系统根本没有在完整状态下启动，所有上层表现都会像鬼打墙。  
+尤其是这些情况：
+
+- 依赖还没就绪，服务先起了 → `No.14`
+- 多个组件互相等待，长期半可用 → `No.15`
+- 首次调用就因为版本、密钥、环境没对齐而塌陷 → `No.16`
+
+只要你看到“刚部署最容易出事”“首轮异常最严重”“重启后暂时恢复”，就要优先怀疑 `[OP]` 层，而不是先改提示词或参数。
+
+[返回顶部](#top) |
+
+---
+
+<a id="issue-report"></a>
+
+
+## 六、快速返回
+
+[返回顶部](#top) | [这页怎么用](#how-to-use) | [标签说明](#legend) | [常见症状入口](#symptoms) | [16 问题清单](#map16) | [按层排查](#by-layer) 

docs/工作流模块说明.md

@@ -0,0 +1,452 @@
+# Ruoyi-AI 工作流模块详细说明文档
+
+## 概述
+
+Ruoyi-AI 工作流模块是一个基于 LangGraph4j 的智能工作流引擎，支持可视化工作流设计、AI 模型集成、条件分支、人机交互等高级功能。该模块采用微服务架构，提供完整的
+RESTful API 和流式响应支持。
+
+## 模块架构
+
+### 1. 模块结构
+
+```
+ruoyi-ai/
+├── ruoyi-modules/
+│   └── ruoyi-workflow/           # 工作流核心模块
+│       ├── pom.xml
+│       └── src/main/java/org/ruoyi/workflow/
+│           └── controller/       # 控制器层
+│               ├── WorkflowController.java
+│               ├── WorkflowRuntimeController.java
+│               └── admin/        # 管理端控制器
+│                   ├── AdminWorkflowController.java
+│                   └── AdminWorkflowComponentController.java
+└── ruoyi-modules-api/
+    └── ruoyi-workflow-api/       # 工作流API模块
+        ├── pom.xml
+        └── src/main/java/org/ruoyi/workflow/
+            ├── entity/           # 实体类
+            ├── dto/              # 数据传输对象
+            ├── service/          # 服务接口
+            ├── mapper/           # 数据访问层
+            ├── workflow/         # 工作流核心逻辑
+            ├── enums/            # 枚举类
+            ├── util/             # 工具类
+            └── exception/        # 异常处理
+```
+
+### 2. 核心依赖
+
+- **LangGraph4j**: 1.5.3 - 工作流图执行引擎
+- **LangChain4j**: 1.2.0 - AI 模型集成框架
+- **Spring Boot**: 3.x - 应用框架
+- **MyBatis Plus**: 数据访问层
+- **Redis**: 缓存和状态管理
+- **Swagger/OpenAPI**: API 文档
+
+## 核心功能
+
+### 1. 工作流管理
+
+#### 1.1 工作流定义
+
+- **创建工作流**: 支持自定义标题、描述、公开性设置
+- **编辑工作流**: 可视化节点编辑、连接线配置
+- **版本控制**: 支持工作流的版本管理和回滚
+- **权限管理**: 支持公开/私有工作流设置
+
+#### 1.2 工作流执行
+
+- **流式执行**: 基于 SSE 的实时流式响应
+- **状态管理**: 完整的执行状态跟踪
+- **错误处理**: 详细的错误信息和异常处理
+- **中断恢复**: 支持工作流中断和恢复执行
+
+### 2. 节点类型
+
+#### 2.1 基础节点
+
+- **Start**: 开始节点，定义工作流入口
+- **End**: 结束节点，定义工作流出口
+
+#### 2.2 AI 模型节点
+
+- **Answer**: 大语言模型问答节点
+- **Dalle3**: DALL-E 3 图像生成
+- **Tongyiwanx**: 通义万相图像生成
+- **Classifier**: 内容分类节点
+
+#### 2.3 数据处理节点
+
+- **DocumentExtractor**: 文档信息提取
+- **KeywordExtractor**: 关键词提取
+- **FaqExtractor**: 常见问题提取
+- **KnowledgeRetrieval**: 知识库检索
+
+#### 2.4 控制流节点
+
+- **Switcher**: 条件分支节点
+- **HumanFeedback**: 人机交互节点
+
+#### 2.5 外部集成节点
+
+- **Google**: Google 搜索集成
+- **MailSend**: 邮件发送
+- **HttpRequest**: HTTP 请求
+- **Template**: 模板转换
+
+### 3. 数据流管理
+
+#### 3.1 输入输出定义
+
+```java
+// 节点输入输出数据结构
+public class NodeIOData {
+    private String name;           // 参数名称
+    private NodeIODataContent content; // 参数内容
+}
+
+// 支持的数据类型
+public enum WfIODataTypeEnum {
+    TEXT,        // 文本
+    NUMBER,      // 数字
+    BOOLEAN,     // 布尔值
+    FILES,       // 文件
+    OPTIONS      // 选项
+}
+```
+
+#### 3.2 参数引用
+
+- **节点间引用**: 支持上游节点输出作为下游节点输入
+- **参数映射**: 自动处理参数名称映射
+- **类型转换**: 自动进行数据类型转换
+
+## 数据库设计
+
+### 1. 核心表结构
+
+#### 1.1 工作流定义表 (t_workflow)
+
+```sql
+CREATE TABLE t_workflow (
+    id          BIGINT AUTO_INCREMENT PRIMARY KEY,
+    uuid        VARCHAR(32)  NOT NULL DEFAULT '',
+    title       VARCHAR(100) NOT NULL DEFAULT '',
+    remark      TEXT         NOT NULL DEFAULT '',
+    user_id     BIGINT       NOT NULL DEFAULT 0,
+    is_public   TINYINT(1)   NOT NULL DEFAULT 0,
+    is_enable   TINYINT(1)   NOT NULL DEFAULT 1,
+    create_time DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    update_time DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    is_deleted  TINYINT(1)   NOT NULL DEFAULT 0
+);
+```
+
+#### 1.2 工作流节点表 (t_workflow_node)
+
+```sql
+CREATE TABLE t_workflow_node (
+    id                    BIGINT AUTO_INCREMENT PRIMARY KEY,
+    uuid                  VARCHAR(32)  NOT NULL DEFAULT '',
+    workflow_id           BIGINT       NOT NULL DEFAULT 0,
+    workflow_component_id BIGINT       NOT NULL DEFAULT 0,
+    user_id               BIGINT       NOT NULL DEFAULT 0,
+    title                 VARCHAR(100) NOT NULL DEFAULT '',
+    remark                VARCHAR(500) NOT NULL DEFAULT '',
+    input_config          JSON         NOT NULL DEFAULT ('{}'),
+    node_config           JSON         NOT NULL DEFAULT ('{}'),
+    position_x            DOUBLE       NOT NULL DEFAULT 0,
+    position_y            DOUBLE       NOT NULL DEFAULT 0,
+    create_time           DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    update_time           DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    is_deleted            TINYINT(1)   NOT NULL DEFAULT 0
+);
+```
+
+#### 1.3 工作流边表 (t_workflow_edge)
+
+```sql
+CREATE TABLE t_workflow_edge (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    uuid             VARCHAR(32) NOT NULL DEFAULT '',
+    workflow_id      BIGINT      NOT NULL DEFAULT 0,
+    source_node_uuid VARCHAR(32) NOT NULL DEFAULT '',
+    source_handle    VARCHAR(32) NOT NULL DEFAULT '',
+    target_node_uuid VARCHAR(32) NOT NULL DEFAULT '',
+    create_time      DATETIME    NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    update_time      DATETIME    NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    is_deleted       TINYINT(1)  NOT NULL DEFAULT 0
+);
+```
+
+#### 1.4 工作流运行时表 (t_workflow_runtime)
+
+```sql
+CREATE TABLE t_workflow_runtime (
+    id            BIGINT AUTO_INCREMENT PRIMARY KEY,
+    uuid          VARCHAR(32)  NOT NULL DEFAULT '',
+    user_id       BIGINT       NOT NULL DEFAULT 0,
+    workflow_id   BIGINT       NOT NULL DEFAULT 0,
+    input         JSON         NOT NULL DEFAULT ('{}'),
+    output        JSON         NOT NULL DEFAULT ('{}'),
+    status        SMALLINT     NOT NULL DEFAULT 1,
+    status_remark VARCHAR(250) NOT NULL DEFAULT '',
+    create_time   DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    update_time   DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    is_deleted    TINYINT(1)   NOT NULL DEFAULT 0
+);
+```
+
+#### 1.5 工作流组件表 (t_workflow_component)
+
+```sql
+CREATE TABLE t_workflow_component (
+    id            BIGINT AUTO_INCREMENT PRIMARY KEY,
+    uuid          VARCHAR(32)  DEFAULT '' NOT NULL,
+    name          VARCHAR(32)  DEFAULT '' NOT NULL,
+    title         VARCHAR(100) DEFAULT '' NOT NULL,
+    remark        TEXT                   NOT NULL,
+    display_order INT          DEFAULT 0 NOT NULL,
+    is_enable     TINYINT(1)   DEFAULT 0 NOT NULL,
+    create_time   DATETIME     DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    update_time   DATETIME     DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    is_deleted    TINYINT(1)   DEFAULT 0 NOT NULL
+);
+```
+
+## API 接口
+
+### 1. 工作流管理接口
+
+#### 1.1 基础操作
+
+```http
+# 创建工作流
+POST /workflow/add
+Content-Type: application/json
+{
+    "title": "工作流标题",
+    "remark": "工作流描述",
+    "isPublic": false
+}
+
+# 更新工作流
+POST /workflow/update
+Content-Type: application/json
+{
+    "uuid": "工作流UUID",
+    "title": "新标题",
+    "remark": "新描述"
+}
+
+# 删除工作流
+POST /workflow/del/{uuid}
+
+# 启用/禁用工作流
+POST /workflow/enable/{uuid}?enable=true
+```
+
+#### 1.2 搜索和查询
+
+```http
+# 搜索我的工作流
+GET /workflow/mine/search?keyword=关键词&isPublic=true&currentPage=1&pageSize=10
+
+# 搜索公开工作流
+GET /workflow/public/search?keyword=关键词&currentPage=1&pageSize=10
+
+# 获取工作流组件列表
+GET /workflow/public/component/list
+```
+
+### 2. 工作流执行接口
+
+#### 2.1 流式执行
+
+```http
+# 流式执行工作流
+POST /workflow/run
+Content-Type: application/json
+Accept: text/event-stream
+{
+    "uuid": "工作流UUID",
+    "inputs": [
+        {
+            "name": "input",
+            "content": {
+                "type": 1,
+                "textContent": "用户输入内容"
+            }
+        }
+    ]
+}
+```
+
+#### 2.2 运行时管理
+
+```http
+# 恢复中断的工作流
+POST /workflow/runtime/resume/{runtimeUuid}
+Content-Type: application/json
+{
+    "feedbackContent": "用户反馈内容"
+}
+
+# 查询工作流执行历史
+GET /workflow/runtime/page?wfUuid=工作流UUID&currentPage=1&pageSize=10
+
+# 查询运行时节点详情
+GET /workflow/runtime/nodes/{runtimeUuid}
+
+# 清理运行时数据
+POST /workflow/runtime/clear?wfUuid=工作流UUID
+```
+
+### 3. 管理端接口
+
+#### 3.1 工作流管理
+
+```http
+# 搜索所有工作流
+POST /admin/workflow/search
+Content-Type: application/json
+{
+    "title": "搜索关键词",
+    "isPublic": true,
+    "isEnable": true
+}
+
+# 启用/禁用工作流
+POST /admin/workflow/enable?uuid=工作流UUID&isEnable=true
+```
+
+## 核心实现
+
+### 1. 工作流引擎 (WorkflowEngine)
+
+工作流引擎是整个模块的核心，负责：
+
+- 工作流图的构建和编译
+- 节点执行调度
+- 状态管理和持久化
+- 流式输出处理
+
+```java
+public class WorkflowEngine {
+    // 核心执行方法
+    public void run(User user, List<ObjectNode> userInputs, SseEmitter sseEmitter) {
+        // 1. 验证工作流状态
+        // 2. 创建运行时实例
+        // 3. 构建状态图
+        // 4. 执行工作流
+        // 5. 处理流式输出
+    }
+    
+    // 恢复执行方法
+    public void resume(String userInput) {
+        // 1. 更新状态
+        // 2. 继续执行
+    }
+}
+```
+
+### 2. 节点工厂 (WfNodeFactory)
+
+节点工厂负责根据组件类型创建对应的节点实例：
+
+```java
+public class WfNodeFactory {
+    public static AbstractWfNode create(WorkflowComponent component, 
+                                      WorkflowNode node, 
+                                      WfState wfState, 
+                                      WfNodeState nodeState) {
+        // 根据组件类型创建对应的节点实例
+        switch (component.getName()) {
+            case "Answer":
+                return new LLMAnswerNode(component, node, wfState, nodeState);
+            case "Switcher":
+                return new SwitcherNode(component, node, wfState, nodeState);
+            // ... 其他节点类型
+        }
+    }
+}
+```
+
+### 3. 图构建器 (WorkflowGraphBuilder)
+
+图构建器负责将工作流定义转换为可执行的状态图：
+
+```java
+public class WorkflowGraphBuilder {
+    public StateGraph<WfNodeState> build(WorkflowNode startNode) {
+        // 1. 构建编译节点树
+        // 2. 转换为状态图
+        // 3. 添加节点和边
+        // 4. 处理条件分支
+        // 5. 处理并行执行
+    }
+}
+```
+
+## 流式响应机制
+
+### 1. SSE 事件类型
+
+工作流执行过程中会发送多种类型的 SSE 事件：
+
+```javascript
+// 节点开始执行
+[NODE_RUN_节点UUID] - 节点执行开始事件
+
+// 节点输入数据
+[NODE_INPUT_节点UUID] - 节点输入数据事件
+
+// 节点输出数据
+[NODE_OUTPUT_节点UUID] - 节点输出数据事件
+
+// 流式内容块
+[NODE_CHUNK_节点UUID] - 流式内容块事件
+
+// 等待用户输入
+[NODE_WAIT_FEEDBACK_BY_节点UUID] - 等待用户输入事件
+```
+
+### 2. 流式处理流程
+
+1. **初始化**: 创建工作流运行时实例
+2. **节点执行**: 逐个执行工作流节点
+3. **实时输出**: 通过 SSE 实时推送执行结果
+4. **状态更新**: 实时更新节点和工作流状态
+5. **错误处理**: 捕获并处理执行过程中的错误
+
+## 扩展开发
+
+### 1. 自定义节点开发
+
+要开发自定义工作流节点，需要：
+
+1. **创建节点类**：继承 `AbstractWfNode`
+2. **实现处理逻辑**：重写 `onProcess()` 方法
+3. **定义配置类**：创建节点配置类
+4. **注册组件**：在组件表中注册新组件
+
+```java
+public class CustomNode extends AbstractWfNode {
+    @Override
+    protected NodeProcessResult onProcess() {
+        // 实现自定义处理逻辑
+        List<NodeIOData> outputs = new ArrayList<>();
+        // ... 处理逻辑
+        return NodeProcessResult.success(outputs);
+    }
+}
+```
+
+### 2. 自定义组件注册
+
+```sql
+-- 在 t_workflow_component 表中添加新组件
+INSERT INTO t_workflow_component (uuid, name, title, remark, is_enable) 
+VALUES (REPLACE(UUID(), '-', ''), 'CustomNode', '自定义节点', '自定义节点描述', true);
+```

docs/文件上传接口文档.md

@@ -0,0 +1,42 @@
+## 接口信息
+
+**接口路径**: `POST /resource/oss/upload`
+**请求类型**: `multipart/form-data`
+**权限要求**: `system:oss:upload`
+**业务类型**: [INSERT]
+
+### 接口描述
+上传OSS对象存储接口，用于将文件上传到对象存储服务。
+
+### 请求参数
+| 参数名  | 类型            | 必填   | 说明     |
+| ---- | ------------- | ---- | ------ |
+| file | MultipartFile | 是    | 要上传的文件 |
+
+### 请求头
+- `Content-Type`: `multipart/form-data`
+
+### 返回值
+返回 `R<SysOssUploadVo>` 类型，包含以下字段：
+| 字段名      | 类型     | 说明      |
+| -------- | ------ | ------- |
+| url      | String | 文件访问URL |
+| fileName | String | 原始文件名   |
+| ossId    | String | 文件ID    |
+
+### 响应示例
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {
+    "url": "fileid://xxx",
+    "fileName": "example.jpg",
+    "ossId": "123"
+  }
+}
+```
+
+
+### 异常情况
+- 当上传文件为空时，返回错误信息："上传文件不能为空"

pom.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
@@ -20,7 +20,7 @@
         <java.version>17</java.version>
         <mysql.version>8.0.33</mysql.version>
         <mybatis.version>3.5.16</mybatis.version>
-        <springdoc.version>2.8.5</springdoc.version>
+        <springdoc.version>2.8.13</springdoc.version>
         <therapi-javadoc.version>0.15.0</therapi-javadoc.version>
         <poi.version>5.2.3</poi.version>
         <easyexcel.version>3.2.1</easyexcel.version>
@@ -40,6 +40,8 @@
         <mapstruct-plus.lombok.version>0.2.0</mapstruct-plus.lombok.version>
         <lombok.version>1.18.26</lombok.version>
         <bouncycastle.version>1.72</bouncycastle.version>
+        <!-- Apache Commons Compress 版本 -->
+        <commons-compress.version>1.26.2</commons-compress.version>
         <!-- 离线IP地址定位库 -->
         <ip2region.version>2.7.0</ip2region.version>
         <!-- OSS 配置 -->
@@ -48,6 +50,11 @@
         <aliyun.sms.version>2.0.23</aliyun.sms.version>
         <tencent.sms.version>3.1.687</tencent.sms.version>
 
+        <!-- Neo4j 相关版本 -->
+        <neo4j-driver.version>5.26.0</neo4j-driver.version>
+        <neo4j-cypher-dsl.version>2024.1.0</neo4j-cypher-dsl.version>
+        <langchain4j-neo4j.version>1.2.0-beta8</langchain4j-neo4j.version>
+
         <!-- 插件版本 -->
         <maven-jar-plugin.version>3.2.2</maven-jar-plugin.version>
         <maven-war-plugin.version>3.2.2</maven-war-plugin.version>
@@ -263,13 +270,6 @@
                 <version>${lock4j.version}</version>
             </dependency>
 
-            <!-- xxl-job-core -->
-            <dependency>
-                <groupId>com.xuxueli</groupId>
-                <artifactId>xxl-job-core</artifactId>
-                <version>${xxl-job.version}</version>
-            </dependency>
-
             <dependency>
                 <groupId>com.alibaba</groupId>
                 <artifactId>transmittable-thread-local</artifactId>
@@ -283,6 +283,13 @@
                 <version>${bouncycastle.version}</version>
             </dependency>
 
+            <!-- Apache Commons Compress -->
+            <dependency>
+                <groupId>org.apache.commons</groupId>
+                <artifactId>commons-compress</artifactId>
+                <version>${commons-compress.version}</version>
+            </dependency>
+
             <dependency>
                 <groupId>io.github.linpeilie</groupId>
                 <artifactId>mapstruct-plus-spring-boot-starter</artifactId>
@@ -332,6 +339,53 @@
                 <artifactId>ruoyi-generator</artifactId>
                 <version>${revision}</version>
             </dependency>
+
+            <dependency>
+                <groupId>org.ruoyi</groupId>
+                <artifactId>ruoyi-graph</artifactId>
+                <version>${revision}</version>
+            </dependency>
+
+            <!-- Neo4j Driver -->
+            <dependency>
+                <groupId>org.neo4j.driver</groupId>
+                <artifactId>neo4j-java-driver</artifactId>
+                <version>${neo4j-driver.version}</version>
+            </dependency>
+
+            <!-- Neo4j Cypher DSL -->
+            <dependency>
+                <groupId>org.neo4j</groupId>
+                <artifactId>neo4j-cypher-dsl</artifactId>
+                <version>${neo4j-cypher-dsl.version}</version>
+            </dependency>
+
+            <!-- Langchain4j Neo4j 扩展 -->
+            <dependency>
+                <groupId>dev.langchain4j</groupId>
+                <artifactId>langchain4j-community-neo4j</artifactId>
+                <version>${langchain4j-neo4j.version}</version>
+            </dependency>
+
+            <dependency>
+                <groupId>org.ruoyi</groupId>
+                <artifactId>ruoyi-aihuman</artifactId>
+                <version>${revision}</version>
+            </dependency>
+
+
+            <dependency>
+                <groupId>org.ruoyi</groupId>
+                <artifactId>ruoyi-workflow</artifactId>
+                <version>${revision}</version>
+            </dependency>
+
+            <dependency>
+                <groupId>org.ruoyi</groupId>
+                <artifactId>ruoyi-workflow-api</artifactId>
+                <version>${revision}</version>
+            </dependency>
+
         </dependencies>
     </dependencyManagement>
 
@@ -471,6 +525,4 @@
         </pluginRepository>
     </pluginRepositories>
 
-</project>
-
-
+</project>

ruoyi-admin/pom.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <parent>
         <artifactId>ruoyi-ai</artifactId>
@@ -57,6 +57,21 @@
             <artifactId>ruoyi-generator</artifactId>
         </dependency>
 
+        <!-- 知识图谱模块 -->
+        <dependency>
+            <groupId>org.ruoyi</groupId>
+            <artifactId>ruoyi-graph</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.ruoyi</groupId>
+            <artifactId>ruoyi-workflow</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>org.ruoyi</groupId>
+            <artifactId>ruoyi-aihuman</artifactId>
+        </dependency>
+
     </dependencies>
 
     <build>

ruoyi-admin/src/main/java/org/ruoyi/RuoYiAIApplication.java

@@ -11,7 +11,7 @@ import org.springframework.scheduling.annotation.EnableScheduling;
  *
  * @author Lion Li
  */
-@SpringBootApplication
+@SpringBootApplication(scanBasePackages = {"org.ruoyi", "org.ruoyi.aihuman"})
 @EnableScheduling
 @EnableAsync
 public class RuoYiAIApplication {
@@ -22,4 +22,4 @@ public class RuoYiAIApplication {
         application.run(args);
         System.out.println("(♥◠‿◠)ﾉﾞ  RuoYiAI启动成功   ლ(´ڡ`ლ)ﾞ");
     }
-}
+}

ruoyi-admin/src/main/java/org/ruoyi/controller/AuthController.java

@@ -81,6 +81,7 @@ public class AuthController {
 
     /**
      * 访客登录
+     *
      * @param loginBody 登录信息
      * @return token信息
      */
@@ -119,7 +120,7 @@ public class AuthController {
      */
     @PostMapping("/register")
     public R<Void> register(@Validated @RequestBody RegisterBody user, HttpServletRequest request) {
-        String domainName =  request.getServerName();
+        String domainName = request.getServerName();
         user.setDomainName(domainName);
         registerService.register(user);
         return R.ok();

ruoyi-admin/src/main/java/org/ruoyi/controller/IndexController.java

@@ -22,5 +22,4 @@ public class IndexController {
     }
 
 
-
 }

ruoyi-admin/src/main/resources/application-dev.yml

@@ -1,4 +1,3 @@
-
 --- # 数据源配置
 spring:
   datasource:
@@ -17,8 +16,8 @@ spring:
           type: ${spring.datasource.type}
           driverClassName: com.mysql.cj.jdbc.Driver
           url: jdbc:mysql://127.0.0.1:3306/ruoyi-ai?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true
-          username: ruoyi-ai
-          password: ruoyi-ai
+          username: root
+          password: root
 
       hikari:
         # 最大连接池数量
@@ -37,6 +36,8 @@ spring:
         connectionTestQuery: SELECT 1
         # 多久检查一次连接的活性
         keepaliveTime: 30000
+  mail:
+    username: xx
 
 --- # redis 单机配置(单机与集群只能开启一个另一个需要注释掉)
 spring.data:
@@ -85,4 +86,23 @@ sms:
   # 腾讯专用
   sdkAppId:
 
+pdf:
+  extract:
+    service:
+      url: http://localhost:8080
+    ai-api:
+      url: https://api.pandarobot.chat/v1/chat/completions
+      key: sk-xxxx
+  transition:
+    # 是否开启mineru
+    enable-minerU: true
+    # mineru conda环境路径
+    conda-env-path: "F:\\ProgramData\\Computer\\Anaconda\\envs\\mineru"
+    # 是否开启图片OCR
+    enable-ocr: true
+
+
+
+
+
 

ruoyi-admin/src/main/resources/application.yml

@@ -1,16 +1,13 @@
-
 # 项目相关配置
 ruoyi:
   # 名称
-  name: "ruoyi"
+  name: "ruoyi-ai"
   # 版本
   version: ${revision}
   # 版权年份
   copyrightYear: 2025
   # 实例演示开关
-  demoEnabled: true
-  # 获取ip地址开关
-  addressEnabled: false
+  demoEnabled: false
 
 captcha:
   enable: false
@@ -133,6 +130,9 @@ security:
     - /chat/send
     # 文件上传
     - /chat/upload
+    # 代码生成调用
+    - /tool/gen/getByTableName
+    - /tool/gen/batchGenCode
     # 静态资源
     - /*.html
     - /**/*.html
@@ -144,9 +144,20 @@ security:
     # swagger 文档配置
     - /*/api-docs
     - /*/api-docs/**
+    - /v3/api-docs
+    - /v3/api-docs/**
+    - /v3/api-docs/swagger-config
+    - /swagger-ui.html
+    - /swagger-ui/**
+    - /doc.html
+    - /webjars/**
+    - /swagger-resources
+    - /swagger-resources/**
     # actuator 监控配置
     - /actuator
     - /actuator/**
+    - /workflow/**
+    - /admin/workflow/**
 # 多租户配置
 tenant:
   # 是否开启
@@ -161,6 +172,9 @@ tenant:
     - sys_user_post
     - sys_user_role
 
+knowledge-role:
+  enable: false
+
 # MyBatisPlus配置
 # https://baomidou.com/config/
 mybatis-plus:
@@ -185,7 +199,7 @@ mybatis-plus:
     # 更详细的日志输出 会有性能损耗 org.apache.ibatis.logging.stdout.StdOutImpl
     # 关闭日志记录 (可单纯使用 p6spy 分析) org.apache.ibatis.logging.nologging.NoLoggingImpl
     # 默认日志输出 org.apache.ibatis.logging.slf4j.Slf4jImpl
-    logImpl: org.apache.ibatis.logging.nologging.NoLoggingImpl
+    logImpl: org.apache.ibatis.logging.slf4j.Slf4jImpl
   global-config:
     # 是否打印 Logo banner
     banner: true
@@ -228,9 +242,9 @@ springdoc:
   #    persistAuthorization: true
   info:
     # 标题
-    title: '标题：RuoYi-Vue-Plus多租户管理系统_接口文档'
+    title: '标题：ruoyi-ai 接口文档'
     # 描述
-    description: ' 用于管理集团旗下公司的人员信息,具体包括XXX,XXX模块...'
+    description: ''
     # 版本
     version: '版本号: ${ruoyi.version}'
     # 作者信息
@@ -246,16 +260,19 @@ springdoc:
         in: HEADER
         name: ${sa-token.token-name}
   #这里定义了两个分组，可定义多个，也可以不定义
-  group-configs:
-    - group: 1.系统模块
-      packages-to-scan: org.ruoyi.system
+  packages-to-scan: org.ruoyi
+
+knife4j:
+  enable: true
+  setting:
+    language: zh_cn
 
 # 防止XSS攻击
 xss:
   # 过滤开关
   enabled: true
   # 排除链接（多个用逗号分隔）
-  excludes: /system/notice
+  excludes: /system/notice,/v3/api-docs/**,/doc.html,/swagger-ui/**,/swagger-ui.html,/swagger-resources/**,/webjars/**,/druid/**,/actuator/**,/favicon.ico
   # 匹配链接
   urlPatterns: /system/*,/monitor/*,/tool/*
 
@@ -286,7 +303,12 @@ management:
       show-details: ALWAYS
     logfile:
       external-file: ./logs/sys-console.log
+  health:
+    # 禁用 Neo4j 健康检查（当知识图谱功能未启用时）
+    neo4j:
+      enabled: false
 
+# websocket
 # websocket
 websocket:
   enabled: true
@@ -312,3 +334,71 @@ spring:
           servers-configuration: classpath:mcp-server.json
         request-timeout: 300s
 
+# 向量库配置
+vector-store:
+  # 向量存储类型 可选(weaviate/milvus)
+  # 如需修改向量库类型，请修改此配置值!
+  type: weaviate
+
+  # Weaviate配置
+  weaviate:
+    protocol: http
+    host: 127.0.0.1:6038
+    classname: LocalKnowledge
+  # Milvus配置
+  milvus:
+    url: http://localhost:19530
+    collectionname: LocalKnowledge
+
+
+--- # Neo4j 知识图谱配置
+#neo4j:
+#  uri: bolt://117.72.192.162:7687
+#  username: neo4j
+#  password: MySecurePass123!
+#  database: neo4j
+#  max-connection-pool-size: 50
+#  connection-timeout-seconds: 30
+
+# 知识图谱配置
+knowledge:
+  graph:
+    # 是否启用知识图谱功能
+    enabled: false
+    # 图数据库类型: neo4j 或 apache-age
+    database-type: neo4j
+    # 是否自动创建索引
+    auto-create-index: true
+    # 批量处理大小
+    batch-size: 1000
+    # 最大重试次数
+    max-retry-count: 3
+
+    # 实体抽取配置
+    extraction:
+      # 置信度阈值（低于此值的实体将被过滤）
+      confidence-threshold: 0.7
+      # 最大实体数量（每个文档）
+      max-entities-per-doc: 100
+      # 最大关系数量（每个文档）
+      max-relations-per-doc: 200
+      # 文本分片大小（用于长文档）
+      chunk-size: 2000
+      # 分片重叠大小
+      chunk-overlap: 200
+
+    # 查询配置
+    query:
+      # 默认查询限制数量
+      default-limit: 100
+      # 最大查询限制数量
+      max-limit: 1000
+      # 路径查询最大深度
+      max-path-depth: 5
+      # 查询超时时间（秒）
+      timeout-seconds: 30
+      # 是否启用查询缓存
+      cache-enabled: true
+      # 缓存过期时间（分钟）
+      cache-expire-minutes: 60
+

ruoyi-admin/src/main/resources/logback-plus.xml

@@ -98,32 +98,32 @@
     </appender>
 
     <!-- 整合 skywalking 控制台输出 tid -->
-<!--    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">-->
-<!--        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">-->
-<!--            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">-->
-<!--                <pattern>[%tid] ${console.log.pattern}</pattern>-->
-<!--            </layout>-->
-<!--            <charset>utf-8</charset>-->
-<!--        </encoder>-->
-<!--    </appender>-->
+    <!--    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">-->
+    <!--        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">-->
+    <!--            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">-->
+    <!--                <pattern>[%tid] ${console.log.pattern}</pattern>-->
+    <!--            </layout>-->
+    <!--            <charset>utf-8</charset>-->
+    <!--        </encoder>-->
+    <!--    </appender>-->
 
     <!-- 整合 skywalking 推送采集日志 -->
-<!--    <appender name="sky_log" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender">-->
-<!--        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">-->
-<!--            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">-->
-<!--                <pattern>[%tid] ${console.log.pattern}</pattern>-->
-<!--            </layout>-->
-<!--            <charset>utf-8</charset>-->
-<!--        </encoder>-->
-<!--    </appender>-->
+    <!--    <appender name="sky_log" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender">-->
+    <!--        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">-->
+    <!--            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">-->
+    <!--                <pattern>[%tid] ${console.log.pattern}</pattern>-->
+    <!--            </layout>-->
+    <!--            <charset>utf-8</charset>-->
+    <!--        </encoder>-->
+    <!--    </appender>-->
 
     <!--系统操作日志-->
     <root level="info">
-        <appender-ref ref="console" />
-        <appender-ref ref="async_info" />
-        <appender-ref ref="async_error" />
-        <appender-ref ref="file_console" />
-<!--        <appender-ref ref="sky_log"/>-->
+        <appender-ref ref="console"/>
+        <appender-ref ref="async_info"/>
+        <appender-ref ref="async_error"/>
+        <appender-ref ref="file_console"/>
+        <!--        <appender-ref ref="sky_log"/>-->
     </root>
 
 </configuration>

ruoyi-common/pom.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <parent>

ruoyi-common/ruoyi-common-bom/pom.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 

ruoyi-common/ruoyi-common-chat/pom.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <parent>
         <groupId>org.ruoyi</groupId>

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/config/LocalCache.java

@@ -6,7 +6,6 @@ import cn.hutool.core.date.DateUnit;
 import lombok.extern.slf4j.Slf4j;
 
 /**
- *
  * @author https:www.unfbx.com
  * @date 2023-03-10
  */
@@ -16,16 +15,14 @@ public class LocalCache {
      * 缓存时长
      */
     public static final long TIMEOUT = 30 * DateUnit.MINUTE.getMillis();
-    /**
-     * 清理间隔
-     */
-    private static final long CLEAN_TIMEOUT = 30 * DateUnit.MINUTE.getMillis();
-
     /**
      * 缓存对象
      */
     public static final TimedCache<String, Object> CACHE = CacheUtil.newTimedCache(TIMEOUT);
-
+    /**
+     * 清理间隔
+     */
+    private static final long CLEAN_TIMEOUT = 30 * DateUnit.MINUTE.getMillis();
 
     static {
         //启动定时任务

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/config/WebSocketConfig.java

@@ -39,10 +39,10 @@ public class WebSocketConfig {
         }
         // 返回一个WebSocketConfigurer对象，用于配置WebSocket
         return registry -> registry
-            // 添加WebSocket处理程序和拦截器到指定路径，设置允许的跨域来源
-            .addHandler(webSocketHandler, webSocketProperties.getPath())
-            .addInterceptors(handshakeInterceptor)
-            .setAllowedOrigins(webSocketProperties.getAllowedOrigins());
+                // 添加WebSocket处理程序和拦截器到指定路径，设置允许的跨域来源
+                .addHandler(webSocketHandler, webSocketProperties.getPath())
+                .addInterceptors(handshakeInterceptor)
+                .setAllowedOrigins(webSocketProperties.getAllowedOrigins());
     }
 
     @Bean

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/config/properties/WebSocketProperties.java

@@ -23,7 +23,7 @@ public class WebSocketProperties {
     private String path;
 
     /**
-     *  设置访问源地址
+     * 设置访问源地址
      */
     private String allowedOrigins;
 }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/constant/OpenAIConst.java

@@ -1,9 +1,8 @@
 package org.ruoyi.common.chat.constant;
 
 /**
- *
  * @author https:www.unfbx.com
- * @since  2023-03-06
+ * @since 2023-03-06
  */
 public class OpenAIConst {
 

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/billing/Datum.java

@@ -7,7 +7,6 @@ import lombok.Data;
 import java.math.BigDecimal;
 
 /**
- *
  * @author https:www.unfbx.com
  * @since 2023-03-18
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/billing/Grants.java

@@ -7,7 +7,6 @@ import lombok.Data;
 import java.util.List;
 
 /**
- *
  * @author https:www.unfbx.com
  * @since 2023-03-18
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/billing/Plan.java

@@ -4,9 +4,8 @@ import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import lombok.Data;
 
 /**
- *
  * @author https:www.unfbx.com
- * @since  2023-04-08
+ * @since 2023-04-08
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/billing/Subscription.java

@@ -7,7 +7,7 @@ import lombok.Data;
  * 账户信息
  *
  * @author https:www.unfbx.com
- * @since  2023-04-08
+ * @since 2023-04-08
  */
 @Data
 public class Subscription {

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/BaseMessage.java

@@ -12,7 +12,6 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *
  * @author https:www.unfbx.com
  * @since 1.1.2
  * 2023-03-02
@@ -34,6 +33,7 @@ public class BaseMessage implements Serializable {
 
     /**
      * The tool calls generated by the model, such as function calls.
+     *
      * @since 1.1.2
      */
     @JsonProperty("tool_calls")

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/ChatChoice.java

@@ -7,7 +7,6 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *
  * @author https:www.unfbx.com
  * @since 2023-03-02
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/ChatCompletionWithPicture.java

@@ -11,7 +11,7 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  ： chat模型附带图片的参数
+ * ： chat模型附带图片的参数
  *
  * @author https:www.unfbx.com
  * @since 1.1.2

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/Content.java

@@ -6,7 +6,6 @@ import lombok.*;
 import lombok.extern.slf4j.Slf4j;
 
 /**
- *
  * @author https://www.unfbx.com
  * @since 1.1.2
  * 2023-11-10

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/FastGPTAnswerResponse.java

@@ -0,0 +1,16 @@
+package org.ruoyi.common.chat.entity.chat;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+
+import java.util.List;
+
+@Data
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class FastGPTAnswerResponse {
+    private String id;
+    private String object;
+    private long created;
+    private String model;
+    private List<FastGPTChatChoice> choices;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/FastGPTChatChoice.java

@@ -0,0 +1,25 @@
+package org.ruoyi.common.chat.entity.chat;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+
+@Data
+@JsonIgnoreProperties(ignoreUnknown = true)
+public class FastGPTChatChoice implements Serializable {
+    private long index;
+    /**
+     * 请求参数stream为true返回是delta
+     */
+    @JsonProperty("delta")
+    private Message delta;
+    /**
+     * 请求参数stream为false返回是message
+     */
+    @JsonProperty("message")
+    private Message message;
+    @JsonProperty("finish_reason")
+    private String finishReason;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/FastGPTChatCompletion.java

@@ -0,0 +1,41 @@
+package org.ruoyi.common.chat.entity.chat;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.SuperBuilder;
+
+import java.io.Serializable;
+
+@Data
+@SuperBuilder
+@AllArgsConstructor
+@NoArgsConstructor
+public class FastGPTChatCompletion extends ChatCompletion implements Serializable {
+
+    /**
+     * 是否使用FastGPT提供的上下文
+     */
+    private String chatId;
+
+
+    /**
+     * 是否返回详细信息;stream模式下会通过event进行区分，非stream模式结果保存在responseData中.
+     */
+    private boolean detail;
+
+
+    /**
+     * 运行时变量
+     * 模块变量，一个对象，会替换模块中，输入fastgpt框内容里的{{key}}
+     */
+    private Variables variables;
+
+    /**
+     * responseChatItemId: string | undefined 。
+     * 如果传入，则会将该值作为本次对话的响应消息的 ID，
+     * FastGPT 会自动将该 ID 存入数据库。请确保，
+     * 在当前chatId下，responseChatItemId是唯一的。
+     */
+    private String responseChatItemId;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/Functions.java

@@ -24,8 +24,9 @@ import java.io.Serializable;
  *          },
  *     }
  * </pre>
+ *
  * @author https:www.unfbx.com
- * @since  2023-06-14
+ * @since 2023-06-14
  */
 @Data
 @Builder

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/ImageUrl.java

@@ -8,7 +8,6 @@ import lombok.NoArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 
 /**
- *
  * @author https://www.unfbx.com
  * 2023-11-10
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/Message.java

@@ -10,8 +10,6 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
  * @since 2023-03-02
  */
@@ -24,10 +22,6 @@ public class Message extends BaseMessage implements Serializable {
     @JsonProperty("reasoning_content")
     private String reasoningContent;
 
-    public static Builder builder() {
-        return new Builder();
-    }
-
     /**
      * 构造函数
      *
@@ -57,6 +51,10 @@ public class Message extends BaseMessage implements Serializable {
         super.setToolCallId(builder.toolCallId);
     }
 
+    public static Builder builder() {
+        return new Builder();
+    }
+
     public static final class Builder {
         private String role;
         private String content;

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/MessagePicture.java

@@ -25,10 +25,6 @@ public class MessagePicture extends BaseMessage implements Serializable {
     private List<Content> content;
 
 
-    public static Builder builder() {
-        return new Builder();
-    }
-
     /**
      * 构造函数
      *
@@ -58,6 +54,10 @@ public class MessagePicture extends BaseMessage implements Serializable {
         super.setToolCallId(builder.toolCallId);
     }
 
+    public static Builder builder() {
+        return new Builder();
+    }
+
     public static final class Builder {
         private String role;
         private List<Content> content;

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/Parameters.java

@@ -5,8 +5,9 @@ import lombok.Data;
 
 import java.io.Serializable;
 import java.util.List;
+
 /**
- *  方法参数类，扩展参数可以继承Parameters自己实现
+ * 方法参数类，扩展参数可以继承Parameters自己实现
  * 参考：
  * <pre>
  * {
@@ -21,8 +22,9 @@ import java.util.List;
  *     "required": ["location"]
  * }
  * </pre>
+ *
  * @author https:www.unfbx.com
- * @since  2023-06-14
+ * @since 2023-06-14
  */
 @Data
 @Builder

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/chat/Variables.java

@@ -0,0 +1,20 @@
+package org.ruoyi.common.chat.entity.chat;
+
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+@Data
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+public class Variables implements Serializable {
+
+    private String uid;
+
+    private String name;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/common/Choice.java

@@ -7,9 +7,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/common/DeleteResponse.java

@@ -6,10 +6,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/common/OpenAiResponse.java

@@ -5,11 +5,10 @@ import lombok.Data;
 
 import java.io.Serializable;
 import java.util.List;
+
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/common/Usage.java

@@ -7,10 +7,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/completions/Completion.java

@@ -10,7 +10,7 @@ import java.util.List;
 import java.util.Map;
 
 /**
- *   问题类
+ * 问题类
  *
  * @author https:www.unfbx.com
  * 2023-02-11
@@ -101,7 +101,8 @@ public class Completion implements Serializable {
 
     /**
      * 获取当前参数的tokens数
-     * @return  token数量
+     *
+     * @return token数量
      */
 //    public long tokens() {
 //        if (StrUtil.isBlank(this.prompt) || StrUtil.isBlank(this.model)) {

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/completions/CompletionResponse.java

@@ -9,10 +9,10 @@ import org.ruoyi.common.chat.entity.common.Usage;
 import java.io.Serializable;
 
 /**
- *   答案类
+ * 答案类
  *
  * @author https:www.unfbx.com
- *  2023-02-11
+ * 2023-02-11
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/edits/Edit.java

@@ -7,10 +7,8 @@ import lombok.extern.slf4j.Slf4j;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Getter
 @Builder
@@ -35,7 +33,7 @@ public class Edit implements Serializable {
 
     /**
      * 使用什么取样温度，0到2之间。较高的值(如0.8)将使输出更加随机，而较低的值(如0.2)将使输出更加集中和确定。
-     *
+     * <p>
      * We generally recommend altering this or but not both.top_p
      */
     @Builder.Default
@@ -43,7 +41,7 @@ public class Edit implements Serializable {
 
     /**
      * 使用温度采样的替代方法称为核心采样，其中模型考虑具有top_p概率质量的令牌的结果。因此，0.1 意味着只考虑包含前 10% 概率质量的代币。
-     *
+     * <p>
      * 我们通常建议更改此设置，但不要同时更改两者。temperature
      */
     @JsonProperty("top_p")
@@ -90,6 +88,7 @@ public class Edit implements Serializable {
     public void setInstruction(String instruction) {
         this.instruction = instruction;
     }
+
     @Getter
     @AllArgsConstructor
     public enum Model {

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/edits/EditResponse.java

@@ -9,10 +9,8 @@ import org.ruoyi.common.chat.entity.common.Usage;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/embeddings/Embedding.java

@@ -9,10 +9,8 @@ import java.util.List;
 import java.util.Objects;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Getter
 @Slf4j

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/embeddings/EmbeddingResponse.java

@@ -8,10 +8,8 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/engines/Engine.java

@@ -6,10 +6,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/files/File.java

@@ -6,10 +6,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/files/UploadFileResponse.java

@@ -6,10 +6,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/fineTune/FineTune.java

@@ -30,6 +30,7 @@ public class FineTune implements Serializable {
     private String validationFile;
     /**
      * 参考
+     *
      * @see Model
      */
     private String model;
@@ -101,7 +102,7 @@ public class FineTune implements Serializable {
     }
 
     public void setSuffix(String suffix) {
-        if(Objects.nonNull(suffix) && !"".equals(suffix) && suffix.length() > 40){
+        if (Objects.nonNull(suffix) && !"".equals(suffix) && suffix.length() > 40) {
             log.error("后缀长度不能大于40");
             throw new BaseException(CommonError.PARAM_ERROR.msg());
         }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/Image.java

@@ -11,8 +11,6 @@ import lombok.extern.slf4j.Slf4j;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
  * 2023-02-15
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/ImageEdit.java

@@ -11,10 +11,8 @@ import java.io.Serializable;
 import java.util.Objects;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Getter
 @Slf4j
@@ -48,11 +46,11 @@ public class ImageEdit implements Serializable {
     private String user;
 
     public ImageEdit setN(Integer n) {
-        if(n < 1){
+        if (n < 1) {
             log.warn("n最小值1");
             n = 1;
         }
-        if(n > 10){
+        if (n > 10) {
             log.warn("n最大值10");
             n = 10;
         }
@@ -61,11 +59,11 @@ public class ImageEdit implements Serializable {
     }
 
     public ImageEdit setPrompt(String prompt) {
-        if(Objects.isNull(prompt) || "".equals(prompt)){
+        if (Objects.isNull(prompt) || "".equals(prompt)) {
             log.error("参数异常");
             throw new BaseException(CommonError.PARAM_ERROR.msg());
         }
-        if(prompt.length() > 1000){
+        if (prompt.length() > 1000) {
             log.error("长度超过1000");
             throw new BaseException(CommonError.PARAM_ERROR.msg());
         }
@@ -74,7 +72,7 @@ public class ImageEdit implements Serializable {
     }
 
     public ImageEdit setSize(SizeEnum size) {
-        if(Objects.isNull(size)){
+        if (Objects.isNull(size)) {
             size = SizeEnum.size_512;
         }
         this.size = size.getName();
@@ -82,7 +80,7 @@ public class ImageEdit implements Serializable {
     }
 
     public ImageEdit setResponseFormat(ResponseFormat responseFormat) {
-        if(Objects.isNull(responseFormat)){
+        if (Objects.isNull(responseFormat)) {
             responseFormat = ResponseFormat.URL;
         }
         this.responseFormat = responseFormat.getName();

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/ImageResponse.java

@@ -7,10 +7,8 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/ImageVariations.java

@@ -12,10 +12,8 @@ import java.io.Serializable;
 import java.util.Objects;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Getter
 @Slf4j

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/Item.java

@@ -7,10 +7,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/ResponseFormat.java

@@ -6,10 +6,8 @@ import lombok.Getter;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @AllArgsConstructor
 @Getter

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/images/SizeEnum.java

@@ -6,10 +6,8 @@ import lombok.Getter;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Getter
 @AllArgsConstructor

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/models/LocalModelsSearchResponse.java

@@ -1,4 +1,5 @@
 package org.ruoyi.common.chat.entity.models;
+
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
@@ -13,8 +14,8 @@ public class LocalModelsSearchResponse {
     private List<List<List<Double>>> topKEmbeddings;  // 处理三层嵌套数组
 
     // 默认构造函数
-    public LocalModelsSearchResponse() {}
-
+    public LocalModelsSearchResponse() {
+    }
 
 
 }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/models/Model.java

@@ -8,10 +8,8 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/models/ModelResponse.java

@@ -7,10 +7,8 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/models/Permission.java

@@ -7,8 +7,6 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
  * 2023-02-15
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/moderations/Categories.java

@@ -7,10 +7,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/moderations/CategoryScores.java

@@ -8,10 +8,8 @@ import java.io.Serializable;
 import java.math.BigDecimal;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/moderations/Moderation.java

@@ -10,10 +10,10 @@ import java.util.List;
 import java.util.Objects;
 
 /**
- *  文本审核，敏感词鉴别
+ * 文本审核，敏感词鉴别
  *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Getter
 @Builder

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/moderations/ModerationResponse.java

@@ -7,10 +7,8 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/moderations/Result.java

@@ -7,10 +7,8 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
- *  2023-02-15
+ * 2023-02-15
  */
 @Data
 @JsonIgnoreProperties(ignoreUnknown = true)

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/whisper/Whisper.java

@@ -7,7 +7,7 @@ import lombok.Getter;
 import java.io.Serializable;
 
 /**
- *  语音转文字
+ * 语音转文字
  *
  * @author https:www.unfbx.com
  * @since 2023-03-02

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/whisper/WhisperResponse.java

@@ -6,8 +6,6 @@ import lombok.Data;
 import java.io.Serializable;
 
 /**
- *  
- *
  * @author https:www.unfbx.com
  * @since 2023-03-02
  */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/handler/PlusWebSocketHandler.java

@@ -47,7 +47,7 @@ public class PlusWebSocketHandler extends AbstractWebSocketHandler {
         if (StrUtil.isNotBlank(messageContext)) {
             messages = JSONUtil.toList(messageContext, Message.class);
             // 上下文长度
-            int contextSize=10;
+            int contextSize = 10;
             if (messages.size() >= contextSize) {
                 messages = messages.subList(1, contextSize);
             }
@@ -58,13 +58,13 @@ public class PlusWebSocketHandler extends AbstractWebSocketHandler {
             messages.add(currentMessage);
         }
         ChatCompletion chatCompletion = ChatCompletion
-            .builder()
-            .model("gpt-4o-mini")
-            .messages(messages)
-            .temperature(0.2)
-            .stream(true)
-            .build();
-        OpenAiStreamClient openAiStreamClient=(OpenAiStreamClient) SpringUtils.context().getBean("openAiStreamClient");
+                .builder()
+                .model("gpt-4o-mini")
+                .messages(messages)
+                .temperature(0.2)
+                .stream(true)
+                .build();
+        OpenAiStreamClient openAiStreamClient = (OpenAiStreamClient) SpringUtils.context().getBean("openAiStreamClient");
         openAiStreamClient.streamChatCompletion(chatCompletion, eventSourceListener);
         LocalCache.CACHE.put(session.getId(), JSONUtil.toJsonStr(messages), LocalCache.TIMEOUT);
     }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/listener/WebSocketEventListener.java

@@ -14,7 +14,7 @@ import org.springframework.web.socket.WebSocketSession;
 import java.util.Objects;
 
 /**
- *  OpenAI流式输出Socket接收
+ * OpenAI流式输出Socket接收
  *
  * @author https:www.unfbx.com
  * @date 2023-03-23
@@ -22,12 +22,11 @@ import java.util.Objects;
 @Slf4j
 public class WebSocketEventListener extends EventSourceListener {
 
-    private WebSocketSession session;
-
     /**
      * 消息结束标识
      */
     private final String msgEnd = "[DONE]";
+    private WebSocketSession session;
 
     public WebSocketEventListener(WebSocketSession session) {
         this.session = session;
@@ -59,8 +58,8 @@ public class WebSocketEventListener extends EventSourceListener {
         String delta = "";
         try {
             delta = mapper.writeValueAsString(completionResponse.getChoices().get(0).getDelta());
-        }catch (Exception e){
-            log.error("转换失败{}",e.getMessage());
+        } catch (Exception e) {
+            log.error("转换失败{}", e.getMessage());
         }
         session.sendMessage(new TextMessage(delta));
     }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/openai/OpenAiApi.java

@@ -40,7 +40,7 @@ import java.time.LocalDate;
 import java.util.Map;
 
 /**
- *   open ai官方api接口
+ * open ai官方api接口
  *
  * @author https:www.unfbx.com
  * 2023-02-15
@@ -58,7 +58,7 @@ public interface OpenAiApi {
     /**
      * models 返回的数据id
      *
-     * @param id    模型主键
+     * @param id 模型主键
      * @return Single Model
      */
     @GET("v1/models/{id}")
@@ -317,7 +317,7 @@ public interface OpenAiApi {
     /**
      * 账户信息查询：里面包含总金额（美元）等信息
      *
-     * @return  账户信息
+     * @return 账户信息
      */
     @GET("v1/dashboard/billing/subscription")
     Single<Subscription> subscription();