V4.12.3 document (#5600)

* doc

* doc

* perf: log

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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
     container_name: fastgpt-plugin
     restart: always
     networks:

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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
     container_name: fastgpt-plugin
     restart: always
     networks:

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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
     container_name: fastgpt-plugin
     restart: always
     networks:

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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
     container_name: fastgpt-plugin
     restart: always
     networks:

deploy/docker/yml.js

@@ -95,8 +95,8 @@ services:
 
   fastgpt:
     container_name: fastgpt
-    image: ghcr.io/labring/fastgpt:v4.12.2-fix # git
-    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.12.2-fix # 阿里云
+    image: ghcr.io/labring/fastgpt:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-sandbox:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.12.2 # 阿里云
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.12.3 # git
+    # 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: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.11 # 阿里云
+    image: ghcr.io/labring/fastgpt-plugin:v0.1.12 # git
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin:v0.1.12 # 阿里云
     container_name: fastgpt-plugin
     restart: always
     networks:

document/content/docs/upgrading/4-12/4123.mdx

 ---
-title: 'V4.12.3(进行中)'
-description: 'FastGPT V4.12.3 更新说明'
+title: '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 渲染等部分富文本交互。

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/4121.mdx": "2025-09-04T22:59:41+08:00",
-  "document/content/docs/upgrading/4-12/4122.mdx": "2025-09-04T22:59:41+08:00",
-  "document/content/docs/upgrading/4-12/4123.mdx": "2025-09-05T17:31:22+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-07T14:41:48+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-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",

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) => ({

projects/app/package.json

 {
   "name": "app",
-  "version": "4.12.2",
+  "version": "4.12.3",
   "private": false,
   "scripts": {
     "dev": "next dev",

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);