update doc (#3136)

* fix: null pointer

* perf: not input text

* update doc url

.github/workflows/build-sandbox-image.yml

@@ -1,4 +1,4 @@
-name: Build fastgpt-sandbox images and copy image to docker hub
+name: Build fastgpt-sandbox images
 on:
   workflow_dispatch:
   push:

.github/workflows/fastgpt-image.yml

@@ -1,4 +1,4 @@
-name: Build FastGPT images and copy image to docker hub
+name: Build FastGPT images
 on:
   workflow_dispatch:
   push:
@@ -90,3 +90,86 @@ jobs:
           -t ${Docker_Hub_Tag} \
           -t ${Docker_Hub_Latest} \
           .
+  build-fastgpt-images-sub-route:
+    runs-on: ubuntu-20.04
+    steps:
+      # install env
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+      - name: Install Dependencies
+        run: |
+          sudo apt update && sudo apt install -y nodejs npm
+      - name: Set up QEMU (optional)
+        uses: docker/setup-qemu-action@v2
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+        with:
+          driver-opts: network=host
+      - name: Cache Docker layers
+        uses: actions/cache@v2
+        with:
+          path: /tmp/.buildx-cache
+          key: ${{ runner.os }}-buildx-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-buildx-
+
+      # login docker
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GH_PAT }}
+      - name: Login to Ali Hub
+        uses: docker/login-action@v2
+        with:
+          registry: registry.cn-hangzhou.aliyuncs.com
+          username: ${{ secrets.ALI_HUB_USERNAME }}
+          password: ${{ secrets.ALI_HUB_PASSWORD }}
+      - name: Login to Docker Hub
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKER_HUB_NAME }}
+          password: ${{ secrets.DOCKER_HUB_PASSWORD }}
+
+      # Set tag
+      - name: Set image name and tag
+        run: |
+          if [[ "${{ github.ref_name }}" == "main" ]]; then
+            echo "Git_Tag=ghcr.io/${{ github.repository_owner }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Git_Latest=ghcr.io/${{ github.repository_owner }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Ali_Tag=${{ secrets.ALI_IMAGE_NAME }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Ali_Latest=${{ secrets.ALI_IMAGE_NAME }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Docker_Hub_Tag=${{ secrets.DOCKER_IMAGE_NAME }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Docker_Hub_Latest=${{ secrets.DOCKER_IMAGE_NAME }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+          else
+            echo "Git_Tag=ghcr.io/${{ github.repository_owner }}/fastgpt-sub-route:${{ github.ref_name }}" >> $GITHUB_ENV
+            echo "Git_Latest=ghcr.io/${{ github.repository_owner }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Ali_Tag=${{ secrets.ALI_IMAGE_NAME }}/fastgpt-sub-route:${{ github.ref_name }}" >> $GITHUB_ENV
+            echo "Ali_Latest=${{ secrets.ALI_IMAGE_NAME }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+            echo "Docker_Hub_Tag=${{ secrets.DOCKER_IMAGE_NAME }}/fastgpt-sub-route:${{ github.ref_name }}" >> $GITHUB_ENV
+            echo "Docker_Hub_Latest=${{ secrets.DOCKER_IMAGE_NAME }}/fastgpt-sub-route:latest" >> $GITHUB_ENV
+          fi
+
+      - name: Build and publish image for main branch or tag push event
+        env:
+          DOCKER_REPO_TAGGED: ${{ env.DOCKER_REPO_TAGGED }}
+        run: |
+          docker buildx build \
+          -f projects/app/Dockerfile \
+          --platform linux/amd64,linux/arm64 \
+          --build-arg base_url=/fastai \
+          --label "org.opencontainers.image.source=https://github.com/${{ github.repository_owner }}/FastGPT" \
+          --label "org.opencontainers.image.description=fastgpt image" \
+          --push \
+          --cache-from=type=local,src=/tmp/.buildx-cache \
+          --cache-to=type=local,dest=/tmp/.buildx-cache \
+          -t ${Git_Tag} \
+          -t ${Git_Latest} \
+          -t ${Ali_Tag} \
+          -t ${Ali_Latest} \
+          -t ${Docker_Hub_Tag} \
+          -t ${Docker_Hub_Latest} \
+          .

