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>
This commit is contained in:
Riskey
2025-12-16 19:37:13 +08:00
committed by GitHub
parent 821b83c0b5
commit 5d7556d5f2
15 changed files with 101 additions and 95 deletions

View File

@@ -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 文件中嵌入的图片

View File

@@ -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」问题匹配问题策略。

View File

@@ -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>

View File

@@ -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 上,知识库请求频率限制指一个工作区在知识库中每分钟可执行的最大操作数。这些操作包括数据集创建、文档管理,以及在应用或工作流中的知识库查询。
## 不同订阅版本的限制

View File

@@ -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` 配置日志保留策略。
## 使用日志改进应用程序