V4.12.3 document (#5600)

* doc * doc * perf: log

V4.12.3 document (#5600)
* doc * doc * perf: log
c4632a22 · Archer · GitHub · 3f9b0fa1 · c4632a22 · c4632a22
Commit c4632a22 authored Sep 07, 2025 by Archer Committed by GitHub Sep 07, 2025
10 changed files
--- a/deploy/docker/docker-compose-milvus.yml
+++ b/deploy/docker/docker-compose-milvus.yml
@@ -151,8 +151,8 @@ services:
  fastgpt:
    container_name: fastgpt
-    image: ghcr.io/labring/fastgpt:v4.12.2-fix # git
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.3 # 阿里云
    ports:
      - 3000:3000
    networks:
@@ -209,15 +209,15 @@ services:
      - ./config.json:/app/data/config.json
  sandbox:
    container_name: sandbox
-    image: ghcr.io/labring/fastgpt-sandbox:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.3 # 阿里云
    networks:
      - fastgpt
    restart: always
  fastgpt-mcp-server:
    container_name: fastgpt-mcp-server
-    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.3 # 阿里云
    ports:
      - 3005:3000
    networks:
@@ -226,8 +226,8 @@ services:
    environment:
      - FASTGPT_ENDPOINT=http://fastgpt:3000
  fastgpt-plugin:
-    image: ghcr.io/labring/fastgpt-plugin:v0.1.11 # git
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
    container_name: fastgpt-plugin
    restart: always
    networks:

--- a/deploy/docker/docker-compose-oceanbase/docker-compose.yml
+++ b/deploy/docker/docker-compose-oceanbase/docker-compose.yml
@@ -126,8 +126,8 @@ services:
  fastgpt:
    container_name: fastgpt
-    image: ghcr.io/labring/fastgpt:v4.12.2-fix # git
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.3 # 阿里云
    ports:
      - 3000:3000
    networks:
@@ -183,15 +183,15 @@ services:
      - ./config.json:/app/data/config.json
  sandbox:
    container_name: sandbox
-    image: ghcr.io/labring/fastgpt-sandbox:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.3 # 阿里云
    networks:
      - fastgpt
    restart: always
  fastgpt-mcp-server:
    container_name: fastgpt-mcp-server
-    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.3 # 阿里云
    ports:
      - 3005:3000
    networks:
@@ -200,8 +200,8 @@ services:
    environment:
      - FASTGPT_ENDPOINT=http://fastgpt:3000
  fastgpt-plugin:
-    image: ghcr.io/labring/fastgpt-plugin:v0.1.11 # git
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
    container_name: fastgpt-plugin
    restart: always
    networks:

--- a/deploy/docker/docker-compose-pgvector.yml
+++ b/deploy/docker/docker-compose-pgvector.yml
@@ -112,8 +112,8 @@ services:
  fastgpt:
    container_name: fastgpt
-    image: ghcr.io/labring/fastgpt:v4.12.2-fix # git
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.3 # 阿里云
    ports:
      - 3000:3000
    networks:
@@ -169,15 +169,15 @@ services:
      - ./config.json:/app/data/config.json
  sandbox:
    container_name: sandbox
-    image: ghcr.io/labring/fastgpt-sandbox:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.3 # 阿里云
    networks:
      - fastgpt
    restart: always
  fastgpt-mcp-server:
    container_name: fastgpt-mcp-server
-    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.3 # 阿里云
    ports:
      - 3005:3000
    networks:
@@ -186,8 +186,8 @@ services:
    environment:
      - FASTGPT_ENDPOINT=http://fastgpt:3000
  fastgpt-plugin:
-    image: ghcr.io/labring/fastgpt-plugin:v0.1.11 # git
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
    container_name: fastgpt-plugin
    restart: always
    networks:

--- a/deploy/docker/docker-compose-zilliz.yml
+++ b/deploy/docker/docker-compose-zilliz.yml
@@ -92,8 +92,8 @@ services:
  fastgpt:
    container_name: fastgpt
-    image: ghcr.io/labring/fastgpt:v4.12.2-fix # git
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.3 # 阿里云
    ports:
      - 3000:3000
    networks:
@@ -151,15 +151,15 @@ services:
      - ./config.json:/app/data/config.json
  sandbox:
    container_name: sandbox
-    image: ghcr.io/labring/fastgpt-sandbox:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.3 # 阿里云
    networks:
      - fastgpt
    restart: always
  fastgpt-mcp-server:
    container_name: fastgpt-mcp-server
-    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.3 # 阿里云
    ports:
      - 3005:3000
    networks:
@@ -168,8 +168,8 @@ services:
    environment:
      - FASTGPT_ENDPOINT=http://fastgpt:3000
  fastgpt-plugin:
-    image: ghcr.io/labring/fastgpt-plugin:v0.1.11 # git
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
    container_name: fastgpt-plugin
    restart: always
    networks:

--- a/deploy/docker/yml.js
+++ b/deploy/docker/yml.js
@@ -95,8 +95,8 @@ services:
  fastgpt:
    container_name: fastgpt
-    image: ghcr.io/labring/fastgpt:v4.12.2-fix # git
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.3 # 阿里云
    ports:
      - 3000:3000
    networks:
@@ -152,15 +152,15 @@ services:
      - ./config.json:/app/data/config.json
  sandbox:
    container_name: sandbox
-    image: ghcr.io/labring/fastgpt-sandbox:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.3 # 阿里云
    networks:
      - fastgpt
    restart: always
  fastgpt-mcp-server:
    container_name: fastgpt-mcp-server
-    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.2 # git
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.3 # 阿里云
    ports:
      - 3005:3000
    networks:
@@ -169,8 +169,8 @@ services:
    environment:
      - FASTGPT_ENDPOINT=http://fastgpt:3000
  fastgpt-plugin:
-    image: ghcr.io/labring/fastgpt-plugin:v0.1.11 # git
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
    container_name: fastgpt-plugin
    restart: always
    networks:

--- a/document/content/docs/upgrading/4-12/4123.mdx
+++ b/document/content/docs/upgrading/4-12/4123.mdx
 ---
-title: 'V4.12.3(进行中)'
+title: 'V4.12.3'
-description: 'FastGPT V4.12.3 更新说明'
+description: 'FastGPT V4.12.3 更新说明, 发布于 2025-9-8'
 ---
+## 更新指南
+### 1. 更新镜像：
+- 更新 FastGPT 镜像tag: v4.12.3
+- 更新 FastGPT 商业版镜像tag: v4.12.3
+- 更新 fastgpt-plugin 镜像 tag: v0.1.12
+- mcp_server 无需更新
+- Sandbox 无需更新
+- AIProxy 无需更新
 ## 🚀 新增内容
 1. 提示词编辑器支持列表、tab 渲染等部分富文本交互。

--- a/document/data/doc-last-modified.json
+++ b/document/data/doc-last-modified.json
@@ -102,10 +102,10 @@
  "document/content/docs/upgrading/4-10/4101.mdx": "2025-08-02T19:38:37+08:00",
  "document/content/docs/upgrading/4-11/4110.mdx": "2025-08-05T23:20:39+08:00",
  "document/content/docs/upgrading/4-11/4111.mdx": "2025-08-07T22:49:09+08:00",
-  "document/content/docs/upgrading/4-12/4120.mdx": "2025-09-04T22:59:41+08:00",
+  "document/content/docs/upgrading/4-12/4120.mdx": "2025-09-07T14:41:48+08:00",
-  "document/content/docs/upgrading/4-12/4121.mdx": "2025-09-04T22:59:41+08:00",
+  "document/content/docs/upgrading/4-12/4121.mdx": "2025-09-07T14:41:48+08:00",
-  "document/content/docs/upgrading/4-12/4122.mdx": "2025-09-04T22:59:41+08:00",
+  "document/content/docs/upgrading/4-12/4122.mdx": "2025-09-07T14:41:48+08:00",
-  "document/content/docs/upgrading/4-12/4123.mdx": "2025-09-05T17:31:22+08:00",
+  "document/content/docs/upgrading/4-12/4123.mdx": "2025-09-07T14:41:48+08:00",
  "document/content/docs/upgrading/4-8/40.mdx": "2025-08-02T19:38:37+08:00",
  "document/content/docs/upgrading/4-8/41.mdx": "2025-08-02T19:38:37+08:00",
  "document/content/docs/upgrading/4-8/42.mdx": "2025-08-02T19:38:37+08:00",

--- a/packages/service/core/app/mcp.ts
+++ b/packages/service/core/app/mcp.ts
@@ -8,6 +8,7 @@ import { retryFn } from '@fastgpt/global/common/system/utils';
 import { PluginSourceEnum } from '@fastgpt/global/core/app/plugin/constants';
 import { MongoApp } from './schema';
 import type { McpToolDataType } from '@fastgpt/global/core/app/mcpTools/type';
+import { UserError } from '@fastgpt/global/common/error/utils';
 export class MCPClient {
  private client: Client;
@@ -76,7 +77,7 @@ export class MCPClient {
      const response = await client.listTools();
      if (!Array.isArray(response.tools)) {
-        return Promise.reject('[MCP Client] Get tools response is not an array');
+        return Promise.reject(new UserError('[MCP Client] Get tools response is not an array'));
      }
      const tools = response.tools.map((tool) => ({

--- a/projects/app/package.json
+++ b/projects/app/package.json
 {
  "name": "app",
-  "version": "4.12.2",
+  "version": "4.12.3",
  "private": false,
  "scripts": {
    "dev": "next dev",

--- a/projects/app/src/pages/api/support/user/account/preLogin.ts
+++ b/projects/app/src/pages/api/support/user/account/preLogin.ts
@@ -4,6 +4,7 @@ import { UserAuthTypeEnum } from '@fastgpt/global/support/user/auth/constants';
 import { getNanoid } from '@fastgpt/global/common/string/tools';
 import { addSeconds } from 'date-fns';
 import { addAuthCode } from '@fastgpt/service/support/user/auth/controller';
+import { UserError } from '@fastgpt/global/common/error/utils';
 export type preLoginQuery = {
  username: string;
@@ -20,7 +21,7 @@ async function handler(
  const { username } = req.query;
  if (!username) {
-    return Promise.reject('username is required');
+    return Promise.reject(new UserError('username is required'));
  }
  const code = getNanoid(6);