docSite/content/zh-cn/docs/development/openapi/chat.md

@@ -45,7 +45,7 @@ curl --location --request POST 'http://localhost:3000/api/v1/chat/completions' \
     "messages": [
         {
             "role": "user",
-            "content": "导演是谁",
+            "content": "导演是谁"
         }
     ]
 }'
@@ -312,6 +312,149 @@ event取值：
 {{< /tabs >}}
 
 
+### 交互节点响应
+
+如果工作流中包含交互节点，依然是调用该 API 接口，需要设置`detail=true`，并可以从`event=interactive`的数据中获取交互节点的配置信息。如果是`stream=false`，则可以从 choice 中获取`type=interactive`的元素，获取交互节点的选择信息。
+
+当你调用一个带交互节点的工作流时，如果工作流遇到了交互节点，那么会直接返回，你可以得到下面的信息：
+
+{{< tabs tabTotal="2" >}}
+{{< tab tabName="用户选择" >}}
+{{< markdownify >}}
+
+```json
+{
+    "interactive": {
+        "type": "userSelect",
+        "params": {
+            "description": "测试",
+            "userSelectOptions": [
+                {
+                    "value": "Confirm",
+                    "key": "option1"
+                },
+                {
+                    "value": "Cancel",
+                    "key": "option2"
+                }
+            ]
+        }
+    }
+}
+```
+
+{{< /markdownify >}}
+{{< /tab >}}
+
+{{< tab tabName="表单输入" >}}
+{{< markdownify >}}
+
+```json
+{
+    "interactive": {
+        "type": "userInput",
+        "params": {
+            "description": "测试",
+            "inputForm": [
+                {
+                    "type": "input",
+                    "key": "测试 1",
+                    "label": "测试 1",
+                    "description": "",
+                    "value": "",
+                    "defaultValue": "",
+                    "valueType": "string",
+                    "required": false,
+                    "list": [
+                        {
+                            "label": "",
+                            "value": ""
+                        }
+                    ]
+                },
+                {
+                    "type": "numberInput",
+                    "key": "测试 2",
+                    "label": "测试 2",
+                    "description": "",
+                    "value": "",
+                    "defaultValue": "",
+                    "valueType": "number",
+                    "required": false,
+                    "list": [
+                        {
+                            "label": "",
+                            "value": ""
+                        }
+                    ]
+                }
+            ]
+        }
+    }
+}
+```
+
+{{< /markdownify >}}
+{{< /tab >}}
+{{< /tabs >}}
+
+### 交互节点继续运行
+
+紧接着上一节，当你接收到交互节点信息后，可以根据这些数据进行 UI 渲染，引导用户输入或选择相关信息。然后需要再次发起对话，来继续工作流。调用的接口与仍是该接口，你需要按以下格式来发起请求：
+
+{{< tabs tabTotal="2" >}}
+{{< tab tabName="用户选择" >}}
+{{< markdownify >}}
+
+对于用户选择，你只需要直接传递一个选择的结果给 messages 即可。
+
+```bash
+curl --location --request POST 'https://api.fastgpt.in/api/v1/chat/completions' \
+--header 'Authorization: Bearer fastgpt-xxx' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+    "stream": true,
+    "detail": true,
+    "chatId":"22222231",
+    "messages": [
+        {
+            "role": "user",
+            "content": "Confirm"
+        }
+    ]
+}'
+```
+
+{{< /markdownify >}}
+{{< /tab >}}
+
+{{< tab tabName="表单输入" >}}
+{{< markdownify >}}
+
+表单输入稍微麻烦一点，需要将输入的内容，以对象形式并序列化成字符串，作为`messages`的值。对象的 key 对应表单的 key，value 为用户输入的值。务必确保`chatId`是一致的。
+
+```bash
+curl --location --request POST 'https://api.fastgpt.in/api/v1/chat/completions' \
+--header 'Authorization: Bearer fastgpt-xxxx' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+    "stream": true,
+    "detail": true,
+    "chatId":"22231",
+    "messages": [
+        {
+            "role": "user",
+            "content": "{\"测试 1\":\"这是输入框的内容\",\"测试 2\":666}"
+        }
+    ]
+}'
+```
+
+{{< /markdownify >}}
+{{< /tab >}}
+{{< /tabs >}}
+
+
 ## 请求插件
 
 插件的接口与对话接口一致，仅请求参数略有区别，有以下规定：
