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
2025-07-24 22:03:54 +00:00 · 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/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. .....
+
+逐一升级