Refine docs based on readability, usability, and enterprise PM feedback (#619)

* Refine docs based on internal feedback * update the zh and ja docs --------- Co-authored-by: Riskey <riskey47@dify.ai>
2026-03-26 13:18:34 +07:00 · 2025-12-16 19:37:13 +08:00
parent 821b83c0b5
commit 5d7556d5f2
15 changed files with 101 additions and 95 deletions
--- a/en/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx
+++ b/en/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx
@@ -12,30 +12,34 @@ When quick-creating a knowledge base, you can upload local files as its data sou

 2. Select **Import from file** as the data source, then upload your files.

-    - Maximum file size: 15 MB
-
    - Maximum number of files per upload: 5

-    <Info>
-        On Dify Cloud, **batch uploading** is only available on [the **Professional** and **Team** plans](https://dify.ai/pricing).
-    </Info>
+        <Info>
+            On Dify Cloud, **batch uploading** (up to 50 files per upload) is only available on [paid plans](https://dify.ai/pricing).
+        </Info>
+
+    - Maximum file size: 15 MB
+
+    <Tip>
+        For self-hosted deployments, you can adjust these two limits via the environment variables `UPLOAD_FILE_SIZE_LIMIT` and `UPLOAD_FILE_BATCH_LIMIT`.
+    </Tip>

 ---

 **For Images in Uploaded Files**

-    JPG, JPEG, PNG, and GIF images under 2 MB are automatically extracted as attachments to their corresponding chunks. These images can be managed independently and are returned alongside their chunks during retrieval. 
+    JPG, JPEG, PNG, and GIF images under 2 MB are automatically extracted as attachments to their corresponding chunks. These images can be managed independently and are returned alongside their chunks during retrieval.
+
+    Each chunk supports up to 10 image attachments; images beyond this limit will not be extracted.

    <Tip>
-        For self-hosted deployments, you can adjust the size limit via the environment variable `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`.
+        For self-hosted deployments, you can adjust the following limits via environment variables:
+    
+        - Maximum image size: `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`
+    
+        - Maximum number of attachments per chunk: `SINGLE_CHUNK_ATTACHMENT_LIMIT`
    </Tip>

-    <Note>
-        Each chunk supports up to 10 image attachments; images beyond this limit will not be extracted.
-
-        For self-hosted deployments, you can adjust this limit via the environment variable `SINGLE_CHUNK_ATTACHMENT_LIMIT`.
-    </Note>
-
    The above extraction rule applies to:

    - Images embedded in DOCX files
--- a/en/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx
+++ b/en/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx
@@ -10,10 +10,6 @@ Similar to the search engines use efficient indexing algorithms to match search

 The knowledge base offers two index methods: **High-Quality** and **Economical**, each with different retrieval setting options.

-<Note>
-    The original **Q\&A mode (available only for the Community Edition)** is now an optional feature under the High Quality index method.
-</Note>
-
 <Tabs>
  <Tab title="High Quality">

@@ -35,8 +31,12 @@ The knowledge base offers two index methods: **High-Quality** and **Economical**

    The High-Quality index method supports three retrieval strategies: vector search, full-text search, or hybrid search. Learn more in [Configure the Retrieval Settings](#configure-the-retrieval-settings).

-    ### Enable Q&A Mode (Optional, Community Edition Only)
-        
+    ### Q&A Mode
+
+    <Info>
+      Q&A mode is available for self-hosted deployments only.
+    </Info>
+    
    When this mode is enabled, the system segments the uploaded text and automatically generates Q\&A pairs for each segment after summarizing its content.

    Compared with the common **Q to P** strategy (user questions matched with text paragraphs), the Q\&A mode uses a **Q to Q** strategy (questions matched with questions).
--- a/en/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx
+++ b/en/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx
@@ -196,7 +196,9 @@ You can choose Dify's Doc Extractor to process files, or select tools based on y

 <Accordion title="For images in documents">

-Images in documents can be extracted using appropriate doc processors. Extracted images are attached to their corresponding chunks, can be managed independently, and are returned alongside those chunks during retrieval.
+Images in documents can be extracted using appropriate doc processors. Extracted images are attached to their corresponding chunks, can be managed independently, and are returned alongside those chunks during retrieval. 
+
+Each chunk supports up to 10 image attachments; images beyond this limit will not be extracted.

 If no images are extracted by the selected processor, Dify will automatically extract JPG, JPEG, PNG, and GIF images under 2 MB that are referenced via accessible URLs using the following Markdown syntax:

@@ -204,15 +206,13 @@ If no images are extracted by the selected processor, Dify will automatically ex
  - `![alt text](image_url "optional title")`

 <Tip>
-    For self-hosted deployments, you can adjust the size limit via the environment variable `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`.
+    For self-hosted deployments, you can adjust these limits via environment variables:
+
+    - Maximum image size: `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`
+
+    - Maximum number of attachments per chunk: `SINGLE_CHUNK_ATTACHMENT_LIMIT`
 </Tip>

-<Note>
-    Each chunk supports up to 10 image attachments; images beyond this limit will not be extracted.
-
-    For self-hosted deployments, you can adjust this limit via the environment variable `SINGLE_CHUNK_ATTACHMENT_LIMIT`.
-</Note>
-
 If you select a multimodal embedding model (indicated by the **Vision** icon) in subsequent index settings, the extracted images will be embedded and indexed for retrieval.

 </Accordion>
@@ -419,7 +419,7 @@ In the Economical method, each block uses 10 keywords for retrieval without call
 | Economical      | Inverted Index               | Common search engine retrieval method, matches queries with key content |

 <Note>
-  If candidate chunks may include image attachments, select a multimodal rerank model (indicated by the **Vision** icon). Otherwise, images will be excluded from reranking and the retrieval results.
+  If the selected embedding model is multimodal, select a multimodal rerank model (indicated by the **Vision** icon) as well. Otherwise, retrieved images will be excluded from reranking and the retrieval results.
 </Note>

 You can also refer to the table below for information on configuring chunk structure, index methods, parameters, and retrieval settings.
--- a/en/use-dify/knowledge/knowledge-request-rate-limit.mdx
+++ b/en/use-dify/knowledge/knowledge-request-rate-limit.mdx
@@ -4,11 +4,9 @@ icon: "gauge"
 tag: "CLOUD"
 ---

-We will implement Knowledge Request Rate Limits starting **February 24, 2025**, to ensure optimal service performance and a better knowledge experience for all users.
-
 ## What is Knowledge Request Rate Limit?

-Knowledge Request Rate Limit refers to the maximum number of actions that a workspace can perform in the knowledge base within one minute. These actions include creating datasets, managing documents, and running queries in apps or workflows.
+On Dify Cloud, the knowledge request rate limit refers to the maximum number of actions that a workspace can perform in the knowledge base within one minute. These actions include creating datasets, managing documents, and running queries in apps or workflows. 

 ## Limitations of Different Subscription Versions

--- a/en/use-dify/monitor/logs.mdx
+++ b/en/use-dify/monitor/logs.mdx
@@ -50,15 +50,17 @@ Team members can add internal notes and improved responses directly in the log i
 **Feedback Analysis**
 Identify common complaint patterns, successful interaction types, and areas needing improvement.

-## Data Retention
+## Log Retention

 <Warning>
 Ensure your application complies with local data privacy regulations. Publish a privacy policy and obtain user consent where required.
 </Warning>

-**Free Plans:** Logs are retained for 30 days
-**Paid Plans:** Extended retention based on plan tier
-**Self-Hosted:** Configurable retention policy
+- **Sandbox**: Logs are retained for 30 days.
+
+- **Professional & Team**: Unlimited log retention during active subscription.
+
+- **Self-hosted**: Unlimited by default; configurable via environment variables `WORKFLOW_LOG_CLEANUP_ENABLED`, `WORKFLOW_LOG_RETENTION_DAYS`, and `WORKFLOW_LOG_CLEANUP_BATCH_SIZE`.

 ## Improving Applications with Logs

--- a/ja/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx
+++ b/ja/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx
@@ -14,30 +14,34 @@ title: ローカルファイルをアップロード

 2. データソースとして **既存テキストをインポート** を選択し、ファイルをアップロードします。

-    - 1ファイルの最大サイズ：15 MB
+    - 1回のアップロードで選択できるファイル数の上限：5

-    - 1回のアップロードで最大5ファイルまで
+        <Info>
+            Dify Cloudでは、**バッチアップロード**（1回につき最大50ファイル）は[有料プラン](https://dify.ai/jp/pricing)でのみ利用可能です。
+        </Info>

-    <Info>
-        Dify Cloudでは、**一括アップロード**は[**Professional**および**Team**プラン](https://dify.ai/pricing)のみ対応しています。
-    </Info>
+    - ファイルサイズの上限：15MB
+
+    <Tip>
+        セルフホスト環境では、これら2つの上限は環境変数 `UPLOAD_FILE_SIZE_LIMIT` および `UPLOAD_FILE_BATCH_LIMIT` で調整できます。
+    </Tip>

 ---

 **アップロードファイル内の画像について**

    JPG、JPEG、PNG、GIF形式で2MB未満の画像は、該当するチャンクの添付ファイルとして自動抽出されます。これらの画像は個別に管理でき、検索時にチャンクと一緒に返されます。
+    
+    1チャンクにつき最大10枚まで画像添付が可能です。超過分は抽出されません。

    <Tip>
-        セルフホスト環境では、環境変数 `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT` で画像サイズ上限を調整できます。
+        セルフホスト環境では、以下の上限を環境変数で調整できます：
+    
+        - 画像サイズの上限：`ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`
+    
+        - 1チャンクあたりの添付画像数上限：`SINGLE_CHUNK_ATTACHMENT_LIMIT`
    </Tip>

-    <Note>
-        1チャンクにつき最大10枚まで画像添付が可能です。超過分は抽出されません。
-
-        セルフホスト環境では、環境変数 `SINGLE_CHUNK_ATTACHMENT_LIMIT` でこの上限を調整できます。
-    </Note>
-
    抽出ルールの対象：

    - DOCXファイルに埋め込まれた画像
--- a/ja/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx
+++ b/ja/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx
@@ -10,7 +10,7 @@ title: インデックス方法と検索設定を指定

 検索エンジンが効率的なインデックスアルゴリズムを通じてユーザーの質問に最も関連するウェブページコンテンツをマッチングするように、インデックス方法の適切さはLLMがナレッジベース内のコンテンツを検索する効率と回答の正確性に直接影響します。

-**高品質**と**エコノミー**の2種類のインデックス方法を提供しており、それぞれ異なる検索設定オプションがあります：
+**高品質**と**エコノミー**の2種類のインデックス方法を提供しており、それぞれ異なる検索設定オプションがあります。

 <Note>
  元のQ&Aモード（コミュニティ版のみ対応）は、高品質インデックス方法のオプションになりました。
@@ -39,7 +39,7 @@ title: インデックス方法と検索設定を指定
    
    高品質インデックス方式では、ベクトル検索・全文検索・ハイブリッド検索の3つの検索戦略がサポートされています。詳細は[検索設定の指定](#検索方法の指定)をご覧ください。

-    **Q\&Aモードの有効化（オプション、コミュニティ版のみ）**
+    **Q\&Aモードの有効化（セルフホスト環境のみ対応）**

    このモードを有効にすると、システムはアップロードされたテキストを分割し、各分割のコンテンツを要約して自動的にQ\&Aマッチングペアを生成します。一般的な「Q to P」（ユーザーの質問がテキスト段落にマッチング）戦略とは異なり、QAモードでは「Q to Q」（質問が質問にマッチング）戦略を採用しています。

--- a/ja/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx
+++ b/ja/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx
@@ -186,6 +186,8 @@ Difyのドキュメント抽出器、あるいはMarketplaceから「Dify Extrac
 <Accordion title="ドキュメント内の画像">

  ドキュメント内の画像は、適切なドキュメントプロセッサを使用して抽出できます。抽出された画像は対応するチャンクに添付され、個別に管理でき、検索時にはそのチャンクと一緒に返されます。
+  
+  各チャンクには最大10枚まで画像を添付できます。これを超える画像は抽出されません。

  選択したプロセッサで画像が抽出されなかった場合、Difyは以下のMarkdown記法でアクセス可能なURLが参照されている2MB未満のJPG、PNG、GIF画像を自動的に抽出します：

@@ -193,15 +195,13 @@ Difyのドキュメント抽出器、あるいはMarketplaceから「Dify Extrac
    - `![alt text](image_url "optional title")`

  <Tip>
-      セルフホスト環境では、環境変数 `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT` でサイズ上限を調整できます。
+      セルフホスト環境では、以下の上限を環境変数で調整できます：
+  
+      - 画像サイズの上限：`ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`
+  
+      - 1チャンクあたりの添付画像数上限：`SINGLE_CHUNK_ATTACHMENT_LIMIT`
  </Tip>

-  <Note>
-      各チャンクには最大10枚まで画像を添付できます。これを超える画像は抽出されません。
-
-      セルフホスト環境では、環境変数 `SINGLE_CHUNK_ATTACHMENT_LIMIT` でこの上限を調整できます。
-  </Note>
-
  その後のインデックス設定で**Vision**アイコン付きのマルチモーダル埋め込みモデルを選択した場合、抽出された画像も埋め込み・インデックス化され、検索対象となります。

 </Accordion>
--- a/ja/use-dify/knowledge/knowledge-request-rate-limit.mdx
+++ b/ja/use-dify/knowledge/knowledge-request-rate-limit.mdx
@@ -6,11 +6,9 @@ tag: "CLOUD"

 <Note> ⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/use-dify/knowledge/knowledge-request-rate-limit)を参照してください。</Note>

-Dify クラウドサービスの安定性を維持し、すべてのユーザーにより良いナレッジベース利用体験を向上させるため、**2025 年 2 月 24 日** よりナレッジリクエストレート頻度制限（Knowledge Request Rate Limit）を導入します。
-
 ## ナレッジベースの要求頻度制限とは?

-ナレッジリクエスト頻度制限とは、1つのワークスペースがナレッジベースに対して1分間に実行できる最大リクエスト数のことです。この操作には、データセットの作成、ドキュメントの管理、アプリケーションやワークフローにおけるナレッジベースのクエリなどが含まれます。
+「Dify Cloud」では、ナレッジリクエスト頻度制限とは、ワークスペースが1分間にナレッジベース内で実行できる操作の最大回数を指します。これには、データセットの作成、ドキュメントの管理、アプリやワークフローでのクエリ実行などが含まれます。

 ## サブスクリプションバージョンの制限値

--- a/ja/use-dify/monitor/logs.mdx
+++ b/ja/use-dify/monitor/logs.mdx
@@ -53,15 +53,17 @@ AIが不適切な応答をしたり、ユーザーの意図を理解できなか
 **フィードバック分析**
 一般的な苦情パターン、成功したやり取りタイプ、改善が必要な分野を特定できます。

-## データ保持
+## ログの保持期間

 <Warning>
 アプリケーションが現地のデータプライバシー規制に準拠していることを確認してください。プライバシーポリシーを公開し、必要に応じ
 </Warning>

-**無料プラン：** ログは30日間保持されます
-**有料プラン：** プラン階層に基づく延長保持
-**セルフホスト：** 設定可能な保持ポリシー
+ - **Sandbox**：ログは30日間保持されます。
+
+ - **Professional & Team**：アクティブなサブスクリプション期間中はログ保持期間が無制限です。
+
+ - **セルフホスト**：デフォルトで無制限ですが、環境変数 `WORKFLOW_LOG_CLEANUP_ENABLED`、`WORKFLOW_LOG_RETENTION_DAYS`、`WORKFLOW_LOG_CLEANUP_BATCH_SIZE` で設定可能です。

 ## ログを使ったアプリケーションの改善

--- a/zh/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx
+++ b/zh/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx
@@ -14,13 +14,17 @@ title: 上传本地文件

 2. 选择 **导入已有文本** 作为数据源，然后上传文件。

+    - 单次最多可上传 5 个文件
+    
+        <Info>
+            在 Dify Cloud 上，仅 [**Professional** 和 **Team** 套餐](https://dify.ai/zh/pricing) 支持 **批量上传**（单次最多 50 个文件）。
+        </Info>
+
    - 单个文件最大支持 15 MB

-    - 单次最多可上传 5 个文件
-
-    <Info>
-        在 Dify Cloud 上，仅 [**Professional** 和 **Team** 套餐](https://dify.ai/pricing) 支持 **批量上传**。
-    </Info>
+    <Tip>
+        对于自托管部署，可通过环境变量 `UPLOAD_FILE_SIZE_LIMIT` 和 `UPLOAD_FILE_BATCH_LIMIT` 调整这两个限制。
+    </Tip>

 ---

@@ -28,16 +32,16 @@ title: 上传本地文件

    JPG、JPEG、PNG 和 GIF 格式且小于 2 MB 的图片将作为附件，自动提取到对应的分段。这些图片可独立管理，并在检索时与分段一同返回。

+    每个分段最多支持 10 个图片附件，超出的图片不会被提取。
+
    <Tip>
-        对于自托管部署，可通过环境变量 `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT` 调整图片大小限制。
+        对于自托管部署，可通过环境变量调整以下限制：
+    
+        - 最大图片尺寸：`ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`
+    
+        - 每个分段的最大附件数量：`SINGLE_CHUNK_ATTACHMENT_LIMIT`
    </Tip>

-    <Note>
-        每个分段最多支持 10 个图片附件，超出的图片不会被提取。
-
-        对于自托管部署，可通过环境变量 `SINGLE_CHUNK_ATTACHMENT_LIMIT` 调整此数量限制。
-    </Note>
-
    以上提取规则适用于如下图片类型：

    - DOCX 文件中嵌入的图片
--- a/zh/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx
+++ b/zh/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx
@@ -10,11 +10,7 @@ title: 指定索引方式与检索设置

 正如搜索引擎通过高效的索引算法匹配与用户问题最相关的网页内容，索引方式是否合理将直接影响 LLM 对知识库内容的检索效率以及回答的准确性。

-提供 **高质量** 与 **经济** 两种索引方式，其中分别提供不同的检索设置选项：
-
-<Note>
-  原 Q&A 模式（仅适用于社区版）已成为高质量索引方式下的一个可选项。
-</Note>
+提供 **高质量** 与 **经济** 两种索引方式，其中分别提供不同的检索设置选项。

 <Tabs>
  <Tab title="高质量">
@@ -37,7 +33,7 @@ title: 指定索引方式与检索设置

    高质量索引方式支持三种检索策略：向量检索、全文检索或混合检索。详见 [指定检索设置](#指定检索设置)。

-    **启用 Q\&A 模式（可选，仅适用于社区版）**
+    **启用 Q\&A 模式（仅适用于自托管部署）**

    开启该模式后，系统将对已上传的文本进行分段。总结内容后为每个分段自动生成 Q\&A 匹配对。与常见的 「Q to P」（用户问题匹配文本段落）策略不同，QA 模式采用 「Q to Q」（问题匹配问题）策略。

--- a/zh/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx
+++ b/zh/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx
@@ -188,7 +188,7 @@ title: "步骤二：编排知识流水线"

 <Accordion title="对于文档中的图片">

-通过合适的文档处理工具，可将文档中的图片提取为对应分段的附件。被提取的图片可独立管理，并在检索时与分段一同返回。
+通过合适的文档处理工具，可将文档中的图片提取为对应分段的附件。被提取的图片可独立管理，并在检索时与分段一同返回。每个分段最多支持 10 个图片附件，超出的图片不会被提取。

 若使用的工具未提取到图片，Dify 会自动提取通过以下 Markdown 语法引用、URL 可访问且小于 2 MB 的 JPG、JPEG、PNG 和 GIF 图片：

@@ -196,15 +196,13 @@ title: "步骤二：编排知识流水线"
  - `![替换文本](image_url "标题")`

 <Tip>
-    对于自托管部署，可通过环境变量 `ATTACHMENT_IMAGE_FILE_SIZE_LIMIT` 调整图片大小限制。
+    对于自托管部署，可通过环境变量调整以下限制：
+
+    - 最大图片尺寸：`ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`
+
+    - 每个分段的最大附件数量：`SINGLE_CHUNK_ATTACHMENT_LIMIT`
 </Tip>

-<Note>
-    每个分段最多支持 10 个图片附件，超出的图片不会被提取。
-
-    对于自托管部署，可通过环境变量 `SINGLE_CHUNK_ATTACHMENT_LIMIT` 调整此数量限制。
-</Note>
-
 若在后续的索引设置中选择多模态嵌入模型（带有 **Vision** 图标），则提取出的图片将被向量化并参与检索。

 </Accordion>
--- a/zh/use-dify/knowledge/knowledge-request-rate-limit.mdx
+++ b/zh/use-dify/knowledge/knowledge-request-rate-limit.mdx
@@ -6,11 +6,9 @@ tag: "CLOUD"

 <Note> ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处，请参考[英文原版](/en/use-dify/knowledge/knowledge-request-rate-limit)。</Note>

-为了维护 Dify 云服务系统的稳定性，并提升所有用户的知识库使用体验，我们将从 **2025 年 2 月 24 日** 起引入知识库请求频率限制（Knowledge Request Rate Limit）。
-
 ## 什么是知识库请求频率限制？

-知识库请求频率限制，指一个工作区在知识库中每分钟可执行的最大操作数。这些操作包括数据集创建、文档管理，以及在应用或工作流中的知识库查询。
+在 Dify Cloud 上，知识库请求频率限制指一个工作区在知识库中每分钟可执行的最大操作数。这些操作包括数据集创建、文档管理，以及在应用或工作流中的知识库查询。

 ## 不同订阅版本的限制

--- a/zh/use-dify/monitor/logs.mdx
+++ b/zh/use-dify/monitor/logs.mdx
@@ -58,9 +58,11 @@ icon: "memo"
 确保你的应用程序符合当地数据隐私法规。发布隐私政策并在需要时获得用户同意。
 </Warning>

-**免费计划：** 日志保留30天
-**付费计划：** 根据计划层级延长保留期
-**自托管：** 可配置的保留策略
+- **Sandbox**：日志保留 30 天。
+
+- **Professional & Team**：在订阅期内，日志无限期保留。
+
+- **自托管**：默认无限期保留；可通过环境变量 `WORKFLOW_LOG_CLEANUP_ENABLED`、`WORKFLOW_LOG_RETENTION_DAYS` 和 `WORKFLOW_LOG_CLEANUP_BATCH_SIZE` 配置日志保留策略。

 ## 使用日志改进应用程序