feat: 新增 ChitChatAgent 闲聊兜底子 Agent 并接入 supervisor

简单任务无专业子 Agent 可用时由闲聊 Agent 兜底，避免 supervisor 空转返回空内容；通过 supervisorContext 约束仅在问候/闲聊场景路由到该 Agent。

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

.gitignore

@@ -45,6 +45,7 @@ nbdist/
 *.xml.versionsBackup
 *.swp
 data/
+logs/
 
 !*/build/*.java
 !*/build/*.html

README.md

@@ -21,30 +21,22 @@
 
 *开箱即用的全栈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)**
+**[English](README_EN.md)** | **[📖 使用文档](https://doc.ruoyiai.chat/)** |
+**[🚀 在线体验](https://web.ruoyiai.chat/)** | **[🐛 问题反馈](https://github.com/ageerle/ruoyi-ai/issues)** | **[💡 功能建议](https://github.com/ageerle/ruoyi-ai/issues)**
 
 </div>
 
 
 ## ✨ 核心亮点
 
-|     模块     | 现有能力 
-|:----------:|---
-|  **模型管理**  | 多模型接入(OpenAI/DeepSeek/通义/智谱)、多模态理解、Coze/DIFY/FastGPT平台集成 
-|  **知识管理**  | 本地RAG + 向量库(Milvus/Weaviate/Qdrant)  + 文档解析        
-|  **工具管理**  | Mcp协议集成、Skills能力 + 可扩展工具生态                             
-|  **流程编排**  | 可视化工作流设计器、节点拖拽编排、SSE流式执行,目前已经支持模型调用,邮件发送,人工审核等节点  
-|  **多智能体**  | 基于Langchain4j的Agent框架、Supervisor模式编排,支持多种决策模型          
+|    模块     | 现有能力 
+|:---------:|---
+| **模型管理**  | 多模型接入(DeepSeek/智谱/MIMO/百炼/OpenAI)、多模态理解、Coze/DIFY/FastGPT/RAGFlow平台集成
+| **知识管理**  | 本地RAG + 向量库(Milvus/Weaviate/Qdrant)  + 文档解析
+| **工具管理**  | Mcp协议集成、Skills能力 + 可扩展工具生态                             
+| **流程编排**  | 可视化工作流设计器、节点拖拽编排、SSE流式执行,目前已经支持模型调用,邮件发送,人工审核等节点  
+| **智能体管理** | 基于Langchain4j的Agent框架、Supervisor模式编排,支持多种决策模型,可以灵活搭配工具,skills          
 
-## 🚀 快速体验
-
-### 在线演示
-
-|   平台   | 地址 | 账号 |
-|:------:|---|---|
-|  用户端   | [web.pandarobot.chat](https://web.pandarobot.chat) | admin / admin123 |
-| 管理后台 | [admin.pandarobot.chat](https://admin.pandarobot.chat) | admin / admin123 |
 
 ### 项目源码
 
@@ -53,6 +45,9 @@
 | 🔧 后端服务  | [ruoyi-ai](https://github.com/ageerle/ruoyi-ai)       | [ruoyi-ai](https://gitee.com/ageerle/ruoyi-ai)       | [ruoyi-ai](https://gitcode.com/ageerle/ruoyi-ai)       |
 | 🎨 用户前端  | [ruoyi-web](https://github.com/ageerle/ruoyi-web)     | [ruoyi-web](https://gitee.com/ageerle/ruoyi-web)     | [ruoyi-web](https://gitcode.com/ageerle/ruoyi-web)     |
 | 🛠️ 管理后台 | [ruoyi-admin](https://github.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitee.com/ageerle/ruoyi-admin) | [ruoyi-admin](https://gitcode.com/ageerle/ruoyi-admin) |
+| 🎬 短剧平台  | [ruoyi-drama](https://github.com/ageerle/ruoyi-drama) | [ruoyi-drama](https://gitee.com/ageerle/ruoyi-drama) | [ruoyi-drama](https://gitcode.com/ageerle/ruoyi-drama)   |
+| 🤖 编程助手  | [ruoyi-copilot](https://github.com/ageerle/ruoyi-copilot) | [ruoyi-copilot](https://gitee.com/ageerle/ruoyi-copilot) | [ruoyi-copilot](https://gitcode.com/ageerle/ruoyi-copilot) |
+| 📱 小程序端  | [ruoyi-uniapp](https://github.com/ageerle/ruoyi-uniapp) | [ruoyi-uniapp](https://gitee.com/ageerle/ruoyi-uniapp) | [ruoyi-uniapp](https://gitcode.com/ageerle/ruoyi-uniapp) |
 
 ### 合作项目
 | 项目名称           | GitHub 仓库                                             | Gitee 仓库                                             
@@ -66,8 +61,6 @@
 - **数据存储**：MySQL 8.0 + Redis + 向量数据库（Milvus/Weaviate/Qdrant）
 - **前端技术**：Vue 3 + Vben Admin + element-plus-x
 - **安全认证**：Sa-Token + JWT 双重保障
-
-
 - **文档处理**：PDF、Word、Excel 解析，图像智能分析
 - **实时通信**：WebSocket 实时通信，SSE 流式响应
 - **系统监控**：完善的日志体系、性能监控、服务健康检查
@@ -187,7 +180,7 @@ docker-compose -f docker-compose-all.yaml restart [服务名]
 
 想要深入了解安装部署、功能配置和二次开发？
 
-**👉 [完整使用文档](https://doc.pandarobot.chat)**
+**👉 [完整使用文档](https://doc.ruoyiai.chat/)**
 
 ## 🤝 参与贡献
 
@@ -210,17 +203,29 @@ docker-compose -f docker-compose-all.yaml restart [服务名]
 ## 🙏 特别鸣谢
 
 感谢以下优秀的开源项目为本项目提供支持：
-- [Spring AI Alibaba Copilot](https://github.com/spring-ai-alibaba/copilot) - 基于spring-ai-alibaba
-  的智能编码助手
 - [Langchain4j](https://github.com/langchain4j/langchain4j) - 强大的 Java LLM 开发框架
 - [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus) - 成熟的企业级快速开发框架
 - [Vben Admin](https://github.com/vbenjs/vue-vben-admin) - 现代化的 Vue 后台管理模板
 
-## 🌐 生态伙伴
 
-- [PPIO 派欧云](https://ppinfra.com/user/register?invited_by=P8QTUY&utm_source=github_ruoyi-ai) - 提供高性价比的 GPU
-  算力和模型 API 服务
-- [优云智算](https://www.compshare.cn/?ytag=GPU_YY-gh_ruoyi) - 万卡RTX40系GPU+海内外主流模型API服务，秒级响应，按量计费，新客免费用。
+## 💎 赞助商
+
+**感谢以下赞助商对本项目的支持：**
+
+<a href="https://www.atlascloud.ai?ref=89F97E">
+  <img src="docs/image/sponsor/atlascloud_banner.png" alt="Atlas Cloud" width="160" height="80">
+</a>
+
+[访问Atlas Cloud官网](https://www.atlascloud.ai?ref=89F97E&utm_source=github&utm_campaign=ruoyi-drama) · [编程计划优惠](https://www.atlascloud.ai/console/coding-plan)
+全模态 AI 推理平台，为开发者提供统一的 AI API，支持视频生成、图像生成和大语言模型。一次接入，即可访问 **300+ 精选模型**。
+
+<a href="https://www.volcengine.com/activity/codingplan?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=ageerle-ruoyi-ai">
+  <img src="docs/image/sponsor/huoshan.png" alt="火山引擎 CodingPlan" width="160" height="80">
+</a>
+
+[注册即领2500万Tokens，立即前往](https://www.volcengine.com/activity/ai618?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=ageerle-ruoyi-ai)
+享字节自研豆包模型+满血版开源 SOTA模型，覆盖文本、VLM、图像生成，全模态一站配齐：Seed-2.1、Seedream-5.0、GLM-5.2、DeepSeek等。不止编程、更能解决 Agent 复杂长程任务！
+
 
 ## 💬 社区交流
 
@@ -234,6 +239,11 @@ docker-compose -f docker-compose-all.yaml restart [服务名]
 <em>邀请进群学习</em>
 </td>
 <td align="center">
+<img src="docs/image/wx06.png" alt="微信二维码" width="200" height="200"><br>
+<strong>微信技术交流群</strong><br>
+<em>技术讨论</em>
+</td>
+<td align="center">
 <img src="docs/image/qq.png" alt="QQ群二维码" width="200" height="200"><br>
 <strong>QQ技术交流群</strong><br>
 <em>技术讨论</em>
@@ -247,7 +257,7 @@ docker-compose -f docker-compose-all.yaml restart [服务名]
 ---
 <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)**
+**[⭐ 点个Star支持一下](https://github.com/ageerle/ruoyi-ai)** • **[ Fork 开始贡献](https://github.com/ageerle/ruoyi-ai/fork)** • **[📚 English](README_EN.md)** • **[📖 查看完整文档](https://doc.ruoyiai.chat/)**
 
 *用 ❤️ 打造，由 RuoYi AI 开源社区维护*
 

README_EN.md

@@ -22,8 +22,8 @@
 
 *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)**
+**[中文](README.md)** | **[📖 Documentation](https://doc.ruoyiai.chat/)** |
+**[🚀 Live Demo](https://web.ruoyiai.chat/)** | **[🐛 Report Issues](https://github.com/ageerle/ruoyi-ai/issues)** | **[💡 Feature Requests](https://github.com/ageerle/ruoyi-ai/issues)**
 
 </div>
 
@@ -34,21 +34,12 @@
 
 | Module | Current Capabilities |
 |:---:|---|
-| **Model Management** | Multi-model integration (OpenAI/DeepSeek/Tongyi/Zhipu), multi-modal understanding, Coze/DIFY/FastGPT platform integration |
+| **Model Management** | Multi-model integration (OpenAI/DeepSeek/Tongyi/Zhipu/MiniMax), 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
-
-|   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                                             |
@@ -56,6 +47,9 @@
 | 🔧 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) |
+| 🎬 Drama | [ruoyi-drama](https://github.com/ageerle/ruoyi-drama) | [ruoyi-drama](https://gitee.com/ageerle/ruoyi-drama) | |
+| 🤖 Copilot | [ruoyi-copilot](https://github.com/ageerle/ruoyi-copilot) | [ruoyi-copilot](https://gitee.com/ageerle/ruoyi-copilot) | [ruoyi-copilot](https://gitcode.com/ageerle/ruoyi-copilot) |
+| 📱 Mini-App | [ruoyi-uniapp](https://github.com/ageerle/ruoyi-uniapp) | [ruoyi-uniapp](https://gitee.com/ageerle/ruoyi-uniapp) | [ruoyi-uniapp](https://gitcode.com/ageerle/ruoyi-uniapp) |
 
 ### Partner Projects
 | Project Name           | GitHub Repository                                             | Gitee Repository |
@@ -69,8 +63,6 @@
 - **Data Storage**: MySQL 8.0 + Redis + Vector Databases (Milvus/Weaviate/Qdrant)
 - **Frontend**: Vue 3 + Vben Admin + element-plus-x
 - **Security**: Sa-Token + JWT dual-layer security
-
-
 - **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
@@ -186,11 +178,39 @@ docker-compose -f docker-compose-all.yaml logs -f [service-name]
 docker-compose -f docker-compose-all.yaml restart [service-name]
 ```
 
+### MiniMax Configuration
+
+The built-in MiniMax provider accepts one API Host value and selects the matching protocol adapter. Use a Base URL from this table:
+
+| Region | OpenAI-compatible Base URL | Anthropic-compatible Base URL |
+| --- | --- | --- |
+| Global | `https://api.minimax.io/v1` | `https://api.minimax.io/anthropic` |
+| China | `https://api.minimaxi.com/v1` | `https://api.minimaxi.com/anthropic` |
+
+For Anthropic-compatible requests, configure the Base URL ending in `/anthropic`. Do not append `/v1` or `/v1/messages`; the provider adapter derives the request path internally.
+
+| Model ID | Total context | Input modalities | Thinking |
+| --- | ---: | --- | --- |
+| `MiniMax-M3` | 1,000,000 tokens | Text, image, video | Adaptive or disabled |
+| `MiniMax-M2.7` | 204,800 tokens | Text | Always on |
+
+Current pay-as-you-go prices are in USD per million tokens:
+
+| Model | Service tier and input range | Input | Output | Cache read | Cache write |
+| --- | --- | ---: | ---: | ---: | ---: |
+| `MiniMax-M3` | Standard, up to 512,000 input tokens | $0.30 | $1.20 | $0.06 | Not listed |
+| `MiniMax-M3` | Standard, over 512,000 input tokens | $0.60 | $2.40 | $0.12 | Not listed |
+| `MiniMax-M3` | Priority, up to 512,000 input tokens | $0.45 | $1.80 | $0.09 | Not listed |
+| `MiniMax-M3` | Priority, over 512,000 input tokens | $0.90 | $3.60 | $0.18 | Not listed |
+| `MiniMax-M2.7` | Standard | $0.30 | $1.20 | $0.06 | $0.375 |
+
+See the [official API overview](https://platform.minimax.io/docs/api-reference/api-overview) and [pay-as-you-go pricing](https://platform.minimax.io/docs/guides/pricing-paygo) for current details.
+
 ## 📚 Documentation
 
 Want to learn more about installation, deployment, configuration, and secondary development?
 
-**👉 [Complete Documentation](https://doc.pandarobot.chat)**
+**👉 [Complete Documentation](https://doc.ruoyiai.chat/)**
 
 ## 🤝 Contributing
 
@@ -213,23 +233,47 @@ This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) f
 ## 🙏 Acknowledgments
 
 Thanks to the following excellent open-source projects for their support:
-- [Spring AI Alibaba Copilot](https://github.com/spring-ai-alibaba/copilot) - Intelligent coding assistant based on spring-ai-alibaba
 - [Langchain4j](https://github.com/langchain4j/langchain4j) - Powerful Java LLM development framework
 - [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus) - Mature enterprise-level rapid development framework
 - [Vben Admin](https://github.com/vbenjs/vue-vben-admin) - Modern Vue admin template
 
-## 🌐 Ecosystem Partners
+## 💎 Sponsors
 
-- [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.
+**Thanks to the following sponsors for supporting this project:**
 
+<a href="https://www.atlascloud.ai?ref=89F97E">
+  <img src="docs/image/sponsor/atlascloud_banner.png" alt="Atlas Cloud" width="160" height="80">
+</a>
+
+[Visit Atlas Cloud](https://www.atlascloud.ai?ref=89F97E) · [Coding Plan Promotion](https://www.atlascloud.ai/console/coding-plan)
+A full-modal AI inference platform that gives developers a unified AI API, supporting video generation, image generation, and LLMs. Connect once to access **300+ curated models**.
+
+<a href="https://www.volcengine.com/activity/codingplan?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=ageerle-ruoyi-ai">
+  <img src="docs/image/sponsor/huoshan.png" alt="Volcengine CodingPlan" width="160" height="80">
+</a>
+
+[Volcengine CodingPlan Developer Program](https://www.volcengine.com/activity/codingplan?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=ageerle-ruoyi-ai)
+Volcengine is ByteDance's cloud and AI service platform. Volcengine Ark provides API access to Doubao LLM, DeepSeek, and more — a one-stop AI development and inference platform for developers.
 
 ## 💬 Community Chat
 
 <div align="center">
 
-**[📱 Join Telegram Group](
-https://t.me/+LqooQAc5HxRmYmE1)**
+<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 on WeChat</strong><br>
+<em>Join group for learning</em>
+</td>
+<td align="center">
+<img src="docs/image/qq.png" alt="QQ Group QR Code" width="200" height="200"><br>
+<strong>QQ Tech Exchange Group</strong><br>
+<em>Technical discussion</em>
+</td>
+
+</tr>
+</table>
 
 </div>
 
@@ -237,7 +281,7 @@ https://t.me/+LqooQAc5HxRmYmE1)**
 
 <div align="center">
 
-**[⭐ Star to Support](https://github.com/ageerle/ruoyi-ai)** • **[Fork to Contribute](https://github.com/ageerle/ruoyi-ai/fork)** • **[📚 中文](README.md)** • **[📖 Complete Documentation](https://doc.pandarobot.chat)**
+**[⭐ Star to Support](https://github.com/ageerle/ruoyi-ai)** • **[Fork to Contribute](https://github.com/ageerle/ruoyi-ai/fork)** • **[📚 中文](README.md)** • **[📖 Complete Documentation](https://doc.ruoyiai.chat/)**
 
 *Built with ❤️, maintained by the RuoYi AI open-source community*
 

docs/docker/ruoyi-ai/Dockerfile.backend

@@ -20,6 +20,22 @@ RUN mvn clean package -Pprod -DskipTests
 # 最终运行镜像
 FROM eclipse-temurin:17-jre-alpine
 
+RUN set -eux; \
+    apk add --no-cache ffmpeg; \
+    for filter in scale pad fps setsar format tpad trim settb setpts xfade \
+        aresample aformat apad atrim asetpts anullsrc concat acrossfade; do \
+        ffmpeg -hide_banner -filters 2>/dev/null | grep -Eq "[[:space:]]${filter}[[:space:]]"; \
+    done; \
+    ffmpeg -hide_banner -h filter=xfade 2>&1 | grep -q dissolve; \
+    ffmpeg -hide_banner -h filter=xfade 2>&1 | grep -q fadeblack; \
+    ffmpeg -hide_banner -h filter=xfade 2>&1 | grep -q slideleft; \
+    ffmpeg -hide_banner -encoders 2>/dev/null | grep -Eq '[[:space:]]libx264[[:space:]]'; \
+    ffmpeg -hide_banner -encoders 2>/dev/null | grep -Eq '[[:space:]]aac[[:space:]]'; \
+    ffprobe -hide_banner -version >/dev/null
+
+ENV FFMPEG_PATH=/usr/bin/ffmpeg \
+    FFPROBE_PATH=/usr/bin/ffprobe
+
 # 设置工作目录
 WORKDIR /app
 
@@ -27,10 +43,10 @@ WORKDIR /app
 COPY --from=builder /build/ruoyi-admin/target/ruoyi-admin.jar ./ruoyi-admin.jar
 
 # 创建日志目录
-RUN mkdir -p /ruoyi/server/logs
+RUN mkdir -p /ruoyi/server/logs /ruoyi/server/temp
 
 # 暴露端口
 EXPOSE 6039
 
 # 启动命令
-ENTRYPOINT ["java", "-jar", "ruoyi-admin.jar", "--spring.profiles.active=prod"]
+ENTRYPOINT ["java", "-Djava.io.tmpdir=/ruoyi/server/temp", "-jar", "ruoyi-admin.jar", "--spring.profiles.active=prod"]

docs/docker/ruoyi-ai/Dockerfile.mysql

@@ -1,16 +1,14 @@
 # 基于官方MySQL 8.0镜像构建自定义镜像
 # 构建命令: docker build -t registry.cn-hangzhou.aliyuncs.com/ruoyi-ai/mysql:v3 -f Dockerfile.mysql .
-FROM mysql:8.0.33
+FROM mysql:8.0
 
 # 设置时区
 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 官方入口会按文件名顺序执行初始化目录中的 SQL。
+# ruoyi-ai.sql 会导入 MYSQL_DATABASE，snail_job_mysql.sql 会自行创建并切换数据库。
+COPY docs/script/sql/ruoyi-ai.sql /docker-entrypoint-initdb.d/01-ruoyi-ai.sql
+COPY docs/script/sql/snail_job_mysql.sql /docker-entrypoint-initdb.d/02-snail-job.sql
 
 # MySQL启动参数
 CMD ["--default-authentication-plugin=mysql_native_password", \
@@ -18,4 +16,4 @@ CMD ["--default-authentication-plugin=mysql_native_password", \
      "--collation-server=utf8mb4_general_ci", \
      "--explicit_defaults_for_timestamp=true", \
      "--lower_case_table_names=1", \
-     "--skip-ssl"]
+     "--skip-ssl"]

docs/docker/ruoyi-ai/docker-compose-all.yaml

@@ -12,8 +12,6 @@
 #
 # 镜像仓库地址: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai
 
-version: '3.8'
-
 services:
   # ==================== MySQL 数据库 ====================
   mysql:
@@ -30,7 +28,10 @@ services:
     volumes:
       - mysql-data:/var/lib/mysql
     healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
+      # Force TCP: during first-time initialization MySQL exposes a temporary
+      # socket-only server. A socket ping would mark the service healthy before
+      # the real network listener (used by the backend) is ready.
+      test: ["CMD", "mysqladmin", "ping", "--protocol=tcp", "-h", "127.0.0.1", "-u", "root", "-proot"]
       interval: 15s
       timeout: 10s
       retries: 10
@@ -65,7 +66,7 @@ services:
       - "28080:8080"
     environment:
       QUERY_DEFAULTS_LIMIT: 25
-      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: true
+      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
@@ -177,4 +178,4 @@ volumes:
   weaviate-data:
   minio-data:
   logs-data:
-  upload-data:
+  upload-data:

docs/docker/ruoyi-ai/docker-compose.yaml

@@ -21,8 +21,8 @@ services:
       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
+      - ../../script/sql/ruoyi-ai.sql:/docker-entrypoint-initdb.d/01-ruoyi-ai.sql:ro
+      - ../../script/sql/snail_job_mysql.sql:/docker-entrypoint-initdb.d/02-snail-job.sql:ro
       - mysql-data:/var/lib/mysql
     command:
       --default-authentication-plugin=mysql_native_password
@@ -32,7 +32,9 @@ services:
       --lower_case_table_names=1
       --skip-ssl
     healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
+      # Do not let the socket-only initialization server satisfy the check.
+      # The backend connects over TCP and must wait for that listener.
+      test: ["CMD", "mysqladmin", "ping", "--protocol=tcp", "-h", "127.0.0.1", "-u", "root", "-proot"]
       interval: 15s
       timeout: 10s
       retries: 10

docs/script/docker/mysql/init/init-db.sh

@@ -1,10 +0,0 @@
-#!/bin/bash
-# 数据库初始化脚本
-# 使用 --force 参数确保即使出错也继续执行
-
-echo "开始初始化数据库..."
-
-# 使用 --force 参数忽略错误继续执行
-mysql -uroot -proot ruoyi-ai-agent --force < /docker-entrypoint-initdb.d/ruoyi-ai-v3_mysql8.sql
-
-echo "数据库初始化完成"

docs/script/install-ffmpeg-windows.ps1

@@ -0,0 +1,86 @@
+[CmdletBinding()]
+param(
+    [switch]$Force
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Find-Executable([string]$Name) {
+    $command = Get-Command $Name -ErrorAction SilentlyContinue
+    if ($command) {
+        return $command.Source
+    }
+
+    $roots = @(
+        (Join-Path $env:LOCALAPPDATA 'Microsoft\WinGet\Packages'),
+        (Join-Path $env:USERPROFILE 'scoop\apps\ffmpeg'),
+        'C:\ProgramData\chocolatey\bin',
+        'C:\ffmpeg'
+    )
+    foreach ($root in $roots) {
+        if (-not (Test-Path $root)) { continue }
+        $match = Get-ChildItem -Path $root -Filter "$Name.exe" -Recurse -ErrorAction SilentlyContinue |
+            Select-Object -First 1 -ExpandProperty FullName
+        if ($match) { return $match }
+    }
+    return $null
+}
+
+$ffmpeg = Find-Executable 'ffmpeg'
+$ffprobe = Find-Executable 'ffprobe'
+
+if ($Force -or -not $ffmpeg -or -not $ffprobe) {
+    $winget = Get-Command winget -ErrorAction SilentlyContinue
+    if (-not $winget) {
+        throw '未找到 winget。请先从 Microsoft Store 安装“应用安装程序”，或使用项目 Dockerfile 运行后端。'
+    }
+
+    Write-Host '正在通过 winget 安装 FFmpeg...' -ForegroundColor Cyan
+    & winget install --id Gyan.FFmpeg --exact --source winget `
+        --accept-package-agreements --accept-source-agreements
+    if ($LASTEXITCODE -ne 0) {
+        throw "winget 安装失败，退出码: $LASTEXITCODE"
+    }
+
+    $ffmpeg = Find-Executable 'ffmpeg'
+    $ffprobe = Find-Executable 'ffprobe'
+}
+
+if (-not $ffmpeg -or -not $ffprobe) {
+    throw 'FFmpeg 已安装但未能定位 ffmpeg.exe 或 ffprobe.exe。请重新打开 PowerShell 后再次运行脚本。'
+}
+
+$binDirectory = Split-Path -Parent $ffmpeg
+[Environment]::SetEnvironmentVariable('FFMPEG_PATH', $ffmpeg, 'User')
+[Environment]::SetEnvironmentVariable('FFPROBE_PATH', $ffprobe, 'User')
+
+$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+$pathParts = @($userPath -split ';' | Where-Object { $_ })
+if ($pathParts -notcontains $binDirectory) {
+    $newPath = (@($pathParts) + $binDirectory) -join ';'
+    [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
+}
+
+$env:FFMPEG_PATH = $ffmpeg
+$env:FFPROBE_PATH = $ffprobe
+if (($env:Path -split ';') -notcontains $binDirectory) {
+    $env:Path = "$binDirectory;$env:Path"
+}
+
+Write-Host "ffmpeg:  $ffmpeg" -ForegroundColor Green
+Write-Host "ffprobe: $ffprobe" -ForegroundColor Green
+
+& $ffmpeg -hide_banner -version | Select-Object -First 1
+& $ffprobe -hide_banner -version | Select-Object -First 1
+
+$encoders = & $ffmpeg -hide_banner -encoders 2>&1 | Out-String
+if ($encoders -notmatch '\blibx264\b') {
+    throw '当前 FFmpeg 不包含 libx264 编码器，无法满足短剧合成配置。'
+}
+if ($encoders -notmatch '\baac\b') {
+    throw '当前 FFmpeg 不包含 AAC 编码器，无法满足短剧合成配置。'
+}
+
+Write-Host ''
+Write-Host '安装与配置完成。请完全重启 IntelliJ IDEA 和 ruoyi-ai 后端服务。' -ForegroundColor Yellow
+Write-Host '重启后，Spring 将从 FFMPEG_PATH 和 FFPROBE_PATH 读取绝对路径。'

pom.xml

@@ -13,7 +13,7 @@
     <description>全栈式AI开发平台</description>
 
     <properties>
-        <revision>3.0.0</revision>
+        <revision>3.1.0</revision>
         <spring-boot.version>3.5.8</spring-boot.version>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
@@ -54,18 +54,23 @@
         <!-- Jackson XML -->
         <jackson-dataformat-xml.version>2.18.2</jackson-dataformat-xml.version>
         <!-- AI 相关依赖 -->
-        <langchain4j.version>1.13.0</langchain4j.version>
-        <langchain4j.community.version>1.13.0-beta23</langchain4j.community.version>
-        <langgraph4j.version>1.5.3</langgraph4j.version>
+
+        <langchain4j.version>1.17.2</langchain4j.version>
+        <langchain4j.beta.version>1.17.2-beta27</langchain4j.beta.version>
+        <langchain4j.community.version>1.17.0-beta27</langchain4j.community.version>
+        <langgraph4j.version>1.8.20</langgraph4j.version>
+
         <weaviate.version>1.19.6</weaviate.version>
-        <dify.version>1.0.7</dify.version>
+        <dify.version>1.2.7</dify.version>
+        <coze.version>0.4.2</coze.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>
+        <javassist.version>3.30.2-GA</javassist.version>
         <jsoup.version>1.21.2</jsoup.version>
         <knife4j.version>4.4.0</knife4j.version>
         <swagger-annotations.version>2.2.8</swagger-annotations.version>
@@ -499,20 +504,8 @@
         <resources>
             <resource>
                 <directory>src/main/resources</directory>
-                <!-- 关闭过滤 -->
                 <filtering>false</filtering>
             </resource>
-            <resource>
-                <directory>src/main/resources</directory>
-                <!-- 引入所有 匹配文件进行过滤 -->
-                <includes>
-                    <include>application*</include>
-                    <include>bootstrap*</include>
-                    <include>banner*</include>
-                </includes>
-                <!-- 启用过滤 即该资源中的变量将会被过滤器中的值替换 -->
-                <filtering>true</filtering>
-            </resource>
         </resources>
     </build>
 

ruoyi-admin/Dockerfile

@@ -1,31 +1,59 @@
-# 贝尔实验室 Spring 官方推荐镜像 JDK下载地址 https://bell-sw.com/pages/downloads/
+# FFmpeg-enabled variant of ruoyi-admin/Dockerfile.
 FROM bellsoft/liberica-openjdk-rocky:17.0.16-cds
-#FROM bellsoft/liberica-openjdk-rocky:21.0.8-cds
-#FROM findepi/graalvm:java17-native
 
 LABEL maintainer="Lion Li"
 
+# Rocky base repositories do not provide the full codec build. RPM Fusion Free
+# supplies ffmpeg with libx264, while the checks below prevent a reduced build
+# from reaching production unnoticed.
+RUN set -eux; \
+    dnf -y install dnf-plugins-core epel-release; \
+    . /etc/os-release; \
+    rocky_major="${VERSION_ID%%.*}"; \
+    if [ "${rocky_major}" -ge 9 ]; then \
+        dnf config-manager --set-enabled crb; \
+    else \
+        dnf config-manager --set-enabled powertools; \
+    fi; \
+    dnf -y install "https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-${rocky_major}.noarch.rpm"; \
+    dnf -y install ffmpeg; \
+    for filter in scale pad fps setsar format tpad trim settb setpts xfade \
+        aresample aformat apad atrim asetpts anullsrc concat acrossfade; do \
+        ffmpeg -hide_banner -filters 2>/dev/null | grep -Eq "[[:space:]]${filter}[[:space:]]"; \
+    done; \
+    ffmpeg -hide_banner -h filter=xfade 2>&1 | grep -q dissolve; \
+    ffmpeg -hide_banner -h filter=xfade 2>&1 | grep -q fadeblack; \
+    ffmpeg -hide_banner -h filter=xfade 2>&1 | grep -q slideleft; \
+    ffmpeg -hide_banner -encoders 2>/dev/null | grep -Eq '[[:space:]]libx264[[:space:]]'; \
+    ffmpeg -hide_banner -encoders 2>/dev/null | grep -Eq '[[:space:]]aac[[:space:]]'; \
+    ffprobe -hide_banner -version >/dev/null; \
+    dnf clean all; \
+    rm -rf /var/cache/dnf
+
 RUN mkdir -p /ruoyi/server/logs \
     /ruoyi/server/temp \
     /ruoyi/skywalking/agent
 
 WORKDIR /ruoyi/server
 
-ENV SERVER_PORT=8080 SNAIL_PORT=28080 LANG=C.UTF-8 LC_ALL=C.UTF-8 JAVA_OPTS=""
+ENV SERVER_PORT=8080 \
+    SNAIL_PORT=28080 \
+    LANG=C.UTF-8 \
+    LC_ALL=C.UTF-8 \
+    JAVA_OPTS="" \
+    FFMPEG_PATH=/usr/bin/ffmpeg \
+    FFPROBE_PATH=/usr/bin/ffprobe
 
 EXPOSE ${SERVER_PORT}
-# 暴露 snail job 客户端端口 用于定时任务调度中心通信
 EXPOSE ${SNAIL_PORT}
 
 ADD ./target/ruoyi-admin.jar ./app.jar
 
 SHELL ["/bin/bash", "-c"]
 
-ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -Dserver.port=${SERVER_PORT} \
+ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom \
+           -Djava.io.tmpdir=/ruoyi/server/temp \
+           -Dserver.port=${SERVER_PORT} \
            -Dsnail-job.port=${SNAIL_PORT} \
-           # 应用名称 如果想区分集群节点监控 改成不同的名称即可
-           #-Dskywalking.agent.service_name=ruoyi-server \
-           #-javaagent:/ruoyi/skywalking/agent/skywalking-agent.jar \
            -XX:+HeapDumpOnOutOfMemoryError -XX:+UseZGC ${JAVA_OPTS} \
            -jar app.jar
-

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

@@ -8,8 +8,8 @@ spring.boot.admin.client:
     metadata:
       username: ${spring.boot.admin.client.username}
       userpassword: ${spring.boot.admin.client.password}
-  username: @monitor.username@
-  password: @monitor.password@
+  username: ${MONITOR_USERNAME:ruoyi}
+  password: ${MONITOR_PASSWORD:123456}
 
 --- # mcp配置信息
 mcp:
@@ -27,12 +27,12 @@ snail-job:
   enabled: false
   # 需要在 SnailJob 后台组管理创建对应名称的组,然后创建任务的时候选择对应的组,才能正确分派任务
   group: "ruoyi_group"
-  # SnailJob 接入验证令牌 详见 script/sql/ry_job.sql `sj_group_config` 表
+  # SnailJob 接入验证令牌 详见 docs/script/sql/ruoyi-ai-v3_mysql8.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`字段
+  # 命名空间UUID 详见 docs/script/sql/ruoyi-ai-v3_mysql8.sql `sj_namespace`表`unique_id`字段
   namespace: ${spring.profiles.active}
   # 随主应用端口漂移
   port: 2${server.port}

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

@@ -9,8 +9,8 @@ spring.boot.admin.client:
     metadata:
       username: ${spring.boot.admin.client.username}
       userpassword: ${spring.boot.admin.client.password}
-  username: @monitor.username@
-  password: @monitor.password@
+  username: ${MONITOR_USERNAME:ruoyi}
+  password: ${MONITOR_PASSWORD:123456}
 
 --- # mcp配置信息
 mcp:
@@ -28,12 +28,12 @@ snail-job:
   enabled: false
   # 需要在 SnailJob 后台组管理创建对应名称的组,然后创建任务的时候选择对应的组,才能正确分派任务
   group: "ruoyi_group"
-  # SnailJob 接入验证令牌 详见 script/sql/ry_job.sql `sj_group_config` 表
+  # SnailJob 接入验证令牌 详见 docs/script/sql/ruoyi-ai-v3_mysql8.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`字段
+  # 命名空间UUID 详见 docs/script/sql/ruoyi-ai-v3_mysql8.sql `sj_namespace`表`unique_id`字段
   namespace: ${spring.profiles.active}
   # 随主应用端口漂移
   port: 2${server.port}

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

@@ -20,6 +20,10 @@ server:
       # 阻塞任务线程池, 当执行类似servlet请求阻塞操作, undertow会从这个线程池中取得线程,它的值设置取决于系统的负载
       worker: 256
 
+--- # 小程序对话 WebSocket 兜底默认模型（前端未传 model 且无智能体绑定时使用）
+chat:
+  default-model: deepseek-v4-flash
+
 captcha:
   # 是否启用验证码校验
   enable: false
@@ -35,7 +39,7 @@ captcha:
 # 日志配置
 logging:
   level:
-    org.ruoyi: @logging.level@
+    org.ruoyi: ${LOGGING_LEVEL_ORG_RUOYI:info}
     org.springframework: warn
     org.mybatis.spring.mapper: error
     org.apache.fury: warn
@@ -75,7 +79,7 @@ spring:
     # 国际化资源文件路径
     basename: i18n/messages
   profiles:
-    active: @profiles.active@
+    active: ${SPRING_PROFILES_ACTIVE:dev}
   # 文件上传
   servlet:
     multipart:
@@ -125,6 +129,7 @@ security:
     - /*/api-docs/**
     - /warm-flow-ui/config
     - /workflow/run
+    - /coding/**
 # 多租户配置
 tenant:
   # 是否开启
@@ -265,7 +270,7 @@ demo:
   # 是否开启演示模式（开启后所有写操作将被拦截）
   enabled: false
   # 提示消息
-  message: "演示模式，不允许进行写操作"
+  message: "演示模式，不允许操作"
   # 排除的路径（这些路径不受演示模式限制）
   excludes:
     - /login
@@ -276,7 +281,9 @@ demo:
     - /chat/send
     - /system/session/**
     - /system/message/**
-
+    - /system/attach/**
+    - /system/fragment/**
+    - /system/info/**
 --- # warm-flow工作流配置
 warm-flow:
   # 是否开启工作流，默认true
@@ -311,3 +318,38 @@ vector-store:
     collectionname: LocalKnowledge
     api-key:
     use-tls: false
+
+# 短剧成片合成
+short-drama:
+  composition:
+    ffmpeg-path: ${FFMPEG_PATH:ffmpeg}
+    ffprobe-path: ${FFPROBE_PATH:ffprobe}
+    fps: ${SHORT_DRAMA_COMPOSITION_FPS:30}
+    audio-sample-rate: ${SHORT_DRAMA_COMPOSITION_AUDIO_SAMPLE_RATE:48000}
+    video-codec: ${SHORT_DRAMA_COMPOSITION_VIDEO_CODEC:libx264}
+    audio-codec: ${SHORT_DRAMA_COMPOSITION_AUDIO_CODEC:aac}
+    preset: ${SHORT_DRAMA_COMPOSITION_PRESET:medium}
+    crf: ${SHORT_DRAMA_COMPOSITION_CRF:20}
+    audio-bitrate: ${SHORT_DRAMA_COMPOSITION_AUDIO_BITRATE:192k}
+    max-clips: ${SHORT_DRAMA_COMPOSITION_MAX_CLIPS:100}
+    max-transition-seconds: ${SHORT_DRAMA_COMPOSITION_MAX_TRANSITION_SECONDS:2.0}
+    minimum-output-bytes: ${SHORT_DRAMA_COMPOSITION_MINIMUM_OUTPUT_BYTES:1024}
+    max-process-output-bytes: ${SHORT_DRAMA_COMPOSITION_MAX_PROCESS_OUTPUT_BYTES:1048576}
+    max-source-bytes: ${SHORT_DRAMA_COMPOSITION_MAX_SOURCE_BYTES:536870912}
+    max-total-source-bytes: ${SHORT_DRAMA_COMPOSITION_MAX_TOTAL_SOURCE_BYTES:2147483648}
+    probe-timeout: ${SHORT_DRAMA_COMPOSITION_PROBE_TIMEOUT:30s}
+    process-timeout: ${SHORT_DRAMA_COMPOSITION_PROCESS_TIMEOUT:30m}
+    job-stale-after: ${SHORT_DRAMA_COMPOSITION_JOB_STALE_AFTER:45m}
+    watermark-font-file: ${SHORT_DRAMA_COMPOSITION_WATERMARK_FONT_FILE:}
+    worker-core-size: ${SHORT_DRAMA_COMPOSITION_WORKER_CORE_SIZE:1}
+    worker-max-size: ${SHORT_DRAMA_COMPOSITION_WORKER_MAX_SIZE:2}
+    worker-queue-capacity: ${SHORT_DRAMA_COMPOSITION_WORKER_QUEUE_CAPACITY:8}
+    storage-mode: ${SHORT_DRAMA_COMPOSITION_STORAGE_MODE:local}
+    local-output-directory: ${SHORT_DRAMA_COMPOSITION_LOCAL_OUTPUT_DIRECTORY:logs/short-drama-compositions}
+    download:
+      connect-timeout: ${SHORT_DRAMA_DOWNLOAD_CONNECT_TIMEOUT:30s}
+      call-timeout: ${SHORT_DRAMA_DOWNLOAD_CALL_TIMEOUT:10m}
+      max-redirects: ${SHORT_DRAMA_DOWNLOAD_MAX_REDIRECTS:5}
+      # 生产环境建议配置为视频供应商或 OSS/CDN 域名，多个值用逗号分隔。
+      allowed-hosts: ${SHORT_DRAMA_DOWNLOAD_ALLOWED_HOSTS:}
+      fake-ip-allowed-hosts: ${SHORT_DRAMA_DOWNLOAD_FAKE_IP_ALLOWED_HOSTS:atlas-media.oss-us-west-1.aliyuncs.com}

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

@@ -14,7 +14,7 @@
     </description>
 
     <properties>
-        <revision>3.0.0</revision>
+        <revision>3.1.0</revision>
     </properties>
 
     <dependencyManagement>

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/bo/chat/ChatModelBo.java

@@ -1,10 +1,12 @@
 package org.ruoyi.common.chat.domain.bo.chat;
 
 import io.github.linpeilie.annotations.AutoMapper;
+import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 import org.ruoyi.common.chat.entity.chat.ChatModel;
+import org.ruoyi.common.core.validate.AddGroup;
 import org.ruoyi.common.core.validate.EditGroup;
 import org.ruoyi.common.mybatis.core.domain.BaseEntity;
 
@@ -28,16 +30,19 @@ public class ChatModelBo extends BaseEntity {
     /**
      * 模型分类
      */
