refactor: move RAG trace classes to argtrace package and update SQL schema

- Rename org.ruoyi.trace package to org.ruoyi.argtrace for RagTraceNodeTypes and RagTracePayloadBuilder; fix package declarations and update imports in ChatServiceFacade and KnowledgeRetrievalServiceImpl - Remove obsolete RagTracePayloadBuilderTest - Switch supervisor response strategy from SUMMARY to LAST in ChatServiceFacade - Refresh docs/script/sql/ruoyi-ai.sql with the latest full schema dump - Add live demo links (admin panel, user frontend, commercial edition) to README.md and README_ZH.md Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs: remove redundant registry commands
2026-09-13 00:14:59 +00:00 · 2026-08-04 17:44:39 +08:00 · 2026-08-04 15:57:32 +08:00 · 2026-08-04 15:55:17 +08:00 · 2026-08-04 15:50:51 +08:00 · 2026-08-04 15:50:36 +08:00
21 changed files with 1028 additions and 195 deletions
--- a/.github/workflows/publish-images.yml
+++ b/.github/workflows/publish-images.yml
@@ -0,0 +1,133 @@
+name: Publish Docker Images
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      release_tag:
+        description: Release tag to rebuild
+        required: true
+        type: string
+
+concurrency:
+  group: publish-images-${{ inputs.release_tag || github.ref_name }}
+  cancel-in-progress: false
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_OWNER: ${{ github.repository_owner }}
+  RELEASE_TAG: ${{ inputs.release_tag || github.ref_name }}
+
+jobs:
+  publish:
+    name: Publish ${{ matrix.image }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - image: ruoyi-ai-backend
+            source: local
+            context: .
+            dockerfile: docs/docker/ruoyi-ai/Dockerfile.backend
+          - image: ruoyi-ai-mysql
+            source: local
+            context: .
+            dockerfile: docs/docker/ruoyi-ai/Dockerfile.mysql
+          - image: ruoyi-ai-admin
+            source: admin
+            context: build/ruoyi-admin
+            dockerfile: build/ruoyi-admin/apps/web-antd/Dockerfile
+          - image: ruoyi-ai-web
+            source: web
+            context: build/ruoyi-web
+            dockerfile: build/ruoyi-web/Dockerfile.frontend
+
+    steps:
+      - name: Checkout backend repository
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ env.RELEASE_TAG }}
+          fetch-depth: 1
+
+      - name: Checkout admin repository
+        if: matrix.source == 'admin'
+        uses: actions/checkout@v6
+        with:
+          repository: ${{ github.repository_owner }}/ruoyi-admin
+          ref: ${{ env.RELEASE_TAG }}
+          path: build/ruoyi-admin
+          fetch-depth: 1
+
+      - name: Checkout web repository
+        if: matrix.source == 'web'
+        uses: actions/checkout@v6
+        with:
+          repository: ${{ github.repository_owner }}/ruoyi-web
+          ref: ${{ env.RELEASE_TAG }}
+          path: build/ruoyi-web
+          fetch-depth: 1
+
+      - name: Configure frontend dependency builds
+        if: matrix.source == 'admin' || matrix.source == 'web'
+        shell: bash
+        run: |
+          python3 - "${{ matrix.dockerfile }}" <<'PY'
+          from pathlib import Path
+          import sys
+
+          dockerfile = Path(sys.argv[1])
+          content = dockerfile.read_text()
+          marker = "pnpm install --frozen-lockfile"
+          replacement = (
+              "pnpm install --frozen-lockfile "
+              "--config.dangerously-allow-all-builds=true"
+          )
+          if marker not in content:
+              raise SystemExit(f"pnpm install command not found in {dockerfile}")
+          dockerfile.write_text(content.replace(marker, replacement, 1))
+          PY
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_OWNER }}/${{ matrix.image }}
+          tags: |
+            type=raw,value=${{ env.RELEASE_TAG }}
+            type=raw,value=latest
+          labels: |
+            org.opencontainers.image.source=https://github.com/${{ github.repository }}
+            org.opencontainers.image.version=${{ env.RELEASE_TAG }}
+
+      - name: Build and push image
+        uses: docker/build-push-action@v6
+        with:
+          context: ${{ matrix.context }}
+          file: ${{ matrix.dockerfile }}
+          platforms: linux/amd64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha,scope=${{ matrix.image }}
+          cache-to: type=gha,mode=max,scope=${{ matrix.image }}
+          provenance: true
+          sbom: true
--- a/.gitignore
+++ b/.gitignore
@@ -23,6 +23,9 @@ target/
 .idea
 .claude
 .github
