Merge pull request #282 from Anush008/main

docs: Docker Compose setup for Qdrant
2026-04-05 15:57:32 +00:00 · 2026-03-28 20:33:25 +08:00 · 2026-03-28 13:37:53 +05:30 · 2026-03-27 21:51:03 +08:00 · 2026-03-27 18:36:30 +05:30 · 2026-03-27 18:31:05 +05:30
442 changed files with 8643 additions and 28627 deletions
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,41 @@
+---
+name: 漏洞报告
+about: 报告项目中的Bug或安全问题
+title: '[Bug] '
+labels: 'bug'
+assignees: ''
+---
+
+## 问题描述
+
+简要描述遇到的问题：
+
+## 复现步骤
+
+1.
+2.
+3.
+
+## 期望行为
+
+描述你期望发生的情况：
+
+## 实际行为
+
+描述实际发生的情况：
+
+## 环境信息
+
+| 项目 | 信息 |
+|:---|:---|
+| 操作系统 |  |
+| JDK版本 |  |
+| 项目版本 |  |
+
+## 截图/日志
+
+如有相关信息，请在此粘贴：
+
+## 补充说明
+
+其他补充信息：
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1 @@
+blank_issues_enabled: true
--- a/.github/ISSUE_TEMPLATE/custom.md
+++ b/.github/ISSUE_TEMPLATE/custom.md
@@ -0,0 +1,15 @@
+---
+name: 自定义
+about: 其他问题或讨论
+title: ''
+labels: ''
+assignees: ''
+---
+
+## 描述
+
+请详细描述你的问题或需求：
+
+## 补充信息
+
+如有其他补充，请在此填写：
--- a/.github/ISSUE_TEMPLATE/enterprise-collaboration.md
+++ b/.github/ISSUE_TEMPLATE/enterprise-collaboration.md
@@ -0,0 +1,57 @@
+---
+name: 企业AI应用合作登记
+about: 登记企业信息与合作意向，获取免费技术支持
+title: '[合作登记] 企业AI应用需求登记'
+labels: '合作登记'
+assignees: ''
+---
+
+## 登记说明
+
+感谢您关注 RuoYi AI！我们团队今年的重点是帮助企业落地AI应用，如果贵公司符合要求，我们可以提供**免费的技术支持**。
+
+请在下方评论中填写登记信息，格式如下：
+
+---
+
+## 登记格式预览
+
+| 字段 | 内容 |
+|:---|:---|
+| 公司名称 | （必填） |
+| 公司Logo地址 | （可选） |
+| 所属行业 | （必填） |
+| 公司所在地 | （必填） |
+| 项目名称 | （必填） |
+| 项目Logo地址 | （可选） |
+| 项目简介 | （必填） |
+| 当前AI应用状态 | □ 尚未开始 □ 规划中 □ 已有初步应用 □ 已有成熟应用 |
+| 计划落地时间 | □ 1个月内 □ 1-3个月 □ 3-6个月 □ 6个月以上 |
+| 当前痛点或挑战 | （可选） |
+| 公司简介 | （可选） |
+
+---
+
+## 可复制格式
+
+复制下方内容并在评论中填写：
+
+```
+| 字段 | 内容 |
+|:---|:---|
+| 公司名称 |  |
+| 公司Logo地址 |  |
+| 所属行业 |  |
+| 公司所在地 |  |
+| 项目名称 |  |
+| 项目Logo地址 |  |
+| 项目简介 |  |
+| 当前AI应用状态 |  |
+| 计划落地时间 |  |
+| 当前痛点或挑战 |  |
+| 公司简介 |  |
+```
+
+---
+
+> **温馨提示**：提交的信息仅用于合作沟通，不会对外公开。
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,31 @@
+---
+name: 想法建议
+about: 提出新功能建议或改进想法
+title: '[Feature] '
+labels: 'enhancement'
+assignees: ''
+---
+
+## 建议类型
+
+□ 新功能  □ 功能改进  □ 文档完善  □ 其他
+
+## 建议描述
+
+清晰描述你的建议内容：
+
+## 使用场景
+
+描述这个功能在什么场景下会用到：
+
+## 期望效果
+
+描述你期望的效果：
+
+## 参考示例
+
+如有类似的参考实现或产品，请提供链接：
+
+## 补充说明
+
+其他补充信息：
--- a/.gitignore
+++ b/.gitignore
@@ -21,10 +21,13 @@ target/

 ### IntelliJ IDEA ###
 .idea
+.claude
+.github
 *.iws
 *.iml
 *.ipr

+
 ### JRebel ###
 rebel.xml

@@ -41,9 +44,11 @@ nbdist/
 *.log.gz
 *.xml.versionsBackup
 *.swp
