New dpcs structure and dataset i18n (#551)

* perf: check balance * md * lock way * i18n * docs * doc * i18n * update doc * feat: one link sync * feat: one link sync * feat: one link sync * feat: one link sync * feat: one link sync * feat: one link sync * feat: one link sync
2023-12-04 21:37:07 +08:00
parent c3ae38df8b
commit 62e87551ac
141 changed files with 961 additions and 469 deletions
--- a/docSite/content/docs/development/_index.md
+++ b/docSite/content/docs/development/_index.md
@@ -1,8 +1,9 @@
 ---
-weight: 500
-title: '开发指南'
+weight: 700
+title: '开发与部署指南'
 description: '本地开发 FastGPT 必看'
 icon: 'code_blocks'
 draft: false
 images: []
 ---
+<!-- 700 ~ 1100 -->
--- a/docSite/content/docs/development/configuration.md
+++ b/docSite/content/docs/development/configuration.md
@@ -4,10 +4,10 @@ description: 'FastGPT 配置参数介绍'
 icon: 'settings'
 draft: false
 toc: true
-weight: 520
+weight: 708
 ---

-由于环境变量不利于配置复杂的内容，新版 FastGPT 采用了 ConfigMap 的形式挂载配置文件，你可以在 `projects/app/data/config.json` 看到默认的配置文件。可以参考 [docker-compose 快速部署](/docs/installation/docker/) 来挂载配置文件。
+由于环境变量不利于配置复杂的内容，新版 FastGPT 采用了 ConfigMap 的形式挂载配置文件，你可以在 `projects/app/data/config.json` 看到默认的配置文件。可以参考 [docker-compose 快速部署](/docs/development/docker/) 来挂载配置文件。

 **开发环境下**，你需要将示例配置文件 `config.json` 复制成 `config.local.json` 文件才会生效。

--- a/docSite/content/docs/development/custom-models/_index.md
+++ b/docSite/content/docs/development/custom-models/_index.md
@@ -0,0 +1,9 @@
+---
+weight: 900
+title: '本地模型使用'
+description: 'FastGPT 对接本地模型'
+icon: 'model_training'
+draft: false
+images: []
+---
+<!-- 900~950 -->
--- a/docSite/content/docs/development/custom-models/chatglm2-m3e.md
+++ b/docSite/content/docs/development/custom-models/chatglm2-m3e.md
@@ -0,0 +1,117 @@
+---
+title: '接入 ChatGLM2-m3e 模型'
+description: ' 将 FastGPT 接入私有化模型 ChatGLM2和m3e-large'
+icon: 'model_training'
+draft: false
+toc: true
+weight: 930
+---
+
+## 前言
+
+FastGPT 默认使用了 OpenAI 的 LLM 模型和向量模型，如果想要私有化部署的话，可以使用 ChatGLM2 和 m3e-large 模型。以下是由用户@不做了睡大觉 提供的接入方法。该镜像直接集成了 M3E-Large 和 ChatGLM2-6B 模型，可以直接使用。
+
+## 部署镜像
+
+ 镜像名: `stawky/chatglm2-m3e:latest`  
+ 国内镜像名: `registry.cn-hangzhou.aliyuncs.com/fastgpt_docker/chatglm2-m3e:latest`
+ 端口号: 6006
+
+```
+# 设置安全凭证（即oneapi中的渠道密钥）
+默认值：sk-aaabbbcccdddeeefffggghhhiiijjjkkk
+也可以通过环境变量引入：sk-key。有关docker环境变量引入的方法请自寻教程，此处不再赘述。
+```
+
+## 接入 [One API](/docs/development/one-api/)
+
+为 chatglm2 和 m3e-large 各添加一个渠道，参数如下：
+
+![](/imgs/model-m3e1.png)
+
+这里我填入 m3e 作为向量模型，chatglm2 作为语言模型
+
+## 测试
+
+curl 例子：
+
+```bash
+curl --location --request POST 'https://domain/v1/embeddings' \
+--header 'Authorization: Bearer sk-aaabbbcccdddeeefffggghhhiiijjjkkk' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+  "model": "m3e",
+  "input": ["laf是什么"]
+}'
+```
+
+```bash
+curl --location --request POST 'https://domain/v1/chat/completions' \
+--header 'Authorization: Bearer sk-aaabbbcccdddeeefffggghhhiiijjjkkk' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+  "model": "chatglm2",
+  "messages": [{"role": "user", "content": "Hello!"}]
+}'
+```
+
+Authorization 为 sk-aaabbbcccdddeeefffggghhhiiijjjkkk。model 为刚刚在 One API 填写的自定义模型。
+
+## 接入 FastGPT
+
+修改 config.json 配置文件，在 ChatModels 中加入 chatglm2, 在 VectorModels 中加入 M3E 模型：
+
+```json
+"ChatModels": [
+  //其他对话模型
+  {
+    "model": "chatglm2",
+    "name": "chatglm2",
+    "maxToken": 8000,
+    "price": 0,
+    "quoteMaxToken": 4000,
+    "maxTemperature": 1.2,
+    "defaultSystemChatPrompt": ""
+  }
+],
+"VectorModels": [
+    {
+      "model": "text-embedding-ada-002",
+      "name": "Embedding-2",
+      "price": 0.2,
+      "defaultToken": 500,
+      "maxToken": 3000
+    },
+    {
+      "model": "m3e",
+      "name": "M3E（测试使用）",
+      "price": 0.1,
+      "defaultToken": 500,
+      "maxToken": 1800
+    }
+],
+```
+
+## 测试使用
+
+M3E 模型的使用方法如下：
+
+1. 创建知识库时候选择 M3E 模型。
+
+   注意，一旦选择后，知识库将无法修改向量模型。
+   
+   ![](/imgs/model-m3e2.png)
+
+2. 导入数据
+3. 搜索测试
+
+   ![](/imgs/model-m3e3.png)
+
+4. 应用绑定知识库
+
+   注意，应用只能绑定同一个向量模型的知识库，不能跨模型绑定。并且，需要注意调整相似度，不同向量模型的相似度（距离）会有所区别，需要自行测试实验。
+   
+   ![](/imgs/model-m3e4.png)
+
+chatglm2 模型的使用方法如下：
+模型选择 chatglm2 即可
--- a/docSite/content/docs/development/custom-models/chatglm2.md
+++ b/docSite/content/docs/development/custom-models/chatglm2.md
@@ -0,0 +1,124 @@
+---
+title: '接入 ChatGLM2-6B'
+description: ' 将 FastGPT 接入私有化模型 ChatGLM2-6B'
+icon: 'model_training'
+draft: false
+toc: true
+weight: 910
+---
+
+## 前言
+
+FastGPT 允许你使用自己的 OpenAI API KEY 来快速调用 OpenAI 接口，目前集成了 GPT-3.5, GPT-4 和 embedding，可构建自己的知识库。但考虑到数据安全的问题，我们并不能将所有的数据都交付给云端大模型。
+
+那么如何在 FastGPT 上接入私有化模型呢？本文就以清华的 ChatGLM2 为例，为各位讲解如何在 FastGPT 中接入私有化模型。
+
+## ChatGLM2-6B 简介
+
+ChatGLM2-6B 是开源中英双语对话模型 ChatGLM-6B 的第二代版本，具体介绍可参阅 [ChatGLM2-6B 项目主页](https://github.com/THUDM/ChatGLM2-6B)。
+
+{{% alert context="warning" %}}
+注意，ChatGLM2-6B 权重对学术研究完全开放，在获得官方的书面许可后，亦允许商业使用。本教程只是介绍了一种用法，无权给予任何授权！
+{{% /alert %}}
+
+## 推荐配置
+
+依据官方数据，同样是生成 8192 长度，量化等级为 FP16 要占用 12.8GB 显存、int8 为 8.1GB 显存、int4 为 5.1GB 显存，量化后会稍微影响性能，但不多。
+
+因此推荐配置如下：
+
+{{< table "table-hover table-striped-columns" >}}
+| 类型 | 内存 | 显存 | 硬盘空间 | 启动命令 |
+|------|---------|---------|----------|--------------------------|
+| fp16 | >=16GB | >=16GB | >=25GB | python openai_api.py 16 |
+| int8 | >=16GB | >=9GB | >=25GB | python openai_api.py 8 |
+| int4 | >=16GB | >=6GB | >=25GB | python openai_api.py 4 |
+{{< /table >}}
+
+## 部署
+
+### 环境要求
+
+- Python 3.8.10
+- CUDA 11.8
+- 科学上网环境
+
+### 源码部署
+
+1. 根据上面的环境配置配置好环境，具体教程自行 GPT；
+2. 下载 [python 文件](https://github.com/labring/FastGPT/blob/main/files/models/ChatGLM2/openai_api.py)
+3. 在命令行输入命令 `pip install -r requirments.txt`；
+4. 打开你需要启动的 py 文件，在代码的 `verify_token` 方法中配置 token，这里的 token 只是加一层验证，防止接口被人盗用；
+5. 执行命令 `python openai_api.py --model_name 16`。这里的数字根据上面的配置进行选择。
+
+然后等待模型下载，直到模型加载完毕为止。如果出现报错先问 GPT。
+
+启动成功后应该会显示如下地址：
+
+![](/imgs/chatglm2.png)
+
+> 这里的 `http://0.0.0.0:6006` 就是连接地址。
+
+### docker 部署
+
+**镜像和端口**
+
+ 镜像名: `stawky/chatglm2:latest`  
+ 国内镜像名: `registry.cn-hangzhou.aliyuncs.com/fastgpt_docker/chatglm2:latest`
+ 端口号: 6006
+
+```
+# 设置安全凭证（即oneapi中的渠道密钥）
+默认值：sk-aaabbbcccdddeeefffggghhhiiijjjkkk
+也可以通过环境变量引入：sk-key。有关docker环境变量引入的方法请自寻教程，此处不再赘述。
+```
+
+## 接入 One API
+
+为 chatglm2 添加一个渠道，参数如下：
+
+![](/imgs/model-m3e1.png)
+
+这里我填入 chatglm2 作为语言模型
+
+## 测试
+
+curl 例子：
+
+```bash
+curl --location --request POST 'https://domain/v1/chat/completions' \
+--header 'Authorization: Bearer sk-aaabbbcccdddeeefffggghhhiiijjjkkk' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+  "model": "chatglm2",
+  "messages": [{"role": "user", "content": "Hello!"}]
+}'
+```
+
+Authorization 为 sk-aaabbbcccdddeeefffggghhhiiijjjkkk。model 为刚刚在 One API 填写的自定义模型。
+
+## 接入 FastGPT
+
+修改 config.json 配置文件，在 ChatModels 中加入 chatglm2 模型：
+
+```json
+"ChatModels": [
+  //已有模型
+  {
+    "model": "chatglm2",
+    "name": "chatglm2",
+    "maxContext": 4000,
+    "maxResponse": 4000,
+    "quoteMaxToken": 2000,
+    "maxTemperature": 1,
+    "vision": false, 
+    "defaultSystemChatPrompt": ""
+  }
+]
+```
+
+## 测试使用
+
+chatglm2 模型的使用方法如下：
+
+模型选择 chatglm2 即可
--- a/docSite/content/docs/development/custom-models/m3e.md
+++ b/docSite/content/docs/development/custom-models/m3e.md
@@ -0,0 +1,89 @@
+---
+title: '接入 M3E 向量模型'
+description: ' 将 FastGPT 接入私有化模型 M3E'
+icon: 'model_training'
+draft: false
+toc: true
+weight: 920
+---
+
+## 前言
+
+FastGPT 默认使用了 openai 的 embedding 向量模型，如果你想私有部署的话，可以使用 M3E 向量模型进行替换。M3E 向量模型属于小模型，资源使用不高，CPU 也可以运行。下面教程是基于 “睡大觉” 同学提供的一个的镜像。
+
+## 部署镜像
+
+镜像名: `stawky/m3e-large-api:latest`  
+国内镜像： `registry.cn-hangzhou.aliyuncs.com/fastgpt_docker/m3e-large-api:latest`
+端口号: 6008
+环境变量：
+
+```
+# 设置安全凭证（即oneapi中的渠道密钥）
+默认值：sk-aaabbbcccdddeeefffggghhhiiijjjkkk
+也可以通过环境变量引入：sk-key。有关docker环境变量引入的方法请自寻教程，此处不再赘述。
+```
+
+## 接入 One API
+
+添加一个渠道，参数如下：
+
+![](/imgs/model-m3e1.png)
+
+## 测试
+
+curl 例子：
+
+```bash
+curl --location --request POST 'https://domain/v1/embeddings' \
+--header 'Authorization: Bearer xxxx' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+  "model": "m3e",
+  "input": ["laf是什么"]
+}'
+```
+
+Authorization 为 sk-key。model 为刚刚在 One API 填写的自定义模型。
+
+## 接入 FastGPT
+
+修改 config.json 配置文件，在 VectorModels 中加入 M3E 模型：
+
+```json
+"VectorModels": [
+    {
+      "model": "text-embedding-ada-002",
+      "name": "Embedding-2",
+      "price": 0.2,
+      "defaultToken": 500,
+      "maxToken": 3000
+    },
+    {
+      "model": "m3e",
+      "name": "M3E（测试使用）",
+      "price": 0.1,
+      "defaultToken": 500,
+      "maxToken": 1800
+    }
+]
+```
+
+## 测试使用
+
+1. 创建知识库时候选择 M3E 模型。
+
+      注意，一旦选择后，知识库将无法修改向量模型。
+
+      ![](/imgs/model-m3e2.png)
+
+2. 导入数据
+3. 搜索测试
+
+      ![](/imgs/model-m3e3.png)
+
+4. 应用绑定知识库
+
+      注意，应用只能绑定同一个向量模型的知识库，不能跨模型绑定。并且，需要注意调整相似度，不同向量模型的相似度（距离）会有所区别，需要自行测试实验。
+
+      ![](/imgs/model-m3e4.png)
--- a/docSite/content/docs/development/design/_index.md
+++ b/docSite/content/docs/development/design/_index.md
@@ -1,8 +1,9 @@
 ---
-weight: 540
+weight: 960
 title: "设计方案"
 description: "FastGPT 部分设计方案"
 icon: public
 draft: false
 images: []
---
+---
+<!-- 960~1050 -->
--- a/docSite/content/docs/development/design/dataset.md
+++ b/docSite/content/docs/development/design/dataset.md
@@ -1,5 +1,5 @@
 ---
-weight: 541
+weight: 961
 title: "数据集"
 description: "FastGPT 数据集中文件与数据的设计方案"
 icon: dataset
--- a/docSite/content/docs/development/docker.md
+++ b/docSite/content/docs/development/docker.md
@@ -0,0 +1,162 @@
+---
+title: 'Docker Compose 快速部署'
+description: '使用 Docker Compose 快速部署 FastGPT'
+icon: ''
+draft: false
+toc: true
+weight: 707
+---
+
+## 准备条件
+
+服务器要求：2C2G 起
+
+### 1. 准备好代理环境（国外服务器可忽略）
+
+确保可以访问 OpenAI，具体方案可以参考：[代理方案](/docs/development/proxy/)。或直接在 Sealos 上 [部署 OneAPI](/docs/development/one-api)，既解决代理问题也能实现多 Key 轮询、接入其他大模型。
+
+### 2. 多模型支持
+
+FastGPT 使用了 one-api 项目来管理模型池，其可以兼容 OpenAI 、Azure 、国内主流模型和本地模型等。
+
+可选择 [Sealos 快速部署 OneAPI](/docs/development/one-api)，更多部署方法可参考该项目的 [README](https://github.com/songquanpeng/one-api)，也可以直接通过以下按钮一键部署：
+
+[![](https://fastly.jsdelivr.net/gh/labring-actions/templates@main/Deploy-on-Sealos.svg)](https://cloud.sealos.io/?openapp=system-fastdeploy%3FtemplateName%3Done-api)
+
+## 一、安装 Docker 和 docker-compose
+
+{{< tabs tabTotal="3" >}}
+{{< tab tabName="Linux" >}}
+{{< markdownify >}}
+
+```bash
+# 安装 Docker
+curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
+systemctl enable --now docker
+# 安装 docker-compose
+curl -L https://github.com/docker/compose/releases/download/2.20.3/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
+chmod +x /usr/local/bin/docker-compose
+# 验证安装
+docker -v
+docker-compose -v
+# 如失效，自行百度~
+```
+
+{{< /markdownify >}}
+{{< /tab >}}
+{{< tab tabName="MacOS" >}}
+{{< markdownify >}}
+推荐直接使用 [Orbstack](https://orbstack.dev/)。可直接通过 Homebrew 来安装：
+
+```bash
+brew install orbstack
+```
+
+或者直接[下载安装包](https://orbstack.dev/download)进行安装。
+{{< /markdownify >}}
+{{< /tab >}}
+{{< tab tabName="Windows" >}}
+{{< markdownify >}}
+
+我们建议将源代码和其他数据绑定到 Linux 容器中时，将其存储在 Linux 文件系统中，而不是 Windows 文件系统中。
+
+可以选择直接[使用 WSL 2 后端在 Windows 中安装 Docker Desktop](https://docs.docker.com/desktop/wsl/)。
+
+也可以直接[在 WSL 2 中安装命令行版本的 Docker](https://nickjanetakis.com/blog/install-docker-in-wsl-2-without-docker-desktop)。
+
+{{< /markdownify >}}
+{{< /tab >}}
+{{< /tabs >}}
+
+## 二、创建目录并下载 docker-compose.yml
+
+依次执行下面命令，创建 FastGPT 文件并拉取`docker-compose.yml`和`config.json`，执行完后目录下会有 2 个文件。
+
+非 Linux 环境或无法访问外网环境，可手动创建一个目录，并下载下面2个链接的文件: [docker-compose.yml](https://github.com/labring/FastGPT/blob/main/files/deploy/fastgpt/docker-compose.yml),[config.json](https://github.com/labring/FastGPT/blob/main/projects/app/data/config.json)
+
+**注意: `docker-compose.yml` 配置文件中 Mongo 为 5.x，部分服务器不支持，需手动更改其镜像版本为 4.4.24**
+
+```bash
+mkdir fastgpt
+cd fastgpt
+curl -O https://raw.githubusercontent.com/labring/FastGPT/main/files/deploy/fastgpt/docker-compose.yml
+curl -O https://raw.githubusercontent.com/labring/FastGPT/main/projects/app/data/config.json
+```
+
+
+## 三、启动容器
+
+修改`docker-compose.yml`中的`OPENAI_BASE_URL`和`CHAT_API_KEY`即可，对应为 API 的地址(别忘记加/v1)和 key。
+
+```bash
+# 在 docker-compose.yml 同级目录下执行
+docker-compose pull
+docker-compose up -d
+```
+
+## 四、访问 FastGPT
+
+目前可以通过 `ip:3000` 直接访问(注意防火墙)。登录用户名为 `root`，密码为`docker-compose.yml`环境变量里设置的 `DEFAULT_ROOT_PSW`。
+
+如果需要域名访问，请自行安装并配置 Nginx。
+
+## QA
+
+### 如何更新？
+
+执行下面命令会自动拉取最新镜像，一般情况下不需要执行额外操作。
+
+```bash
+docker-compose pull
+docker-compose up -d
+```
+
+### 如何自定义配置文件？
+
+修改`config.json`文件，并执行`docker-compose up -d`重起容器。具体配置，参考[配置详解](/docs/development/configuration)。
+
+### 如何检查自定义配置文件是否挂载
+
+1. `docker logs fastgpt` 可以查看日志，在启动容器后，第一次请求网页，会进行配置文件读取，可以看看有没有读取成功以及有无错误日志。
+2. `docker exec -it fastgpt sh` 进入 FastGPT 容器，可以通过`ls data`查看目录下是否成功挂载`config.json`文件。可通过`cat data/config.json`查看配置文件。
+
+**可能不生效的原因**
+
+1. 挂载目录不正确
+2. 配置文件不正确，日志中会提示`invalid json`，配置文件需要是标准的 JSON 文件。
+
+### 为什么无法连接`本地模型`镜像。
+
+`docker-compose.yml`中使用了桥接的模式建立了`fastgpt`网络，如想通过0.0.0.0或镜像名访问其它镜像，需将其它镜像也加入到网络中。
+
+### 端口冲突怎么解决？
+
+docker-compose 端口定义为：`映射端口:运行端口`。
+
+桥接模式下，容器运行端口不会有冲突，但是会有映射端口冲突，只需将映射端口修改成不同端口即可。
+
+如果`容器1`需要连接`容器2`，使用`容器2:运行端口`来进行连接即可。
+
+（自行补习 docker 基本知识）
+
+### relation "modeldata" does not exist
+
+PG 数据库没有连接上/初始化失败，可以查看日志。FastGPT 会在每次连接上 PG 时进行表初始化，如果报错会有对应日志。
+
+1. 检查数据库容器是否正常启动
+2. 非 docker 部署的，需要手动安装 pg vector 插件
+3. 查看 fastgpt 日志，有没有相关报错
+
+### Operation `auth_codes.findOne()` buffering timed out after 10000ms
+
+mongo连接失败，检查
+1. mongo 服务有没有起来(有些 cpu 不支持 AVX，无法用 mongo5，需要换成 mongo4.x，可以dockerhub找个最新的4.x，修改镜像版本，重新运行）
+2. 环境变量（账号密码，注意host和port）
+
+
+### 错误排查方式
+
+遇到问题先按下面方式排查。
+
+1. `docker ps -a` 查看所有容器运行状态，检查是否全部 running，如有异常，尝试`docker logs 容器名`查看对应日志。
+2. 不懂 docker 不要瞎改端口，只需要改`OPENAI_BASE_URL`和`CHAT_API_KEY`即可。
--- a/docSite/content/docs/development/intro.md
+++ b/docSite/content/docs/development/intro.md
@@ -1,10 +1,10 @@
 ---
-title: '快速开始'
+title: '快速开始本地开发'
 description: '对 FastGPT 进行开发调试'
 icon: 'developer_guide'
 draft: false
 toc: true
-weight: 510
+weight: 705
 ---

 本文档介绍了如何设置开发环境以构建和测试 [FastGPT](https://fastgpt.run)。
@@ -46,7 +46,7 @@ git clone git@github.com:<github_username>/FastGPT.git

 ### 3. 安装数据库

-第一次开发，需要先部署数据库，建议本地开发可以随便找一台 2C2G 的轻量小数据库实践。数据库部署教程：[Docker 快速部署](/docs/installation/docker/)。部署完了，可以本地访问其数据库。
+第一次开发，需要先部署数据库，建议本地开发可以随便找一台 2C2G 的轻量小数据库实践。数据库部署教程：[Docker 快速部署](/docs/development/docker/)。部署完了，可以本地访问其数据库。

 ### 4. 初始配置

--- a/docSite/content/docs/development/one-api.md
+++ b/docSite/content/docs/development/one-api.md
@@ -0,0 +1,113 @@
+---
+title: '接入微软、ChatGLM、本地模型等'
+description: '通过接入 One API 来实现对各种大模型的支持'
+icon: 'Api'
+draft: false
+toc: true
+weight: 708
+---
+
+* 默认情况下，FastGPT 只配置了 GPT 的 3 个模型，如果你需要接入其他模型，需要进行一些额外配置。
+* [One API](https://github.com/songquanpeng/one-api) 是一个 OpenAI 接口管理 & 分发系统，可以通过标准的 OpenAI API 格式访问所有的大模型，开箱即用。
+
+FastGPT 可以通过接入 One API 来实现对各种大模型的支持。部署方法也很简单。
+
+## MySQL 版本
+
+MySQL 版本支持多实例，高并发。
+
+直接点击以下按钮即可一键部署 👇
+
+[![](https://fastly.jsdelivr.net/gh/labring-actions/templates@main/Deploy-on-Sealos.svg)](https://cloud.sealos.io/?openapp=system-fastdeploy%3FtemplateName%3Done-api)
+
+部署完后会跳转「应用管理」，数据库在另一个应用「数据库」中。需要等待 1~3 分钟数据库运行后才能访问成功。
+
+## SqlLite 版本
+
+SqlLite 版本不支持多实例，适合个人小流量使用，但是价格非常便宜。
+
+**1. [点击打开 Sealos 公有云](https://cloud.sealos.io/)**
+
+**2. 打开 AppLaunchpad(应用管理) 工具**
+
+![step1](/imgs/oneapi-step1.png)
+
+**3. 点击创建新应用**
+
+**4. 填写对应参数**
+
+镜像：ghcr.io/songquanpeng/one-api:latest
+
+![step2](/imgs/oneapi-step2.png)
+打开外网访问开关后，Sealos 会自动分配一个可访问的地址，不需要自己配置。
+
+![step3](/imgs/oneapi-step3.png)
+填写完参数后，点击右上角部署即可。环境变量：
+
+```
+SESSION_SECRET=SESSION_SECRET
+POLLING_INTERVAL=60
+BATCH_UPDATE_ENABLED=true
+BATCH_UPDATE_INTERVAL=60
+```
+
+## 使用步骤
+
+### 1. 登录 One API
+
+打开 【One API 应用详情】，找到访问地址：
+![step4](/imgs/oneapi-step4.png)
+
+登录 One API
+![step5](/imgs/oneapi-step5.png)
+
+### 2. 创建渠道和令牌
+
+在 One API 中添加对应渠道，直接点击 【添加基础模型】，不要遗漏了向量模型
+![step6](/imgs/oneapi-step6.png)
+
+创建一个令牌
+![step7](/imgs/oneapi-step7.png)
+
+### 3. 修改 FastGPT 的环境变量
+
+有了 One API 令牌后，FastGPT 可以通过修改 `baseurl` 和 `key` 去请求到 One API，再由 One API 去请求不同的模型。修改下面两个环境变量：
+
+```bash
+# 下面的地址是 Sealos 提供的，务必写上 v1， 两个项目都在 sealos 部署时候，https://xxxx.cloud.sealos.io 可以改用内网地址
+OPENAI_BASE_URL=https://xxxx.cloud.sealos.io/v1
+# 下面的 key 是由 One API 提供的令牌
+CHAT_API_KEY=sk-xxxxxx
+```
+
+## 接入其他模型
+
+**以添加文心一言为例:**
+
+### 1. One API 添加对应模型渠道
+
+![](/imgs/oneapi-demo1.png)
+
+### 2. 修改 FastGPT 配置文件
+
+可以在 `/projects/app/src/data/config.json` 里找到配置文件（本地开发需要复制成 config.local.json），配置文件中有一项是对话模型配置：
+
+```json
+"ChatModels": [
+    ...
+    {
+      "model": "ERNIE-Bot", // 这里的模型需要对应 One API 的模型
+      "name": "文心一言", // 对外展示的名称
+      "maxContext": 8000, // 最大长下文 token，无论什么模型都按 GPT35 的计算。GPT 外的模型需要自行大致计算下这个值。可以调用官方接口去比对 Token 的倍率，然后在这里粗略计算。
+      "maxResponse": 4000, // 最大回复 token
+      // 例如：文心一言的中英文 token 基本是 1:1，而 GPT 的中文 Token 是 2:1，如果文心一言官方最大 Token 是 4000，那么这里就可以填 8000，保险点就填 7000.
+      "quoteMaxToken": 2000, // 引用知识库的最大 Token
+      "maxTemperature": 1, // 最大温度
+      "vision": false, // 是否开启图片识别
+      "defaultSystemChatPrompt": "" // 默认的系统提示词
+    }
+    ...
+],
+```
+
+添加完后，重启 FastGPT 即可在选择文心一言模型进行对话。
--- a/docSite/content/docs/development/openapi/_index.md
+++ b/docSite/content/docs/development/openapi/_index.md
@@ -1,8 +1,9 @@
 ---
-weight: 560
+weight: 850
 title: "OpenAPI 接口文档"
 description: "FastGPT OpenAPI 文档"
 icon: api
 draft: false
 images: []
---
+---
+<!-- 850~900 -->
--- a/docSite/content/docs/development/openapi/auth.md
+++ b/docSite/content/docs/development/openapi/auth.md
@@ -4,7 +4,7 @@ description: 'FastGPT Api Key 使用与鉴权'
 icon: 'key'
 draft: false
 toc: true
-weight: 561
+weight: 851
 ---

 ## 使用说明
--- a/docSite/content/docs/development/openapi/chat.md
+++ b/docSite/content/docs/development/openapi/chat.md
@@ -4,7 +4,7 @@ description: 'FastGPT OpenAPI 对话接口'
 icon: 'chat'
 draft: false
 toc: true
-weight: 562
+weight: 852
 ---

 ## 发起对话
--- a/docSite/content/docs/development/openapi/dataset.md
+++ b/docSite/content/docs/development/openapi/dataset.md
@@ -4,7 +4,7 @@ description: 'FastGPT OpenAPI 知识库接口'
 icon: 'dataset'
 draft: false
 toc: true
-weight: 563
+weight: 853
 ---

 | 如何获取知识库ID（datasetId） | 如何获取文件集合ID（collection_id） |
--- a/docSite/content/docs/development/openapi/share.md
+++ b/docSite/content/docs/development/openapi/share.md
@@ -4,7 +4,7 @@ description: 'FastGPT 分享链接鉴权'
 icon: 'share'
 draft: false
 toc: true
-weight: 564
+weight: 860
 ---

 ## 使用说明
--- a/docSite/content/docs/development/proxy/_index.md
+++ b/docSite/content/docs/development/proxy/_index.md
@@ -0,0 +1,9 @@
+---
+weight: 950
+title: "代理方案"
+description: "FastGPT 私有化部署代理方案"
+icon: wify_proxy
+draft: false
+images: []
+---
+<!-- 950~960 -->
--- a/docSite/content/docs/development/proxy/cloudflare.md
+++ b/docSite/content/docs/development/proxy/cloudflare.md
@@ -0,0 +1,54 @@
+---
+title: "Cloudflare Worker 中转"
+description: "使用 Cloudflare Worker 实现中转"
+icon: "foggy"
+draft: false
+toc: true
+weight: 953
+---
+
+[参考 "不做了睡觉" 的教程](https://gravel-twister-d32.notion.site/FastGPT-API-ba7bb261d5fd4fd9bbb2f0607dacdc9e)
+
+**workers 配置文件**
+
+```js
+const TELEGRAPH_URL = 'https://api.openai.com';
+
+addEventListener('fetch', (event) => {
+  event.respondWith(handleRequest(event.request));
+});
+
+async function handleRequest(request) {
+  // 安全校验
+  if (request.headers.get('auth') !== 'auth_code') {
+    return new Response('UnAuthorization', { status: 403 });
+  }
+
+  const url = new URL(request.url);
+  url.host = TELEGRAPH_URL.replace(/^https?:\/\//, '');
+
+  const modifiedRequest = new Request(url.toString(), {
+    headers: request.headers,
+    method: request.method,
+    body: request.body,
+    redirect: 'follow'
+  });
+
+  const response = await fetch(modifiedRequest);
+  const modifiedResponse = new Response(response.body, response);
+
+  // 添加允许跨域访问的响应头
+  modifiedResponse.headers.set('Access-Control-Allow-Origin', '*');
+
+  return modifiedResponse;
+}
+```
+
+**修改 FastGPT 的环境变量**
+
+> 务必别忘了填 v1！
+
+```bash
+OPENAI_BASE_URL=https://xxxxxx/v1
+OPENAI_BASE_URL_AUTH=auth_code
+```
--- a/docSite/content/docs/development/proxy/http_proxy.md
+++ b/docSite/content/docs/development/proxy/http_proxy.md
@@ -0,0 +1,47 @@
+---
+title: "HTTP 代理中转"
+description: "使用 HTTP 代理实现中转"
+icon: "http"
+draft: false
+toc: true
+weight: 952
+---
+
+如果你有代理工具（例如 [Clash](https://github.com/Dreamacro/clash) 或者 [sing-box](https://github.com/SagerNet/sing-box)），也可以使用 HTTP 代理来访问 OpenAI。只需要添加以下两个环境变量即可：
+
+```bash
+AXIOS_PROXY_HOST=
+AXIOS_PROXY_PORT=
+```
+
+以 Clash 为例，建议指定 `api.openai.com` 走代理，其他请求都直连。示例配置如下：
+
+```yaml
+mixed-port: 7890
+allow-lan: false
+bind-address: '*'
+mode: rule
+log-level: warning
+dns:  
+  enable: true  
+  ipv6: false  
+  nameserver:  
+    - 8.8.8.8
+    - 8.8.4.4 
+  cache-size: 400
+proxies:
+    - 
+proxy-groups:
+  - { name: '♻️ 自动选择', type: url-test,  proxies: [香港V01×1.5], url: 'https://api.openai.com', interval: 3600}
+rules:
+  - 'DOMAIN-SUFFIX,api.openai.com,♻️ 自动选择'
+  - 'MATCH,DIRECT'
+```
+
+然后给 FastGPT 添加两个环境变量：
+
+```bash
+AXIOS_PROXY_HOST=127.0.0.1
+AXIOS_PROXY_PORT=7890
+```
+
--- a/docSite/content/docs/development/proxy/nginx.md
+++ b/docSite/content/docs/development/proxy/nginx.md
@@ -0,0 +1,105 @@
+---
+title: "Nginx 中转"
+description: "使用 Sealos 部署 Nginx 实现中转"
+icon: "cloud_sync"
+draft: false
+toc: true
+weight: 951
+---
+
+## 登录 Sealos
+
+[Sealos](https://cloud.sealos.io/)
+
+## 创建应用
+
+打开 「应用管理」，点击「新建应用」：
+
+![](/imgs/sealos3.png)  
+![](/imgs/sealos4.png)
+
+### 填写基本配置
+
+务必开启外网访问，复制外网访问提供的地址。
+
+![](/imgs/sealos5.png)
+
+### 添加配置文件
+
+1. 复制下面这段配置文件，注意 `server_name` 后面的内容替换成第二步的外网访问地址。
+
+   ```nginx
+   user nginx;
+   worker_processes auto;
+   worker_rlimit_nofile 51200;
+   
+   events {
+       worker_connections 1024;
+   }
+   
+   http {
+       resolver 8.8.8.8;
+       proxy_ssl_server_name on;
+   
+       access_log off;
+       server_names_hash_bucket_size 512;
+       client_header_buffer_size 64k;
+       large_client_header_buffers 4 64k;
+       client_max_body_size 50M;
+   
+       proxy_connect_timeout       240s;
+       proxy_read_timeout          240s;
+       proxy_buffer_size 128k;
+       proxy_buffers 4 256k;
+   
+       server {
+           listen 80;
+           server_name tgohwtdlrmer.cloud.sealos.io; # 这个地方替换成 Sealos 提供的外网地址
+   
+           location ~ /openai/(.*) {
+               proxy_pass https://api.openai.com/$1$is_args$args;
+               proxy_set_header Host api.openai.com;
+               proxy_set_header X-Real-IP $remote_addr;
+               proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+               # 如果响应是流式的
+               proxy_set_header Connection '';
+               proxy_http_version 1.1;
+               chunked_transfer_encoding off;
+               proxy_buffering off;
+               proxy_cache off;
+               # 如果响应是一般的
+               proxy_buffer_size 128k;
+               proxy_buffers 4 256k;
+               proxy_busy_buffers_size 256k;
+           }
+       }
+   }
+   ```
+
+2. 点开高级配置。
+3. 点击「新增配置文件」。
+4. 文件名写: `/etc/nginx/nginx.conf`。
+5. 文件值为刚刚复制的那段代码。
+6. 点击确认。
+
+   ![](/imgs/sealos6.png)
+
+### 部署应用
+
+填写完毕后，点击右上角的「部署」，即可完成部署。
+
+## 修改 FastGPT 环境变量
+
+1. 进入刚刚部署应用的详情，复制外网地址
+
+   > 注意：这是个 API 地址，点击打开是无效的。如需验证，可以访问: `*.cloud.sealos.io/openai/api`，如果提示 `Invalid URL (GET /api)` 则代表成功。
+   
+   ![](/imgs/sealos7.png)
+
+2. 修改环境变量（是 FastGPT 的环境变量，不是 Sealos 的）：
+
+   ```bash
+   OPENAI_BASE_URL=https://tgohwtdlrmer.cloud.sealos.io/openai/v1
+   ```
+   
+**Done!**
--- a/docSite/content/docs/development/sealos.md
+++ b/docSite/content/docs/development/sealos.md
@@ -0,0 +1,44 @@
+---
+title: "Sealos 一键部署"
+description: "使用 Sealos 一键部署 FastGPT"
+icon: "cloud"
+draft: false
+toc: true
+weight: 706
+---
+
+Sealos 的服务器在国外，不需要额外处理网络问题，无需服务器、无需魔法、无需域名，支持高并发 & 动态伸缩。点击以下按钮即可一键部署 👇
+
+[![](https://fastly.jsdelivr.net/gh/labring-actions/templates@main/Deploy-on-Sealos.svg)](https://cloud.sealos.io/?openapp=system-fastdeploy%3FtemplateName%3Dfastgpt)
+
+由于需要部署数据库，部署完后需要等待 2~4 分钟才能正常访问。默认用了最低配置，首次访问时会有些慢。
+
+![](/imgs/sealos1.png)
+
+点击 Sealos 提供的外网地址即可打开 FastGPT 的可视化界面。
+
+![](/imgs/sealos2.png)
+
+> 用户名：`root`
+> 
+> 密码就是刚刚一键部署时设置的环境变量
+
+## 修改配置文件和环境变量
+
+在 Sealos 中，你可以打开`应用管理`（App Launchpad）看到部署的 FastGPT，可以打开`数据库`（Database）看到对应的数据库。
+
+在`应用管理`中，选中 FastGPT，点击变更，可以看到对应的环境变量和配置文件。
+
+![](/imgs/fastgptonsealos1.png)
+
+{{% alert icon="🤖 " context="success" %}}
+在 Sealos 上，FastGPT 一共运行了 1 个服务和 2 个数据库，如暂停和删除请注意数据库一同操作。（你可以白天启动，晚上暂停它们，省钱大法）
+{{% /alert %}}
+
+## 更新
+
+点击重启会自动拉取最新镜像更新，请确保镜像`tag`正确。
+
+## 部署架构图
+
+![](/imgs/sealos-fastgpt.webp)
--- a/docSite/content/docs/development/upgrading/40.md
+++ b/docSite/content/docs/development/upgrading/40.md
@@ -0,0 +1,66 @@
+---
+title: '升级到 V4.0'
+description: 'FastGPT 从旧版本升级到 V4.0 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 850
+---
+
+如果您是**从旧版本升级到 V4**，由于新版 MongoDB 表变更比较大，需要按照本文档的说明执行一些初始化脚本。
+
+## 重命名表名
+
+需要连接上 MongoDB 数据库，执行两条命令：
+
+```mongodb
+db.models.renameCollection("apps")
+db.sharechats.renameCollection("outlinks")
+```
+
+{{% alert context="warning" %}}
+注意：从旧版更新到 V4， MongoDB 会自动创建空表，你需要先手动删除这两个空表，再执行上面的操作。
+{{% /alert %}}
+
+## 初始化几个表中的字段
+
+依次执行下面 3 条命令，时间比较长，不成功可以重复执行（会跳过已经初始化的数据），直到所有数据更新完成。
+
+```mongodb
+db.chats.find({appId: {$exists: false}}).forEach(function(item){
+  db.chats.updateOne(
+    {
+      _id: item._id,
+    },
+    { "$set": {"appId":item.modelId}}
+  )
+})
+
+db.collections.find({appId: {$exists: false}}).forEach(function(item){
+  db.collections.updateOne(
+    {
+      _id: item._id,
+    },
+    { "$set": {"appId":item.modelId}}
+  )
+})
+
+db.outlinks.find({shareId: {$exists: false}}).forEach(function(item){
+   db.outlinks.updateOne(
+     {
+       _id: item._id,
+    },
+    { "$set": {"shareId":item._id.toString(),"appId":item.modelId}}
+   )
+})
+```
+
+## 初始化 API
+
+部署新版项目，并发起 3 个 HTTP 请求（记得携带 `headers.rootkey`，这个值是环境变量里的）
+
+1. https://xxxxx/api/admin/initv4
+2. https://xxxxx/api/admin/initChat
+3. https://xxxxx/api/admin/initOutlink
+
+1 和 2 有可能会因为内存不足挂掉，可以重复执行。
--- a/docSite/content/docs/development/upgrading/41.md
+++ b/docSite/content/docs/development/upgrading/41.md
@@ -0,0 +1,29 @@
+---
+title: '升级到 V4.1'
+description: 'FastGPT 从旧版本升级到 V4.1 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 849
+---
+
+如果您是**从旧版本升级到 V4.1**，由于新版重新设置了对话存储结构，需要初始化原来的存储内容。
+
+## 更新环境变量
+
+V4.1 优化了 PostgreSQL 和 MongoDB 的连接变量，只需要填 1 个 URL 即可：
+
+注意：/fastgpt 和 /postgres 是指数据库名称，需要和旧版的变量对应。
+
+```bash
+# mongo 配置，不需要改. 如果连不上，可能需要去掉 ?authSource=admin
+- MONGODB_URI=mongodb://username:password@mongo:27017/fastgpt?authSource=admin
+# pg配置. 不需要改
+- PG_URL=postgresql://username:password@pg:5432/postgres
+```
+
+## 初始化 API
+
+部署新版项目，并发起 1 个 HTTP 请求（记得携带 `headers.rootkey`，这个值是环境变量里的）
+
+- https://xxxxx/api/admin/initChatItem
--- a/docSite/content/docs/development/upgrading/42.md
+++ b/docSite/content/docs/development/upgrading/42.md
@@ -0,0 +1,21 @@
+---
+title: '升级到 V4.2'
+description: 'FastGPT 从旧版本升级到 V4.2 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 848
+---
+
+99.9%用户不影响，升级 4.2 主要是修改了配置文件中 QAModel 的格式。从原先的数组改成对象：
+
+```json
+"QAModel": {
+    "model": "gpt-3.5-turbo-16k",
+    "name": "GPT35-16k",
+    "maxToken": 16000,
+    "price": 0
+}
+```
+
+改动目的是，我们认为不需要留有选择余地，选择一个最合适的模型去进行任务即可。
--- a/docSite/content/docs/development/upgrading/421.md
+++ b/docSite/content/docs/development/upgrading/421.md
@@ -0,0 +1,24 @@
+---
+title: '升级到 V4.2.1'
+description: 'FastGPT 从旧版本升级到 V4.2.1 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 847
+---
+
+私有部署，如果添加了配置文件，需要在配置文件中修改 `VectorModels` 字段。增加 defaultToken 和 maxToken，分别对应直接分段时的默认 token 数量和该模型支持的 token 上限 (通常不建议超过 3000)
+
+```json
+"VectorModels": [
+    {
+      "model": "text-embedding-ada-002",
+      "name": "Embedding-2",
+      "price": 0,
+      "defaultToken": 500,
+      "maxToken": 3000
+    }
+]
+```
+
+改动目的是，我们认为不需要留有选择余地，选择一个最合适的模型去进行任务即可。
--- a/docSite/content/docs/development/upgrading/43.md
+++ b/docSite/content/docs/development/upgrading/43.md
@@ -0,0 +1,30 @@
+---
+title: '升级到 V4.3(需要初始化)'
+description: 'FastGPT 从旧版本升级到 V4.3 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 846
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求 (记得携带 `headers.rootkey`，这个值是环境变量里的)
+
+1. https://xxxxx/api/admin/initv43
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv43' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+会给 PG 数据库的 modeldata 表插入一个新列 file_id，用于存储文件 ID。
+
+## 增加环境变量
+
+增加一个 `FILE_TOKEN_KEY` 环境变量，用于生成文件预览链接，过期时间为 30 分钟。
+
+```
+FILE_TOKEN_KEY=filetokenkey
+```
--- a/docSite/content/docs/development/upgrading/44.md
+++ b/docSite/content/docs/development/upgrading/44.md
@@ -0,0 +1,23 @@
+---
+title: '升级到 V4.4(需要初始化)'
+description: 'FastGPT 从旧版本升级到 V4.4 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 845
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求 (记得携带 `headers.rootkey`，这个值是环境变量里的)
+
+1. https://xxxxx/api/admin/initv44
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv44' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+会给初始化 Mongo 的部分字段。
+
--- a/docSite/content/docs/development/upgrading/441.md
+++ b/docSite/content/docs/development/upgrading/441.md
@@ -0,0 +1,23 @@
+---
+title: '升级到 V4.4.1(需要初始化)'
+description: 'FastGPT 从旧版本升级到 V4.4.1 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 844
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求（记得携带 `headers.rootkey`，这个值是环境变量里的）
+
+1. https://xxxxx/api/admin/initv441
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv441' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+会给初始化 Mongo 的 dataset.files，将所有数据设置为可用。
+
--- a/docSite/content/docs/development/upgrading/442.md
+++ b/docSite/content/docs/development/upgrading/442.md
@@ -0,0 +1,23 @@
+---
+title: '升级到 V4.4.2(需要初始化)'
+description: 'FastGPT 从旧版本升级到 V4.4.2 操作指南'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 843
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求 (记得携带 `headers.rootkey`，这个值是环境变量里的)
+
+1. https://xxxxx/api/admin/initv442
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv442' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+会给初始化 Mongo 的 Bill 表的索引，之前过期时间有误。
+
--- a/docSite/content/docs/development/upgrading/445.md
+++ b/docSite/content/docs/development/upgrading/445.md
@@ -0,0 +1,31 @@
+---
+title: 'V4.4.5(需要初始化)'
+description: 'FastGPT V4.4.5 更新'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 842
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求（记得携带 `headers.rootkey`，这个值是环境变量里的）
+
+1. https://xxxxx/api/admin/initv445
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv445' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+初始化了 variable 模块，将其合并到用户引导模块中。
+
+## 功能介绍
+
+### Fast GPT V4.4.5
+
+1. 新增 - 下一步指引选项，可以通过模型生成 3 个预测问题。
+2. 商业版新增 - 分享链接限制及 hook 身份校验（可对接已有的用户系统）。
+3. 商业版新增 - Api Key 使用。增加别名、额度限制和过期时间。自带 appId，无需额外连接。
+4. 优化 - 全局变量与开场白合并成同一模块。
--- a/docSite/content/docs/development/upgrading/446.md
+++ b/docSite/content/docs/development/upgrading/446.md
@@ -0,0 +1,14 @@
+---
+title: 'V4.4.6'
+description: 'FastGPT V4.4.6 更新'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 841
+---
+
+## 功能介绍
+
+1. 高级编排新增模块 - 应用调用，可调用其他应用。
+2. 新增 - 必要连接校验
+3. 修复 - 下一步指引在免登录中身份问题。
--- a/docSite/content/docs/development/upgrading/447.md
+++ b/docSite/content/docs/development/upgrading/447.md
@@ -0,0 +1,31 @@
+---
+title: 'V4.4.7（需执行升级脚本）'
+description: 'FastGPT V4.4.7 更新（需执行升级脚本）'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 840
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求（{{rootkey}} 替换成环境变量里的`rootkey`，{{host}}替换成自己域名）
+
+1. https://xxxxx/api/admin/initv447
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv447' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+初始化 pg 索引以及将 file_id 中空对象转成 manual 对象。如果数据多，可能需要较长时间，可以通过日志查看进度。
+
+## 功能介绍
+
+### Fast GPT V4.4.7
+
+1. 优化了数据库文件 crud。
+2. 兼容链接读取，作为 source。
+3. 区分手动录入和标注，可追数据至某个文件。
+4. 升级 openai sdk。
--- a/docSite/content/docs/development/upgrading/45.md
+++ b/docSite/content/docs/development/upgrading/45.md
@@ -0,0 +1,93 @@
+---
+title: 'V4.5(需进行较为复杂更新)'
+description: 'FastGPT V4.5 更新'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 839
+---
+
+FastGPT V4.5 引入 PgVector0.5 版本的 HNSW 索引，极大的提高了知识库检索的速度，比起`IVFFlat`索引大致有3~10倍的性能提升，可轻松实现百万数据毫秒级搜索。缺点在于构建索引的速度非常慢，4c16g 500w 组数据使用`并行构建`大约花了 48 小时。具体参数配置可参考 [PgVector官方](https://github.com/pgvector/pgvector)
+
+下面需要对数据库进行一些操作升级：
+
+## PgVector升级：Sealos 部署方案
+
+1. 点击[Sealos桌面](https://cloud.sealos.io)的数据库应用。
+2. 点击【pg】数据库的详情。
+3. 点击右上角的重启，等待重启完成。
+4. 点击左侧的一键链接，等待打开 Terminal。
+5. 依次输入下方 sql 命令
+
+```sql
+-- 升级插件名
+ALTER EXTENSION vector UPDATE;
+-- 插件是否升级成功，成功的话，vector插件版本为 0.5.0，旧版的为 0.4.1
+\dx
+
+-- 下面两个语句会设置 pg 在构建索引时可用的内存大小，需根据自身的数据库规格来动态配置，可配置为 1/4 的内存大小
+alter system set maintenance_work_mem = '2400MB'; 
+select pg_reload_conf();
+
+-- 重构数据库索引和排序
+REINDEX DATABASE postgres;
+
+-- 开始构建索引，该索引构建时间非常久，直接点击右上角的叉，退出 Terminal 即可
+CREATE INDEX CONCURRENTLY vector_index ON modeldata USING hnsw (vector vector_ip_ops) WITH (m = 16, ef_construction = 64);
+-- 可以再次点击一键链接，进入 Terminal，输入下方命令，如果看到 "vector_index" hnsw (vector vector_ip_ops) WITH (m='16', ef_construction='64') 则代表构建完成（注意，后面没有 INVALID）
+\d modeldata
+```
+
+|                       |                       |
+| --------------------- | --------------------- |
+| ![](/imgs/v45-1.png) | ![](/imgs/v45-2.png) |
+| ![](/imgs/v45-3.png) | ![](/imgs/v45-4.png) |
+
+
+
+## PgVector升级：Docker-compose.yml 部署方案
+
+下面的命令是基于给的 docker-compose 模板，如果数据库账号密码更换了，请自行调整。
+
+1. 修改 `docker-compose.yml` 中pg的镜像版本，改成 `ankane/pgvector:v0.5.0` 或 `registry.cn-hangzhou.aliyuncs.com/fastgpt/pgvector:v0.5.0`
+2. 重启 pg 容器(docker-compose pull && docker-compose up -d)，等待重启完成。
+3. 进入容器: `docker exec -it pg bash`
+4. 连接数据库: `psql 'postgresql://username:password@localhost:5432/postgres'`
+5. 执行下面 sql 命令
+
+```sql
+-- 升级插件名
+ALTER EXTENSION vector UPDATE;
+-- 插件是否升级成功，成功的话，vector插件版本为 0.5.0，旧版的为 0.4.2
+\dx
+
+-- 下面两个语句会设置 pg 在构建索引时可用的内存大小，需根据自身的数据库规格来动态配置，可配置为 1/4 的内存大小
+alter system set maintenance_work_mem = '2400MB'; 
+select pg_reload_conf();
+
+-- 重构数据库索引和排序
+REINDEX DATABASE postgres;
+ALTER DATABASE postgres REFRESH COLLATION VERSION;
+
+-- 开始构建索引，该索引构建时间非常久，直接关掉终端即可，不要使用 ctrl+c 关闭
+CREATE INDEX CONCURRENTLY vector_index ON modeldata USING hnsw (vector vector_ip_ops) WITH (m = 16, ef_construction = 64);
+-- 可以再次连接数据库，输入下方命令。如果看到 "vector_index" hnsw (vector vector_ip_ops) WITH (m='16', ef_construction='64') 则代表构建完成（注意，后面没有 INVALID）
+\d modeldata
+
+
+```
+
+## 版本新功能介绍
+
+### Fast GPT V4.5
+
+1. 新增 - 升级 PgVector 插件，引入 HNSW 索引，极大加快的知识库搜索速度。
+2. 新增 - AI对话模块，增加【返回AI内容】选项，可控制 AI 的内容不直接返回浏览器。
+3. 新增 - 支持问题分类选择模型
+4. 优化 - TextSplitter，采用递归拆解法。
+5. 优化 - 高级编排 UX 性能
+6. 修复 - 分享链接鉴权问题
+
+## 该版本需要修改 `config.json` 文件
+
+最新配置可参考: [V45版本最新 config.json](/docs/development/configuration)
--- a/docSite/content/docs/development/upgrading/451.md
+++ b/docSite/content/docs/development/upgrading/451.md
@@ -0,0 +1,35 @@
+---
+title: 'V4.5.1(需进行初始化)'
+description: 'FastGPT V4.5.1 更新'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 838
+---
+
+## 执行初始化 API
+
+发起 1 个 HTTP 请求（{{rootkey}} 替换成环境变量里的`rootkey`，{{host}}替换成自己域名）
+
+1. https://xxxxx/api/admin/initv451
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv451' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+初始化内容：
+1. rename 数据库字段
+2. 初始化 Mongo APP 表中知识库的相关字段
+3. 初始化 PG 和 Mongo 的内容，为每个文件创建一个集合（存储 Mongo 中），并反馈赋值给 PG。
+
+**该初始化接口可能速度很慢，返回超时不用管，注意看日志即可**
+
+## 功能介绍
+
+### Fast GPT V4.5.1
+
+1. 新增知识库文件夹管理
+2. 修复了 openai4.x sdk 无法兼容 oneapi 的智谱和阿里的接口。
+3. 修复部分模块无法触发完成事件
--- a/docSite/content/docs/development/upgrading/452.md
+++ b/docSite/content/docs/development/upgrading/452.md
@@ -0,0 +1,15 @@
+---
+title: 'V4.5.2'
+description: 'FastGPT V4.5.2 更新'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 837
+---
+
+## 功能介绍
+
+### Fast GPT V4.5.2
+
+1. 新增 - 模块插件，允许自行组装插件进行模块复用。
+2. 优化 - 知识库引用提示。
--- a/docSite/content/docs/development/upgrading/46.md
+++ b/docSite/content/docs/development/upgrading/46.md
@@ -0,0 +1,67 @@
+---
+title: 'V4.6(需要初始化)'
+description: 'FastGPT V4.6 更新'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 836
+---
+
+**V4.6 版本加入了简单的团队功能，可以邀请其他用户进来管理资源。该版本升级后无法执行旧的升级脚本，且无法回退。**
+
+## 1。更新镜像并变更配置文件
+
+更新镜像至 latest 或者 v4.6 版本。商业版镜像更新至 V0.2.1
+
+最新配置可参考：[V46 版本最新 config.json](/docs/development/configuration)，商业镜像配置文件也更新，参考最新的飞书文档。
+
+
+## 2。执行初始化 API
+
+发起 2 个 HTTP 请求 ({{rootkey}} 替换成环境变量里的 `rootkey`，{{host}} 替换成自己域名)
+
+**该初始化接口可能速度很慢，返回超时不用管，注意看日志即可，需要注意的是，需确保 initv46 成功后，在执行 initv46-2**
+
+1. https://xxxxx/api/admin/initv46
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv46' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+2. https://xxxxx/api/admin/initv46-2
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv46-2' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+初始化内容：
+1。创建默认团队
+2。初始化 Mongo 所有资源的团队字段
+3。初始化 Pg 的字段
+4。初始化 Mongo Data
+
+
+## V4.6 功能介绍
+
+1. 新增 - 团队空间
+2. 新增 - 多路向量 (多个向量映射一组数据)
+3. 新增 - tts 语音
+4. 新增 - 支持知识库配置文本预处理模型
+5. 线上环境新增 - ReRank 向量召回，提高召回精度
+6. 优化 - 知识库导出，可直接触发流下载，无需等待转圈圈
+
+## 4.6 缺陷修复
+
+旧的 4.6 版本由于缺少一个字段，导致文件导入时知识库数据无法显示，可执行下面的脚本：
+
+https://xxxxx/api/admin/initv46-fix
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv46-fix' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
--- a/docSite/content/docs/development/upgrading/461.md
+++ b/docSite/content/docs/development/upgrading/461.md
@@ -0,0 +1,16 @@
+---
+title: 'V4.6.1'
+description: 'FastGPT V4.6 .1'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 835
+---
+
+
+## V4.6.1 功能介绍
+
+1. 新增 - GPT4-v 模型支持
+2. 新增 - whisper 语音输入
+3. 优化 - TTS 流传输
+4. 优化 - TTS 缓存
--- a/docSite/content/docs/development/upgrading/462.md
+++ b/docSite/content/docs/development/upgrading/462.md
@@ -0,0 +1,31 @@
+---
+title: 'V4.6.2(需要初始化)'
+description: 'FastGPT V4.6.2'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 834
+---
+
+## 1。执行初始化 API
+
+发起 1 个 HTTP 请求 ({{rootkey}} 替换成环境变量里的 `rootkey`，{{host}} 替换成自己域名)
+
+1. https://xxxxx/api/admin/initv462
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv462' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+初始化说明：
+1. 初始化全文索引
+
+## V4.6.2 功能介绍
+
+1. 新增 - 全文索引（需配合 Rerank 模型，在看怎么放到开源版，模型接口比较特殊）
+2. 新增 - 插件来源（预计4.7/4.8版本会正式使用）
+3. 优化 - PDF读取
+4. 优化 - docx文件读取，转成 markdown 并保留其图片内容
+5. 修复和优化 TextSplitter 函数
--- a/docSite/content/docs/development/upgrading/463.md
+++ b/docSite/content/docs/development/upgrading/463.md
@@ -0,0 +1,33 @@
+---
+title: 'V4.6.3(需要初始化)'
+description: 'FastGPT V4.6.3'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 833
+---
+
+## 1。执行初始化 API
+
+发起 1 个 HTTP 请求 ({{rootkey}} 替换成环境变量里的 `rootkey`，{{host}} 替换成自己域名)
+
+1. https://xxxxx/api/admin/initv463
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/initv463' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
+初始化说明：
+1. 初始化Mongo 中 dataset，collection 和 data 的部分字段
+
+## V4.6.3 功能介绍
+
+1. 商业版新增 - web站点同步
+2. 新增 - 集合元数据记录
+3. 优化 - url 读取内容
+4. 优化 - 流读取文件，防止内存溢出
+5. 优化 - 4v模型自动将 url 转 base64，本地也可调试
+6. 优化 - 图片压缩等级
+7. 修复 - 图片压缩失败报错，防止文件读取过程卡死。
--- a/docSite/content/docs/development/upgrading/_index.md
+++ b/docSite/content/docs/development/upgrading/_index.md
@@ -0,0 +1,9 @@
+---
+weight: 750
+title: "版本更新/升级操作"
+description: "FastGPT 版本更新介绍及升级操作"
+icon: upgrade
+draft: false
+images: []
+---
+<!-- 750~850 -->
--- a/docSite/content/docs/development/upgrading/intro.md
+++ b/docSite/content/docs/development/upgrading/intro.md
@@ -0,0 +1,88 @@
+---
+title: '升级说明'
+description: 'FastGPT 升级说明'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 751
+---
+
+FastGPT 升级包括两个步骤：
+
+1. 镜像升级
+2. 执行升级初始化脚本
+
+
+
+## 镜像名
+
+**git版**
+- FastGPT 主镜像：ghcr.io/labring/fastgpt:latest
+- 商业版镜像：ghcr.io/c121914yu/fastgpt-pro:latest
+- Admin 镜像：ghcr.io/c121914yu/fastgpt-admin:latest
+
+**阿里云**
+- FastGPT 主镜像: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt
+- 商业版镜像：ghcr:registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-pro
+- Admin 镜像: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-admin
+
+镜像由镜像名和`Tag`组成，例如: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.6.1 代表`4.6.3`版本镜像，具体可以看 docker hub, github 仓库。
+
+## Sealos 修改镜像
+
+1. 打开 [Sealos Cloud](https://cloud.sealos.io/)， 找到桌面上的应用管理
+   
+![](/imgs/updateImageSealos1.jpg)
+
+2. 选择对应的应用 - 点击右边三个点 - 变更
+
+![](/imgs/updateImageSealos2.jpg)
+
+3. 修改镜像 - 确认变更
+
+    如果要修改配置文件，可以拉到下面的`配置文件`进行修改。
+
+![](/imgs/updateImageSealos3.jpg)
+
+## Docker-Compose 修改镜像
+
+直接修改`yml`文件中的`image: `即可。随后执行:
+
+```bash
+docker-compose pull
+docker-compose up -d
+```
+
+## 执行升级初始化脚本
+
+镜像更新完后，可以查看文档中的`版本介绍`，通常需要执行升级脚本的版本都会标明`需要初始化`，打开对应的文档，参考说明执行初始化脚本即可，大部分时候都是需要发送一个`POST`请求。
+
+
+## QA
+
+### {{host}} 是什么
+
+{{}} 代表变量， {{host}}代表一个名为 host 的变量。指的是你服务器的域名或 IP。
+
+Sealos 中，你可以在下图中找到你的域名：
+
+![](/imgs/updateImageSealos4.jpg)
+
+
+### 如何获取 rootkey
+
+从`docker-compose.yml`中的`environment`中获取，对应的是`ROOT_KEY`的值。
+
+sealos 中可以从上图左侧的环境变量中获取。
+
+### 如何跨版本升级！！
+
+建议逐一版本升级，防止脏数据。例如，当前版本是4.4.7，需要升级到4.6。
+
+1. 修改镜像到4.5，执行初始化
+2. 修改镜像到4.5.1，执行初始化
+3. 修改镜像到4.5.2，执行初始化
+4. 修改镜像到4.6，执行初始化
+5. .....
+
+逐一升级