+!.github/
+!.github/workflows/
+!.github/workflows/**
 *.iws
 *.iml
 *.ipr
--- a/README.md
+++ b/README.md
@@ -23,7 +23,13 @@
 </div>


+## 🚀 Live Demo

+| Service | URL | Default Account |
+|---|---|---|
+| Admin Panel | http://129.226.199.247:25666 | admin / admin123 |
+| User Frontend | http://129.226.199.247:25137 | admin / admin123 |
+| Commercial Edition | https://web.ruoyiai.chat | WeChat QR code login |

 ## ✨ Core Features

@@ -71,22 +77,42 @@ This project provides two Docker deployment methods:
 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
+# Requirements: Docker Engine and Docker Compose V2
+
+# Clone the v3.1.0 release
+git clone --depth 1 --branch v3.1.0 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
+# Pin the image version. Public GHCR images do not require docker login.
+cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env
+sed -i 's/^RUIYI_VERSION=.*/RUIYI_VERSION=v3.1.0/' docs/docker/ruoyi-ai/.env
+
+# Pull pre-built images from GHCR and start all services
+docker compose --env-file docs/docker/ruoyi-ai/.env \
+  -f docs/docker/ruoyi-ai/docker-compose-all.yaml pull
+docker compose --env-file docs/docker/ruoyi-ai/.env \
+  -f docs/docker/ruoyi-ai/docker-compose-all.yaml up -d

 # Check service status
-docker-compose -f docker-compose-all.yaml ps
+docker compose --env-file docs/docker/ruoyi-ai/.env \
+  -f docs/docker/ruoyi-ai/docker-compose-all.yaml ps

-# Access services
-# Admin Panel: http://localhost:25666 (admin / admin123)
-# User Frontend: http://localhost:25137
-# Backend API: http://localhost:26039
+# Access services (replace SERVER_IP with the server address)
+# Admin Panel: http://SERVER_IP:25666 (admin / admin123)
+# User Frontend: http://SERVER_IP:25137
+# Backend API: http://SERVER_IP:26039
 ```

+The default Compose file also publishes MySQL (`23306`), Redis (`26379`),
+Weaviate (`28080`), and MinIO (`29000`/`29090`). For production deployments,
+change the default MySQL and MinIO passwords and expose only the application
+ports through the firewall or a reverse proxy.
+
+To upgrade to another published release, update `RUIYI_VERSION` in
+`docs/docker/ruoyi-ai/.env`, then run `docker compose pull` and
+`docker compose up -d` with the same `--env-file` and `-f` options. Do not use
+`docker compose down -v` unless you intend to delete persistent data volumes.
+
 ### Method 2: Step-by-step Deployment (Source Build)

 If you need to build backend services from source, follow these steps:
@@ -143,36 +169,6 @@ docker-compose up -d --build
 | 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

 Want to learn more about installation, deployment, configuration, and secondary development?
@@ -234,9 +230,9 @@ Enjoy ByteDance's in-house Doubao models plus full-power open-source SOTA models
 <em>Join group for learning</em>
 </td>
 <td align="center">
-<img src="docs/image/wx06.png" alt="WeChat QR Code" width="200" height="200"><br>
-<strong>WeChat Tech Exchange Group</strong><br>
-<em>Technical discussion</em>
+<img src="docs/image/douyin.png" alt="Douyin QR Code" width="200" height="200"><br>
+<strong>Douyin Video Tutorials</strong><br>
+<em>Open Douyin, scan & follow to watch video tutorials</em>
 </td>
 <td align="center">
 <img src="docs/image/qq.png" alt="QQ Group QR Code" width="200" height="200"><br>
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -23,6 +23,14 @@
 </div>


+## 🚀 演示地址
+
+| 服务 | 访问地址 | 默认账号 |
+|---|---|---|
+| 管理端 | http://129.226.199.247:25666 | admin / admin123 |
+| 用户端 | http://129.226.199.247:25137 | admin / admin123 |
+| 商业版 | https://web.ruoyiai.chat | 微信扫码登录 |
+
 ## ✨ 核心亮点

 |    模块     | 现有能力
@@ -70,22 +78,39 @@
 使用 `docker-compose-all.yaml` 可以一键启动所有服务（包括后端、管理端、用户端及依赖服务）：

 ```bash
