Merge remote-tracking branch 'origin/v2' into v2

greenyhsj · greenyhsj · commit d721903f497d · 2025-07-21T16:30:03.000+08:00
diff --git a/docs/changelog.md b/docs/changelog.md
@@ -8,6 +8,21 @@
     - v2.1.0 是 v2.0.0 之后的功能版本
 
 ## 2 更新内容
+
+### v2.0.1
+
+2025 年 7 月 18 日
+
+!!! Abstract "问题修复 :palm_tree:"
+    
+    - 应用：修复在“显示设置” 功能中只开启显示知识来源不开启执行详情，对话时知识来源的引用分段显示错误；
+    - 应用：修复“多路召回”节点的重排内容的值为空时，对话时执行到该节点会报错的问题；
+    - 工具：修复普通用户角色的用户登录系统后，创建工具界面缺少“调试”功能；
+    - 问答页面：修复AI回复的音频文件无法拖拽播放的问题；
+    - 用户管理：修复的编辑用户报错的问题；
+    - 共享工具：修复从工具商店添加工具失败的问题。（X-Pack）
+
+
 ### v2.0.0
 
 2025 年 7 月 17 日
diff --git a/docs/img/index/install.png b/docs/img/index/install.png
diff --git a/docs/img/index/login.png b/docs/img/index/login.png
diff --git a/docs/index.md b/docs/index.md
@@ -83,7 +83,7 @@
 
 !!! Abstract ""
 