+data/

 !*/build/*.java
 !*/build/*.html
 !*/build/*.xml

 .flattened-pom.xml
+/.claude/settings.local.json
--- a/README.md
+++ b/README.md
@@ -17,12 +17,9 @@

 <img src="docs/image/logo.png" alt="RuoYi AI Logo" width="120" height="120">

-## 功能建议&bug提交：【腾讯文档】
-https://docs.qq.com/sheet/DR3hoR3FVVkpJcnVm
-
 ### 企业级AI助手平台

-*开箱即用的全栈AI平台，集成Coze、DIFY等主流AI平台，提供先进的RAG技术、知识图谱、数字人和AI流程编排能力*
+*开箱即用的全栈AI平台，支持多智能体协同、Supervisor模式编排、多种决策模式、RAG技术和流程编排能力*

 **[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)**
@@ -30,38 +27,24 @@ https://docs.qq.com/sheet/DR3hoR3FVVkpJcnVm
 </div>


-
-
 ## ✨ 核心亮点

-### 智能AI引擎
- **多模型接入**：支持 OpenAI、DeepSeek、通义千问、智谱AI 等主流厂商的模型
- **多模态理解**：支持文本、图片、文档等多种格式的智能处理
- **AI平台集成**：集成了 **扣子(Coze)**、**DIFY**、**FastGPT** 等主流AI应用平台
- **MCP能力集成**：基于模型上下文协议，打造可扩展的AI工具生态系统
- **AI编程助手**：内置智能代码分析和项目脚手架生成能力
-
-### 本地化RAG方案
- **私有知识库**：基于 Langchain4j 框架 + BGE-large-zh-v1.5 中文向量模型实现本地私有知识库
- **多种向量库**：支持 Milvus、Weaviate、Qdrant 等主流向量数据库
- **数据安全可控**：支持完全本地部署，保护企业数据隐私
- **灵活模型部署**：兼容 Ollama、vLLM 等本地推理框架
-
-### AI创作工具
- **AI 绘画创作**： 集成 MidJourney、GPT-4o-image
- **智能PPT生成**：一键将文本内容转换为精美演示文稿
-
-### 知识图谱与智能编排
- **知识图谱构建**：自动从文档和对话中提取实体关系，构建可视化知识网络
- **AI 流程编排**：可视化工作流设计器，支持复杂AI任务的编排和自动化执行
- **数字人交互**：集成数字人形象，提供更自然的人机交互体验
+|     模块     | 现有能力 
+|:----------:|---
+|  **模型管理**  | 多模型接入(OpenAI/DeepSeek/通义/智谱)、多模态理解、Coze/DIFY/FastGPT平台集成 
+|  **知识管理**  | 本地RAG + 向量库(Milvus/Weaviate/Qdrant)  + 文档解析        
+|  **工具管理**  | Mcp协议集成、Skills能力 + 可扩展工具生态                             
+|  **流程编排**  | 可视化工作流设计器、节点拖拽编排、SSE流式执行,目前已经支持模型调用,邮件发送,人工审核等节点  
+|  **多智能体**  | 基于Langchain4j的Agent框架、Supervisor模式编排,支持多种决策模型          

 ## 🚀 快速体验

 ### 在线演示

- **用户端体验**：[web.pandarobot.chat](https://web.pandarobot.chat) (账号：admin 密码：admin123)
- **管理后台**：[admin.pandarobot.chat](https://admin.pandarobot.chat) (账号：admin 密码：admin123)
+|   平台   | 地址 | 账号 |
+|:------:|---|---|
+|  用户端   | [web.pandarobot.chat](https://web.pandarobot.chat) | admin / admin123 |
+| 管理后台 | [admin.pandarobot.chat](https://admin.pandarobot.chat) | admin / admin123 |

 ### 项目源码

@@ -71,25 +54,147 @@ https://docs.qq.com/sheet/DR3hoR3FVVkpJcnVm
 | 🎨 用户前端  | [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 仓库                                             
+|----------------|-------------------------------------------------------|------------------------------------------------------|
+| element-plus-x | [element-plus-x](https://github.com/element-plus-x/Element-Plus-X)       | [element-plus-x](https://gitee.com/he-jiayue/element-plus-x)       | 
+
 ## 🛠️ 技术架构

 ### 核心框架
- **后端架构**：Spring Boot 3.5 + Langchain4j
+- **后端架构**：Spring Boot 4.0 + Spring ai 2.0 + Langchain4j
 - **数据存储**：MySQL 8.0 + Redis + 向量数据库（Milvus/Weaviate/Qdrant）
- **前端技术**：Vue 3 + Vben Admin + Element UI
+- **前端技术**：Vue 3 + Vben Admin + element-plus-x
 - **安全认证**：Sa-Token + JWT 双重保障

-### 系统组件
+
 - **文档处理**：PDF、Word、Excel 解析，图像智能分析
 - **实时通信**：WebSocket 实时通信，SSE 流式响应
 - **系统监控**：完善的日志体系、性能监控、服务健康检查

+## 🐳 Docker 部署
+
+本项目提供两种 Docker 部署方式：
+
+### 方式一：一键启动所有服务（推荐）
+
+使用 `docker-compose-all.yaml` 可以一键启动所有服务（包括后端、管理端、用户端及依赖服务）：
+
+```bash
+# 克隆仓库
+git clone https://github.com/ageerle/ruoyi-ai.git
+cd ruoyi-ai
+
+# 启动所有服务（从镜像仓库拉取预构建镜像）
+docker-compose -f docker-compose-all.yaml up -d
+
+# 查看服务状态
+docker-compose -f docker-compose-all.yaml ps
+
+# 访问服务
+# 管理端: http://localhost:25666 (admin / admin123)
+# 用户端: http://localhost:25137
+# 后端API: http://localhost:26039
+```
+
+### 方式二：分步部署（源码编译）
+
+如果您需要从源码构建后端服务，请按照以下步骤操作：
+
+#### 第一步：部署后端服务
+
+```bash
+# 进入后端项目目录
+cd ruoyi-ai
+
+# 启动后端服务（源码编译构建）
+docker-compose up -d --build
+
+# 等待后端服务启动完成
+docker-compose logs -f backend
+```
+
+#### 第二步：部署管理端
+
+```bash
+# 进入管理端项目目录
+cd ruoyi-admin
+
+# 构建并启动管理端
+docker-compose up -d --build
+
+# 访问管理端
+# 地址: http://localhost:5666
+```
+
+#### 第三步：部署用户端（可选）
+
+```bash
+# 进入用户端项目目录
+cd ruoyi-web
+
+# 构建并启动用户端
+docker-compose up -d --build
+
+# 访问用户端
+# 地址: http://localhost:5137
+```
+
+### 服务端口说明
+
+| 服务 | 一键启动端口 | 分步部署端口 | 说明 |
+|------|-------------|-------------|------|
+| 管理端 | 25666 | 5666 | 管理后台访问地址 |
+| 用户端 | 25137 | 5137 | 用户前端访问地址 |
+| 后端服务 | 26039 | 6039 | 后端 API 服务 |
+| MySQL | 23306 | 23306 | 数据库服务 |
+| Redis | 26379 | 6379 | 缓存服务 |
+| Weaviate | 28080 | 28080 | 向量数据库 |
+| MinIO API | 29000 | 9000 | 对象存储 API |
+| MinIO Console | 29090 | 9090 | 对象存储控制台 |
+
+### 镜像仓库
+
+所有镜像托管在阿里云容器镜像服务：
+
+```
+crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai
+```
+
+可用镜像：
+- `mysql:v3` - MySQL 数据库（包含初始化 SQL）
+- `redis:6.2` - Redis 缓存
+- `weaviate:1.30.0` - 向量数据库
+- `minio:latest` - 对象存储
+- `ruoyi-ai-backend:latest` - 后端服务
+- `ruoyi-ai-admin:latest` - 管理端前端
+- `ruoyi-ai-web:latest` - 用户端前端
+
+### 常用命令
+
+```bash
+# 停止所有服务
+docker-compose -f docker-compose-all.yaml down
+
+# 查看服务日志
+docker-compose -f docker-compose-all.yaml logs -f [服务名]
+
+# 重启某个服务
+docker-compose -f docker-compose-all.yaml restart [服务名]
+```
+
 ## 📚 使用文档

 想要深入了解安装部署、功能配置和二次开发？

 **👉 [完整使用文档](https://doc.pandarobot.chat)**

+遇到知识库或 RAG 回答异常问题？
+
+**👉 [RAG 回答异常排查手册](docs/troubleshooting/rag-failures.md)**
+
+---
+
 ## 🤝 参与贡献

 我们热烈欢迎社区贡献！无论您是资深开发者还是初学者，都可以为项目贡献力量 💪
@@ -123,9 +228,6 @@ https://docs.qq.com/sheet/DR3hoR3FVVkpJcnVm
  算力和模型 API 服务
 - [优云智算](https://www.compshare.cn/?ytag=GPU_YY-gh_ruoyi) - 万卡RTX40系GPU+海内外主流模型API服务，秒级响应，按量计费，新客免费用。

-## 优秀开源项目及社区推荐
- [imaiwork](https://gitee.com/tsinghua-open/imaiwork) - AI手机开源版，AI获客手机项目，基于无障碍模式，RPA，比豆包AI手机更强大。
-
 ## 💬 社区交流

 <div align="center">
@@ -149,7 +251,6 @@ https://docs.qq.com/sheet/DR3hoR3FVVkpJcnVm
 </div>

 ---
-
 <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)**
--- a/README_EN.md
+++ b/README_EN.md
@@ -1,3 +1,4 @@
+
 # RuoYi AI

 <div align="center">
@@ -19,64 +20,171 @@

 ### Enterprise-Grade AI Assistant Platform

-*An out-of-the-box intelligent AI platform that integrates mainstream AI platforms such as Coze and DIFY, providing advanced RAG technology, knowledge graphs, digital humans, and AI workflow orchestration capabilities*
+*An out-of-the-box full-stack AI platform supporting multi-agent collaboration, Supervisor mode orchestration, and multiple decision models, with advanced RAG technology and visual workflow orchestration capabilities*

 **[中文](README.md)** | **[📖 Documentation](https://doc.pandarobot.chat)** |
 **[🚀 Live Demo](https://web.pandarobot.chat)** | **[🐛 Report Issues](https://github.com/ageerle/ruoyi-ai/issues)** | **[💡 Feature Requests](https://github.com/ageerle/ruoyi-ai/issues)**

 </div>

+
+
+
 ## ✨ Core Features

-### Intelligent AI Engine
- **Multi-Model Integration**: Supports mainstream LLM providers including OpenAI, DeepSeek, Alibaba's Tongyi Qianwen, and Zhipu AI
- **Multi-Modal Understanding**: Intelligently processes multiple formats including text, images, and documents
- **AI Platform Integration**: Integrates mainstream AI application platforms like **Coze**, **DIFY**, and **FastGPT**
- **MCP Capability Integration**: Build an extensible AI toolkit ecosystem based on the Model Context Protocol
- **AI Coding Assistant**: Built-in intelligent code analysis and project scaffolding generation capabilities
-
-### Local RAG Solution
- **Private Knowledge Base**: Implements local private knowledge base based on Langchain4j framework + BGE-large-zh-v1.5 Chinese vector model
- **Multiple Vector Databases**: Supports mainstream vector databases including Milvus, Weaviate, and Qdrant
- **Data Security & Privacy**: Supports fully local deployment to protect enterprise data privacy
- **Flexible Model Deployment**: Compatible with local inference frameworks like Ollama and vLLM
-
-### AI Creative Tools
- **AI Image Generation**: Integrates MidJourney and GPT-4o-image
- **Intelligent PPT Generation**: Convert text content to beautiful presentations with one click
-
-### Knowledge Graph & Intelligent Orchestration
- **Knowledge Graph Construction**: Automatically extract entity relationships from documents and conversations, build visualized knowledge networks
- **AI Workflow Orchestration**: Visual workflow designer supporting complex AI task orchestration and automated execution
- **Digital Human Interaction**: Integrated digital avatars providing more natural human-machine interaction experience
+| Module | Current Capabilities |
+|:---:|---|
+| **Model Management** | Multi-model integration (OpenAI/DeepSeek/Tongyi/Zhipu), multi-modal understanding, Coze/DIFY/FastGPT platform integration |
+| **Knowledge Base** | Local RAG + Vector DB (Milvus/Weaviate/Qdrant) + Document parsing |
+| **Tool Management** | MCP protocol integration, Skills capability + Extensible tool ecosystem |
+| **Workflow Orchestration** | Visual workflow designer, drag-and-drop node orchestration, SSE streaming execution, currently supports model calls, email sending, manual review nodes |
+| **Multi-Agent** | Agent framework based on Langchain4j, Supervisor mode orchestration, supports multiple decision models |

 ## 🚀 Quick Start

 ### Live Demo

- **User Experience**: [web.pandarobot.chat](https://web.pandarobot.chat) (Username: admin, Password: admin123)
- **Admin Dashboard**: [admin.pandarobot.chat](https://admin.pandarobot.chat) (Username: admin, Password: admin123)
+|   Platform   | URL | Account |
+|:------:|---|---|
+|  User Frontend   | [web.pandarobot.chat](https://web.pandarobot.chat) | admin / admin123 |
+| Admin Panel | [admin.pandarobot.chat](https://admin.pandarobot.chat) | admin / admin123 |

 ### Project Repositories

-| Module           | GitHub Repository                                      | Gitee Repository                                      | GitCode Repository                                      |
-|------------------|-------------------------------------------------------|------------------------------------------------------|--------------------------------------------------------|
-| 🔧 Backend       | [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 Panel   | [ruoyi-admin](https://github.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitee.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitcode.com/ageerle/ruoyi-admin) |
+| Module     | GitHub Repository                                             | Gitee Repository                                             | GitCode Repository                                             |
+|----------|-------------------------------------------------------|------------------------------------------------------|--------------------------------------------------------|
+| 🔧 Backend  | [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 Panel | [ruoyi-admin](https://github.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitee.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitcode.com/ageerle/ruoyi-admin) |
+
+### Partner Projects
+| Project Name           | GitHub Repository                                             | Gitee Repository |
+|----------------|-------------------------------------------------------|------------------------------------------------------|
+| element-plus-x | [element-plus-x](https://github.com/element-plus-x/Element-Plus-X)       | [element-plus-x](https://gitee.com/he-jiayue/element-plus-x)       |

 ## 🛠️ Technical Architecture

 ### Core Framework
- **Backend**: Spring Boot 3.5 + Langchain4j
+- **Backend**: Spring Boot 4.0 + Spring AI 2.0 + Langchain4j
 - **Data Storage**: MySQL 8.0 + Redis + Vector Databases (Milvus/Weaviate/Qdrant)
- **Frontend**: Vue 3 + Vben Admin + Element UI
+- **Frontend**: Vue 3 + Vben Admin + element-plus-x
 - **Security**: Sa-Token + JWT dual-layer security

-### System Components
- **Document Processing**: PDF, Word, and Excel parsing with intelligent image analysis
- **Real-Time Communication**: WebSocket real-time communication with SSE streaming responses
- **System Monitoring**: Comprehensive logging system, performance monitoring, and service health checks
+
+- **Document Processing**: PDF, Word, Excel parsing, intelligent image analysis
+- **Real-time Communication**: WebSocket real-time communication, SSE streaming response
+- **System Monitoring**: Comprehensive logging system, performance monitoring, service health checks
+
+## 🐳 Docker Deployment
+
+This project provides two Docker deployment methods:
+
+### Method 1: One-click Start All Services (Recommended)
+
+Use `docker-compose-all.yaml` to start all services at once (including backend, admin panel, user frontend, and dependencies):
+
+```bash
+# Clone the repository
+git clone https://github.com/ageerle/ruoyi-ai.git
+cd ruoyi-ai
+
+# Start all services (pull pre-built images from registry)
+docker-compose -f docker-compose-all.yaml up -d
+
+# Check service status
+docker-compose -f docker-compose-all.yaml ps
+
+# Access services
+# Admin Panel: http://localhost:25666 (admin / admin123)
+# User Frontend: http://localhost:25137
+# Backend API: http://localhost:26039
+```
+
+### Method 2: Step-by-step Deployment (Source Build)
+
+If you need to build backend services from source, follow these steps:
+
+#### Step 1: Deploy Backend Service
+
+```bash
+# Enter backend project directory
+cd ruoyi-ai
+
+# Start backend service (build from source)
+docker-compose up -d --build
+
+# Wait for backend service to start
+docker-compose logs -f backend
+```
+
+#### Step 2: Deploy Admin Panel
+
+```bash
+# Enter admin panel project directory
+cd ruoyi-admin
+
+# Build and start admin panel
+docker-compose up -d --build
+
+# Access admin panel
+# URL: http://localhost:5666
+```
+
+#### Step 3: Deploy User Frontend (Optional)
+
+```bash
+# Enter user frontend project directory
+cd ruoyi-web
+
+# Build and start user frontend
+docker-compose up -d --build
+
+# Access user frontend
+# URL: http://localhost:5137
+```
+
+### Service Ports
+
+| Service | One-click Port | Step-by-step Port | Description |
+|------|-------------|-------------|------|
+| Admin Panel | 25666 | 5666 | Admin backend access |
+| User Frontend | 25137 | 5137 | User frontend access |
+| Backend Service | 26039 | 6039 | Backend API service |
+| MySQL | 23306 | 23306 | Database service |
+| Redis | 26379 | 6379 | Cache service |
+| Weaviate | 28080 | 28080 | Vector database |
+| MinIO API | 29000 | 9000 | Object storage API |
+| MinIO Console | 29090 | 9090 | Object storage console |
+
+### Image Registry
+
+All images are hosted on Alibaba Cloud Container Registry:
+
+```
+crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai
+```
+
+Available images:
+- `mysql:v3` - MySQL database (includes initialization SQL)
+- `redis:6.2` - Redis cache
+- `weaviate:1.30.0` - Vector database
+- `minio:latest` - Object storage
+- `ruoyi-ai-backend:latest` - Backend service
+- `ruoyi-ai-admin:latest` - Admin frontend
+- `ruoyi-ai-web:latest` - User frontend
+
+### Common Commands
+
+```bash
+# Stop all services
+docker-compose -f docker-compose-all.yaml down
+
+# View service logs
+docker-compose -f docker-compose-all.yaml logs -f [service-name]
+
+# Restart a service
+docker-compose -f docker-compose-all.yaml restart [service-name]
+```

 ## 📚 Documentation

@@ -84,6 +192,12 @@ Want to learn more about installation, deployment, configuration, and secondary

 **👉 [Complete Documentation](https://doc.pandarobot.chat)**

+Experiencing issues with knowledge base or RAG responses?
+
+**👉 [RAG Troubleshooting Guide](docs/troubleshooting/rag-failures.md)**
+
+---
+
 ## 🤝 Contributing

 We warmly welcome community contributions! Whether you are a seasoned developer or just getting started, you can contribute to the project 💪
@@ -115,28 +229,13 @@ Thanks to the following excellent open-source projects for their support:
 - [PPIO Cloud](https://ppinfra.com/user/register?invited_by=P8QTUY&utm_source=github_ruoyi-ai) - Provides cost-effective GPU computing and model API services
 - [Youyun Intelligent Computing](https://www.compshare.cn/?ytag=GPU_YY-gh_ruoyi) - Thousands of RTX40 series GPUs + mainstream models API services, second-level response, pay-per-use, free for new customers.

-## Outstanding Open-Source Projects and Community Recommendations
- [imaiwork](https://gitee.com/tsinghua-open/imaiwork) - Open-source AI phone, AI customer acquisition phone project, based on accessibility mode and RPA, more powerful than Doubao AI phone.

 ## 💬 Community Chat

 <div align="center">

-<table>
-<tr>
-<td align="center">
-<img src="docs/image/wx.png" alt="WeChat QR Code" width="200" height="200"><br>
-<strong>Scan to Add Author's WeChat</strong><br>
-<em>Invitation to join the group</em>
-</td>
-<td align="center">
-<img src="docs/image/qq.png" alt="QQ Group QR Code" width="200" height="200"><br>
-<strong>QQ Technical Discussion Group</strong><br>
-<em>Technical discussions</em>
-</td>
-
-</tr>
-</table>
+**[📱 Join Telegram Group](
+https://t.me/+LqooQAc5HxRmYmE1)**

 </div>

@@ -170,4 +269,4 @@ Thanks to the following excellent open-source projects for their support:

 [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
+[license-url]: https://github.com/ageerle/ruoyi-ai/blob/main/LICENSE
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -0,0 +1,28 @@
+---
+version: '3.8'
+
+services:
+  minio:
+    image: minio/minio
+    container_name: minio
+    ports:
+      - "9000:9000"
+      - "9090:9090"
+    environment:
+      - MINIO_ACCESS_KEY=ruoyi
+      - MINIO_SECRET_KEY=ruoyi123
+    volumes:
+      - minio_data:/data
+      - minio_config:/root/.minio
+    command: server /data --console-address ":9090"
+    restart: always
+    networks:
+      - minio-net
+
+networks:
+  minio-net:
+    driver: bridge
+
+volumes:
+  minio_data:
+  minio_config:
--- a/neo4j/docker-compose.yml
+++ b/neo4j/docker-compose.yml
@@ -0,0 +1,65 @@
+version: '3.8'
+
+services:
+  neo4j:
+    image: neo4j:5.15.0
+    container_name: ruoyi-neo4j
+    restart: unless-stopped
+    ports:
+      # HTTP端口
+      - "7474:7474"
+      # HTTPS端口
+      - "7473:7473"
+      # Bolt端口
+      - "7687:7687"
+    environment:
+      # 初始密码设置（首次启动后需要修改）
+      - NEO4J_AUTH=neo4j/your_password
+      # 接受许可协议
+      - NEO4J_ACCEPT_LICENSE_AGREEMENT=yes
+      # 内存配置（根据服务器配置调整）
+      - NEO4J_dbms_memory_heap_initial__size=512m
+      - NEO4J_dbms_memory_heap_max__size=2g
+      - NEO4J_dbms_memory_pagecache_size=1g
+      # 事务日志配置
+      - NEO4J_dbms_tx__log_rotation_retention__policy=3 days
+      # 允许从任何主机连接
+      - NEO4J_dbms_default__listen__address=0.0.0.0
+      # 启用APOC插件
+      - NEO4J_dbms_security_procedures_unrestricted=apoc.*
+      - NEO4J_dbms_security_procedures_allowlist=apoc.*
+      # 日志级别
+      - NEO4J_dbms_logs_debug_level=INFO
+    volumes:
+      # 数据持久化
+      - neo4j_data:/data
+      # 日志持久化
+      - neo4j_logs:/logs
+      # 导入目录
+      - neo4j_import:/var/lib/neo4j/import
+      # 插件目录
+      - neo4j_plugins:/plugins
+    networks:
+      - ruoyi-network
+    healthcheck:
+      test: [ "CMD-SHELL", "wget --no-verbose --tries=1 --spider localhost:7474 || exit 1" ]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 40s
+
+volumes:
+  neo4j_data:
+    name: ruoyi-neo4j-data
+  neo4j_logs:
+    name: ruoyi-neo4j-logs
+  neo4j_import:
+    name: ruoyi-neo4j-import
+  neo4j_plugins:
+    name: ruoyi-neo4j-plugins
+
+networks:
+  ruoyi-network:
+    name: ruoyi-network
+    driver: bridge
+
--- a/docs/docker/milvus/docker-compose.yml
+++ b/docs/docker/milvus/docker-compose.yml
@@ -0,0 +1,75 @@
+version: '3.5'
+ 
+services:
+  etcd:
+    container_name: milvus-etcd
+    image: quay.io/coreos/etcd:v3.5.18
+    environment:
+      - ETCD_AUTO_COMPACTION_MODE=revision
+      - ETCD_AUTO_COMPACTION_RETENTION=1000
+      - ETCD_QUOTA_BACKEND_BYTES=4294967296
+      - ETCD_SNAPSHOT_COUNT=50000
+    volumes:
+      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/etcd:/etcd
+    command: etcd -advertise-client-urls=http://etcd:2379 -listen-client-urls http://0.0.0.0:2379 --data-dir /etcd
+    healthcheck:
+      test: ["CMD", "etcdctl", "endpoint", "health"]
+      interval: 30s
+      timeout: 20s
+      retries: 3
+ 
+  minio:
+    container_name: milvus-minio
+    image: minio/minio:RELEASE.2023-03-20T20-16-18Z
+    environment:
+      MINIO_ACCESS_KEY: minioadmin
+      MINIO_SECRET_KEY: minioadmin
+    ports:
+      - "9001:9001"
+      - "9000:9000"
+    volumes:
+      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/minio:/minio_data
+    command: minio server /minio_data --console-address ":9001"
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+      interval: 30s
+      timeout: 20s
+      retries: 3
+ 
+  standalone:
+    container_name: milvus-standalone
+    image: milvusdb/milvus:v2.5.7
+    command: ["milvus", "run", "standalone"]
+    security_opt:
+    - seccomp:unconfined
+    environment:
+      ETCD_ENDPOINTS: etcd:2379
+      MINIO_ADDRESS: minio:9000
+    volumes:
+      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/milvus:/var/lib/milvus
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9091/healthz"]
+      interval: 30s
+      start_period: 90s
+      timeout: 20s
+      retries: 3
+    ports:
+      - "19530:19530"
+      - "9091:9091"
+    depends_on:
+      - "etcd"
+      - "minio"
+ 
+  attu:
+    container_name: attu
+    image: zilliz/attu:v2.5.7
+    environment:
+      MILVUS_URL: milvus-standalone:19530
+    ports:
+      - "19500:3000"  # 外部端口19500可以自定义
+    depends_on:
+      - "standalone"
+ 
+networks:
+  default:
+    name: milvus
--- a/docs/docker/qdrant/docker-compose.yml
+++ b/docs/docker/qdrant/docker-compose.yml
@@ -0,0 +1,12 @@
+---
+services:
+  qdrant:
+    image: qdrant/qdrant:latest
+    ports:
+      - 6333:6333
+      - 6334:6334
+    volumes:
+      - qdrant_data:/qdrant/storage
+volumes:
+  qdrant_data:
+...
--- a/docs/docker/ruoyi-ai/Dockerfile.backend
+++ b/docs/docker/ruoyi-ai/Dockerfile.backend
@@ -0,0 +1,36 @@
+# RuoYi-AI 后端 Dockerfile
+# 基于 Maven + OpenJDK 17
+
+FROM maven:3.9-eclipse-temurin-17 AS builder
+
+# 设置工作目录
+WORKDIR /build
+
+# 复制 pom.xml 和源码
+COPY pom.xml .
+COPY ruoyi-admin ./ruoyi-admin
+COPY ruoyi-common ./ruoyi-common
+COPY ruoyi-modules ./ruoyi-modules
+COPY ruoyi-extend ./ruoyi-extend
+
+
+# 构建项目 (使用 prod profile)
+RUN mvn clean package -Pprod -DskipTests
+
+# 最终运行镜像
+FROM eclipse-temurin:17-jre-alpine
+
+# 设置工作目录
+WORKDIR /app
+
+# 从构建阶段复制 jar 包
+COPY --from=builder /build/ruoyi-admin/target/ruoyi-admin.jar ./ruoyi-admin.jar
+
+# 创建日志目录
+RUN mkdir -p /ruoyi/server/logs
+
+# 暴露端口
+EXPOSE 6039
+
+# 启动命令
+ENTRYPOINT ["java", "-jar", "ruoyi-admin.jar", "--spring.profiles.active=prod"]
--- a/docs/docker/ruoyi-ai/Dockerfile.mysql
+++ b/docs/docker/ruoyi-ai/Dockerfile.mysql
@@ -0,0 +1,21 @@
+# 基于官方MySQL 8.0镜像构建自定义镜像
+# 构建命令: docker build -t registry.cn-hangzhou.aliyuncs.com/ruoyi-ai/mysql:v3 -f Dockerfile.mysql .
+FROM mysql:8.0.33
+
+# 设置时区
+ENV TZ=Asia/Shanghai
+
+# 复制初始化脚本和SQL文件到镜像中
+COPY docs/script/docker/mysql/init/init-db.sh /docker-entrypoint-initdb.d/init-db.sh
+COPY docs/script/sql/ruoyi-ai-v3_mysql8.sql /docker-entrypoint-initdb.d/ruoyi-ai-v3_mysql8.sql
+
+# 设置脚本可执行权限
+RUN chmod +x /docker-entrypoint-initdb.d/init-db.sh
+
+# MySQL启动参数
+CMD ["--default-authentication-plugin=mysql_native_password", \
+     "--character-set-server=utf8mb4", \
+     "--collation-server=utf8mb4_general_ci", \
+     "--explicit_defaults_for_timestamp=true", \
+     "--lower_case_table_names=1", \
+     "--skip-ssl"]
--- a/docs/docker/ruoyi-ai/docker-compose-all.yaml
+++ b/docs/docker/ruoyi-ai/docker-compose-all.yaml
@@ -0,0 +1,180 @@
+# RuoYi-AI 一键启动全部服务
+# 使用方式: docker-compose up -d
+#
+# 包含服务:
+#   - MySQL 8.0 (数据库，包含初始化SQL)
+#   - Redis 6.2 (缓存)
+#   - Weaviate (向量数据库)
+#   - MinIO (对象存储)
+#   - RuoYi-Backend (后端服务)
+#   - RuoYi-Admin (管理端前端)
+#   - RuoYi-Web (用户端前端)
+#
+# 镜像仓库地址: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai
+
+version: '3.8'
+
+services:
+  # ==================== MySQL 数据库 ====================
+  mysql:
+    # 阿里云镜像地址（包含初始化SQL）
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/mysql:v3
+    container_name: ruoyi-ai-mysql
+    restart: always
+    ports:
+      - "23306:3306"
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: ruoyi-ai-agent
+      TZ: Asia/Shanghai
+    volumes:
+      - mysql-data:/var/lib/mysql
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
+      interval: 15s
+      timeout: 10s
+      retries: 10
+      start_period: 60s
+    networks:
+      - ruoyi-net
+
+  # ==================== Redis 缓存 ====================
+  redis:
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/redis:6.2
+    container_name: ruoyi-ai-redis
+    restart: always
+    ports:
+      - "26379:6379"
+    volumes:
+      - redis-data:/data
+    command: redis-server --appendonly yes
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - ruoyi-net
+
+  # ==================== Weaviate 向量数据库 ====================
+  weaviate:
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/weaviate:1.30.0
+    container_name: ruoyi-ai-weaviate
+    restart: always
+    ports:
+      - "28080:8080"
+    environment:
+      QUERY_DEFAULTS_LIMIT: 25
+      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: true
+      PERSISTENCE_DATA_PATH: /var/lib/weaviate
+      DEFAULT_VECTORIZER_MODULE: none
+      ENABLE_MODULES: text2vec-cohere,text2vec-huggingface,text2vec-palm,text2vec-openai,generative-openai,generative-cohere,generative-palm,ref2vec-centroid,reranker-cohere,qna-openai
+      CLUSTER_HOSTNAME: node1
+    volumes:
+      - weaviate-data:/var/lib/weaviate
+    networks:
+      - ruoyi-net
+
+  # ==================== MinIO 对象存储 ====================
+  minio:
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/minio:latest
+    container_name: ruoyi-ai-minio
+    restart: always
+    ports:
+      - "29000:9000"
+      - "29090:9090"
+    environment:
+      MINIO_ROOT_USER: ruoyi
+      MINIO_ROOT_PASSWORD: ruoyi123
+    volumes:
+      - minio-data:/data
+    command: server /data --console-address ":9090"
+    networks:
+      - ruoyi-net
+
+  # ==================== RuoYi-AI 后端服务 ====================
+  backend:
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/ruoyi-ai-backend:latest
+    container_name: ruoyi-ai-backend
+    restart: always
+    ports:
+      - "26039:6039"
+    environment:
+      TZ: Asia/Shanghai
+      # MySQL 配置
+      SPRING_DATASOURCE_DYNAMIC_PRIMARY: master
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVERCLASSNAME: com.mysql.cj.jdbc.Driver
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL: jdbc:mysql://mysql:3306/ruoyi-ai-agent?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME: root
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD: root
+      # Redis 配置
+      SPRING_DATA_REDIS_HOST: redis
+      SPRING_DATA_REDIS_PORT: 6379
+      SPRING_DATA_REDIS_DATABASE: 0
+      # 日志配置
+      LOGGING_LEVEL_ORG_RUOYI: info
+      LOGGING_LEVEL_ORG_SPRINGFRAMEWORK: warn
+      SYS_UPLOAD_PATH: /ruoyi/upload
+    volumes:
+      - logs-data:/ruoyi/server/logs
+      - upload-data:/ruoyi/upload
+    depends_on:
+      mysql:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    networks:
+      - ruoyi-net
+
+  # ==================== RuoYi-AI 管理端前端 ====================
+  admin-frontend:
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/ruoyi-ai-admin:latest
+    container_name: ruoyi-ai-admin
+    restart: always
+    ports:
+      - "25666:5666"
+    environment:
+      # 后端 API 地址 - 运行时动态配置（无需重新构建镜像）
+      # nginx upstream 配置不需要 http:// 前缀，直接使用 host:port
+      UPSTREAM_HOST: backend:6039
+    # 资源限制 - 防止 CPU 和内存耗尽
+    deploy:
+      resources:
+        limits:
+          cpus: '2'
+          memory: 3G
+        reservations:
+          cpus: '1'
+          memory: 1G
+    depends_on:
+      - backend
+    networks:
+      - ruoyi-net
+
+  # ==================== RuoYi-AI 用户端前端 ====================
+  web-frontend:
+    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/ruoyi-ai-web:latest
+    container_name: ruoyi-ai-web
+    restart: always
+    ports:
+      - "25137:5137"
+    environment:
+      UPSTREAM_URL: http://backend:6039
+    depends_on:
+      - backend
+    networks:
+      - ruoyi-net
+
+# ==================== 网络配置 ====================
+networks:
+  ruoyi-net:
+    driver: bridge
+
+# ==================== 数据卷配置 ====================
+volumes:
+  mysql-data:
+  redis-data:
+  weaviate-data:
+  minio-data:
+  logs-data:
+  upload-data:
--- a/docs/docker/ruoyi-ai/docker-compose.yaml
+++ b/docs/docker/ruoyi-ai/docker-compose.yaml
@@ -0,0 +1,144 @@
+# RuoYi-AI 一键启动后端服务
+# 使用方式: docker-compose up -d --build
+#
+# 包含服务:
+#   - MySQL 8.0 (数据库)
+#   - Redis 6.2 (缓存)
+#   - Weaviate (向量数据库)
+#   - MinIO (对象存储)
+#   - RuoYi-Backend (后端服务，源码编译)
+
+services:
+  # MySQL 数据库
+  mysql:
+    image: mysql:8.0.33
+    container_name: ruoyi-ai-mysql
+    restart: always
+    ports:
+      - "23306:3306"
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: ruoyi-ai-agent
+      TZ: Asia/Shanghai
+    volumes:
+      - ./docs/script/docker/mysql/init/init-db.sh:/docker-entrypoint-initdb.d/init-db.sh:ro
+      - ./docs/script/sql/ruoyi-ai-v3_mysql8.sql:/docker-entrypoint-initdb.d/ruoyi-ai-v3_mysql8.sql:ro
+      - mysql-data:/var/lib/mysql
+    command:
+      --default-authentication-plugin=mysql_native_password
+      --character-set-server=utf8mb4
+      --collation-server=utf8mb4_general_ci
+      --explicit_defaults_for_timestamp=true
+      --lower_case_table_names=1
+      --skip-ssl
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
+      interval: 15s
+      timeout: 10s
+      retries: 10
+      start_period: 60s
+    networks:
+      - ruoyi-net
+
+  # Redis 缓存
+  redis:
+    image: redis:6.2
+    container_name: ruoyi-ai-redis
+    restart: always
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis-data:/data
+    command: redis-server --appendonly yes
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - ruoyi-net
+
+  # Weaviate 向量数据库
+  weaviate:
+    image: semitechnologies/weaviate:1.30.0
+    container_name: ruoyi-ai-weaviate
+    restart: always
+    ports:
+      - "28080:8080"
+    environment:
+      QUERY_DEFAULTS_LIMIT: 25
+      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: true
+      PERSISTENCE_DATA_PATH: /var/lib/weaviate
+      DEFAULT_VECTORIZER_MODULE: none
+      ENABLE_MODULES: text2vec-cohere,text2vec-huggingface,text2vec-palm,text2vec-openai,generative-openai,generative-cohere,generative-palm,ref2vec-centroid,reranker-cohere,qna-openai
+      CLUSTER_HOSTNAME: node1
+    volumes:
+      - weaviate-data:/var/lib/weaviate
+    networks:
+      - ruoyi-net
+
+  # MinIO 对象存储
+  minio:
+    image: minio/minio
+    container_name: ruoyi-ai-minio
+    restart: always
+    ports:
+      - "9000:9000"
+      - "9090:9090"
+    environment:
+      MINIO_ROOT_USER: ruoyi
+      MINIO_ROOT_PASSWORD: ruoyi123
+    volumes:
+      - minio-data:/data
+    command: server /data --console-address ":9090"
+    networks:
+      - ruoyi-net
+
+  # RuoYi-AI 后端服务 (源码编译)
+  backend:
+    build:
+      context: .
+      dockerfile: Dockerfile.backend
+    container_name: ruoyi-ai-backend
+    restart: always
+    ports:
+      - "26039:6039"
+    environment:
+      TZ: Asia/Shanghai
+      # MySQL 配置
+      SPRING_DATASOURCE_DYNAMIC_PRIMARY: master
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_DRIVERCLASSNAME: com.mysql.cj.jdbc.Driver
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_URL: jdbc:mysql://mysql:3306/ruoyi-ai-agent?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_USERNAME: root
+      SPRING_DATASOURCE_DYNAMIC_DATASOURCE_MASTER_PASSWORD: root
+      # Redis 配置
+      SPRING_DATA_REDIS_HOST: redis
+      SPRING_DATA_REDIS_PORT: 6379
+      SPRING_DATA_REDIS_DATABASE: 0
+      # 日志配置
+      LOGGING_LEVEL_ORG_RUOYI: info
+      LOGGING_LEVEL_ORG_SPRINGFRAMEWORK: warn
+      SYS_UPLOAD_PATH: /ruoyi/upload   # 新增：对应 sys.upload.path
+    volumes:
+      - logs-data:/ruoyi/server/logs
+      - upload-data:/ruoyi/upload
+    depends_on:
+      mysql:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    networks:
+      - ruoyi-net
+
+networks:
+  ruoyi-net:
+    driver: bridge
+
+# 数据卷 支持手动指定 空为默认值
+volumes:
+  mysql-data:
+  redis-data:
+  weaviate-data:
+  minio-data:
+  logs-data:
+  upload-data:
--- a/docs/docker/weaviate/docker-compose.yml
+++ b/docs/docker/weaviate/docker-compose.yml
@@ -0,0 +1,25 @@
+---
+services:
+  weaviate:
+    command:
+      - --host
+      - 0.0.0.0
+      - --port
+      - '6038'
+      - --scheme
+      - http
+    image: semitechnologies/weaviate:1.19.7
+    ports:
+      - 6038:6038
+      - 50051:50051
+    volumes:
+      - weaviate_data:/var/lib/weaviate
+    environment:
+      QUERY_DEFAULTS_LIMIT: 25
+      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: 'true'
+      PERSISTENCE_DATA_PATH: '/var/lib/weaviate'
+      DEFAULT_VECTORIZER_MODULE: 'none'
+      CLUSTER_HOSTNAME: 'node1'
+volumes:
+  weaviate_data:
+...
--- a/docs/image/bibi.png
+++ b/docs/image/bibi.png
--- a/docs/image/dy.png
+++ b/docs/image/dy.png
--- a/docs/script/docker/database.yml
+++ b/docs/script/docker/database.yml
--- a/docs/script/docker/docker-compose.yml
+++ b/docs/script/docker/docker-compose.yml
--- a/docs/script/docker/mysql/init/init-db.sh
+++ b/docs/script/docker/mysql/init/init-db.sh
@@ -0,0 +1,10 @@
+#!/bin/bash
+# 数据库初始化脚本
+# 使用 --force 参数确保即使出错也继续执行
+
+echo "开始初始化数据库..."
+
+# 使用 --force 参数忽略错误继续执行
+mysql -uroot -proot ruoyi-ai-agent --force < /docker-entrypoint-initdb.d/ruoyi-ai-v3_mysql8.sql
+
+echo "数据库初始化完成"
--- a/docs/script/docker/nginx/conf/nginx.conf
+++ b/docs/script/docker/nginx/conf/nginx.conf
@@ -1,161 +0,0 @@
-worker_processes  1;
-
-error_log  /var/log/nginx/error.log warn;
-pid        /var/run/nginx.pid;
-
-events {
-    # 可以根据业务并发量适当调高
-    worker_connections  1024;
-}
-
-http {
-    include       mime.types;
-    default_type  application/octet-stream;
-    # 高效传输文件
-    sendfile        on;
-    # 长连接超时时间
-    keepalive_timeout  65;
-    # 单连接最大请求数，提高长连接复用率
-    keepalive_requests 100000;
-    # 限制body大小
-    client_max_body_size 100m;
-    client_header_buffer_size 32k;
-    client_body_buffer_size   512k;
-    # 开启静态资源压缩
-    gzip_static on;
-    # 连接数限制 (防御类配置) 10m 一般够用了，能存储上万 IP 的计数
-    limit_conn_zone $binary_remote_addr zone=perip:10m;
-    limit_conn_zone $server_name zone=perserver:10m;
-    # 隐藏 nginx 版本号，防止暴露版本信息
-    server_tokens off;
-
-    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
-                          '$status $body_bytes_sent "$http_referer" '
-                          '"$http_user_agent" "$http_x_forwarded_for"';
-
-    access_log  /var/log/nginx/access.log  main;
-
-    upstream server {
-        ip_hash;
-        server 127.0.0.1:8080;
-        server 127.0.0.1:8081;
-    }
-
-    upstream monitor-admin {
-        server 127.0.0.1:9090;
-    }
-
-    upstream snailjob-server {
-        server 127.0.0.1:8800;
-    }
-
-    server {
-        listen       80;
-        server_name  localhost;
-
-        # https配置参考 start
-        #listen       443 ssl;
-
-        # 证书直接存放 /docker/nginx/cert/ 目录下即可 更改证书名称即可 无需更改证书路径
-        #ssl on;
-        #ssl_certificate      /etc/nginx/cert/xxx.local.crt; # /etc/nginx/cert/ 为docker映射路径 不允许更改
-        #ssl_certificate_key  /etc/nginx/cert/xxx.local.key; # /etc/nginx/cert/ 为docker映射路径 不允许更改
-        #ssl_session_timeout 5m;
-        #ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
-        #ssl_protocols TLSv1.3 TLSv1.2 TLSv1.1 TLSv1;
-        #ssl_prefer_server_ciphers on;
-        # https配置参考 end
-
-        # 演示环境配置 拦截除 GET POST 之外的所有请求
-        # if ($request_method !~* GET|POST) {
-        #     rewrite  ^/(.*)$  /403;
-        # }
-
-        # location = /403 {
-        #     default_type application/json;
-        #     return 200 '{"msg":"演示模式，不允许操作","code":500}';
-        # }
-
-        # 限制外网访问内网 actuator 相关路径
-        location ~ ^(/[^/]*)?/actuator.*(/.*)?$ {
-            return 403;
-        }
-
-        location / {
-            root   /usr/share/nginx/html; # docker映射路径 不允许更改
-            try_files $uri $uri/ /index.html;
-            index  index.html index.htm;
-        }
-
-        location /prod-api/ {
-            # 设置客户端请求头中的 Host 信息（保持原始 Host）
-            proxy_set_header Host $http_host;
-            # 获取客户端真实 IP
-            proxy_set_header X-Real-IP $remote_addr;
-            # 自定义头 REMOTE-HOST，记录客户端 IP
-            proxy_set_header REMOTE-HOST $remote_addr;
-            # 获取完整的客户端 IP 链（经过多级代理时）
-            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-            # 设置后端响应超时时间（这里是 24 小时，适合长连接/SSE）
-            proxy_read_timeout 86400s;
-            # SSE (Server-Sent Events) 与 WebSocket 支持参数
-            proxy_http_version 1.1;
-            proxy_set_header Upgrade $http_upgrade;
-            proxy_set_header Connection "upgrade";
-            # 禁用代理缓冲，数据直接传给客户端
-            proxy_buffering off;
-            # 禁用代理缓存
-            proxy_cache off;
-            # 按 IP 限制连接数（防 CC 攻击） 小型站：10~20 就够 中型站：50~100
-            limit_conn perip 20;
-
-            # 按 Server 限制总并发连接数 根据服务器的最大并发处理能力来定 太小会限制合法用户访问，太大会占满服务器资源
-            limit_conn perserver 500;
-            proxy_pass http://server/;
-        }
-
-        # https 会拦截内链所有的 http 请求 造成功能无法使用
-        # 解决方案1 将 admin 服务 也配置成 https
-        # 解决方案2 将菜单配置为外链访问 走独立页面 http 访问
-        location /admin/ {
-            # 设置客户端请求头中的 Host 信息（保持原始 Host）
-            proxy_set_header Host $http_host;
-            # 获取客户端真实 IP
-            proxy_set_header X-Real-IP $remote_addr;
-            # 自定义头 REMOTE-HOST，记录客户端 IP
-            proxy_set_header REMOTE-HOST $remote_addr;
-            # 获取完整的客户端 IP 链（经过多级代理时）
-            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-            # 禁用代理缓冲，数据直接传给客户端
-            proxy_buffering off;
-            # 禁用代理缓存
-            proxy_cache off;
-            proxy_pass http://monitor-admin/admin/;
-        }
-
-        location /snail-job/ {
-            # 设置客户端请求头中的 Host 信息（保持原始 Host）
-            proxy_set_header Host $http_host;
-            # 获取客户端真实 IP
-            proxy_set_header X-Real-IP $remote_addr;
-            # 自定义头 REMOTE-HOST，记录客户端 IP
-            proxy_set_header REMOTE-HOST $remote_addr;
-            # 获取完整的客户端 IP 链（经过多级代理时）
-            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-            # SSE (Server-Sent Events) 与 WebSocket 支持参数
-            proxy_http_version 1.1;
-            proxy_set_header Upgrade $http_upgrade;
-            proxy_set_header Connection "upgrade";
-            # 禁用代理缓冲，直接传输给客户端
-            proxy_buffering off;
-            # 禁用代理缓存
-            proxy_cache off;
-            proxy_pass http://snailjob-server/snail-job/;
-        }
-
-        error_page   500 502 503 504  /50x.html;
-        location = /50x.html {
-            root   html;
-        }
-    }
-}
--- a/docs/script/docker/redis/conf/redis.conf
+++ b/docs/script/docker/redis/conf/redis.conf
@@ -1,28 +0,0 @@
-# redis 密码
-requirepass ruoyi123
-
-# key 监听器配置
-# notify-keyspace-events Ex
-
-# 配置持久化文件存储路径
-dir /redis/data
-# 配置rdb
-# 15分钟内有至少1个key被更改则进行快照
-save 900 1
-# 5分钟内有至少10个key被更改则进行快照
-save 300 10
-# 1分钟内有至少10000个key被更改则进行快照
-save 60 10000
-# 开启压缩
-rdbcompression yes
-# rdb文件名 用默认的即可
-dbfilename dump.rdb
-
-# 开启aof
-appendonly yes
-# 文件名
-appendfilename "appendonly.aof"
-# 持久化策略,no:不同步,everysec:每秒一次,always:总是同步,速度比较慢
-# appendfsync always
-appendfsync everysec
-# appendfsync no
--- a/docs/script/docker/redis/data/README.md
+++ b/docs/script/docker/redis/data/README.md
@@ -1 +0,0 @@
-数据目录 请执行 `chmod 777 /docker/redis/data` 赋予读写权限 否则将无法写入数据
--- a/docs/script/sql/ruoyi-ai-v3_mysql8.sql
+++ b/docs/script/sql/ruoyi-ai-v3_mysql8.sql
--- a/docs/script/sql/workFlow-v3.0.sql
+++ b/docs/script/sql/workFlow-v3.0.sql
@@ -1,6 +0,0 @@
-INSERT INTO `mysql`.`t_workflow_component` (`id`, `uuid`, `name`, `title`, `remark`, `display_order`, `is_enable`, `create_time`, `update_time`, `is_deleted`, `tenant_id`) VALUES (17, '5cd68dccbbb411f0bb7840c2ba9a7fbc', 'Start', '开始', '流程由此开始', 0, 1, '2025-11-07 16:32:49', '2025-11-07 16:32:49', 0, '000000');
-INSERT INTO `mysql`.`t_workflow_component` (`id`, `uuid`, `name`, `title`, `remark`, `display_order`, `is_enable`, `create_time`, `update_time`, `is_deleted`, `tenant_id`) VALUES (18, '5cd6ac69bbb411f0bb7840c2ba9a7fbc', 'End', '结束', '流程由此结束', 0, 1, '2025-11-07 16:32:49', '2025-11-07 16:32:49', 0, '000000');
-INSERT INTO `mysql`.`t_workflow_component` (`id`, `uuid`, `name`, `title`, `remark`, `display_order`, `is_enable`, `create_time`, `update_time`, `is_deleted`, `tenant_id`) VALUES (19, '5cd6c8eabbb411f0bb7840c2ba9a7fbc', 'Answer', '生成回答', '调用大语言模型回答问题', 0, 1, '2025-11-07 16:32:49', '2025-11-07 16:32:49', 0, '000000');
-INSERT INTO `mysql`.`t_workflow_component` (`id`, `uuid`, `name`, `title`, `remark`, `display_order`, `is_enable`, `create_time`, `update_time`, `is_deleted`, `tenant_id`) VALUES (25, '0b4369bb60dc46d6bd84ceb4e36184dc', 'KeywordExtractor', '关键词提取', '从文本中提取关键词', 0, 1, '2025-12-26 16:30:05', '2025-12-26 16:30:05', 0, '000000');
-INSERT INTO `mysql`.`t_workflow_component` (`id`, `uuid`, `name`, `title`, `remark`, `display_order`, `is_enable`, `create_time`, `update_time`, `is_deleted`, `tenant_id`) VALUES (26, 'bb00fc2f52c74fec82ee3f99725b56bb', 'Switcher', '条件分支', '根据条件执行不同分支', 0, 1, '2025-12-26 16:30:46', '2025-12-26 16:30:46', 0, '000000');
-INSERT INTO `mysql`.`t_workflow_component` (`id`, `uuid`, `name`, `title`, `remark`, `display_order`, `is_enable`, `create_time`, `update_time`, `is_deleted`, `tenant_id`) VALUES (36, 'f37dbcb8f0d5464d90fbb22774490a56', 'HumanFeedback', '人类', '人机沟通', 0, 1, '2025-12-30 17:37:14', '2025-12-30 17:37:14', 0, '000000');
--- a/docs/troubleshooting/rag-failures.md
+++ b/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) 
--- a/docs/文件上传接口文档.md
+++ b/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"
+  }
+}
+```
+
+
+### 异常情况
+- 当上传文件为空时，返回错误信息："上传文件不能为空"
--- a/pom.xml
+++ b/pom.xml
@@ -50,15 +50,19 @@
        <!-- 工作流配置 -->
        <warm-flow.version>1.8.2</warm-flow.version>
        <!-- 企业微信SDK -->
-        <weixin-java-cp.version>4.4.0</weixin-java-cp.version>
+        <weixin-java-cp.version>4.6.0</weixin-java-cp.version>
        <!-- Jackson XML -->
-        <jackson-dataformat-xml.version>2.20.1</jackson-dataformat-xml.version>
+        <jackson-dataformat-xml.version>2.18.2</jackson-dataformat-xml.version>
        <!-- AI 相关依赖 -->
        <langchain4j.version>1.11.0</langchain4j.version>
        <langchain4j.community.version>1.11.0-beta19</langchain4j.community.version>
        <langgraph4j.version>1.5.3</langgraph4j.version>
        <weaviate.version>1.19.6</weaviate.version>
        <dify.version>1.0.7</dify.version>
+        <!-- gRPC 版本 - 解决 Milvus SDK 依赖冲突 -->
+        <grpc.version>1.62.2</grpc.version>
+        <!-- Apache Commons Compress - 用于POI处理ZIP格式 -->
+        <commons-compress.version>1.27.1</commons-compress.version>


        <avatar-generator.version>1.1.0</avatar-generator.version>
@@ -127,6 +131,15 @@
                <scope>import</scope>
            </dependency>

+            <!-- gRPC BOM - 解决 Milvus SDK 依赖冲突，强制统一版本 -->
+            <dependency>
+                <groupId>io.grpc</groupId>
+                <artifactId>grpc-bom</artifactId>
+                <version>${grpc.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+
            <!-- hutool 的依赖配置-->
            <dependency>
                <groupId>cn.hutool</groupId>
@@ -350,24 +363,12 @@
                <version>${revision}</version>
            </dependency>

-            <dependency>
-                <groupId>org.ruoyi</groupId>
-                <artifactId>ruoyi-job</artifactId>
-                <version>${revision}</version>
-            </dependency>
-
            <dependency>
                <groupId>org.ruoyi</groupId>
                <artifactId>ruoyi-generator</artifactId>
                <version>${revision}</version>
            </dependency>

-            <dependency>
-                <groupId>org.ruoyi</groupId>
-                <artifactId>ruoyi-demo</artifactId>
-                <version>${revision}</version>
-            </dependency>
-
            <dependency>
                <groupId>org.ruoyi</groupId>
                <artifactId>ruoyi-chat</artifactId>
@@ -381,20 +382,6 @@
                <version>${revision}</version>
            </dependency>

-            <!--  微信模块  -->
-            <dependency>
-                <groupId>org.ruoyi</groupId>
-                <artifactId>ruoyi-wechat</artifactId>
-                <version>${revision}</version>
-            </dependency>
-
-            <!--  数字人模块  -->
-            <dependency>
-                <groupId>org.ruoyi</groupId>
-                <artifactId>ruoyi-aihuman</artifactId>
-                <version>${revision}</version>
-            </dependency>
-
            <!--  AI流程编排模块  -->
            <dependency>
                <groupId>org.ruoyi</groupId>
@@ -402,13 +389,6 @@
                <version>${revision}</version>
            </dependency>

-            <!-- 企业微信SDK -->
-            <dependency>
-                <groupId>com.github.binarywang</groupId>
-                <artifactId>weixin-java-cp</artifactId>
-                <version>${weixin-java-cp.version}</version>
-            </dependency>
-
            <!-- Jackson XML -->
            <dependency>
                <groupId>com.fasterxml.jackson.dataformat</groupId>
@@ -416,6 +396,13 @@
                <version>${jackson-dataformat-xml.version}</version>
            </dependency>

+            <!-- Apache Commons Compress - 用于POI处理ZIP格式，解决导出Excel时的NoSuchMethodError -->
+            <dependency>
+                <groupId>org.apache.commons</groupId>
+                <artifactId>commons-compress</artifactId>
+                <version>${commons-compress.version}</version>
+            </dependency>
+
        </dependencies>
    </dependencyManagement>

--- a/ruoyi-admin/pom.xml
+++ b/ruoyi-admin/pom.xml
@@ -70,23 +70,12 @@
            <artifactId>ruoyi-system</artifactId>
        </dependency>

-        <dependency>
-            <groupId>org.ruoyi</groupId>
-            <artifactId>ruoyi-job</artifactId>
-        </dependency>
-
        <!-- 代码生成-->
        <dependency>
            <groupId>org.ruoyi</groupId>
            <artifactId>ruoyi-generator</artifactId>
        </dependency>

-        <!--  demo模块  -->
-        <dependency>
-            <groupId>org.ruoyi</groupId>
-            <artifactId>ruoyi-demo</artifactId>
-        </dependency>
-
        <dependency>
            <groupId>org.ruoyi</groupId>
            <artifactId>ruoyi-chat</artifactId>
@@ -98,24 +87,13 @@
            <artifactId>ruoyi-workflow</artifactId>
        </dependency>

-        <!--  微信模块  -->
-        <dependency>
-            <groupId>org.ruoyi</groupId>
-            <artifactId>ruoyi-wechat</artifactId>
-        </dependency>
-
-        <!--  数字人模块  -->
-        <dependency>
-            <groupId>org.ruoyi</groupId>
-            <artifactId>ruoyi-aihuman</artifactId>
-        </dependency>
-
        <!--  AI流程编排模块  -->
        <dependency>
            <groupId>org.ruoyi</groupId>
            <artifactId>ruoyi-aiflow</artifactId>
        </dependency>

+
        <dependency>
            <groupId>de.codecentric</groupId>
            <artifactId>spring-boot-admin-starter-client</artifactId>
--- a/ruoyi-admin/src/main/java/org/ruoyi/RuoYiAIApplication.java
+++ b/ruoyi-admin/src/main/java/org/ruoyi/RuoYiAIApplication.java
@@ -16,7 +16,7 @@ public class RuoYiAIApplication {
        SpringApplication application = new SpringApplication(RuoYiAIApplication.class);
        application.setApplicationStartup(new BufferingApplicationStartup(2048));
        application.run(args);
-        System.out.println("(♥◠‿◠)ﾉﾞ   RuoYi-AI启动成功   ლ(´ڡ`ლ)ﾞ");
+        System.out.println("(♥◠‿◠)ﾉﾞ     RuoYi-AI启动成功   ლ(´ڡ`ლ)ﾞ");
    }

 }
--- a/ruoyi-admin/src/main/java/org/ruoyi/config/MapperConflictResolver.java
+++ b/ruoyi-admin/src/main/java/org/ruoyi/config/MapperConflictResolver.java
@@ -0,0 +1,48 @@
+package org.ruoyi.config;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.BeansException;
+import org.springframework.beans.factory.config.BeanDefinition;
+import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.beans.factory.support.BeanDefinitionRegistryPostProcessor;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * BeanDefinitionRegistry后置处理器
+ * 解决 MapStruct Plus 生成的 mapper 冲突问题
+ *
+ * @author ruoyi team
+ */
+@Configuration
+public class MapperConflictResolver implements BeanDefinitionRegistryPostProcessor {
+
+    private static final Logger log = LoggerFactory.getLogger(MapperConflictResolver.class);
+
+    @Override
+    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
+        String[] beanNames = registry.getBeanDefinitionNames();
+
+        // 查找冲突的 mapper bean
+        for (String beanName : beanNames) {
+            if (beanName.equals("chatMessageBoToChatMessageMapperImpl")) {
+                BeanDefinition beanDefinition = registry.getBeanDefinition(beanName);
+                String beanClassName = beanDefinition.getBeanClassName();
+
+                log.info("Found mapper bean: {} -> {}", beanName, beanClassName);
+
+                // 如果是 org.ruoyi.domain.bo.chat 包下的（冲突的），移除它
+                if (beanClassName != null && beanClassName.startsWith("org.ruoyi.domain.bo.chat")) {
+                    log.warn("Removing conflicting bean definition: {} ({})", beanName, beanClassName);
+                    registry.removeBeanDefinition(beanName);
+                }
+            }
+        }
+    }
+
+    @Override
+    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
+        // 不需要实现
+    }
+}
--- a/ruoyi-admin/src/main/java/org/ruoyi/controller/AuthController.java
+++ b/ruoyi-admin/src/main/java/org/ruoyi/controller/AuthController.java
@@ -80,10 +80,16 @@ public class AuthController {
        // 授权类型和客户端id
        String clientId = loginBody.getClientId();
        String grantType = loginBody.getGrantType();
+        log.info("登录请求 - clientId: {}, grantType: {}", clientId, grantType);
        SysClientVo client = clientService.queryByClientId(clientId);
+        log.info("查询客户端结果 - client: {}, grantType: {}", client, client != null ? client.getGrantType() : "null");
        // 查询不到 client 或 client 内不包含 grantType
-        if (ObjectUtil.isNull(client) || !StringUtils.contains(client.getGrantType(), grantType)) {
-            log.info("客户端id: {} 认证类型：{} 异常!.", clientId, grantType);
+        if (ObjectUtil.isNull(client)) {
+            log.info("客户端id: {} 不存在!", clientId);
+            return R.fail(MessageUtils.message("auth.grant.type.error"));
+        }
+        if (!StringUtils.contains(client.getGrantType(), grantType)) {
+            log.info("客户端id: {} 认证类型：{} 不匹配! 数据库grantType: {}", clientId, grantType, client.getGrantType());
            return R.fail(MessageUtils.message("auth.grant.type.error"));
        } else if (!SystemConstants.NORMAL.equals(client.getStatus())) {
            return R.fail(MessageUtils.message("auth.grant.type.blocked"));
--- a/ruoyi-admin/src/main/resources/application-dev.yml
+++ b/ruoyi-admin/src/main/resources/application-dev.yml
@@ -11,6 +11,17 @@ spring.boot.admin.client:
  username: @monitor.username@
  password: @monitor.password@

+--- # mcp配置信息
+mcp:
+  sse:
+    enabled: false
+    url: http://localhost:8085/sse
+
+--- # 上传文件地址
+sys:
+  upload:
+    path: D:\\DownLoad
+
 --- # snail-job 配置
 snail-job:
  enabled: false
@@ -47,9 +58,16 @@ spring:
          driverClassName: com.mysql.cj.jdbc.Driver
          # jdbc 所有参数配置参考 https://lionli.blog.csdn.net/article/details/122018562
          # rewriteBatchedStatements=true 批处理优化 大幅提升批量插入更新删除性能(对数据库有性能损耗 使用批量操作应考虑性能问题)
-          url: jdbc:mysql://127.0.0.1:3306/ruoyi-ai-v3?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
-          username: ruoyi-ai-v3
-          password: ruoyi-ai-v3
+          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&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
+          username: root
+          password: root
+#        agent:
+#          url: jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
+#          # url: jdbc:mysql://localhost:3306/agent_db
+#          username: root
+#          password: root
+#          driverClassName: com.mysql.cj.jdbc.Driver
+
      hikari:
        # 最大连接池数量
        maxPoolSize: 20
@@ -66,17 +84,13 @@ spring:
        # 多久检查一次连接的活性
        keepaliveTime: 30000

-agent:
-  mysql:
-    url: jdbc:mysql://localhost:3306/ruoyi-ai-agent?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
-    username: root
-    password: root
+

 --- # 上传文件地址
 sys:
  upload:
    path: D:\\DownLoad
-    
+
 --- # redis 单机配置(单机与集群只能开启一个另一个需要注释掉)
 spring.data:
  redis:
@@ -87,7 +101,7 @@ spring.data:
    # 数据库索引
    database: 0
    # redis 密码必须配置
-    password: 123456
+#    password: 123456
    # 连接超时时间
    timeout: 10s
    # 是否开启ssl
@@ -254,3 +268,4 @@ justauth:
      client-secret: 1f7d08**********5b7**********29e
      redirect-uri: ${justauth.address}/social-callback?source=gitea

+AGENT_ALLOWED_TABLES: ""
--- a/ruoyi-admin/src/main/resources/application-prod.yml
+++ b/ruoyi-admin/src/main/resources/application-prod.yml
@@ -0,0 +1,271 @@
+--- # 监控中心配置
+spring.boot.admin.client:
+  # 增加客户端开关
+  enabled: false
+  url: http://localhost:9090/admin
+  instance:
+    service-host-type: IP
+    metadata:
+      username: ${spring.boot.admin.client.username}
+      userpassword: ${spring.boot.admin.client.password}
+  username: @monitor.username@
+  password: @monitor.password@
+
+--- # mcp配置信息
+mcp:
+  sse:
+    enabled: false
+    url: http://localhost:8085/sse
+
+--- # 上传文件地址
+sys:
+  upload:
+    path: D:\\DownLoad
+
+--- # snail-job 配置
+snail-job:
+  enabled: false
+  # 需要在 SnailJob 后台组管理创建对应名称的组,然后创建任务的时候选择对应的组,才能正确分派任务
+  group: "ruoyi_group"
+  # SnailJob 接入验证令牌 详见 script/sql/ry_job.sql `sj_group_config` 表
+  token: "SJ_cKqBTPzCsWA3VyuCfFoccmuIEGXjr5KT"
+  server:
+    host: 127.0.0.1
+    port: 17888
+  # 命名空间UUID 详见 script/sql/ry_job.sql `sj_namespace`表`unique_id`字段
+  namespace: ${spring.profiles.active}
+  # 随主应用端口漂移
+  port: 2${server.port}
+  # 客户端ip指定
+  host:
+
+--- # 数据源配置
+spring:
+  datasource:
+    type: com.zaxxer.hikari.HikariDataSource
+    # 动态数据源文档 https://www.kancloud.cn/tracy5546/dynamic-datasource/content
+    dynamic:
+      # 性能分析插件(有性能损耗 不建议生产环境使用)
+      p6spy: true
+      # 设置默认的数据源或者数据源组,默认值即为 master
+      primary: master
+      # 严格模式 匹配不到数据源则报错
+      strict: true
+      datasource:
+        # 主库数据源
+        master:
+          type: ${spring.datasource.type}
+          driverClassName: com.mysql.cj.jdbc.Driver
+          # jdbc 所有参数配置参考 https://lionli.blog.csdn.net/article/details/122018562
+          # rewriteBatchedStatements=true 批处理优化 大幅提升批量插入更新删除性能(对数据库有性能损耗 使用批量操作应考虑性能问题)
+          url: jdbc:mysql://127.0.0.1:3306/ruoyi-ai-agent?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
+          username: root
+          password: root
+#        agent:
+#          url: jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
+#          # url: jdbc:mysql://localhost:3306/agent_db
+#          username: root
+#          password: root
+#          driverClassName: com.mysql.cj.jdbc.Driver
+
+      hikari:
+        # 最大连接池数量
+        maxPoolSize: 20
+        # 最小空闲线程数量
+        minIdle: 10
+        # 配置获取连接等待超时的时间
+        connectionTimeout: 30000
+        # 校验超时时间
+        validationTimeout: 5000
+        # 空闲连接存活最大时间，默认10分钟
+        idleTimeout: 600000
+        # 此属性控制池中连接的最长生命周期，值0表示无限生命周期，默认30分钟
+        maxLifetime: 1800000
+        # 多久检查一次连接的活性
+        keepaliveTime: 30000
+
+
+
+--- # 上传文件地址
+sys:
+  upload:
+    path: D:\\DownLoad
+
+--- # redis 单机配置(单机与集群只能开启一个另一个需要注释掉)
+spring.data:
+  redis:
+    # 地址
+    host: localhost
+    # 端口，默认为6379
+    port: 6379
+    # 数据库索引
+    database: 0
+    # redis 密码必须配置
+#    password: 123456
+    # 连接超时时间
+    timeout: 10s
+    # 是否开启ssl
+    ssl.enabled: false
+
+# redisson 配置
+redisson:
+  # redis key前缀
+  keyPrefix:
+  # 线程池数量
+  threads: 4
+  # Netty线程池数量
+  nettyThreads: 8
+  # 单节点配置
+  singleServerConfig:
+    # 客户端名称 不能用中文
+    clientName: ruoyi-ai
+    # 最小空闲连接数
+    connectionMinimumIdleSize: 8
+    # 连接池大小
+    connectionPoolSize: 32
+    # 连接空闲超时，单位：毫秒
+    idleConnectionTimeout: 10000
+    # 命令等待超时，单位：毫秒
+    timeout: 3000
+    # 发布和订阅连接池大小
+    subscriptionConnectionPoolSize: 50
+
+--- # mail 邮件发送
+mail:
+  enabled: false
+  host: smtp.163.com
+  port: 465
+  # 是否需要用户名密码验证
+  auth: true
+  # 发送方，遵循RFC-822标准
+  from: xxx@163.com
+  # 用户名（注意：如果使用foxmail邮箱，此处user为qq号）
+  user: xxx@163.com
+  # 密码（注意，某些邮箱需要为SMTP服务单独设置密码，详情查看相关帮助）
+  pass: xxxxxxxxxx
+  # 使用 STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。
+  starttlsEnable: true
+  # 使用SSL安全连接
+  sslEnable: true
+  # SMTP超时时长，单位毫秒，缺省值不超时
+  timeout: 0
+  # Socket连接超时值，单位毫秒，缺省值不超时
+  connectionTimeout: 0
+
+--- # sms 短信 支持 阿里云 腾讯云 云片 等等各式各样的短信服务商
+# https://sms4j.com/doc3/ 差异配置文档地址 支持单厂商多配置，可以配置多个同时使用
+sms:
+  # 配置源类型用于标定配置来源(interface,yaml)
+  config-type: yaml
+  # 用于标定yml中的配置是否开启短信拦截，接口配置不受此限制
+  restricted: true
+  # 短信拦截限制单手机号每分钟最大发送，只对开启了拦截的配置有效
+  minute-max: 1
+  # 短信拦截限制单手机号每日最大发送量，只对开启了拦截的配置有效
+  account-max: 30
+  # 以下配置来自于 org.dromara.sms4j.provider.config.BaseConfig类中
+  blends:
+    # 唯一ID 用于发送短信寻找具体配置 随便定义别用中文即可
+    # 可以同时存在两个相同厂商 例如: ali1 ali2 两个不同的阿里短信账号 也可用于区分租户
+    config1:
+      # 框架定义的厂商名称标识，标定此配置是哪个厂商，详细请看厂商标识介绍部分
+      supplier: alibaba
+      # 有些称为accessKey有些称之为apiKey，也有称为sdkKey或者appId。
+      access-key-id: 您的accessKey
+      # 称为accessSecret有些称之为apiSecret
+      access-key-secret: 您的accessKeySecret
+      signature: 您的短信签名
+      sdk-app-id: 您的sdkAppId
+    config2:
+      # 厂商标识，标定此配置是哪个厂商，详细请看厂商标识介绍部分
+      supplier: tencent
+      access-key-id: 您的accessKey
+      access-key-secret: 您的accessKeySecret
+      signature: 您的短信签名
+      sdk-app-id: 您的sdkAppId
+
+
+--- # 三方授权
+justauth:
+  # 前端外网访问地址
+  address: http://localhost:80
+  type:
+    maxkey:
+      # maxkey 服务器地址
+      # 注意 如下均配置均不需要修改 maxkey 已经内置好了数据
+      server-url: http://sso.maxkey.top
+      client-id: 876892492581044224
+      client-secret: x1Y5MTMwNzIwMjMxNTM4NDc3Mzche8
+      redirect-uri: ${justauth.address}/social-callback?source=maxkey
+    topiam:
+      # topiam 服务器地址
+      server-url: http://127.0.0.1:1898/api/v1/authorize/y0q************spq***********8ol
+      client-id: 449c4*********937************759
+      client-secret: ac7***********1e0************28d
+      redirect-uri: ${justauth.address}/social-callback?source=topiam
+      scopes: [openid, email, phone, profile]
+    qq:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=qq
+      union-id: false
+    weibo:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=weibo
+    gitee:
+      client-id: 91436b7940090d09c72c7daf85b959cfd5f215d67eea73acbf61b6b590751a98
+      client-secret: 02c6fcfd70342980cd8dd2f2c06c1a350645d76c754d7a264c4e125f9ba915ac
+      redirect-uri: ${justauth.address}/social-callback?source=gitee
+    dingtalk:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=dingtalk
+    baidu:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=baidu
+    csdn:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=csdn
+    coding:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=coding
+      coding-group-name: xx
+    oschina:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=oschina
+    alipay_wallet:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=alipay_wallet
+      alipay-public-key: MIIB**************DAQAB
+    wechat_open:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=wechat_open
+    wechat_mp:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=wechat_mp
+    wechat_enterprise:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=wechat_enterprise
+      agent-id: 1000002
+    gitlab:
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=gitlab
+    gitea:
+      # 前端改动 https://gitee.com/JavaLionLi/plus-ui/pulls/204
+      # gitea 服务器地址
+      server-url: https://demo.gitea.com
+      client-id: 10**********6
+      client-secret: 1f7d08**********5b7**********29e
+      redirect-uri: ${justauth.address}/social-callback?source=gitea
+
+AGENT_ALLOWED_TABLES: "abtest_rule,abtest_project,agent_ban_log,agent_ban_logs,agent_install_sub_task,agent_install_sum_task,agent_install_task"
--- a/ruoyi-admin/src/main/resources/application.yml
+++ b/ruoyi-admin/src/main/resources/application.yml
@@ -124,7 +124,7 @@ security:
    - /*/api-docs
    - /*/api-docs/**
    - /warm-flow-ui/config
-
+    - /workflow/run
 # 多租户配置
 tenant:
  # 是否开启
@@ -203,6 +203,7 @@ springdoc:
      name:  ageerle
      email: ageerle@163.com
      url: https://gitee.com/ageerle/ruoyi-ai
+
  #这里定义了两个分组，可定义多个，也可以不定义
  group-configs:
    - group: 1.演示模块
@@ -215,6 +216,8 @@ springdoc:
      packages-to-scan: org.ruoyi.generator
    - group: 5.工作流模块
      packages-to-scan: org.ruoyi.workflow
+    - group: 6.MCP模块
+      packages-to-scan: org.ruoyi.mcp

 # 防止XSS攻击
 xss:
@@ -242,12 +245,6 @@ management:
      show-details: ALWAYS
    logfile:
      external-file: ./logs/sys-console.log
-  health:
-    # ⚠️ 禁用 Neo4j 健康检查
-    # Spring Boot Actuator 会自动为 Neo4j 创建健康检查器
-    # 这会导致应用在启动时尝试连接到 Neo4j
-    neo4j:
-      enabled: false

 --- # 默认/推荐使用sse推送
 sse:
@@ -278,9 +275,9 @@ warm-flow:

 # 向量库配置
 vector-store:
-  # 向量存储类型 可选(weaviate/milvus)
+  # 向量存储类型 可选(weaviate/milvus/qdrant)
  # 如需修改向量库类型，请修改此配置值!
-  type: weaviate
+  type: milvus
  # Weaviate配置
  weaviate:
    protocol: http
@@ -290,69 +287,10 @@ vector-store:
  milvus:
    url: http://localhost:19530
    collectionname: LocalKnowledge
-
-chat:
-  memory:
-    enabled: true
-    maxMessages: 20
-    persistenceEnabled: true
-
-  #  企业微信应用
-wechat:
-  cp:
-    corpId:
-    appConfigs:
-      - agentId:
-        secret: ''
-        token:  ''
-        aesKey: ''
--- # 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
+  # Qdrant配置
+  qdrant:
+    host: localhost
+    port: 6334
+    collectionname: LocalKnowledge
+    api-key:
+    use-tls: false
--- a/ruoyi-common/ruoyi-common-chat/pom.xml
+++ b/ruoyi-common/ruoyi-common-chat/pom.xml
@@ -62,6 +62,12 @@
            <groupId>org.ruoyi</groupId>
            <artifactId>ruoyi-common-tenant</artifactId>
        </dependency>
+
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-annotations</artifactId>
+            <version>${swagger-annotations.version}</version>
+        </dependency>
    </dependencies>

 </project>
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/Service/IChatService.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/Service/IChatService.java
@@ -1,27 +0,0 @@
-package org.ruoyi.common.chat.Service;
-
-import dev.langchain4j.model.chat.response.StreamingChatResponseHandler;
-import org.ruoyi.common.chat.domain.dto.request.ChatRequest;
-import org.ruoyi.common.chat.domain.vo.chat.ChatModelVo;
-import org.springframework.web.servlet.mvc.method.annotation.SseEmitter;
-
-/**
- * 公共大模型对话接口
- */
-public interface IChatService {
-
-    /**
-     * 客户端发送对话消息到服务端
-     */
-    SseEmitter chat(ChatModelVo chatModelVo, ChatRequest chatRequest, SseEmitter emitter, Long userId, String tokenValue);
-
-    /**
-     * 工作流专用对话
-     */
-    SseEmitter chat(ChatModelVo chatModelVo, ChatRequest chatRequest,SseEmitter emitter,Long userId,String tokenValue, StreamingChatResponseHandler handler);
-
-    /**
-     * 获取服务提供商名称
-     */
-    String getProviderName();
-}
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/base/ThreadContext.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/base/ThreadContext.java
@@ -1,14 +1,14 @@
-package org.ruoyi.workflow.base;
+package org.ruoyi.common.chat.base;

 import cn.dev33.satoken.stp.StpUtil;
 import org.apache.commons.lang3.StringUtils;
+import org.ruoyi.common.chat.entity.User;
+import org.ruoyi.common.chat.enums.UserStatusEnum;
 import org.ruoyi.common.core.domain.model.LoginUser;
 import org.ruoyi.common.core.exception.base.BaseException;
 import org.ruoyi.common.satoken.utils.LoginHelper;
-import org.ruoyi.workflow.entity.User;
-import org.ruoyi.workflow.enums.UserStatusEnum;

-import static org.ruoyi.workflow.enums.ErrorEnum.A_USER_NOT_FOUND;
+import static org.ruoyi.common.chat.enums.ErrorEnum.A_USER_NOT_FOUND;

 /**
 * 线程上下文适配器，统一接入 Sa-Token 登录态。
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/bo/chat/ChatMessageBo.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/bo/chat/ChatMessageBo.java
@@ -1,13 +1,14 @@
-package org.ruoyi.domain.bo.chat;
+package org.ruoyi.common.chat.domain.bo.chat;

-import org.ruoyi.common.core.validate.AddGroup;
-import org.ruoyi.common.core.validate.EditGroup;
-import org.ruoyi.domain.entity.chat.ChatMessage;
-import org.ruoyi.common.mybatis.core.domain.BaseEntity;
 import io.github.linpeilie.annotations.AutoMapper;
+import jakarta.validation.constraints.NotNull;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import jakarta.validation.constraints.*;
+import org.ruoyi.common.chat.entity.chat.ChatMessage;
+import org.ruoyi.common.core.validate.AddGroup;
+import org.ruoyi.common.core.validate.EditGroup;
+import org.ruoyi.common.mybatis.core.domain.BaseEntity;
+

 /**
 * 聊天消息业务对象 chat_message
@@ -47,11 +48,6 @@ public class ChatMessageBo extends BaseEntity {
     */
    private String role;

-    /**
-     * 扣除金额
-     */
-    private Long deductCost;
-
    /**
     * 累计 Tokens
     */
@@ -62,11 +58,6 @@ public class ChatMessageBo extends BaseEntity {
     */
    private String modelName;

-    /**
-     * 计费类型（1-token计费，2-次数计费）
-     */
-    private String billingType;
-
    /**
     * 备注
     */
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/bo/chat/ChatModelBo.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/bo/chat/ChatModelBo.java
@@ -4,7 +4,7 @@ import io.github.linpeilie.annotations.AutoMapper;
 import jakarta.validation.constraints.NotNull;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import org.ruoyi.common.chat.domain.entity.chat.ChatModel;
+import org.ruoyi.common.chat.entity.chat.ChatModel;
 import org.ruoyi.common.core.validate.EditGroup;
 import org.ruoyi.common.mybatis.core.domain.BaseEntity;

@@ -45,30 +45,15 @@ public class ChatModelBo extends BaseEntity {
     */
    private String modelDescribe;

-    /**
-     * 模型价格
-     */
-    private Long modelPrice;
-
-    /**
-     * 计费类型
-     */
-    private String modelType;
-
    /**
     * 是否显示
     */
    private String modelShow;

    /**
-     * 是否免费
+     * 向量维度
     */
-    private String modelFree;
-
-    /**
-     * 模型优先级(值越大优先级越高)
-     */
-    private Long priority;
+    private Integer modelDimension;

    /**
     * 请求地址
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/ChatMessageDTO.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/ChatMessageDTO.java
@@ -1,45 +0,0 @@
-package org.ruoyi.common.chat.domain.dto;
-
-import lombok.Data;
-
-/**
- * 聊天消息DTO - 用于上下文传递
- *
- * @author ageerle@163.com
- * @date 2025/12/13
- */
-@Data
-public class ChatMessageDTO {
-
-    /**
-     * 消息角色: system/user/assistant
-     */
-    private String role;
-
-    /**
-     * 消息内容
-     */
-    private String content;
-
-    public static ChatMessageDTO system(String content) {
-        ChatMessageDTO msg = new ChatMessageDTO();
-        msg.role = "system";
-        msg.content = content;
-        return msg;
-    }
-
-    public static ChatMessageDTO user(String content) {
-        ChatMessageDTO msg = new ChatMessageDTO();
-        msg.role = "user";
-        msg.content = content;
-        return msg;
-    }
-
-    public static ChatMessageDTO assistant(String content) {
-        ChatMessageDTO msg = new ChatMessageDTO();
-        msg.role = "assistant";
-        msg.content = content;
-        return msg;
-    }
-}
-
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/ChatRequest.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/ChatRequest.java
@@ -1,11 +1,11 @@
 package org.ruoyi.common.chat.domain.dto.request;

-import dev.langchain4j.data.message.ChatMessage;
+import com.alibaba.fastjson.annotation.JSONField;
+import com.fasterxml.jackson.databind.annotation.JsonSerialize;
+import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
 import jakarta.validation.constraints.NotEmpty;
 import lombok.Data;
-import org.ruoyi.common.chat.domain.dto.ChatMessageDTO;

-import java.util.List;

 /**
 *  对话请求对象
@@ -16,54 +16,68 @@ import java.util.List;
@Data
 public class ChatRequest {

-    @NotEmpty(message = "对话消息不能为空")
-    private List<ChatMessageDTO> messages;
    @NotEmpty(message = "传入的模型不能为空")
    private String model;

    /**
-     * 会话id
+     * 对话消息
     */
-    private Long sessionId;
+    @NotEmpty(message = "对话消息不能为空")
+    private String content;

    /**
-     * 应用ID
+     * 工作流请求体
     */
-    private String appId;
+    private WorkFlowRunner workFlowRunner;
+
+    /**
+     * 人机交互信息体
+     */
+    private ReSumeRunner reSumeRunner;
+
+    /**
+     * 是否为人机交互用户继续输入
+     */
+    private Boolean isResume = false;
+
+    /**
+     * 是否启用工作流
+     */
+    private Boolean enableWorkFlow = false;
+
+    /**
+     * 会话id
+     */
+    @JsonSerialize(using = ToStringSerializer.class)
+    @JSONField(serializeUsing = String.class)
+    private Long sessionId;

    /**
     * 知识库id
     */
    private String knowledgeId;

+    /**
+     * 应用ID
+     */
+    private String appId;
+
+
    /**
     * 对话id(每个聊天窗口都不一样)
     */
+    @JsonSerialize(using = ToStringSerializer.class)
+    @JSONField(serializeUsing = String.class)
    private Long uuid;

    /**
     * 是否启用深度思考
     */
-    private Boolean enableThinking;
-
-    /**
-     * 是否自动切换模型
-     */
-    private Boolean autoSelectModel;
+    private Boolean enableThinking = false;

    /**
     * 是否支持联网
     */
    private Boolean enableInternet;

-    /**
-     * 会话令牌（为避免在非Web线程中获取Request，入口处注入）
-     */
-    private String token;
-
-    /**
-     * 原生对话对象
-     */
-    private List<ChatMessage> chatMessages;
-
 }
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/ReSumeRunner.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/ReSumeRunner.java
@@ -0,0 +1,19 @@
+package org.ruoyi.common.chat.domain.dto.request;
+
+import lombok.Data;
+
+/**
+ * 人机交互输入信息
+ */
+@Data
+public class ReSumeRunner {
+    /**
+     * 运行节点UUID
+     */
+    private String runtimeUuid;
+
+    /**
+     * 人机交互用户输入信息
+     */
+    private String feedbackContent;
+}
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/WorkFlowRunner.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/WorkFlowRunner.java
@@ -0,0 +1,15 @@
+package org.ruoyi.common.chat.domain.dto.request;
+
+import com.fasterxml.jackson.databind.node.ObjectNode;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 工作流请求体信息
+ */
+@Data
+public class WorkFlowRunner {
+    private List<ObjectNode> inputs;
+    private String uuid;
+}
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/vo/chat/ChatMessageVo.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/vo/chat/ChatMessageVo.java
@@ -1,18 +1,15 @@
-package org.ruoyi.domain.vo.chat;
+package org.ruoyi.common.chat.domain.vo.chat;

-import org.ruoyi.domain.entity.chat.ChatMessage;
 import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
 import cn.idev.excel.annotation.ExcelProperty;
-import org.ruoyi.common.excel.annotation.ExcelDictFormat;
-import org.ruoyi.common.excel.convert.ExcelDictConvert;
 import io.github.linpeilie.annotations.AutoMapper;
 import lombok.Data;
+import org.ruoyi.common.chat.entity.chat.ChatMessage;

 import java.io.Serial;
 import java.io.Serializable;


-
 /**
 * 聊天消息视图对象 chat_message
 *
@@ -57,12 +54,6 @@ public class ChatMessageVo implements Serializable {
    @ExcelProperty(value = "对话角色")
    private String role;

-    /**
-     * 扣除金额
-     */
-    @ExcelProperty(value = "扣除金额")
-    private Long deductCost;
-
    /**
     * 累计 Tokens
     */
@@ -75,12 +66,6 @@ public class ChatMessageVo implements Serializable {
    @ExcelProperty(value = "模型名称")
    private String modelName;

-    /**
-     * 计费类型（1-token计费，2-次数计费）
-     */
-    @ExcelProperty(value = "计费类型", converter = ExcelDictConvert.class)
-    @ExcelDictFormat(readConverterExp = "1=-token计费，2-次数计费")
-    private String billingType;

    /**
     * 备注
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/vo/chat/ChatModelVo.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/vo/chat/ChatModelVo.java
@@ -5,7 +5,7 @@ import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
 import cn.idev.excel.annotation.ExcelProperty;
 import io.github.linpeilie.annotations.AutoMapper;
 import lombok.Data;
-import org.ruoyi.common.chat.domain.entity.chat.ChatModel;
+import org.ruoyi.common.chat.entity.chat.ChatModel;

 import java.io.Serial;
 import java.io.Serializable;
@@ -54,17 +54,6 @@ public class ChatModelVo implements Serializable {
    @ExcelProperty(value = "模型描述")
    private String modelDescribe;

-    /**
-     * 模型价格
-     */
-    @ExcelProperty(value = "模型价格")
-    private Long modelPrice;
-
-    /**
-     * 计费类型
-     */
-    @ExcelProperty(value = "计费类型")
-    private String modelType;

    /**
     * 是否显示
@@ -73,16 +62,10 @@ public class ChatModelVo implements Serializable {
    private String modelShow;

    /**
-     * 是否免费
+     * 向量维度
     */
-    @ExcelProperty(value = "是否免费")
-    private String modelFree;
-
-    /**
-     * 模型优先级(值越大优先级越高)
-     */
-    @ExcelProperty(value = "模型优先级(值越大优先级越高)")
-    private Long priority;
+    @ExcelProperty(value = "向量维度")
+    private Integer modelDimension;

    /**
     * 请求地址
@@ -102,11 +85,5 @@ public class ChatModelVo implements Serializable {
    @ExcelProperty(value = "备注")
    private String remark;

-    /**
-     * 模型维度
-     */
-    private Integer dimension;
-
-
 }

--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/BaseEntity.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/BaseEntity.java
@@ -1,4 +1,4 @@
-package org.ruoyi.workflow.entity;
+package org.ruoyi.common.chat.entity;

 import com.baomidou.mybatisplus.annotation.IdType;
 import com.baomidou.mybatisplus.annotation.TableField;
@@ -6,12 +6,14 @@ import com.baomidou.mybatisplus.annotation.TableId;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;

+import java.io.Serial;
 import java.io.Serializable;
 import java.time.LocalDateTime;

@Data
 public class BaseEntity implements Serializable {

+    @Serial
    private static final long serialVersionUID = 1L;

    @TableId(type = IdType.AUTO)
--- a/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/User.java
+++ b/ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/User.java
@@ -1,11 +1,11 @@
-package org.ruoyi.workflow.entity;
+package org.ruoyi.common.chat.entity;

 import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableName;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import org.ruoyi.workflow.enums.UserStatusEnum;
+import org.ruoyi.common.chat.enums.UserStatusEnum;

 import java.time.LocalDateTime;

--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
ageerle	3071bfd0f9	Merge pull request #282 from Anush008/main docs: Docker Compose setup for Qdrant	2026-03-28 20:33:25 +08:00
Anush008	7bb938c145	docs: Docker Compose setup for Qdrant	2026-03-28 13:37:53 +05:30
ageerle	75b21d3633	Merge pull request #281 from Anush008/main feat: Adds support for Qdrant vector search	2026-03-27 21:51:03 +08:00
Anush008	7ed9d8def4	chore: Rename METADATA_DOC_ID_KEY	2026-03-27 18:36:30 +05:30
Anush008	63ed7ddb02	feat: Adds support for Qdrant vector search	2026-03-27 18:31:05 +05:30
ageerle	11696a016d	fix: 修复文件类型匹配和知识库切割配置问题 1. 修复 ResourceLoaderFactory 文件扩展名匹配问题 - 去除扩展名前导点，确保 .pdf 能正确匹配 PDF 解析器 - 修复 PDF/Word/Excel 等文件走错解析逻辑的问题 2. 优化文本切割器动态配置 - CharacterTextSplitter 和 ExcelTextSplitter 支持从知识库读取配置 - 根据 kid 查询 separator、textBlockSize、overlapChar - 查询失败时降级使用默认配置 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-25 18:51:01 +08:00
ageerle	1a10104751	docs: 更新README文档，同步中英文版本 - 移除优秀开源项目推荐章节 - 英文版添加Docker部署完整文档 - 英文版添加技术架构详细描述 - 英文版添加RAG排查手册链接 - 统一核心功能表格格式 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-21 13:02:46 +08:00
ageerle	f95cb17933	chore: 删除ruoyi-modules-api模块 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-21 12:31:09 +08:00
ageerle	0687b49542	Merge branch 'v3.0.0' into main 合并 v3.0.0 分支到 main，包含以下主要更新： - 重构聊天模块架构，引入Handler模式 - 添加 Docker 部署支持 - 恢复 MCP 模块功能 - 工作流与大模型聊天对话整合 - 多项 bug 修复和文档更新 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-21 12:15:40 +08:00
ageerle	27ad00ac3a	refactor: 抽离特殊聊天模式处理逻辑 - 将工作流、人机交互恢复、思考模式处理逻辑抽离为独立方法 - 新增 handleSpecialChatModes 方法统一处理特殊模式 - 新增 handleThinkingMode 方法专门处理思考模式 - 简化 sseChat 方法结构，提高代码可读性 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-20 10:38:54 +08:00
ageerle	c84d6247b0	refactor: 重构聊天模块架构 - 删除废弃的ChatMessageDTO、ChatContext、AbstractChatMessageService等类 - 迁移ChatServiceFactory和IChatMessageService到ruoyi-chat模块 - 重构ChatHandler体系，移除DefaultChatHandler和ChatContextBuilder - 优化SSE消息处理，新增SseEventDto - 简化各AI服务提供商实现类代码 - 优化工作流节点消息处理逻辑 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-20 01:20:41 +08:00
ageerle	f582f38570	docs: 整理Docker配置文件并更新文档 - 将Docker相关配置文件移动到docs/docker/ruoyi-ai/目录 - 更新README.md核心亮点表格格式 - 新增流程编排模块详细说明文档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-19 15:22:47 +08:00
ageerle	13800dc389	Merge pull request #277 from XiaoEns/v3.0.0 fix: 修复知识库附件上传乱码问题	2026-03-17 22:07:32 +08:00
xiaoen	619d9b1e84	fix: 兼容旧代码，添加deepseek服务调用	2026-03-17 21:30:56 +08:00
xiaoen	556cc93f14	fix: 修复知识库附件上传乱码问题	2026-03-17 18:57:30 +08:00
ageerle	a50375616e	Merge pull request #276 from LM20230311/v3.0.0 V3.0.0	2026-03-17 14:09:52 +08:00
LM20230311	e33447d023	Merge branch 'v3.0.0' of https://github.com/ageerle/ruoyi-ai into v3.0.0	2026-03-17 13:48:21 +08:00
LM20230311	7be277b3e6	Merge branch 'v3.0.0-deploy' into v3.0.0	2026-03-17 13:47:27 +08:00
LM20230311	5fa385e90b	docs: add Docker deployment instructions and service port mappings to README; update sys_client table in MySQL script	2026-03-17 11:09:13 +08:00
LM20230311	0a78966737	chore: update UPSTREAM_HOST configuration in docker-compose-all.yaml to remove http:// prefix	2026-03-17 10:38:43 +08:00
LM20230311	0eb7f00867	chore: add environment variables for backend API configuration in docker-compose-all.yaml	2026-03-16 17:14:01 +08:00
LM20230311	00ce7f2d98	chore: update port mappings in docker-compose.yaml for MySQL, Weaviate, and backend services	2026-03-16 15:32:27 +08:00
ageerle	003c066361	chore(sql): 更新数据库脚本，移除chat_config表 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-15 23:57:55 +08:00
ageerle	a5e7c59fd4	refactor: 重构项目架构，优化向量服务 - 移除 Graph 知识图谱相关模块（Neo4j、GraphRAG等） - 移除 demo、job、wechat 示例模块，简化项目结构 - 修复向量维度获取方式，改为从数据库配置读取 - 添加 gRPC BOM 依赖管理，解决 Milvus SDK 版本冲突 - 新增 PPIO 服务和 Embedding 提供者支持 - 清理冗余代码和未使用的依赖 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-15 23:39:30 +08:00
ageerle	accac603cf	chore(sql): 更新数据库脚本v3版本 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-14 14:16:45 +08:00
ageerle	7c96c730e6	refactor(chat): 重构聊天服务架构，引入Handler模式主要变更: 1. 移除ruoyi-ai-copilot模块 2. 重构docker配置目录结构，统一迁移至docs/docker/ 3. 聊天服务引入Handler模式: - 新增ChatHandler接口及多种实现 - DefaultChatHandler: 默认聊天处理 - AgentChatHandler: Agent模式处理 - WorkflowChatHandler: 工作流处理 - ResumeChatHandler: 恢复会话处理 - ChatContextBuilder: 上下文构建器 4. 简化AbstractStreamingChatService和ChatServiceFacade代码 5. 优化各Provider实现，统一代码风格 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-14 14:14:56 +08:00
LM20230311	a2dbdb30ff	fix: remove unnecessary COPY command for ruoyi-modules-api in Dockerfile.backend	2026-03-11 09:57:47 +08:00
LM20230311	772e4af9bf	Merge remote-tracking branch 'upstream/v3.0.0' into v3.0.0-deploy	2026-03-11 09:35:48 +08:00
ageerle	e601eb6db5	feat(wechat): 修复微信公众号无法登录	2026-03-09 10:27:53 +08:00
evo	84dbc2cfbf	feat：恢复mcp模块动态agent	2026-03-08 22:41:24 +08:00
evo	f160ec714b	feat-恢复mcp模块	2026-03-07 15:53:06 +08:00
ageerle	a8bd4b47a0	chore: 移除项目文档和技术交流链接 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:44:07 +08:00
ageerle	6c4c661516	chore: 移除项目文档和技术交流链接 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:43:54 +08:00
ageerle	b85c17a126	refactor: 重构Issue模板为通用格式 - 删除企业合作登记模板 - 新增漏洞报告模板 - 新增想法建议模板 - 新增自定义模板 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:39:19 +08:00
ageerle	a59ddf6070	refactor: 重构Issue模板为通用格式 - 删除企业合作登记模板 - 新增漏洞报告模板 - 新增想法建议模板 - 新增自定义模板 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:39:06 +08:00
ageerle	797ecbb054	feat: 新增联系人/联系方式字段并添加填写示例 - 新增联系人/联系方式字段，支持登记后主动联系 - 在可复制模板中添加完整填写示例 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:30:15 +08:00
ageerle	b6b78afea9	refactor: 优化企业合作登记模板格式 - 改为评论登记模式，用户在Issue下评论填写 - 提供格式预览和可复制模板 - 新增公司Logo和项目Logo字段 - 移除联系方式模块，保护隐私 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:20:31 +08:00
ageerle	0690156362	refactor: 优化企业合作登记模板格式 - 改为评论登记模式，用户在Issue下评论填写 - 提供格式预览和可复制模板 - 新增公司Logo和项目Logo字段 - 移除联系方式模块，保护隐私 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:19:27 +08:00
ageerle	02240f3fd0	feat: 添加企业AI应用合作登记Issue模板 - 新增企业合作登记模板，用于收集企业AI应用需求 - 包含基本信息、AI应用需求、联系方式三个模块 - 预设筛选字段便于评估合作匹配度 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 11:07:25 +08:00
ageerle	dc1e84bc52	feat: 添加企业AI应用合作登记Issue模板 - 新增企业合作登记模板，用于收集企业AI应用需求 - 包含基本信息、AI应用需求、联系方式三个模块 - 预设筛选字段便于评估合作匹配度 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-03-06 10:57:53 +08:00
ageerle	4977df0ba8	feat: 更新项目文档	2026-03-06 10:27:45 +08:00
ageerle	27211b67f9	feat: 更新项目文档	2026-03-06 10:20:15 +08:00
LM20230311	1600ab384e	feat: 支持手动挂载数据卷；	2026-03-05 09:35:27 +08:00
LM20230311	418805a1ef	feat: 源码docker部署完成；	2026-03-05 09:27:34 +08:00
LM20230311	4c4b52bca7	feat: 忽略data目录；	2026-03-05 09:07:10 +08:00
LM20230311	7245259bc4	fix: 忽略所有错误以确保SQL脚本继续执行	2026-03-04 17:57:08 +08:00
LM20230311	6690c8204c	fix: 修复表数量异常问题；	2026-03-04 17:56:20 +08:00
LM20230311	d8fc597f85	fix: 解决mysql容器长时间建表导致失败问题；	2026-03-04 17:34:38 +08:00
evo	7f1146ecae	Merge pull request #272 from MuSan-Li/v3.0.0 fix: 还原 McpAgent 为通用工具调用版本	2026-03-04 16:37:28 +08:00
evo	0130028952	fix: 还原 McpAgent 为通用工具调用版本	2026-03-04 16:34:56 +08:00
LM20230311	5a716da5a6	feat: 添加docker部署文件；	2026-03-04 16:31:54 +08:00
evo	2470ec7573	Merge pull request #271 from MuSan-Li/feature-20260218-add-mcp-model 增加McpAgent空格	2026-03-04 14:36:32 +08:00
evo	e3fb25fba6	增加McpAgent空格	2026-03-04 14:32:41 +08:00
ageerle	a916f14efc	Merge pull request #268 from onestardao/main docs: add structured RAG 16-problem troubleshooting guide and README entry	2026-03-03 10:40:32 +08:00
PSBigBig × MiniPS	523628ade6	docs: add structured RAG 16-problem troubleshooting guide and README entry	2026-03-02 19:01:59 +08:00
PSBigBig × MiniPS	2259a2f717	docs: add structured RAG 16-problem troubleshooting guide and README entry This commit introduces a structured RAG troubleshooting guide based on a fixed 16-problem failure map. Changes include: 1. Added a dedicated RAG troubleshooting document: - docs/troubleshooting/rag-failures.md - Includes full 16-problem map (No.1–No.16) with layer tags [IN]/[RE]/[ST]/[OP] - Adds symptom-based entry points - Adds layer-based diagnostics section - Adds issue reporting template referencing No.X labels 2. Updated README.md: - Added entry link under the "使用文档" section - Direct link to the new RAG troubleshooting guide - Keeps README structure and tone consistent No functional changes. Documentation only.	2026-03-02 18:51:36 +08:00
PSBigBig × MiniPS	8df37274da	docs: add RAG answer troubleshooting guide	2026-03-02 17:44:59 +08:00
PSBigBig × MiniPS	393057ab24	docs: add RAG answer troubleshooting guide	2026-03-02 17:41:47 +08:00
ageerle	2aa7e0f4f1	Merge pull request #267 from StevenJack666/v3.0.0 V3.0.0	2026-03-02 09:10:12 +08:00
steve	b2d2fb34b8	Merge branch 'ageerle:v3.0.0' into v3.0.0	2026-03-01 11:37:10 +08:00
zhang	c1e2a03178	解决冲突	2026-03-01 11:29:58 +08:00
zhang	fd38d2030e	修改异常节点	2026-02-28 11:53:36 +08:00
zhang	a42f881b67	Merge branch 'vFuture3.0.0' into v3.0.0	2026-02-27 17:35:42 +08:00
zengxb	20d531c0db	context:新增工作流节点提供模板消息输出以及智谱大模型Chat对话接入	2026-02-27 14:53:07 +08:00
ageerle	1e6046cf52	feat: 移除数字人模块	2026-02-27 14:00:57 +08:00
zhang	495f2de6ef	Merge remote-tracking branch 'origin/v3.0.0' into v3.0.0	2026-02-27 10:30:33 +08:00
zhang	e97bd4e201	去掉分号	2026-02-27 10:14:53 +08:00
zhang	70e5e393ef	Merge branch 'work_flow_v3.0' into v3.0.0 # Conflicts: # ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/chat/impl/ChatServiceFacade.java	2026-02-26 14:48:19 +08:00
zengxb	8954f59cd7	context:工作流和Ai Chat对话消息功能整合	2026-02-26 14:36:33 +08:00
ageerle	c78b1a14a9	feat: 增加ppio厂商支持	2026-02-25 21:20:22 +08:00
ageerle	e768c4b356	feat: 调整默认sql脚本	2026-02-24 22:46:47 +08:00
zhang	d059f50ba6	配置信息修改	2026-02-24 16:09:37 +08:00
zhang	26bcfbba8a	修改数据库读取工具	2026-02-24 16:07:18 +08:00
zengxb	d6e4a50d6e	context:根据模型分类找到实现类修改为由模型供应商找到实现类（保持工作流和对话流程一致）	2026-02-24 10:58:11 +08:00
zengxb	0a115f289e	context:通义万相文生图节点功能以及发送邮箱和HTTP请求节点调研	2026-02-24 10:34:26 +08:00
ageerle	31e8df8bc0	Merge pull request #262 from MuSan-Li/feature-20260218-add-mcp-model add mcp model	2026-02-23 22:57:44 +08:00
evo	ee477213e0	优化mcp模块功能	2026-02-23 18:21:31 +08:00
evo	1e6e236d3c	优化导出报错提示	2026-02-23 16:07:38 +08:00
evo	593a0d0049	增加mcp工具模块	2026-02-23 16:07:13 +08:00
ageerle	d4f8f91893	Merge pull request #259 from StevenJack666/v3.0.0 chat对话接口如参改为ChatContext，方便后续扩展	2026-02-15 15:54:21 +08:00
zhang	f25ebdf9ec	去掉多余字符	2026-02-14 22:07:09 +08:00
zhang	32b8144b56	Merge branch 'work_flow_v3.0' into v3.0.0 # Conflicts: # ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/Service/IChatService.java # ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/WorkflowUtil.java # ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/chat/impl/AbstractStreamingChatService.java # ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/chat/impl/ChatServiceFacade.java # ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/chat/impl/provider/QianWenChatServiceImpl.java	2026-02-14 21:14:50 +08:00
zengxb	b40805cb57	context:公共聊天接口调整为对话上下文对象传输	2026-02-14 10:55:53 +08:00
steve	008f64617f	Merge pull request #4 from StevenJack666/feature-v3.0.0 Feature v3.0.0	2026-02-14 10:49:52 +08:00
zhang	3539e222d2	init	2026-02-14 10:48:43 +08:00
zhang	c4d1ea974d	init	2026-02-14 10:48:33 +08:00
ageerle	ace7e961a4	Merge pull request #258 from StevenJack666/v3.0.0 修改千问模型调用逻辑	2026-02-14 10:47:14 +08:00
ageerle	1d1b72c6e2	Merge pull request #257 from StevenJack666/v3.0.0 V3.0.0	2026-02-13 19:02:16 +08:00
zengxb	420e05ecf3	context:工作流与大模型聊天对话整合（新增Common-Chat公共对话接口）	2026-02-13 17:56:55 +08:00
ageerle	ee8c882b6f	Merge pull request #256 from StevenJack666/main 修改AI工作流后端逻辑	2026-02-11 17:03:31 +08:00
zhang	69ec2a33a4	init	2026-02-09 17:47:18 +08:00
zhang	1cd8ae1cd9	人机交互节点逻辑修改	2026-02-09 17:43:29 +08:00
				`@@ -1 +0,0 @@`
				数据目录请执行 `chmod 777 /docker/redis/data` 赋予读写权限否则将无法写入数据