-# 克隆仓库
-git clone https://github.com/ageerle/ruoyi-ai.git
+# 环境要求：Docker Engine 和 Docker Compose V2
+
+# 克隆 v3.1.0 版本
+git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git
 cd ruoyi-ai

-# 启动所有服务（从镜像仓库拉取预构建镜像）
-docker-compose -f docker-compose-all.yaml up -d
+# 固定镜像版本。GHCR 镜像已公开，无需 docker login
+cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env
+sed -i 's/^RUIYI_VERSION=.*/RUIYI_VERSION=v3.1.0/' docs/docker/ruoyi-ai/.env
+
+# 从 GHCR 拉取预构建镜像并启动全部服务
+docker compose --env-file docs/docker/ruoyi-ai/.env \
+  -f docs/docker/ruoyi-ai/docker-compose-all.yaml pull
+docker compose --env-file docs/docker/ruoyi-ai/.env \
+  -f docs/docker/ruoyi-ai/docker-compose-all.yaml up -d

 # 查看服务状态
-docker-compose -f docker-compose-all.yaml ps
+docker compose --env-file docs/docker/ruoyi-ai/.env \
+  -f docs/docker/ruoyi-ai/docker-compose-all.yaml ps

-# 访问服务
-# 管理端: http://localhost:25666 (admin / admin123)
-# 用户端: http://localhost:25137
-# 后端API: http://localhost:26039
+# 访问服务（将 SERVER_IP 替换为服务器地址）
+# 管理端: http://SERVER_IP:25666 (admin / admin123)
+# 用户端: http://SERVER_IP:25137
+# 后端API: http://SERVER_IP:26039
 ```

+默认 Compose 还会发布 MySQL（`23306`）、Redis（`26379`）、Weaviate（`28080`）和
+MinIO（`29000`/`29090`）端口。生产环境请修改 MySQL 和 MinIO 默认密码，并通过防火墙或反向代理只开放应用端口。
+
+升级到其他已发布版本时，修改 `docs/docker/ruoyi-ai/.env` 中的 `RUIYI_VERSION`，然后使用相同的
+`--env-file` 和 `-f` 参数执行 `docker compose pull`、`docker compose up -d`。除非确定要删除持久化数据卷，
+不要执行 `docker compose down -v`。
+
 ### 方式二：分步部署（源码编译）

 如果您需要从源码构建后端服务，请按照以下步骤操作：
@@ -142,36 +167,6 @@ docker-compose up -d --build
 | 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 [服务名]
-```
-
 ## 📚 使用文档

 想要深入了解安装部署、功能配置和二次开发？
@@ -235,9 +230,9 @@ 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>
+<img src="docs/image/douyin.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>
--- a/docs/docker/ruoyi-ai/.env.example
+++ b/docs/docker/ruoyi-ai/.env.example
@@ -0,0 +1,6 @@
+# GitHub Container Registry namespace owner.
+# For the upstream project this is ageerle; change it when using a fork.
+IMAGE_OWNER=ageerle
+
+# Use latest for convenience, or pin a release such as v3.1.0.
+RUIYI_VERSION=latest
--- a/docs/docker/ruoyi-ai/docker-compose-all.yaml
+++ b/docs/docker/ruoyi-ai/docker-compose-all.yaml
@@ -10,13 +10,13 @@
 #   - RuoYi-Admin (管理端前端)
 #   - RuoYi-Web (用户端前端)
 #
-# 镜像仓库地址: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai
+# 镜像仓库地址: ghcr.io/ageerle

 services:
  # ==================== MySQL 数据库 ====================
  mysql:
-    # 阿里云镜像地址（包含初始化SQL）
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/mysql:v3
+    # GHCR 镜像（包含初始化SQL）
+    image: ghcr.io/${IMAGE_OWNER:-ageerle}/ruoyi-ai-mysql:${RUIYI_VERSION:-latest}
    container_name: ruoyi-ai-mysql
    restart: always
    ports:
@@ -41,7 +41,7 @@ services:

  # ==================== Redis 缓存 ====================
  redis:
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/redis:6.2
+    image: redis:6.2
    container_name: ruoyi-ai-redis
    restart: always
    ports:
@@ -59,7 +59,7 @@ services:

  # ==================== Weaviate 向量数据库 ====================
  weaviate:
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/weaviate:1.30.0
+    image: semitechnologies/weaviate:1.30.0
    container_name: ruoyi-ai-weaviate
    restart: always
    ports:
@@ -78,7 +78,7 @@ services:

  # ==================== MinIO 对象存储 ====================
  minio:
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/minio:latest
+    image: minio/minio:latest
    container_name: ruoyi-ai-minio
    restart: always
    ports:
@@ -95,7 +95,7 @@ services:

  # ==================== RuoYi-AI 后端服务 ====================
  backend:
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/ruoyi-ai-backend:latest
+    image: ghcr.io/${IMAGE_OWNER:-ageerle}/ruoyi-ai-backend:${RUIYI_VERSION:-latest}
    container_name: ruoyi-ai-backend
    restart: always
    ports:
@@ -129,7 +129,7 @@ services:

  # ==================== RuoYi-AI 管理端前端 ====================
  admin-frontend:
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/ruoyi-ai-admin:latest
+    image: ghcr.io/${IMAGE_OWNER:-ageerle}/ruoyi-ai-admin:${RUIYI_VERSION:-latest}
    container_name: ruoyi-ai-admin
    restart: always
    ports:
@@ -154,7 +154,7 @@ services:

  # ==================== RuoYi-AI 用户端前端 ====================
  web-frontend:
-    image: crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai/ruoyi-ai-web:latest
+    image: ghcr.io/${IMAGE_OWNER:-ageerle}/ruoyi-ai-web:${RUIYI_VERSION:-latest}
    container_name: ruoyi-ai-web
    restart: always
    ports:
--- a/docs/image/douyin.png
+++ b/docs/image/douyin.png
--- a/docs/image/dy.png
+++ b/docs/image/dy.png
--- a/docs/image/wx06.png
+++ b/docs/image/wx06.png
--- a/docs/script/sql/ruoyi-ai.sql
+++ b/docs/script/sql/ruoyi-ai.sql
--- a/pom.xml
+++ b/pom.xml
@@ -43,7 +43,6 @@
        <aws.sdk.version>2.28.22</aws.sdk.version>
        <!-- SMS 配置 -->
        <sms4j.version>3.3.5</sms4j.version>
-        <!-- FastJson已移除，使用Jackson替代 -->
        <!-- 面向运行时的D-ORM依赖 -->
        <anyline.version>8.7.2-20250603</anyline.version>
        <!-- 工作流配置 -->
@@ -62,6 +61,8 @@
        <weaviate.version>1.19.6</weaviate.version>
        <dify.version>1.2.7</dify.version>
        <coze.version>0.4.2</coze.version>
+        <!-- 智谱官方 Java SDK -->
+        <zai-sdk.version>0.3.5</zai-sdk.version>

        <!-- gRPC 版本 - 解决 Milvus SDK 依赖冲突 -->
        <grpc.version>1.62.2</grpc.version>
@@ -342,8 +343,6 @@
            </dependency>

            <!-- JustAuth 的依赖配置-->
-            <!-- 排除 fastjson(存在 RCE 漏洞且已停止维护), 项目内自定义的登录类(钉钉/企业微信/gitea/maxkey/topiam)已改用 Jackson -->
-            <!-- 注意: JustAuth 内置平台类(github/gitee/qq 等)内部仍使用 fastjson, 排除后如需使用这些平台请自行覆写对应请求类 -->
            <dependency>
                <groupId>me.zhyd.oauth</groupId>
                <artifactId>JustAuth</artifactId>