@@ -526,7 +669,8 @@ curl --location --request POST 'http://localhost:3000/api/core/chat/getHistories
 --data-raw '{
     "appId": "appId",
     "offset": 0,
-    "pageSize": 20
+    "pageSize": 20,
+    "source: "api"
 }'
 ```
 
@@ -540,6 +684,7 @@ curl --location --request POST 'http://localhost:3000/api/core/chat/getHistories
 - appId - 应用 Id
 - offset - 偏移量，即从第几条数据开始取
 - pageSize - 记录数量
+- source - 对话源
 {{% /alert %}}
 
 {{< /markdownify >}}

docSite/content/zh-cn/docs/development/upgrading/4812.md

@@ -1,5 +1,5 @@
 ---
-title: 'V4.8.12(进行中)'
+title: 'V4.8.12(需要初始化)'
 description: 'FastGPT V4.8.12 更新说明'
 icon: 'upgrade'
 draft: false
@@ -13,14 +13,14 @@ weight: 812
 
 ### 2. 修改镜像
 
-- 更新 FastGPT 镜像 tag: v4.8.12-beta
-- 更新 FastGPT 商业版镜像 tag: v4.8.12-beta
+- 更新 FastGPT 镜像 tag: v4.8.12-fix
+- 更新 FastGPT 管理端镜像 tag: v4.8.12 （fastgpt-pro镜像）
 - Sandbox 镜像，可以不更新
 
 
 ### 3. 商业版执行初始化
 
-从任意终端，发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 `rootkey`；{{host}} 替换成**FastGPT 商业版域名**。
+从任意终端，发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 `rootkey`；{{host}} 替换成**FastGPT 管理端域名**。
 
 ```bash
 curl --location --request POST 'https://{{host}}/api/admin/init/4812' \
@@ -30,6 +30,18 @@ curl --location --request POST 'https://{{host}}/api/admin/init/4812' \
 
 会初始化应用和知识库的成员组数据。
 
+### 4. 重构 Milvus 数据
+
+由于 js int64 精度丢失问题，之前私有化使用 milvus 或者 zilliz 的用户，如果存在数据精度丢失的问题，需要重构 Milvus 数据。（可以查看 dataset_datas 表中，indexes 中的 dataId 是否末尾精度丢失）。使用 PG 的用户不需要操作。
+
+从任意终端，发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 `rootkey`；{{host}} 替换成**FastGPT 主域名**。
+
+```bash
+curl --location --request POST 'https://{{host}}/api/admin/resetMilvus' \
+--header 'rootkey: {{rootkey}}' \
+--header 'Content-Type: application/json'
+```
+
 ## 更新说明
 
 1. 新增 - 全局变量支持数字类型，支持配置默认值和部分输入框参数。
@@ -45,10 +57,12 @@ curl --location --request POST 'https://{{host}}/api/admin/init/4812' \
 11. 新增 - HTTP 节点支持 JSONPath 表达式
 12. 新增 - 应用和知识库支持成员组配置权限
 13. 优化 - 循环节点支持选择外部节点的变量
-14. 修复 - 文件后缀判断，去除 query 影响。
-15. 修复 - AI 响应为空时，会造成 LLM  历史记录合并。
-16. 修复 - 用户交互节点未阻塞流程。
-17. 修复 - 新建 APP，有时候会导致空指针报错。
-18. 修复 - 拥有多个循环节点时，错误运行。
-19. 修复 - 循环节点中修改变量，无法传递。
-20. 修复 - 非 stream 模式，嵌套子应用/插件执行时无法获取子应用响应。
+14. 优化 - Docx 文件读取中， HTML to Markdown 优化，提高速度和大幅度降低内存消耗。
+15. 修复 - 文件后缀判断，去除 query 影响。
+16. 修复 - AI 响应为空时，会造成 LLM  历史记录合并。
+17. 修复 - 用户交互节点未阻塞流程。
+18. 修复 - 新建 APP，有时候会导致空指针报错。
+19. 修复 - 拥有多个循环节点时，错误运行。
+20. 修复 - 循环节点中修改变量，无法传递。
+21. 修复 - 非 stream 模式，嵌套子应用/插件执行时无法获取子应用响应。
+22. 修复 - 数据分块策略，同时将每个 Markdown 独立分块。 

