4.11.2 dev (#5368)

* 4.11.2 dev (#103) * update document * update doc * update doc * doc img * action * fix action * fix: action * fix: action * perf: action * doc * perf: action
2025-10-16 16:04:34 +00:00 · 2025-08-02 19:38:37 +08:00
parent 1014f349de
commit 109bdbe9db
137 changed files with 632 additions and 570 deletions
--- a/document/content/docs/upgrading/4-9/490.mdx
+++ b/document/content/docs/upgrading/4-9/490.mdx
@@ -0,0 +1,187 @@
+---
+title: V4.9.0(包含升级脚本)
+description: FastGPT V4.9.0 更新说明
+---
+
+
+## 更新指南
+
+### 1. 做好数据库备份
+
+### 2. 更新镜像和 PG 容器
+
+- 更新 FastGPT 镜像 tag: v4.9.0
+- 更新 FastGPT 商业版镜像 tag: v4.9.0
+- Sandbox 镜像，可以不更新
+- 更新 PG 容器为 v0.8.0-pg15, 可以查看[最新的 yml](https://raw.githubusercontent.com/labring/FastGPT/main/deploy/docker/docker-compose-pgvector.yml)
+
+### 3. 替换 OneAPI（可选）
+
+如果需要使用 [AI Proxy](https://github.com/labring/aiproxy) 替换 OneAPI 的用户可执行该步骤。
+
+#### 1. 修改 yml 文件
+
+参考[最新的 yml](https://raw.githubusercontent.com/labring/FastGPT/main/deploy/docker/docker-compose-pgvector.yml) 文件。里面已移除 OneAPI 并添加了 AIProxy配置。包含一个服务和一个 PgSQL 数据库。将 `aiproxy` 的配置`追加`到 OneAPI 的配置后面（先不要删除 OneAPI，有一个初始化会自动同步 OneAPI 的配置）
+
+<details>
+<summary>AI Proxy Yml 配置</summary>
+
+```
+  # AI Proxy
+  aiproxy:
+    image: 'ghcr.io/labring/aiproxy:latest'
+    container_name: aiproxy
+    restart: unless-stopped
+    depends_on:
+      aiproxy_pg:
+        condition: service_healthy
+    networks:
+      - fastgpt
+    environment:
+      # 对应 fastgpt 里的AIPROXY_API_TOKEN
+      - ADMIN_KEY=aiproxy
+      # 错误日志详情保存时间（小时）
+      - LOG_DETAIL_STORAGE_HOURS=1
+      # 数据库连接地址
+      - SQL_DSN=postgres://postgres:aiproxy@aiproxy_pg:5432/aiproxy
+      # 最大重试次数
+      - RETRY_TIMES=3
+      # 不需要计费
+      - BILLING_ENABLED=false
+      # 不需要严格检测模型
+      - DISABLE_MODEL_CONFIG=true
+    healthcheck:
+      test: ['CMD', 'curl', '-f', 'http://localhost:3000/api/status']
+      interval: 5s
+      timeout: 5s
+      retries: 10
+  aiproxy_pg:
+    image: pgvector/pgvector:0.8.0-pg15 # docker hub
+    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/pgvector:v0.8.0-pg15 # 阿里云
+    restart: unless-stopped
+    container_name: aiproxy_pg
+    volumes:
+      - ./aiproxy_pg:/var/lib/postgresql/data
+    networks:
+      - fastgpt
+    environment:
+      TZ: Asia/Shanghai
+      POSTGRES_USER: postgres
+      POSTGRES_DB: aiproxy
+      POSTGRES_PASSWORD: aiproxy
+    healthcheck:
+      test: ['CMD', 'pg_isready', '-U', 'postgres', '-d', 'aiproxy']
+      interval: 5s
+      timeout: 5s
+      retries: 10
+```
+
+</details>
+
+#### 2. 增加 FastGPT 环境变量：
+
+修改 yml 文件中，fastgpt 容器的环境变量：
+
+```
+# AI Proxy 的地址，如果配了该地址，优先使用
+- AIPROXY_API_ENDPOINT=http://aiproxy:3000
+# AI Proxy 的 Admin Token，与 AI Proxy 中的环境变量 ADMIN_KEY
+- AIPROXY_API_TOKEN=aiproxy
+```
+
+#### 3. 重载服务
+
+`docker-compose down` 停止服务，然后 `docker-compose up -d` 启动服务，此时会追加 `aiproxy` 服务，并修改 FastGPT 的配置。
+
+#### 4. 执行OneAPI迁移AI proxy脚本
+
+- 可联网方案:
+
+```bash
+# 进入 aiproxy 容器
+docker exec -it aiproxy sh
+# 安装 curl
+apk add curl
+# 执行脚本
+curl --location --request POST 'http://localhost:3000/api/channels/import/oneapi' \
+--header 'Authorization: Bearer aiproxy' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+    "dsn": "mysql://root:oneapimmysql@tcp(mysql:3306)/oneapi"
+}'
+# 返回 {"data":[],"success":true} 代表成功
+```
+
+- 无法联网时，可打开`aiproxy`的外网暴露端口，然后在本地执行脚本。
+
+aiProxy 暴露端口：3003:3000，修改后重新 `docker-compose up -d` 启动服务。
+
+```bash
+# 在终端执行脚本
+curl --location --request POST 'http://localhost:3003/api/channels/import/oneapi' \
+--header 'Authorization: Bearer aiproxy' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+    "dsn": "mysql://root:oneapimmysql@tcp(mysql:3306)/oneapi"
+}'
+# 返回 {"data":[],"success":true} 代表成功
+```
+
+- 如果不熟悉 docker 操作，建议不要走脚本迁移，直接删除 OneAPI 所有内容，然后手动重新添加渠道。
+
+#### 5. 进入 FastGPT 检查`AI Proxy` 服务是否正常启动。
+
+登录 root 账号后，在`账号-模型提供商`页面，可以看到多出了`模型渠道`和`调用日志`两个选项，打开模型渠道，可以看到之前 OneAPI 的渠道，说明迁移完成，此时可以手动再检查下渠道是否正常。
+
+#### 6. 删除 OneAPI 服务
+
+```bash
+# 停止服务，或者针对性停止 OneAPI 和其 Mysql
+docker-compose down
+# yml 文件中删除 OneAPI 和其 Mysql 依赖
+# 重启服务
+docker-compose up -d
+```
+
+### 4. 运行 FastGPT 升级脚本
+
+从任意终端，发起 1 个 HTTP 请求。其中 ``{{rootkey}}`` 替换成环境变量里的 `rootkey`；``{{host}}`` 替换成**FastGPT 域名**。
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv490' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+**脚本功能**
+
+1. 升级 PG Vector 插件版本
+2. 全量更新知识库集合字段。
+3. 全量更新知识库数据中，index 的 type 类型。（时间较长，最后可能提示 timeout，可忽略，数据库不崩都会一直增量执行）
+
+## 兼容 & 弃用
+
+1. 弃用 - 之前私有化部署的自定义文件解析方案，请同步更新到最新的配置方案。[点击查看 PDF 增强解析配置](/docs/development/configuration/#使用-doc2x-解析-pdf-文件)
+2. 弃用 - 弃用旧版本地文件上传 API：/api/core/dataset/collection/create/file（以前仅商业版可用的 API，该接口已放切换成：/api/core/dataset/collection/create/localFile）
+3. 停止维护，即将弃用 - 外部文件库相关 API，可通过 API 文件库替代。
+4. API更新 - 上传文件至知识库、创建连接集合、API 文件库、推送分块数据等带有 `trainingType` 字段的接口，`trainingType`字段未来仅支持`chunk`和`QA`两种模式。增强索引模式将设置单独字段：`autoIndexes`，目前仍有适配旧版`trainingType=auto`代码，但请尽快变更成新接口类型。具体可见：[知识库 OpenAPI 文档](/docs/development/openapi/dataset.md)
+
+## 🚀 新增内容
+
+1. PDF增强解析交互添加到页面上。同时内嵌 Doc2x 服务，可直接使用 Doc2x 服务解析 PDF 文件。
+2. 图片自动标注，同时修改知识库文件上传部分数据逻辑和交互。
+3. pg vector 插件升级 0.8.0 版本，引入迭代搜索，减少部分数据无法被检索的情况。
+4. 新增 qwen-qwq 系列模型配置。
+
+## ⚙️ 优化
+
+1. 知识库数据不再限制索引数量，可无限自定义。同时可自动更新输入文本的索引，不影响自定义索引。
+2. Markdown 解析，增加链接后中文标点符号检测，增加空格。
+3. Prompt 模式工具调用，支持思考模型。同时优化其格式检测，减少空输出的概率。
+4. Mongo 文件读取流合并，减少计算量。同时优化存储 chunks，极大提高大文件读取速度。50M PDF 读取时间提高 3 倍。
+5. HTTP Body 适配，增加对字符串对象的适配。
+
+## 🐛 修复
+
+1. 增加网页抓取安全链接校验。
+2. 批量运行时，全局变量未进一步传递到下一次运行中，导致最终变量更新错误。
--- a/document/content/docs/upgrading/4-9/491.mdx
+++ b/document/content/docs/upgrading/4-9/491.mdx
@@ -0,0 +1,61 @@
+---
+title: V4.9.1
+description: FastGPT V4.9.1 更新说明
+---
+
+## 更新指南
+
+### 1. 做好数据库备份
+
+### 2. 更新镜像
+
+- 更新 FastGPT 镜像 tag: v4.9.1-fix2
+- 更新 FastGPT 商业版镜像 tag: v4.9.1-fix2
+- Sandbox 镜像，可以不更新
+- AIProxy 镜像修改为: registry.cn-hangzhou.aliyuncs.com/labring/aiproxy:v0.1.3
+
+### 3. 执行升级脚本
+
+从任意终端，发起 1 个 HTTP 请求。其中 `{{rootkey}}` 替换成环境变量里的 `rootkey`；`{{host}}` 替换成**FastGPT 域名**。
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv491' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+**脚本功能**
+
+重新使用最新的 jieba 分词库进行分词处理。时间较长，可以从日志里查看进度。
+
+## 🚀 新增内容
+
+1. 商业版支持单团队模式，更好的管理内部成员。
+2. 知识库分块阅读器。
+3. API 知识库支持 PDF 增强解析。
+4. 邀请团队成员，改为邀请链接模式。
+5. 支持混合检索权重设置。
+6. 支持重排模型选择和权重设置，同时调整了知识库搜索权重计算方式，改成 搜索权重 + 重排权重，而不是向量检索权重+全文检索权重+重排权重。会对检索结果有一定影响，可以通过调整相关权重来进行数据适配。
+
+## ⚙️ 优化
+
+1. 知识库数据输入框交互
+2. 应用拉取绑定知识库数据交由后端处理。
+3. 增加依赖包安全版本检测，并升级部分依赖包。
+4. 模型测试代码。
+5. 优化思考过程解析逻辑：只要配置了模型支持思考，均会解析 `<think>` 标签，不会因为对话时，关闭思考而不解析。
+6. 载入最新 jieba 分词库，增强全文检索分词效果。
+
+## 🐛 修复
+
+1. 最大响应 tokens 提示显示错误的问题。
+2. HTTP Node 中，字符串包含换行符时，会解析失败。
+3. 知识库问题优化中，未传递历史记录。
+4. 错误提示翻译缺失。
+5. 内容提取节点，array 类型 schema 错误。
+6. 模型渠道测试时，实际未指定渠道测试。
+7. 新增自定义模型时，会把默认模型字段也保存，导致默认模型误判。
+8. 修复 promp 模式工具调用，未判空思考链，导致 UI 错误展示。
+9. 编辑应用信息导致头像丢失。
+10. 分享链接标题会被刷新掉。
+11. 计算 parentPath 时，存在鉴权失败清空。
--- a/document/content/docs/upgrading/4-9/4910.mdx
+++ b/document/content/docs/upgrading/4-9/4910.mdx
@@ -0,0 +1,46 @@
+---
+title: V4.9.10
+description: FastGPT V4.9.10 更新说明
+---
+
+## 升级指南
+
+重要提示：本次更新会重新构建全文索引，构建期间，全文检索结果会为空，4c16g 700 万组全文索引大致消耗 25 分钟。如需无缝升级，需自行做表同步工程。
+
+### 1. 做好数据备份
+
+### 2. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.10-fix2
+- 更新 FastGPT 商业版镜像 tag: v4.9.10-fix2
+- mcp_server 无需更新
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+## 🚀 新增内容
+
+1. 支持 PG 设置`systemEnv.hnswMaxScanTuples`参数，提高迭代搜索的数据总量。
+2. 知识库预处理参数增加 “分块条件”，可控制某些情况下不进行分块处理。
+3. 知识库预处理参数增加 “段落优先” 模式，可控制最大段落深度。原“长度优先”模式，不再内嵌段落优先逻辑。
+4. 工作流调整为单向接入和接出，支持快速的添加下一步节点。
+5. 开放飞书和语雀知识库到开源版。
+6. gemini 和 claude 最新模型预设。
+
+## ⚙️ 优化
+
+1. LLM stream调用，默认超时调大。
+2. 部分确认交互优化。
+3. 纠正原先知识库的“表格数据集”名称，改成“备份导入”。同时支持知识库索引的导出和导入。
+4. 工作流知识库引用上限，如果工作流中没有相关 AI 节点，则交互模式改成纯手动输入，并且上限为 1000万。
+5. 语音输入，移动端判断逻辑，准确判断是否为手机，而不是小屏。
+6. 优化上下文截取算法，至少保证留下一组 Human 信息。
+
+## 🐛 修复
+
+1. 全文检索多知识库时排序得分排序不正确。
+2. 流响应捕获 finish_reason 可能不正确。
+3. 工具调用模式，未保存思考输出。
+4. 知识库 indexSize 参数未生效。
+5. 工作流嵌套 2 层后，获取预览引用、上下文不正确。
+6. xlsx 转成 Markdown 时候，前面会多出一个空格。
+7. 读取 Markdown 文件时，Base64 图片未进行额外抓换保存。
--- a/document/content/docs/upgrading/4-9/4911.mdx
+++ b/document/content/docs/upgrading/4-9/4911.mdx
@@ -0,0 +1,54 @@
+---
+title: V4.9.11(包含升级脚本)
+description: FastGPT V4.9.11 更新说明
+---
+
+## 更新指南
+
+### 1. 更新镜像：
+
+- 更新 FastGPT 镜像 tag: v4.9.11
+- 更新 FastGPT 商业版镜像 tag: v4.9.11
+- mcp_server 无需更新
+- 更新 Sandbox 镜像 tag: v4.9.11
+- AIProxy 无需更新
+
+### 2. 执行升级脚本
+
+该脚本仅需商业版用户执行。
+
+从任意终端，发起 1 个 HTTP 请求。其中 `{{rootkey}}` 替换成环境变量里的 `rootkey`；`{{host}}` 替换成**FastGPT 域名**。
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv4911' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+**脚本功能**
+
+1. 移动第三方知识库 API 配置。
+
+## 🚀 新增内容
+
+1. 商业版支持图片知识库。
+2. 工作流中增加节点搜索功能。
+3. 工作流中，子流程版本控制，可选择“保持最新版本”，无需手动更新。
+4. 增加更多审计操作日志。
+5. 知识库增加文档解析异步队列，导入文档时，无需等待文档解析完毕才进行导入。
+6. 第三方知识库开发文档, [点击查看](/docs/introduction/guide/knowledge_base/third_dataset/)
+
+## ⚙️ 优化
+
+1. 原文缓存改用 gridfs 存储，提高上限。
+2. 增加知识库模板导入选项。
+
+## 🐛 修复
+
+1. 工作流中，管理员声明的全局系统工具，无法进行版本管理。
+2. 工具调用节点前，有交互节点时，上下文异常。
+3. 修复备份导入，小于 1000 字时，无法分块问题。
+4. 自定义 PDF 解析，无法保存 base64 图片。
+5. 非流请求，未进行 CITE 标记替换。
+6. Python 沙盒存在隐藏风险。
+7. curl 导入插件缺失确认按键
--- a/document/content/docs/upgrading/4-9/4912.mdx
+++ b/document/content/docs/upgrading/4-9/4912.mdx
@@ -0,0 +1,49 @@
+---
+title: V4.9.12
+description: FastGPT V4.9.12 更新说明
+---
+
+## 更新指南
+
+### 1. 更新环境变量
+
+在 `fastgpt`和`fastgpt-pro`镜像环境变量中加入: `AES256_SECRET_KEY=` 变量，用于密钥加密。
+
+### 2. 更新镜像：
+
+- 更新 FastGPT 镜像 tag: v4.9.12
+- 更新 FastGPT 商业版镜像 tag: v4.9.12
+- mcp_server 无需更新
+- Sandbox 无需更新
+- 更新 AIProxy 镜像 tag: v0.2.2
+
+## 🚀 新增内容
+
+1. AI proxy 监控完善，支持以图表/表格形式查看模型调用和性能情况。
+2. HTTP 节点和 MCP 支持单独“鉴权配置”，鉴权配置明文不会二次返回客户端，以保障数据安全。
+3. 问题分类和内容提取，提示词中自动加入上一轮结果进行额外引导。
+4. 判断器支持变量引用。
+5. 商业版支持知识库分块时，LLM 进行自动分段识别。
+6. Admin 管理员数据看板。
+7. 豆包 1.6 系列模型，更新 qwen 模型配置。
+
+## ⚙️ 优化
+
+1. 密码校验时，增加更多的特殊字符
+2. 后端全量计算知识库 chunk 参数，避免自动模式下部分参数未正确使用默认值。
+3. 将文本分块移至 worker 线程，避免阻塞。
+4. 展示更多套餐用量信息。
+5. 优化输入框样式，桌面和移动端的语音输入样式更新。
+6. MCP 工具调用，使用 Raw schema 进行工具调用，保障完整性。
+7. 删除知识库文件时，如果文件不存在，不会阻断删除。
+8. 升级 MCP SDK，兼容最新的 HTTPStreamable。
+9. 语雀文档库，递归获取文档类型目录下的数据。
+
+## 🐛 修复
+
+1. 自定义问答提取提示词被覆盖。
+2. 模板导入时，存在空 indexes 时，导致数据插入失败。
+3. 登录页可能存在的 XSS 攻击。
+4. 输入框语音输入时候会丢失文件列表的问题。
+5. 知识库文档中图片 TTL 字段未清除，导致图片过期。
+6. MCP 工具存储时，未转义 int 类型数据。
--- a/document/content/docs/upgrading/4-9/4913.mdx
+++ b/document/content/docs/upgrading/4-9/4913.mdx
@@ -0,0 +1,31 @@
+---
+title: V4.9.13
+description: FastGPT V4.9.13 更新说明
+---
+
+## 更新指南
+
+### 1. 更新镜像：
+
+- 更新 FastGPT 镜像 tag: v4.9.13
+- 更新 FastGPT 商业版镜像 tag: v4.9.13
+- mcp_server 无需更新
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+
+## 🚀 新增内容
+
+1. 套餐缓存，减少 MongoDB 查询次数。
+
+## ⚙️ 优化
+
+1. 所有 NodeId 调整随机值生成，避免首字母数字开头。
+2. 知识库集合搜索，支持嵌套搜索。
+
+## 🐛 修复
+
+1. 对话日志，日期范围选择问题。
+2. API 调用时，传入的 system 提示词可能会重复。
+3. AI 对话/工具调用，未选择文件链接时，也会从历史记录读取文件。
+4. 手动更新知识库索引时，错误的删除旧索引，导致手动索引无效。
--- a/document/content/docs/upgrading/4-9/4914.mdx
+++ b/document/content/docs/upgrading/4-9/4914.mdx
@@ -0,0 +1,38 @@
+---
+title: V4.9.14
+description: FastGPT V4.9.14 更新说明
+---
+
+## 更新指南
+
+### 1. 更新镜像：
+
+- 更新 FastGPT 镜像 tag: v4.9.14
+- 更新 FastGPT 商业版镜像 tag: v4.9.14
+- mcp_server 无需更新
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+## 🚀 新增内容
+
+1. 知识库导入，支持配置：自动将文件名加入系统索引中。
+2. Admin 端审计日志。
+
+## ⚙️ 优化
+
+1. 统一知识库训练队列代码逻辑。
+2. 输入框 UX。
+3. 图片知识库自动去除介绍中的换行，避免模型输出换行导致无法显示图片。
+4. 图片索引过程会单独描述图片内容，并在检索后会将图片描述赋予检索结果，使语言模型也可以对图片进行理解。
+5. 对于 MCP Schema 中，缺少`properties`属性的值，进行自动补全，避免部分模型报错。
+6. 对 JSON 导入模板可能的报错进行捕获。
+7. 过滤 CSV 导出时可能存在的危险字符串。
+8. 添加安全请求头。
+9. 修改密码，强制其他登录端失效。
+10. Cite 引用展示优化，识别前置的 url 并自动加空格。
+
+## 🐛 修复
+
+1. 知识库数据输入，识别 QA 模式错误。
+2. 知识库标签条件冲突。
+3. 对话日志点赞点踩统计。
--- a/document/content/docs/upgrading/4-9/492.mdx
+++ b/document/content/docs/upgrading/4-9/492.mdx
@@ -0,0 +1,71 @@
+---
+title: V4.9.2
+description: FastGPT V4.9.2 更新说明
+---
+## 更新指南
+
+可直接升级v4.9.3，v4.9.2存在一个工作流数据类型转化错误。
+
+### 1. 做好数据库备份
+
+### 2. SSO 迁移
+
+使用了 SSO 或成员同步的商业版用户，并且是对接`钉钉`、`企微`的，需要迁移已有的 SSO 相关配置: 
+
+参考：[SSO & 外部成员同步](/docs/introduction/guide/admin/sso)中的配置进行`sso-service`的部署和配置。
+
+1. 先将原商业版后台中的相关配置项复制备份出来（以企微为例，将 AppId, Secret 等复制出来）再进行镜像升级。
+2. 参考上述文档，部署 SSO 服务，配置相关的环境变量
+3. 如果原先使用企微组织架构同步的用户，升级完镜像后，需要在商业版后台切换团队模式为“同步模式”
+
+### 3. 配置参数变更
+
+修改`config.json`文件中`systemEnv.pgHNSWEfSearch`参数名，改成`hnswEfSearch`。  
+商业版用户升级镜像后，直接在后台`系统配置-基础配置`中进行变更。
+
+### 4. 更新镜像
+
+- 更新 FastGPT 镜像 tag: v4.9.2
+- 更新 FastGPT 商业版镜像 tag: v4.9.2
+- Sandbox 镜像，可以不更新
+- AIProxy 镜像修改为: registry.cn-hangzhou.aliyuncs.com/labring/aiproxy:v0.1.4
+
+## 重要更新
+
+- 知识库导入数据 API 变更，增加`chunkSettingMode`,`chunkSplitMode`,`indexSize`可选参数，具体可参考 [知识库导入数据 API](/docs/development/openapi/dataset) 文档。
+
+## 🚀 新增内容
+
+1. 知识库分块优化：支持单独配置分块大小和索引大小，允许进行超大分块，以更大的输入 Tokens 换取完整分块。
+2. 知识库分块增加自定义分隔符预设值，同时支持自定义换行符分割。
+3. 外部变量改名：自定义变量。 并且支持在测试时调试，在分享链接中，该变量直接隐藏。
+4. 集合同步时，支持同步修改标题。
+5. 团队成员管理重构，抽离主流 IM SSO（企微、飞书、钉钉），并支持通过自定义 SSO 接入 FastGPT。同时完善与外部系统的成员同步。 
+6. 支持 `oceanbase` 向量数据库。填写环境变量`OCEANBASE_URL`即可。
+7. 基于 mistral-ocr 的 PDF 解析示例。
+8. 基于 miner-u 的 PDF 解析示例。
+
+## ⚙️ 优化
+
+1. 导出对话日志时，支持导出成员名。
+2. 邀请链接交互。
+3. 无 SSL 证书时复制失败，会提示弹窗用于手动复制。
+4. FastGPT 未内置 ai proxy 渠道时，也能正常展示其名称。
+5. 升级 nextjs 版本至 14.2.25。
+6. 工作流节点数组字符串类型，自动适配 string 输入。
+7. 工作流节点数组类型，自动进行 JSON parse 解析 string 输入。
+8. AI proxy 日志优化，去除重试失败的日志，仅保留最后一份错误日志。
+9. 个人信息和通知展示优化。
+10. 模型测试 loading 动画优化。
+11. 分块算法小调整：  
+  * 跨处理符号之间连续性更强。  
+  * 代码块分割时，用 LLM 模型上下文作为分块大小，尽可能保证代码块完整性。
+  * 表格分割时，用 LLM 模型上下文作为分块大小，尽可能保证表格完整性。
+
+## 🐛 修复
+
+1. 飞书和语雀知识库无法同步。
+2. 渠道测试时，如果配置了模型自定义请求地址，会走自定义请求地址，而不是渠道请求地址。
+3. 语音识别模型测试未启用的模型时，无法正常测试。
+4. 管理员配置系统插件时，如果插件包含其他系统应用，无法正常鉴权。
+5. 移除 TTS 自定义请求地址时，必须需要填 requestAuth 字段。
--- a/document/content/docs/upgrading/4-9/493.mdx
+++ b/document/content/docs/upgrading/4-9/493.mdx
@@ -0,0 +1,25 @@
+---
+title: V4.9.3
+description: FastGPT V4.9.3 更新说明
+---
+
+## 更新指南
+
+### 1. 做好数据库备份
+
+### 2. 更新镜像
+
+- 更新 FastGPT 镜像 tag: v4.9.3
+- 更新 FastGPT 商业版镜像 tag: v4.9.3
+- Sandbox 镜像tag: v4.9.3
+- AIProxy 镜像tag: v0.1.5
+
+
+## 🚀 新增内容
+
+1. 工作流 debug 模式支持交互节点。
+2. 代码运行支持 Python3 代码。
+
+## 🐛 修复
+
+1. 工作流格式转化异常。
--- a/document/content/docs/upgrading/4-9/494.mdx
+++ b/document/content/docs/upgrading/4-9/494.mdx
@@ -0,0 +1,62 @@
+---
+title: V4.9.4
+description: FastGPT V4.9.4 更新说明
+---
+
+## 升级指南
+
+### 1. 做好数据备份
+
+### 2. 安装 Redis
+
+* docker 部署的用户，参考最新的 `docker-compose.yml` 文件增加 Redis 配置。增加一个 redis 容器，并配置`fastgpt`,`fastgpt-pro`的环境变量，增加 `REDIS_URL` 环境变量。
+* Sealos 部署的用户，在数据库里新建一个`redis`数据库，并复制`内网地址的 connection` 作为 `redis` 的链接串。然后配置`fastgpt`,`fastgpt-pro`的环境变量，增加 `REDIS_URL` 环境变量。
+
+| | | |
+| --- | --- |  --- |
+| ![](/imgs/sealos-redis1.png) | ![](/imgs/sealos-redis2.png) |  ![](/imgs/sealos-redis3.png) |
+
+### 3. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.4
+- 更新 FastGPT 商业版镜像 tag: v4.9.4
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+### 4. 执行升级脚本
+
+该脚本仅需商业版用户执行。
+
+从任意终端，发起 1 个 HTTP 请求。其中 `{{rootkey}}` 替换成环境变量里的 `rootkey`；`{{host}}` 替换成**FastGPT 域名**:
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv494' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+**脚本功能**
+
+1. 更新站点同步定时器
+
+## 🚀 新增内容
+
+1. 集合数据训练状态展示
+2. SMTP 发送邮件插件
+3. BullMQ 消息队列。
+4. 利用 redis 进行部分数据缓存。
+5. 站点同步支持配置训练参数和增量同步。
+6. AI 对话/工具调用，增加返回模型 finish_reason 字段，便于追踪模型输出中断原因。
+7. 移动端语音输入交互调整
+
+## ⚙️ 优化
+
+1. Admin 模板渲染调整。
+2. 支持环境变量配置对话文件过期时间。
+3. MongoDB log 库可独立部署。
+
+## 🐛 修复
+
+1. 搜索应用/知识库时，无法点击目录进入下一层。
+2. 重新训练时，参数未成功初始化。
+3. package/service 部分请求在多 app 中不一致。
--- a/document/content/docs/upgrading/4-9/495.mdx
+++ b/document/content/docs/upgrading/4-9/495.mdx
@@ -0,0 +1,35 @@
+---
+title: V4.9.5
+description: FastGPT V4.9.5 更新说明
+---
+
+## 升级指南
+### 1. 做好数据备份
+
+### 2. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.5
+- 更新 FastGPT 商业版镜像 tag: v4.9.5
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+## 🚀 新增内容
+
+1. 团队成员权限细分，可分别控制是否可创建在根目录应用/知识库以及 API Key
+2. 支持交互节点在嵌套工作流中使用。
+3. 团队成员操作日志。
+4. 用户输入节点支持多选框。
+
+## ⚙️ 优化
+
+1. 繁体中文翻译。
+2. Arm 镜像打包
+
+
+## 🐛 修复
+
+1. password 检测规则错误。
+2. 分享链接无法隐藏知识库检索结果。
+3. IOS 低版本正则兼容问题。
+4. 修复问答提取队列错误后，计数器未清零问题，导致问答提取队列失效。
+5. Debug 模式交互节点下一步可能造成死循环。
--- a/document/content/docs/upgrading/4-9/496.mdx
+++ b/document/content/docs/upgrading/4-9/496.mdx
@@ -0,0 +1,81 @@
+---
+title: V4.9.6
+description: FastGPT V4.9.6 更新说明
+---
+
+## 🚀 新增内容
+
+1. 以 MCP 方式对外提供应用调用。
+2. 支持以 MCP SSE 协议创建工具。
+3. 批量执行节点支持交互节点，可实现每一轮循环都人工参与。
+4. 增加工作台二级菜单，合并工具箱。
+5. 增加 grok3、GPT4.1、o系列、Gemini2.5 模型系统配置。
+
+## ⚙️ 优化
+
+1. 工作流数据类型转化鲁棒性和兼容性增强。
+2. Python sandbox 代码，支持大数据输入。
+3. 路径组件支持配置最后一步是否可点击。
+4. 知识库工具调用结果，自动补充图片域名。
+5. Github action runner 升级成 unbuntu24
+6. 去除飞书、公众号等三方渠道，回复时，可能前后多一个换行的问题。
+7. 调整分块策略，大表格时，不进行超大块合并，而是独立拆块。
+8. Iframe 嵌套组件，内置允许麦克风声明。
+
+## 🐛 修复
+
+1. 修复子工作流包含交互节点时，未成功恢复子工作流所有数据。
+2. completion v1 接口，未接受 interactive 参数，导致 API 调用失败。
+3. 连续工具调用，上下文截断异常
+
+## 升级指南
+### 1. 做好数据备份
+
+### 2. 部署 MCP server 服务
+
+#### Docker 部署
+
+在`docker-compose.yml`文件中，加入`fastgpt-mcp-server`服务:
+
+```yml
+fastgpt-mcp-server:
+    container_name: fastgpt-mcp-server
+    image: ghcr.io/labring/fastgpt-mcp_server:v4.9.6
+    ports:
+      - 3005:3000
+    networks:
+      - fastgpt
+    restart: always
+    environment:
+      - FASTGPT_ENDPOINT=http://fastgpt:3000
+```
+
+#### Sealos 部署
+
+直接在`应用管理`中，增加一个`fastgpt-mcp-server`应用，镜像为`ghcr.io/labring/fastgpt-mcp_server:v4.9.6`，并设置环境变量`FASTGPT_ENDPOINT=fastgpt 的访问地址`。
+
+### 3. 修改 FastGPT 容器环境变量
+
+#### 开源版
+
+修改`config.json`配置文件，增加: `"feconfigs.mcpServerProxyEndpoint": "fastgpt-mcp-server 的访问地址"`， 末尾不要携带/，例如:
+```json
+{
+  "feConfigs": {
+    "lafEnv": "https://laf.dev",
+    "mcpServerProxyEndpoint": "https://mcp.fastgpt.cn" 
+  }
+}
+```
+
+#### 商业版
+
+在 Admin 后台，`系统配置-基础配置-系统参数`中的`MCP 转发服务地址`中，设置`fastgpt-mcp-server`的公网访问地址。
+
+### 4. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.6
+- 更新 FastGPT 商业版镜像 tag: v4.9.6
+- 更新 Sandbox 镜像 tag: v4.9.6
+- 增加 FastGPT mcp server 镜像 tag: v4.9.6
+- AIProxy 无需更新
--- a/document/content/docs/upgrading/4-9/497.mdx
+++ b/document/content/docs/upgrading/4-9/497.mdx
@@ -0,0 +1,55 @@
+---
+title: V4.9.7
+description: FastGPT V4.9.7 更新说明
+---
+
+## 升级指南
+
+### 1. 做好数据备份
+
+### 2. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.7-fix2
+- 更新 FastGPT 商业版镜像 tag: v4.9.7
+- mcp_server 无需更新
+- Sandbox 无需更新
+- 更新 AIProxy 镜像 tag: v0.1.8
+
+## 🚀 新增内容
+
+1. 知识库回答时，回答段落末尾增加引用。
+2. MCP 工具支持 HTTP Streamable 协议。
+3. MCP server 支持编辑工具名，适配部分客户端不支持中文名问题。
+4. 工作流右键可自动对齐节点。
+5. 支持生产环境自定义`config.json`路径。
+6. API 调用，支持传递一个特殊 chatId(`NO_RECORD_HISTORIES`)，使得系统不会进行历史记录存储。
+7. 支持 Rerank 模型按量计费。
+8. 套餐兑换码功能。
+9. 支付宝支付。
+10. 短链数据埋点。
+11. 新增 Jina AI 模型系统配置。
+
+## ⚙️ 优化
+
+1. Doc2x 文档解析，增加报错信息捕获，增加超时时长。
+2. 调整 PG vector 查询语句，强制使用向量索引。
+3. 对话时间统计，准确返回工作流整体运行时间。
+4. 从 ai_proxy 获取音频解析时长。
+5. AI 模型 Token 值均优先采用 API usage，确保 tokens 值准确，若为空，则再采用 GPT3.5 的估算方式。
+6. 优化对话日志 list 接口，适配单个对话框，大量对话的场景。
+
+## 🐛 修复
+
+1. 文件上传分块大小限制，避免超出 MongoDB 限制。
+2. 使用记录仪表盘，无法获取指定成员的使用统计。
+3. 仪表盘接口，因未考虑时区问题，统计异常。
+4. LLM 模型测试接口，无法测试未启用的 LLM。同时修复，模型测试接口会把模型自定义请求地址去除问题。
+5. Copy app 权限问题。
+6. 导出对话记录，限制单条对话记录消息上限 1000 组，避免导出失败。
+7. 工作流变量下一段文本仍是工作流变量，不触发渲染。
+8. 调试知识库检索模块，提示无权操作知识库。
+9. 文本内容提取节点，默认值赋值逻辑。
+10. 分享链接中，会强制返回嵌套应用中的引用内容。
+11. 知识库集合元数据过滤时，不同知识库的同名标签使用 $and 筛选无法获取结果。
+12. 修复应用列表，权限配置可能出现 index 刷新问题。
+
--- a/document/content/docs/upgrading/4-9/498.mdx
+++ b/document/content/docs/upgrading/4-9/498.mdx
@@ -0,0 +1,45 @@
+---
+title: V4.9.8
+description: FastGPT V4.9.8 更新说明
+---
+
+## 升级指南
+
+### 1. 做好数据备份
+
+### 2. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.8
+- 更新 FastGPT 商业版镜像 tag: v4.9.8
+- mcp_server 无需更新
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+## 🚀 新增内容
+
+1. 支持 Toolcalls 并行执行。
+2. 将所有内置任务，从非 stream 模式调整成 stream 模式，避免部分模型不支持非 stream 模式。如需覆盖，则可以在模型`额外 Body`参数中，强制指定`stream=false`。
+3. qwen3 模型预设
+4. 语雀知识库支持设置根目录。
+5. 可配置密码过期时间，过期后下次登录会强制要求修改密码。
+6. 密码登录增加 preLogin 临时密钥校验。
+7. 支持 Admin 后台配置发布渠道和第三方知识库的显示隐藏。
+
+## ⚙️ 优化
+
+1. Chat log list 优化，避免大数据时超出内存限制。
+2. 预加载 token 计算 worker，避免主任务中并发创建导致线程阻塞。
+3. 工作流节点版本控制交互优化。
+4. 网络获取以及 html2md 优化，支持视频和音频标签的转换。
+
+## 🐛 修复
+
+1. 应用列表/知识库列表，删除行权限展示问题。
+2. 打开知识库搜索参数后，重排选项自动被打开。
+3. LLM json_schema 模式 API 请求格式错误。 
+4. 重新训练时，图片过期索引未成功清除，导致图片会丢失。
+5. 重新训练权限问题。
+6. 文档链接地址。
+7. Claude 工具调用，由于 index 为空，导致工具调用失败。
+8. 嵌套工作流，工具调用下包含交互节点时，流程异常。
+
--- a/document/content/docs/upgrading/4-9/499.mdx
+++ b/document/content/docs/upgrading/4-9/499.mdx
@@ -0,0 +1,39 @@
+---
+title: V4.9.9
+description: FastGPT V4.9.9 更新说明
+---
+
+## 升级指南
+
+### 1. 做好数据备份
+
+### 2. 商业版用户替换新 License
+
+商业版用户可以联系 FastGPT 团队支持同学，获取 License 替换方案。替换后，可以直接升级系统，管理后台会提示输入新 License。
+
+### 3. 更新镜像 tag
+
+- 更新 FastGPT 镜像 tag: v4.9.9
+- 更新 FastGPT 商业版镜像 tag: v4.9.9
+- mcp_server 无需更新
+- Sandbox 无需更新
+- AIProxy 无需更新
+
+## 🚀 新增内容
+
+1. 切换 SessionId 来替代 JWT 实现登录鉴权，可控制最大登录客户端数量。
+2. 新的商业版 License 管理模式。
+3. 公众号调用，显示记录 chat 对话错误，方便排查。
+4. API 知识库支持 BasePath 选择，需增加 API 接口，具体可见[API 知识库介绍](/docs/introduction/guide/knowledge_base/api_dataset/#4-获取文件详细信息用于获取文件信息)
+
+## ⚙️ 优化
+
+1. 优化工具调用，新工具的判断逻辑。
+2. 调整 Cite 引用提示词。
+
+## 🐛 修复
+
+1. 无法正常获取应用历史保存/发布记录。
+2. 成员创建 MCP 工具权限问题。
+3. 来源引用展示，存在 ID 传递错误，导致提示无权操作该文件。
+4. 回答标注前端数据报错。
--- a/document/content/docs/upgrading/4-9/meta.json
+++ b/document/content/docs/upgrading/4-9/meta.json
@@ -0,0 +1,21 @@
+{
+  "title": "4.9.x",
+  "description": "",
+  "pages": [
+    "4914",
+    "4913",
+    "4912",
+    "4911",
+    "4910",
+    "499",
+    "498",
+    "497",
+    "496",
+    "495",
+    "494",
+    "493",
+    "492",
+    "491",
+    "490"
+  ]
+}