--- a/ruoyi-common/ruoyi-common-chat/pom.xml
+++ b/ruoyi-common/ruoyi-common-chat/pom.xml
@@ -37,7 +37,6 @@
            <artifactId>ruoyi-common-sse</artifactId>
        </dependency>

-        <!-- FastJson已移除，使用Spring Boot自带的Jackson -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
--- a/ruoyi-common/ruoyi-common-social/src/main/java/me/zhyd/oauth/request/AbstractAuthWeChatEnterpriseRequest.java
+++ b/ruoyi-common/ruoyi-common-social/src/main/java/me/zhyd/oauth/request/AbstractAuthWeChatEnterpriseRequest.java
@@ -61,7 +61,6 @@ public abstract class AbstractAuthWeChatEnterpriseRequest extends AuthDefaultReq
        String userTicket = object.has("user_ticket") ? object.get("user_ticket").asText() : null;
        JsonNode userDetail = getUserDetail(authToken.getAccessToken(), userId, userTicket);

-        // rawUserInfo 为 JustAuth 的 fastjson 类型字段, 项目内无消费方, 不再设置
        return AuthUser.builder()
            .username(userDetail.has("name") ? userDetail.get("name").asText() : null)
            .nickname(userDetail.has("alias") ? userDetail.get("alias").asText() : null)