docSite/content/zh-cn/docs/development/upgrading/4813.md

@@ -0,0 +1,44 @@
+---
+title: 'V4.8.13(进行中)'
+description: 'FastGPT V4.8.13 更新说明'
+icon: 'upgrade'
+draft: false
+toc: true
+weight: 811
+---
+
+## 更新指南
+
+### 1. 做好数据备份
+
+### 2. 修改镜像
+
+- 更新 FastGPT 镜像 tag: v4.8.13-alpha
+- 更新 FastGPT 管理端镜像 tag: v4.8.13-alpha （fastgpt-pro镜像）
+- Sandbox 镜像，可以不更新
+
+### 3. 调整文件上传编排
+
+虽然依然兼容旧版的文件上传编排，但是未来两个版本内将会去除兼容代码，请尽快调整编排，以适应最新的文件上传逻辑。尤其是嵌套应用的文件传递，未来将不会自动传递，必须手动指定传递的文件。
+
+## 更新说明
+
+1. 新增 - 数组变量选择支持多选，可以选多个数组或对应的单一数据类型，会自动按选择顺序进行合并。
+2. 新增 - 文件上传方案调整，AI对话和工具调用节点直接支持接收文件链接，并且会强制加入提示词，无需由模型决策调用。插件自定义变量支持文件上传类型，取代全局文件。 
+3. 新增 - 对话记录增加时间显示。 
+4. 新增 - 工作流校验错误时，跳转至错误节点。  
+5. 新增 - 循环节点增加下标值。 
+6. 新增 - 部分对话错误提醒增加翻译。 
+7. 新增 - 对话输入框支持拖拽文件上传，可直接拖文件到输入框中。  
+8. 新增 - 对话日志，来源可显示分享链接/API具体名称
+9. 新增 - 分享链接支持配置是否展示实时运行状态。
+10. 优化 - 合并多个 system 提示词成 1 个，避免部分模型不支持多个 system 提示词。  
+11. 优化 - 知识库上传文件，优化报错提示。  
+12. 优化 - 全文检索语句，减少一轮子查询。  
+13. 优化 - 修改 findLast 为 [...array].reverse().find，适配旧版浏览器。  
+14. 优化 - Markdown 组件自动空格，避免分割 url 中的中文。  
+15. 优化 - 工作流上下文拆分，性能优化。 
+16. 优化 - 语音播报，不支持 mediaSource 的浏览器可等待完全生成语音后输出。 
+17. 修复 - Dockerfile pnpm install 支持代理。 
+18. 修复 - BI 图表生成无法写入文件。同时优化其解析，支持数字类型数组。
+19. 修复 - 分享链接首次加载时，标题显示不正确。 

docSite/content/zh-cn/docs/faq/_index.md

@@ -6,6 +6,6 @@ draft: false
 toc: true
 weight: 900
 ---
-<!-- 9800 ~ 1000 -->
+<!-- 900 ~ 1000 -->
 
 FastGPT 是一个由用户和贡献者参与推动的开源项目，如果您对产品使用存在疑问和建议，可尝试[加入社区](community)寻求支持。我们的团队与社区会竭尽所能为您提供帮助。

docSite/content/zh-cn/docs/faq/app.md

@@ -4,7 +4,7 @@ description: 'FastGPT 常见应用使用问题，包括简易应用、工作流
 icon: 'quiz'
 draft: false
 toc: true
-weight: 903
+weight: 908
 ---
 
 ## 工作流中多轮对话场景中如何使连续问题被问题分类节点正确的归类

docSite/content/zh-cn/docs/faq/chat.md