-    - [如何向团队介绍 MaxKB](https://fit2cloud.com/maxkb/download/introduce-maxkb_202504.pdf)
+    - [如何向团队介绍 MaxKB](https://fit2cloud.com/maxkb/download/introduce-maxkb_202507.pdf)
     - [飞致云培训认证中心](https://edu.fit2cloud.com/index) 
     - [MaxKB 小课堂](https://space.bilibili.com/510493147/lists/3590204?type=season)
     - [MaxKB 知识库](https://kb.fit2cloud.com/categories/maxkb)
diff --git a/docs/installation/offline_installtion.md b/docs/installation/offline_installtion.md
@@ -38,7 +38,7 @@
 
     以 root 用户通过 ssh 协议登录到部署服务器, 对安装包进行解压：
     ```
-    tar -zxvf maxkb-v2.0.0-offline-installer.tar.gz
+    tar -zxvf maxkb-v2.0.0-x86_64-offline-installer.tar.gz
     ```
 
 ### 3.2 安装配置（可选）
@@ -86,7 +86,7 @@
     ## 镜像仓库
     MAXKB_IMAGE_REPOSITORY=registry.fit2cloud.com/maxkb
     ## 镜像名称
-    MAXKB_IMAGE=maxkb-ce
+    MAXKB_IMAGE=maxkb
     ## 版本号
     MAXKB_VERSION=v2.0.0
     ```
@@ -101,13 +101,13 @@
 
     ```
     # 进入安装包解压缩后目录  
-    cd maxkb-ce-v2.0.0-offline
+    cd maxkb-v2.0.0-x86_64-offline-installer
 
     # 执行安装命令
     bash install.sh
     ```
 
-![安装](../img/index/install.jpg)
+![安装](../img/index/install.png)
 
 ## 4 登录访问
 
diff --git a/docs/quick_start.md b/docs/quick_start.md
@@ -33,7 +33,7 @@
 
     - 工具：提供内置及自定义函数，用于数据获取、逻辑判断、信息提取等操作，创建后的工具可在应用编排中调用。
 
-    - 知识库：创建和管理级知识库，包括上传离线文档、Web 站点、飞书文档等，为问答对话提供知识来源，对知识进行统一管理，并助力智能问答。
+    - 知识库：创建和管理知识库，包括上传离线文档、Web 站点、飞书文档等，为问答对话提供知识来源，对知识进行统一管理，并助力智能问答。
 
     - 应用：提供预配置模板和组件，可快速创建基础问答应用，或对复杂业务流程进行高级编排，打造专属 AI 助手。
 
@@ -78,9 +78,8 @@
 
     * 文本文件：Markdown、TXT、PDF、DOCX、HTML、XLS、XLSX、CSV、ZIP；
     * 表格格式：Excel、CSV;
-    * QA 问答对：Excel、CSV；  
-    * 每次最多上传 50 个文件；   
-    * 每个文件不超过 100 MB；
+    * QA 问答对：Excel、CSV；
+    * 每次默认最多上传 50 个文件，每个文件不超过 100 MB，可配置；
     * 支持选择文件夹，上传文件夹下符合格式要求的文件。
 
     文档规范建议：
@@ -115,26 +114,28 @@
 !!! Abstract ""
     点击【创建】，选择应用类型，输入应用名称后点击【创建】。
 
-    - **简单配置**：提供了较为基础的功能和设置选项，基本功能完备满足大多数基本的问答需求，适用于需要快速上线智能体应用。
-    - **高级编排**：支持用户创建符合业务逻辑的工作流，包括但不限于使用判断器、问题优化、工具、内置标签等功能，满足用户问题分类、敏感词检索等各类需求，适用于需要复杂逻辑和自定义工作流的场景。
+    - **简单配置**：提供了较为基础的功能和设置选项，满足大多数基本的问答需求，适用于需要快速上线智能体应用。
+    - **高级编排**：通过基础组件、工具以及应用嵌套进行功能和逻辑的编排，设计工作流程，满足各类复杂业务场景的需求。
 
 ![创建应用](img/index/creat_app.png)
 
 
 !!! Abstract ""
     应用创建完成，进入【简单配置】配置应用的设置页面，左侧为应用信息，右侧为调试预览界面。
 
-    * 应用名称：用户提问时对话框的标题和名字。    
-    * 应用描述：对应用场景及用途的描述。    
-    * AI 模型：在【系统设置】-【模型管理】中添加的大语言模型。    
+    * 名称：用户提问时对话框的标题和名字。    
+    * 描述：对应用场景及用途的描述。    
+    * AI 模型：在【系统设置】-【模型管理】中添加的大语言模型。   
+    * 系统角色：AI 模型在交互中被预设的身份、功能以及行为边界。
     * 提示词：系统默认有智能知识库的提示词，用户可以自定义通过调整提示词内容，引导大模型聊天方向。可对无引用知识库和引用知识库两种情况分别设置不同的提示词。
     * 历史聊天记录：大模型提交当前会话中最后 N 条对话内容，否则仅向大模型提交当前问题。
     * 关联知识库：用户提问后将在关联的知识库中检索分段。   
     * 开场白：用户打开对话时，系统弹出的问候语。支持 Markdown 格式；[-]后的内容为快捷问题，一行一个。 
+    * 输出思考：对大语言模型的思考过程是否输出进行配置。
     * 语音输入：开启后将支持语音方式进行提问，需要语音识别模型支持。
     * 语音播放：开启后可以通过语音进行播放回答，可以通过浏览器播放，也可以通选择语音合成模型。
 
-    应用信息设置完成后，可以在右侧调试预览中进行提问预览，调试预览中提问内容不计入对话日志。
+    应用信息设置完成后，可以在右侧调试预览中进行测试验证，调试预览中的提问内容不计入对话日志。
 
 ![应用设置](img/index/app_setting.png)
 
@@ -151,16 +152,16 @@
 
     - **相似度：** 相似度越高代表问题和分段的相关性越强。 
 
-    - **引用分段数：** 提问时按相似度携带 N 个分段生成提示词询问 LLM 模型。 
+    - **引用分段数 TOP：** 提问时按相似度携带 N 个分段生成提示词询问 LLM 模型。 
 
-    - **引用最大字符数：** 引用分段内容设置最大字符数，超过时则截断。     
+    - **最多引用字符数：** 引用分段内容设置最大字符数，超过时则截断。     
 
     - **无引用知识库处理**
 
         * 继续提问：可以自定义设置提示词，需要有`{question}`用户问题的占位符，才会把用户问题发送给模型。       
         * 指定回复内容：当没有命中知识库分段时可以指定回复内容。   
     
-    - **问题优化：** 开启后对用户提出的问题先进行一次 LLM 优化处理，将优化后的问题在知识库中进行向量化检索，能提高检索知识库的准确度，但由于多一次询问大模型会增加回答问题的时长。
+    - **问题优化：** 开启后对用户提出的问题先进行一次 LLM 优化处理，然后根据问题优化后的结果在知识库中进行检索。
 
 ![应用知识库参数设置](img/index/parameter_setting.png)
 
diff --git a/docs/user_manual/dataset/dataset.md b/docs/user_manual/dataset/dataset.md
@@ -40,8 +40,7 @@
     * 文本文件：Markdown、TXT、PDF、DOCX、HTML、XLS、XLSX、CSV、ZIP；
     * 表格：XLS、XLSX、CSV、ZIP；
     * QA 问答对：XLS、XLSX、CSV、ZIP；  
-    * 每次最多上传 50 个文件；   
-    * 每个文件不超过 100 MB；
+    * 每次默认最多上传 50 个文件，每个文件不超过 100 MB，可配置；
     * 支持选择文件夹，上传文件夹下符合要求的文件。
     * ZIP 文件包括两种形式：
 
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -121,7 +121,7 @@ nav:
             - Ollama 离线部署 LLM 模型: faq/Offline_install_OllamaModel.md
             - Ollama 使用 GPU 运行 LLM 模型: faq/GPU_runOllama.md
             - 将 MaxKB 小助手集成到 Halo 中: faq/maxkb_In_halo.md
-            - MaxKB 和 Dify 有什么区别: faq/MaxKB VS.Dify.md
+            #- MaxKB 和 Dify 有什么区别: faq/MaxKB VS.Dify.md
             - 知识库文档如何合理分段: faq/doc_segment.md
   #- 教学视频: instructional_video
     - 联系我们: contact.md