--- a/ruoyi-common/ruoyi-common-social/src/main/java/me/zhyd/oauth/request/AuthDingTalkV2Request.java
+++ b/ruoyi-common/ruoyi-common-social/src/main/java/me/zhyd/oauth/request/AuthDingTalkV2Request.java
@@ -91,7 +91,6 @@ public class AuthDingTalkV2Request extends AuthDefaultRequest {

            authToken.setOpenId(object.has("openId") ? object.get("openId").asText() : null);
            authToken.setUnionId(object.has("unionId") ? object.get("unionId").asText() : null);
-            // rawUserInfo 为 JustAuth 的 fastjson 类型字段, 项目内无消费方, 不再设置
            return AuthUser.builder()
                .uuid(object.has("unionId") ? object.get("unionId").asText() : null)
                .username(object.has("nick") ? object.get("nick").asText() : null)
--- a/ruoyi-modules/ruoyi-aiflow/pom.xml
+++ b/ruoyi-modules/ruoyi-aiflow/pom.xml
@@ -28,7 +28,7 @@
        <dependency>
            <groupId>ai.z.openapi</groupId>
            <artifactId>zai-sdk</artifactId>
-            <version>0.3.5</version>
+            <version>${zai-sdk.version}</version>
        </dependency>

        <dependency>
@@ -126,6 +126,7 @@
            <version>${langchain4j.version}</version>
            <scope>compile</scope>
        </dependency>
+
        <dependency>
            <groupId>org.jsoup</groupId>
            <artifactId>jsoup</artifactId>
@@ -145,8 +146,6 @@
            <version>${langgraph4j.version}</version>
        </dependency>

-
-
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-collections4</artifactId>
--- a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/argtrace/RagTraceNodeTypes.java
+++ b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/argtrace/RagTraceNodeTypes.java
@@ -1,4 +1,4 @@
-package org.ruoyi.trace;
+package org.ruoyi.argtrace;

 /**
 * RAG trace 业务与节点类型常量。
--- a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/argtrace/RagTracePayloadBuilder.java
+++ b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/argtrace/RagTracePayloadBuilder.java
@@ -1,4 +1,4 @@
-package org.ruoyi.trace;
+package org.ruoyi.argtrace;

 import org.ruoyi.common.chat.domain.dto.request.ChatRequest;
 import org.ruoyi.common.chat.domain.vo.chat.ChatModelVo;
--- a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/mcp/McpToolController.java
+++ b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/mcp/McpToolController.java
@@ -48,11 +48,11 @@ public class McpToolController extends BaseController {
     */
    @SaCheckPermission("mcp:tool:list")
    @GetMapping("/all")
-    public McpToolListResult listAll(
+    public R<McpToolListResult> listAll(
        @RequestParam(required = false) String keyword,
        @RequestParam(required = false) String type,
        @RequestParam(required = false) String status) {
-        return mcpToolService.listTools(keyword, type, status);
+        return R.ok(mcpToolService.listTools(keyword, type, status));
    }

    /**
--- a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/chat/impl/ChatServiceFacade.java
+++ b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/chat/impl/ChatServiceFacade.java
@@ -80,8 +80,8 @@ import org.ruoyi.service.chat.impl.memory.PersistentChatMemoryStore;
 import org.ruoyi.service.knowledge.IKnowledgeInfoService;
 import org.ruoyi.service.retrieval.KnowledgeRetrievalService;
 import org.ruoyi.service.knowledge.retriever.CustomVectorRetriever;
-import org.ruoyi.trace.RagTraceNodeTypes;
-import org.ruoyi.trace.RagTracePayloadBuilder;
+import org.ruoyi.argtrace.RagTraceNodeTypes;
+import org.ruoyi.argtrace.RagTracePayloadBuilder;
 import org.springframework.stereotype.Service;
 import org.springframework.web.servlet.mvc.method.annotation.SseEmitter;

@@ -348,7 +348,7 @@ public class ChatServiceFacade implements IChatService {
            .subAgents(skillsAgent, searchAgent, sqlAgent, chartGenerationAgent, echartsAgent, chitChatAgent)
            .supervisorContext("仅当请求是问候或简单闲聊、不需要任何数据、搜索、技能或图表时,才使用 chitChatAgent;"
                + "其余情况必须使用对应的专业 Agent")
-            .responseStrategy(SupervisorResponseStrategy.SUMMARY);
+            .responseStrategy(SupervisorResponseStrategy.LAST);
        SupervisorAgent supervisor = supervisorBuilder.build();

        // 知识库增强：智能体绑定了知识库时，对 supervisor 输入做一次 RAG 增强（全程唯一一次检索）
--- a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/retrieval/impl/KnowledgeRetrievalServiceImpl.java
+++ b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/retrieval/impl/KnowledgeRetrievalServiceImpl.java
@@ -21,8 +21,8 @@ import org.ruoyi.mapper.knowledge.KnowledgeFragmentMapper;
 import org.ruoyi.service.rerank.RerankModelService;
 import org.ruoyi.service.retrieval.KnowledgeRetrievalService;
 import org.ruoyi.service.vector.VectorStoreService;
-import org.ruoyi.trace.RagTraceNodeTypes;
-import org.ruoyi.trace.RagTracePayloadBuilder;
+import org.ruoyi.argtrace.RagTraceNodeTypes;
+import org.ruoyi.argtrace.RagTracePayloadBuilder;
 import org.springframework.stereotype.Service;

 import java.util.*;
--- a/ruoyi-modules/ruoyi-chat/src/test/java/org/ruoyi/trace/RagTracePayloadBuilderTest.java
+++ b/ruoyi-modules/ruoyi-chat/src/test/java/org/ruoyi/trace/RagTracePayloadBuilderTest.java
@@ -1,78 +0,0 @@
-package org.ruoyi.trace;
-
-import org.junit.jupiter.api.Test;
-import org.ruoyi.common.chat.domain.dto.request.ChatRequest;
-import org.ruoyi.common.chat.domain.vo.chat.ChatModelVo;
-import org.ruoyi.domain.bo.vector.QueryVectorBo;
-import org.ruoyi.domain.vo.knowledge.KnowledgeRetrievalVo;
-
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-class RagTracePayloadBuilderTest {
-
-    @Test
-    void chatRequestSummaryShouldHandleNullsAndAvoidPromptBody() {
-        ChatRequest request = new ChatRequest();
-        request.setSessionId(100L);
-        request.setModel("qwen-plus");
-        request.setKnowledgeId("200");
-        request.setContent("secret prompt body");
-
-        ChatModelVo model = new ChatModelVo();
-        model.setProviderCode("dashscope");
-        request.setChatModelVo(model);
-
-        String payload = RagTracePayloadBuilder.chatRequestSummary(request);
-
-        assertTrue(payload.contains("\"sessionId\":100"));
-        assertTrue(payload.contains("\"contentLength\":18"));
-        assertTrue(payload.contains("\"providerCode\":\"dashscope\""));
-        assertFalse(payload.contains("secret prompt body"));
-    }
-
-    @Test
-    void retrievalInputSummaryShouldUseSummaryOnly() {
-        QueryVectorBo query = new QueryVectorBo();
-        query.setKid("200");
-        query.setQuery("private retrieval query");
-        query.setMaxResults(5);
-        query.setEnableRerank(true);
-        query.setRerankModelName("gte-rerank");
-        query.setRerankTopN(null);
-
-        String payload = RagTracePayloadBuilder.retrievalInputSummary(query);
-
-        assertTrue(payload.contains("\"kid\":\"200\""));
-        assertTrue(payload.contains("\"queryLength\":23"));
-        assertTrue(payload.contains("\"enableRerank\":true"));
-        assertFalse(payload.contains("private retrieval query"));
-    }
-
-    @Test
-    void retrievalOutputSummaryShouldAvoidFragmentContent() {
-        KnowledgeRetrievalVo result = new KnowledgeRetrievalVo();
-        result.setId("fragment-1");
-        result.setDocId("doc-1");
-        result.setIdx(1);
-        result.setScore(0.85);
-        result.setContent("sensitive knowledge fragment");
-
-        String payload = RagTracePayloadBuilder.retrievalOutputSummary(List.of(result));
-
-        assertTrue(payload.contains("\"resultCount\":1"));
-        assertTrue(payload.contains("\"contentLength\":28"));
-        assertTrue(payload.contains("\"fragment-1\""));
-        assertFalse(payload.contains("sensitive knowledge fragment"));
-    }
-
-    @Test
-    void summariesShouldAcceptNullValuesWithoutMapOfNpe() {
-        assertTrue(RagTracePayloadBuilder.chatRequestSummary(null).contains("\"requestPresent\":false"));
-        assertTrue(RagTracePayloadBuilder.retrievalInputSummary(null).contains("\"queryPresent\":false"));
-        assertTrue(RagTracePayloadBuilder.retrievalOutputSummary(null).contains("\"resultCount\":0"));
-        assertTrue(RagTracePayloadBuilder.rerankInputSummary(null, 0, null).contains("\"candidateCount\":0"));
-    }
-}
Author	SHA1	Message	Date
ageerle	9d439d1dcf	refactor: move RAG trace classes to argtrace package and update SQL schema - Rename org.ruoyi.trace package to org.ruoyi.argtrace for RagTraceNodeTypes and RagTracePayloadBuilder; fix package declarations and update imports in ChatServiceFacade and KnowledgeRetrievalServiceImpl - Remove obsolete RagTracePayloadBuilderTest - Switch supervisor response strategy from SUMMARY to LAST in ChatServiceFacade - Refresh docs/script/sql/ruoyi-ai.sql with the latest full schema dump - Add live demo links (admin panel, user frontend, commercial edition) to README.md and README_ZH.md Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-08-04 17:44:39 +08:00
ageerle	0a08c489be	docs: remove redundant registry commands	2026-08-04 15:57:32 +08:00
ageerle	038e7725f9	docs: add prebuilt image deployment guide	2026-08-04 15:55:17 +08:00
ageerle	4ccf249663	docs: remove obsolete WeChat image	2026-08-04 15:50:51 +08:00
ageerle	1d5b01f77f	docs: remove obsolete Douyin image	2026-08-04 15:50:36 +08:00
ageerle	538dac3a46	docs: add Douyin tutorial QR code	2026-08-04 15:49:40 +08:00
ageerle	6c383dd9f5	fix: 修复智能体编辑时关联工具加载失败 (#320 )	2026-08-04 15:38:25 +08:00
ageerle	9ae49f8797	fix: allow frontend dependency builds in image workflow	2026-08-04 15:30:34 +08:00
ageerle	3c175ba28d	chore: sync pending project changes	2026-08-04 15:23:19 +08:00
ageerle	e34592c3d4	release: prepare v3.1.0	2026-08-04 15:18:57 +08:00