@@ -4,7 +4,7 @@ description: 'FastGPT 常见聊天框问题'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 905
+weight: 906
 ---
 
 ## 我修改了工作台的应用，为什么在“聊天”时没有更新配置？

docSite/content/zh-cn/docs/faq/dataset.md

@@ -4,7 +4,7 @@ description: '常见知识库使用问题'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 904
+weight: 910
 ---
 
 ## 上传的文件内容出现中文乱码

docSite/content/zh-cn/docs/faq/docker.md

@@ -4,7 +4,7 @@ description: 'FastGPT Docker 部署问题'
 icon: ''
 draft: false
 toc: true
-weight: 901
+weight: 902
 type: redirect
 target: /docs/development/docker/#faq
 ---

docSite/content/zh-cn/docs/faq/error.md

@@ -1,7 +1,15 @@
 ---
-title: '常见错误'
+title: '报错'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 920
----
+weight: 914
+---
+
+1. ### 当前分组上游负载已饱和，请稍后再试(request id:202407100753411462086782835521)
+
+是oneapi渠道的问题，可以换个模型用or换一家中转站
+
+1. ### 使用API时在日志中报错Connection Error 
+
+大概率是api-key填写了openapi，然后部署的服务器在国内，不能访问海外的api，可以使用中转或者反代的手段解决访问不到的问题

docSite/content/zh-cn/docs/faq/external_channel_integration.md

@@ -0,0 +1,18 @@
+---
+title: "接入外部渠道"
+description: "如何通过外部渠道与 FastGPT 集成，实现对多种平台的支持"
+icon: "integration"
+draft: false
+toc: true
+weight: 912
+---
+
+1. ### 接入cow，图文对话无法直接显示图片
+
+提示词给引导，不要以markdown格式输出。图片需要二开 cow 实现图片链接截取并发送。
+
+1. ### 可以获取到用户发送问答的记录吗
+
+在应用的对话日志里可以查看。
+
+![](/imgs/integration1.png)

docSite/content/zh-cn/docs/faq/other.md

@@ -3,7 +3,7 @@ title: '其他问题'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 925
+weight: 918
 ---
 
 ## oneapi 官网是哪个

docSite/content/zh-cn/docs/faq/points_consumption.md

@@ -0,0 +1,14 @@
+---
+title: "积分消耗"
+description: "了解 FastGPT 中的积分消耗机制和使用场景"
+icon: "points"
+draft: false
+toc: true
+weight: 916
+---
+
+1. ### 接入oneapi后，为什么还会消耗fastgpt的积分
+
+矢量数据库检索会默认消耗。可以查看看绑定提示和使用记录。
+
+![](/imgs/points1.png)

docSite/content/zh-cn/docs/faq/privateDeploy.md

@@ -4,7 +4,7 @@ description: "FastGPT 私有部署常见问题"
 icon: upgrade
 draft: false
 images: []
-weight: 902
+weight: 904
 type: redirect
 target: /docs/development/faq/
 ---

docSite/content/zh-cn/docs/guide/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 100
+title: '功能介绍'
+description: 'FastGPT 的功能和使用指南'
+icon: 'import_contacts'
+draft: false
+images: []
+---
+<!-- 100 ~ 500 -->

docSite/content/zh-cn/docs/guide/course/_index.md

@@ -6,4 +6,4 @@ icon: 'import_contacts'
 draft: false
 images: []
 ---
-<!-- 100 ~ 300 -->
+<!-- 100 ~ 200 -->

docSite/content/zh-cn/docs/guide/course/ai_settings.md

@@ -4,7 +4,7 @@ description: "FastGPT AI 相关参数配置说明"
 icon: "sign_language"
 draft: false
 toc: true
-weight: 102
+weight: 104
 ---
 
 在 FastGPT 的 AI 对话模块中，有一个 AI 高级配置，里面包含了 AI 模型的参数配置，本文详细介绍这些配置的含义。

docSite/content/zh-cn/docs/guide/course/chat_input_guide.md

@@ -4,7 +4,7 @@ description: "FastGPT 对话问题引导"
 icon: "code"
 draft: false
 toc: true
-weight: 108
+weight: 106
 ---
 
 ![](/imgs/questionGuide.png)