在使用 Dify 知识库 API 过程中，很多开发者在调用 /datasets/{dataset_id}/document/update-by-text 接口时，常常会产生一个疑问：

👉 这个接口到底是 “智能差异更新” 还是 “纯覆盖更新”？

网上的资料并不多，很多人根据接口名误以为是增量更新。今天我结合官方源码 + 实际测试，给大家全面拆解一下 Dify 知识库 API 中 “根据文本更新文档” 的真实行为，避免大家踩坑！

 

---

📌 1️⃣ API 接口名称解析

Dify 提供的接口路径如下：

/datasets/{dataset_id}/document/update-by-text

从名字 update-by-text 看起来像是 “更新已有文档”，容易误解成 智能 diff 更新 或 增量追加。

但实际行为和名字并不完全一致！

---

📌 2️⃣ 实际行为࿱