+    @NotBlank(message = "模型分类不能为空", groups = { AddGroup.class, EditGroup.class })
     private String category;
 
     /**
      * 模型名称
      */
+    @NotBlank(message = "模型名称不能为空", groups = { AddGroup.class, EditGroup.class })
     private String modelName;
 
     /**
      * 模型供应商
      */
+    @NotBlank(message = "模型供应商不能为空", groups = { AddGroup.class, EditGroup.class })
     private String providerCode;
 
     /**

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/bo/chat/ModelBatchKeyBo.java

@@ -0,0 +1,30 @@
+package org.ruoyi.common.chat.domain.bo.chat;
+
+import jakarta.validation.constraints.NotBlank;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.ruoyi.common.mybatis.core.domain.BaseEntity;
+
+/**
+ * 按厂商批量更新密钥业务对象
+ *
+ * @author ageerle
+ * @date 2025-12-14
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ModelBatchKeyBo extends BaseEntity {
+
+    /**
+     * 模型供应商
+     */
+    @NotBlank(message = "厂商编码不能为空")
+    private String providerCode;
+
+    /**
+     * 密钥
+     */
+    @NotBlank(message = "密钥不能为空")
+    private String apiKey;
+
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/ChatRequest.java

@@ -21,9 +21,19 @@ import java.util.List;
 @Data
 public class ChatRequest {
 
-    @NotEmpty(message = "传入的模型不能为空")
+    /**
+     * 模型名称。
+     * 智能体模式下可缺省：传 agentId 时后端按智能体绑定的模型解析，此字段仅作回退。
+     */
     private String model;
 
+    /**
+     * 智能体ID。传入时后端按智能体配置解析模型/工具/技能/知识库/提示词/是否深度思考。
+     */
+    @JsonSerialize(using = ToStringSerializer.class)
+    @JSONField(serializeUsing = String.class)
+    private Long agentId;
+
     /**
      * 对话消息
      */
@@ -35,16 +45,6 @@ public class ChatRequest {
      */
     private WorkFlowRunner workFlowRunner;
 
-    /**
-     * 人机交互信息体
-     */
-    private ReSumeRunner reSumeRunner;
-
-    /**
-     * 是否为人机交互用户继续输入
-     */
-    private Boolean isResume = false;
-
     /**
      * 是否启用工作流
      */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/domain/dto/request/ReSumeRunner.java

@@ -1,19 +0,0 @@
-package org.ruoyi.common.chat.domain.dto.request;
-
-import lombok.Data;
-
-/**
- * 人机交互输入信息
- */
-@Data
-public class ReSumeRunner {
-    /**
-     * 运行节点UUID
-     */
-    private String runtimeUuid;
-
-    /**
-     * 人机交互用户输入信息
-     */
-    private String feedbackContent;
-}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/audio/AudioContext.java

@@ -0,0 +1,44 @@
+package org.ruoyi.common.chat.entity.audio;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Builder;
+import lombok.Data;
+import org.ruoyi.common.chat.domain.vo.chat.ChatModelVo;
+
+/**
+ * Text-to-speech context.
+ */
+@Data
+@Builder
+public class AudioContext {
+
+    @NotNull(message = "模型配置不能为空")
+    private ChatModelVo chatModelVo;
+
+    @NotBlank(message = "输入文本不能为空")
+    private String input;
+
+    private String voice;
+
+    private String responseFormat;
+
+    private Double speed;
+
+    private String instructions;
+
+    /** Atlas seed-audio 参考资源：[{speaker, audioUrl, audioData, imageData}]，speaker 为音色名 */
+    private java.util.List<java.util.Map<String, String>> references;
+
+    /** Atlas seed-audio 采样率 */
+    private Integer sampleRate;
+
+    /** Atlas seed-audio 音调调整 (-12~12) */
+    private Integer pitchRate;
+
+    /** Atlas seed-audio 语速调整 (-50~100) */
+    private Integer speechRate;
+
+    /** Atlas seed-audio 响度调整 (-50~100) */
+    private Integer loudnessRate;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/image/ImageContext.java

@@ -42,4 +42,9 @@ public class ImageContext {
     @Min(value = 0, message = "随机数种子不能小于0")
     @Max(value = 2147483647, message = "随机数种子不能大于2147483647")
     private Integer seed;
+
+    /**
+     * 参考图 URL（图生图用）
+     */
+    private String image;
 }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/media/MediaGenerationResponse.java

@@ -0,0 +1,31 @@
+package org.ruoyi.common.chat.entity.media;
+
+import lombok.Builder;
+import lombok.Data;
+
+/**
+ * Unified media generation response.
+ */
+@Data
+@Builder
+public class MediaGenerationResponse {
+
+    private String type;
+
+    private String mimeType;
+
+    private String url;
+
+    private String b64Json;
+
+    private String dataUrl;
+
+    private String id;
+
+    private String status;
+
+    private String rawResponse;
+
+    /** 末帧图片 URL（Atlas return_last_frame=true 时返回，用于下一镜首帧承接） */
+    private String lastFrameUrl;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/entity/video/VideoContext.java

@@ -0,0 +1,47 @@
+package org.ruoyi.common.chat.entity.video;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Builder;
+import lombok.Data;
+import org.ruoyi.common.chat.domain.vo.chat.ChatModelVo;
+
+/**
+ * Text-to-video context.
+ */
+@Data
+@Builder
+public class VideoContext {
+
+    @NotNull(message = "模型配置不能为空")
+    private ChatModelVo chatModelVo;
+
+    @NotBlank(message = "提示词不能为空")
+    private String prompt;
+
+    private String size;
+
+    private Integer seconds;
+
+    private String quality;
+
+    /** 参考图 URL（图生视频模式，单图） */
+    private String imageUrl;
+
+    /** 多参考图 URL（多参考图生视频模式，配合 @imageN prompt 使用） */
+    private java.util.List<String> referenceImages;
+
+    /** 参考音频 URL 列表（对白口型对齐模式） */
+    private java.util.List<String> referenceAudios;
+
+    /** 是否让模型生成同步音频（环境音/动效） */
+    private Boolean generateAudio;
+
+    /** 是否要求返回末帧，用于下一镜首帧承接 */
+    private Boolean returnLastFrame;
+
+    /** 上一镜末帧 URL（同场景连续镜头首帧承接用，作为额外参考图传入） */
+    private String lastFrameUrl;
+
+    private String videoId;
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/factory/AudioServiceFactory.java

@@ -0,0 +1,40 @@
+package org.ruoyi.common.chat.factory;
+
+import org.ruoyi.common.chat.service.audio.IAudioGenerationService;
+import org.springframework.beans.BeansException;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.ApplicationContextAware;
+import org.springframework.stereotype.Component;
+
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * Text-to-speech service factory.
+ */
+@Component
+public class AudioServiceFactory implements ApplicationContextAware {
+
+    private final Map<String, IAudioGenerationService> audioServiceMap = new ConcurrentHashMap<>();
+
+    @Override
+    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
+        Map<String, IAudioGenerationService> serviceMap = applicationContext.getBeansOfType(IAudioGenerationService.class);
+        for (IAudioGenerationService service : serviceMap.values()) {
+            if (service != null) {
+                audioServiceMap.put(service.getProviderName(), service);
+            }
+        }
+    }
+
+    public IAudioGenerationService getOriginalService(String providerCode) {
+        IAudioGenerationService service = audioServiceMap.get(providerCode);
+        if (service == null && "custom_api".equals(providerCode)) {
+            service = audioServiceMap.get("openai");
+        }
+        if (service == null) {
+            throw new IllegalArgumentException("不支持的语音模型供应商: " + providerCode);
+        }
+        return service;
+    }
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/factory/ImageServiceFactory.java

@@ -37,6 +37,9 @@ public class ImageServiceFactory implements ApplicationContextAware {
      */
     public IImageGenerationService getOriginalService(String category) {
         IImageGenerationService service = imageSerivceMap.get(category);
+        if (service == null && "custom_api".equals(category)) {
+            service = imageSerivceMap.get("openai");
+        }
         if (service == null) {
             throw new IllegalArgumentException("不支持的模型类别: " + category);
         }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/factory/VideoServiceFactory.java

@@ -0,0 +1,40 @@
+package org.ruoyi.common.chat.factory;
+
+import org.ruoyi.common.chat.service.video.IVideoGenerationService;
+import org.springframework.beans.BeansException;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.ApplicationContextAware;
+import org.springframework.stereotype.Component;
+
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * Text-to-video service factory.
+ */
+@Component
+public class VideoServiceFactory implements ApplicationContextAware {
+
+    private final Map<String, IVideoGenerationService> videoServiceMap = new ConcurrentHashMap<>();
+
+    @Override
+    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
+        Map<String, IVideoGenerationService> serviceMap = applicationContext.getBeansOfType(IVideoGenerationService.class);
+        for (IVideoGenerationService service : serviceMap.values()) {
+            if (service != null) {
+                videoServiceMap.put(service.getProviderName(), service);
+            }
+        }
+    }
+
+    public IVideoGenerationService getOriginalService(String providerCode) {
+        IVideoGenerationService service = videoServiceMap.get(providerCode);
+        if (service == null && "custom_api".equals(providerCode)) {
+            service = videoServiceMap.get("openai");
+        }
+        if (service == null) {
+            throw new IllegalArgumentException("不支持的视频模型供应商: " + providerCode);
+        }
+        return service;
+    }
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/audio/IAudioGenerationService.java

@@ -0,0 +1,15 @@
+package org.ruoyi.common.chat.service.audio;
+
+import jakarta.validation.Valid;
+import org.ruoyi.common.chat.entity.audio.AudioContext;
+import org.ruoyi.common.chat.entity.media.MediaGenerationResponse;
+
+/**
+ * Public text-to-speech service.
+ */
+public interface IAudioGenerationService {
+
+    MediaGenerationResponse generateSpeech(@Valid AudioContext audioContext);
+
+    String getProviderName();
+}

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/chat/IChatModelService.java

@@ -73,4 +73,13 @@ public interface IChatModelService {
      * @return 是否删除成功
      */
     Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+
+    /**
+     * 按厂商批量更新密钥
+     *
+     * @param providerCode 厂商编码
+     * @param apiKey       密钥
+     * @return 是否更新成功
+     */
+    Boolean updateApiKeyByProvider(String providerCode, String apiKey);
 }

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/image/IImageGenerationService.java

@@ -2,6 +2,8 @@ package org.ruoyi.common.chat.service.image;
 
 import jakarta.validation.Valid;
 import org.ruoyi.common.chat.entity.image.ImageContext;
+import org.ruoyi.common.chat.entity.media.MediaGenerationResponse;
+import org.ruoyi.common.chat.domain.vo.chat.ChatModelVo;
 
 /**
  * 公共文生图接口
@@ -9,10 +11,31 @@ import org.ruoyi.common.chat.entity.image.ImageContext;
 public interface IImageGenerationService {
 
     /**
-     * 根据文字生成图片
+     * 根据文字生成图片（同步阻塞，返回 URL）
      */
     String generateImage(@Valid ImageContext imageContext);
 
+    /**
+     * 异步启动图片生成（返回 prediction 信息，用于轮询进度）
+     * 默认回退到同步模式
+     */
+    default MediaGenerationResponse startImageGeneration(@Valid ImageContext imageContext) {
+        String url = generateImage(imageContext);
+        return MediaGenerationResponse.builder()
+            .type("image")
+            .url(url)
+            .status("completed")
+            .build();
+    }
+
+    /**
+     * 上传图生图/图生视频使用的临时媒体文件。
+     * 不支持上传的供应商保持默认异常，避免静默回退到错误存储。
+     */
+    default String uploadMedia(ChatModelVo model, byte[] content, String fileName, String contentType) {
+        throw new UnsupportedOperationException("当前图片供应商不支持临时媒体上传");
+    }
+
     /**
      * 获取服务提供商名称
      */

ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/video/IVideoGenerationService.java

@@ -0,0 +1,17 @@
+package org.ruoyi.common.chat.service.video;
+
+import jakarta.validation.Valid;
+import org.ruoyi.common.chat.entity.media.MediaGenerationResponse;
+import org.ruoyi.common.chat.entity.video.VideoContext;
+
+/**
+ * Public text-to-video service.
+ */
+public interface IVideoGenerationService {
+
+    MediaGenerationResponse generateVideo(@Valid VideoContext videoContext);
+
+    MediaGenerationResponse retrieveVideo(@Valid VideoContext videoContext);
+
+    String getProviderName();
+}

ruoyi-common/ruoyi-common-core/src/main/java/org/ruoyi/common/core/config/ThreadPoolConfig.java

@@ -10,6 +10,7 @@ import org.springframework.boot.context.properties.EnableConfigurationProperties
 import org.springframework.context.annotation.Bean;
 import org.springframework.core.task.VirtualThreadTaskExecutor;
 
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
 import java.util.concurrent.*;
 
 /**
@@ -22,6 +23,12 @@ import java.util.concurrent.*;
 @EnableConfigurationProperties(ThreadPoolProperties.class)
 public class ThreadPoolConfig {
 
+    private final ThreadPoolProperties properties;
+
+    public ThreadPoolConfig(ThreadPoolProperties properties) {
+        this.properties = properties;
+    }
+
     /**
      * 核心线程数 = cpu 核心数 + 1
      */
@@ -54,6 +61,22 @@ public class ThreadPoolConfig {
         return scheduledThreadPoolExecutor;
     }
 
+    /**
+     * 知识库解析专用异步线程池
+     */
+    @Bean(name = "knowledgeParseExecutor")
+    public ThreadPoolTaskExecutor knowledgeParseExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        executor.setCorePoolSize(core);
+        executor.setMaxPoolSize(core * 2);
+        executor.setQueueCapacity(properties.getQueueCapacity());
+        executor.setKeepAliveSeconds(properties.getKeepAliveSeconds());
+        executor.setThreadNamePrefix("knowledge-parse-pool-");
+        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
+        executor.initialize();
+        return executor;
+    }
+
     /**
      * 销毁事件
      * 停止线程池

ruoyi-common/ruoyi-common-core/src/main/java/org/ruoyi/common/core/service/OssService.java

@@ -1,8 +1,11 @@
 package org.ruoyi.common.core.service;
 
+import jakarta.servlet.http.HttpServletResponse;
 import org.ruoyi.common.core.domain.dto.OssDTO;
 import org.springframework.web.multipart.MultipartFile;
 
+import java.io.File;
+import java.io.IOException;
 import java.util.List;
 
 /**
@@ -33,5 +36,19 @@ public interface OssService {
      */
     OssDTO uploadFile(MultipartFile file);
 
+    /**
+     * Upload a server-side file without buffering the complete payload in memory.
+     */
+    OssDTO uploadFile(File file);
+
+    /**
+     * Stream an object as an authenticated attachment response.
+     */
+    void downloadFile(Long ossId, HttpServletResponse response) throws IOException;
+
+    /**
+     * Delete one object and its sys_oss metadata.
+     */
+    Boolean deleteFile(Long ossId);
 
 }

ruoyi-common/ruoyi-common-oss/src/main/java/org/ruoyi/common/oss/core/OssClient.java

@@ -310,7 +310,7 @@ public class OssClient {
             client.deleteObject(
                 x -> x.bucket(properties.getBucketName())
                     .key(removeBaseUrl(path))
-                    .build());
+                    .build()).join();
         } catch (Exception e) {
             throw new OssException("删除文件失败，请检查配置信息:[" + e.getMessage() + "]");
         }

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

@@ -4,7 +4,7 @@ spring:
   application:
     name: ruoyi-monitor-admin
   profiles:
-    active: @profiles.active@
+    active: ${SPRING_PROFILES_ACTIVE:dev}
 
 logging:
   config: classpath:logback-plus.xml
@@ -13,8 +13,8 @@ logging:
 spring:
   security:
     user:
-      name: @monitor.username@
-      password: @monitor.password@
+      name: ${MONITOR_USERNAME:ruoyi}
+      password: ${MONITOR_PASSWORD:123456}
   boot:
     admin:
       ui:
@@ -47,5 +47,5 @@ spring.boot.admin.client:
     metadata:
       username: ${spring.boot.admin.client.username}
       userpassword: ${spring.boot.admin.client.password}
-  username: @monitor.username@
-  password: @monitor.password@
+  username: ${MONITOR_USERNAME:ruoyi}
+  password: ${MONITOR_PASSWORD:123456}

ruoyi-extend/ruoyi-snailjob-server/src/main/resources/application-dev.yml

@@ -2,7 +2,7 @@ spring:
   datasource:
     type: com.zaxxer.hikari.HikariDataSource
     driver-class-name: com.mysql.cj.jdbc.Driver
-    url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
+    url: jdbc:mysql://localhost:3306/snail_job?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
     username: root
     password: root
     hikari:
@@ -47,5 +47,5 @@ spring.boot.admin.client:
     metadata:
       username: ${spring.boot.admin.client.username}
       userpassword: ${spring.boot.admin.client.password}
-  username: @monitor.username@
-  password: @monitor.password@
+  username: ${MONITOR_USERNAME:ruoyi}
+  password: ${MONITOR_PASSWORD:123456}

ruoyi-extend/ruoyi-snailjob-server/src/main/resources/application-prod.yml

@@ -47,5 +47,5 @@ spring.boot.admin.client:
     metadata:
       username: ${spring.boot.admin.client.username}
       userpassword: ${spring.boot.admin.client.password}
-  username: @monitor.username@
-  password: @monitor.password@
+  username: ${MONITOR_USERNAME:ruoyi}
+  password: ${MONITOR_PASSWORD:123456}

ruoyi-extend/ruoyi-snailjob-server/src/main/resources/application.yml

@@ -7,7 +7,7 @@ spring:
   application:
     name: ruoyi-snailjob-server
   profiles:
-    active: @profiles.active@
+    active: ${SPRING_PROFILES_ACTIVE:dev}
   web:
     resources:
       static-locations: classpath:admin/

ruoyi-modules/ruoyi-aiflow/pom.xml

@@ -72,6 +72,21 @@
             <groupId>com.talanlabs</groupId>
             <artifactId>avatar-generator-cat</artifactId>
             <version>${avatar-generator.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.javassist</groupId>
+                    <artifactId>javassist</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
+        <!-- avatar-generator-cat pulls an obsolete Javassist POM that Maven 3.9
+             warns about. Reflections 0.9.10 is compatible with the maintained
+             drop-in replacement. -->
+        <dependency>
+            <groupId>org.javassist</groupId>
+            <artifactId>javassist</artifactId>
+            <version>${javassist.version}</version>
         </dependency>
 
 

ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/CompileNode.java

@@ -16,6 +16,7 @@ import java.util.List;
 @AllArgsConstructor
 public class CompileNode {
     protected String id;
+    @Builder.Default
     protected Boolean conditional = false;
 
     /**
@@ -24,5 +25,6 @@ public class CompileNode {
      * 2. 当前节点为条件分支节点，下游节点为多个节点，实际执行时只会执行一条
      * 两种节点根据是否GraphCompileNode来区分
      */
+    @Builder.Default
     protected List<CompileNode> nextNodes = new ArrayList<>();
 }

ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/NodeProcessResult.java

@@ -15,6 +15,7 @@ import java.util.List;
 @NoArgsConstructor
 public class NodeProcessResult {
 
+    @Builder.Default
     private List<NodeIOData> content = new ArrayList<>();
 
     /**
@@ -25,6 +26,7 @@ public class NodeProcessResult {
     /**
      * 是否发生错误
      */
+    @Builder.Default
     private boolean error = false;
 
     /**

ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/WorkflowEngine.java

@@ -265,10 +265,6 @@ public class WorkflowEngine {
                 String node = streamingOutput.node();
                 String chunk = streamingOutput.chunk();
                 log.info("node:{},chunk:{}", node, chunk);
-                Map<String, String> strMap = new HashMap<>();
-                strMap.put("ck", chunk);
-//                SSEEmitterHelper.parseAndSendPartialMsg(sseEmitter, "[NODE_CHUNK_" + node + "]", strMap.toString());
-
                 SSEEmitterHelper.parseAndSendPartialMsg(sseEmitter, "[NODE_CHUNK_" + node + "]", chunk);
             } else {
                 AbstractWfNode abstractWfNode = wfState.getCompletedNodes().stream()

ruoyi-modules/ruoyi-chat/docs/MCP工具模块接口文档.md

@@ -1,336 +0,0 @@
-# MCP工具管理模块 - API接口文档
-
-## 概述
-
-本文档描述了MCP工具管理模块的REST API接口，供前端开发人员参考。
-
-## 基础信息
-
-- **Base URL**: `/api/mcp`
-- **认证方式**: Bearer Token (SaToken)
-- **响应格式**: JSON
-
----
-
-## 1. MCP工具管理
-
-### 1.1 查询工具列表（分页）
-
-**接口**: `GET /tool/list`
-
-**权限**: `mcp:tool:list`
-
-**请求参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| name | String | 否 | 工具名称（模糊查询） |
-| description | String | 否 | 工具描述（模糊查询） |
-| type | String | 否 | 工具类型：LOCAL/REMOTE/BUILTIN |
-| status | String | 否 | 状态：0-启用, 1-禁用 |
-| pageNum | Integer | 是 | 页码，默认1 |
-| pageSize | Integer | 是 | 每页数量，默认10 |
-
-**响应示例**:
-```json
-{
-  "rows": [
-    {
-      "id": 1,
-      "name": "ReadFileTool",
-      "description": "读取文件内容工具",
-      "type": "BUILTIN",
-      "status": "0",
-      "configJson": null,
-      "createTime": "2026-03-08 10:00:00",
-      "updateTime": "2026-03-08 10:00:00"
-    }
-  ],
-  "total": 1
-}
-```
-
-### 1.2 查询工具列表（不分页）
-
-**接口**: `GET /tool/all`
-
-**权限**: `mcp:tool:list`
-
-**请求参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| keyword | String | 否 | 关键词 |
-| type | String | 否 | 工具类型 |
-| status | String | 否 | 状态 |
-
-**响应示例**:
-```json
-{
-  "tools": [
-    {
-      "id": 1,
-      "name": "ReadFileTool",
-      "description": "读取文件内容工具",
-      "type": "BUILTIN",
-      "status": "0"
-    }
-  ],
-  "total": 1
-}
-```
-
-### 1.3 获取工具详情
-
-**接口**: `GET /tool/{id}`
-
-**权限**: `mcp:tool:query`
-
-**路径参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| id | Long | 是 | 工具ID |
-
-### 1.4 新增工具
-
-**接口**: `POST /tool`
-
-**权限**: `mcp:tool:add`
-
-**请求体**:
-```json
-{
-  "name": "MyMcpTool",
-  "description": "我的MCP工具",
-  "type": "REMOTE",
-  "status": "0",
-  "configJson": "{\"baseUrl\": \"http://localhost:8080/mcp\"}"
-}
-```
-
-### 1.5 修改工具
-
-**接口**: `PUT /tool`
-
-**权限**: `mcp:tool:edit`
-
-**请求体**: 同新增工具
-
-### 1.6 删除工具
-
-**接口**: `DELETE /tool/{ids}`
-
-**权限**: `mcp:tool:remove`
-
-**路径参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| ids | String | 是 | 工具ID，多个用逗号分隔 |
-
-### 1.7 更新工具状态
-
-**接口**: `PUT /tool/{id}/status`
-
-**权限**: `mcp:tool:edit`
-
-**路径参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| id | Long | 是 | 工具ID |
-
-**请求参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| status | String | 是 | 状态：0-启用, 1-禁用 |
-
-### 1.8 测试工具连接
-
-**接口**: `POST /tool/{id}/test`
-
-**权限**: `mcp:tool:query`
-
-**响应示例**:
-```json
-{
-  "success": true,
-  "message": "连接测试成功",
-  "toolCount": 5,
-  "tools": ["tool1", "tool2", "tool3", "tool4", "tool5"]
-}
-```
-
----
-
-## 2. MCP市场管理
-
-### 2.1 查询市场列表
-
-**接口**: `GET /market/list`
-
-**权限**: `mcp:market:list`
-
-**请求参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| name | String | 否 | 市场名称 |
-| description | String | 否 | 市场描述 |
-| status | String | 否 | 状态 |
-| pageNum | Integer | 是 | 页码 |
-| pageSize | Integer | 是 | 每页数量 |
-
-### 2.2 获取市场工具列表
-
-**接口**: `GET /market/{marketId}/tools`
-
-**权限**: `mcp:market:query`
-
-**路径参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| marketId | Long | 是 | 市场ID |
-
-**请求参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| page | Integer | 否 | 页码，默认1 |
-| size | Integer | 否 | 每页数量，默认10 |
-
-### 2.3 刷新市场工具
-
-**接口**: `POST /market/{marketId}/refresh`
-
-**权限**: `mcp:market:edit`
-
-**响应示例**:
-```json
-{
-  "success": true,
-  "message": "刷新成功",
-  "addedCount": 3,
-  "updatedCount": 5
-}
-```
-
-### 2.4 加载工具到本地
-
-**接口**: `POST /market/tool/{toolId}/load`
-
-**权限**: `mcp:market:edit`
-
-**路径参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| toolId | Long | 是 | 市场工具ID |
-
-### 2.5 批量加载工具
-
-**接口**: `POST /market/tools/batchLoad`
-
-**权限**: `mcp:market:edit`
-
-**请求体**:
-```json
-{
-  "toolIds": [1, 2, 3]
-}
-```
-
----
-
-## 3. 工具调用日志
-
-### 3.1 查询调用日志
-
-**接口**: `GET /tool/callLog`
-
-**权限**: `mcp:tool:query`
-
-**请求参数**:
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| toolId | Long | 否 | 工具ID |
-| sessionId | Long | 否 | 会话ID |
-| startDate | Date | 否 | 开始日期 |
-| endDate | Date | 否 | 结束日期 |
-| pageNum | Integer | 是 | 页码 |
-| pageSize | Integer | 是 | 每页数量 |
-
-### 3.2 获取工具统计
-
-**接口**: `GET /tool/{toolId}/metrics`
-
-**权限**: `mcp:tool:query`
-
-**响应示例**:
-```json
-{
-  "toolId": 1,
-  "toolName": "ReadFileTool",
-  "today": {
-    "callCount": 100,
-    "successCount": 95,
-    "failureCount": 5,
-    "avgDurationMs": 150,
-    "successRate": 95.0
-  },
-  "week": {
-    "callCount": 500,
-    "successCount": 475,
-    "failureCount": 25,
-    "avgDurationMs": 160,
-    "successRate": 95.0
-  }
-}
-```
-
----
-
-## 4. 状态码说明
-
-| 状态码 | 说明 |
-|--------|------|
-| 200 | 请求成功 |
-| 401 | 未认证 |
-| 403 | 无权限 |
-| 404 | 资源不存在 |
-| 500 | 服务器错误 |
-
----
-
-## 5. 前端页面需求
-
-### 5.1 MCP工具管理页面 (`/mcp/tool`)
-
-**功能**:
-- 工具列表展示（分页）
-- 工具搜索和筛选
-- 新增/编辑/删除工具
-- 工具状态切换
-- 工具连接测试
-
-**表格列**:
-- 工具名称
-- 工具描述
-- 工具类型（标签显示）
-- 状态（开关）
-- 创建时间
-- 操作（编辑、删除、测试）
-
-### 5.2 MCP市场管理页面 (`/mcp/market`)
-
-**功能**:
-- 市场列表展示
-- 市场工具浏览
-- 刷新市场工具
-- 加载工具到本地
-
-### 5.3 工具调用日志页面 (`/mcp/log`)
-
-**功能**:
-- 调用日志列表
-- 按工具/日期筛选
-- 成功率统计
-- 响应时间统计
-
-**图表**:
-- 每日调用次数趋势图
-- 工具调用成功率饼图
-- 平均响应时间柱状图