从 Dify 撤下一份旧资料,要确认它真的退出检索
Dify 禁用、归档和删除文档的作用不同。用旧版退出、新版进入和全新会话复查,判断陈旧答案来自检索、历史对话还是应用缓存。

把新版文件上传成功,只说明多了一份资料,旧版未必退出检索。Dify 的禁用、归档和删除对应不同的保留方式。撤回旧知识后,要直接检查候选片段,并用全新对话验证应用,才能分清旧答案还从哪里来。
禁用、归档和删除该怎么选?
按当前内容维护文档,禁用会把文档临时排除在检索之外;归档适合暂时不检索、仍需保留的资料,归档文档只读,可以取消归档;删除则永久移除,不能撤销。
| 目标 | 可先考虑的操作 | 随后验证什么 |
|---|---|---|
| 暂时撤回有疑问的资料 | 禁用 | 同一知识库的新检索不再返回它 |
| 保存历史、停止日常检索 | 归档 | 当前检索不含它,历史资料仍按管理规则保留 |
| 明确不再保留该文档 | 按保留制度删除 | 对象与范围正确,另查备份及其他副本 |
先在临时知识库或应用副本演练,再处理正式资料。删除一份知识文档不能证明上传原件、备份、外部源、历史消息和应用缓存都被清理;这些存放位置需要各自的保留规则。本文也不提供全库清空命令。
上传新版之前,应该记下哪几个标识?
至少记下知识库 ID、旧文档 ID、版本与关键片段,以及哪些应用仍绑定这份库。文件名容易重复,不能只靠“制度最新版.pdf”确认对象。新旧版本需要同时保留供历史查询时,先采用版本与适用日期筛选,别把每份旧资料都当垃圾删除。
准备两条教学输入:demo-hours-v1 写“服务窗口为 09:00–17:00”,demo-hours-v2 写“服务窗口为 10:00–18:00”。它们不是本站实际服务时间。两个版本都加稳定标识,测试问题用“演示窗口几点开始”。
这类更新有两种处理顺序。普通换版可以先让新资料完成处理并在副本中验证,再切换适用范围并撤下旧版;若旧资料已经确认错误且不能继续使用,先停止它参与检索,即使短期只能回复“资料待确认”。不要为了保持有答案,继续让已撤回的规则进入模型。
什么结果才说明旧资料没有被新请求搜到?
先在知识库检索测试中查原问题及改写问题,检查实际文档/片段 ID,不只看答案里的时间。然后核对应用节点选择了哪些库,是否还有另一份同内容文档或外部知识源。
Dify 的检索测试说明提醒,测试页设置只对当前测试会话有效。节点文档也区分库层与节点层处理。因此,不能拿测试页临时收紧的条件,代替已经发布应用的实际条件。
可以把检查写成“禁止再出现的来源集合”。下面的离线检查只适用于已经归一化为这组结构的检索结果,不是 Dify 原始响应契约:
retired_ids = {"demo-hours-v1"}
retrieved = [
{"document_id": "demo-hours-v2", "chunk_id": "opening-hours"},
]
leaked = [row["document_id"] for row in retrieved
if row["document_id"] in retired_ids]
if leaked:
raise ValueError("Retired evidence is still retrievable")
print("No retired IDs in this result")
它只证明这一次结果没有这些 ID,不证明所有问法、所有应用或所有存储都已清理。还要包含旧文独有的一句内容作为反向测试,避免两版文字接近时只盯着正确答案。
候选已经干净,为什么聊天还说旧规则?
旧会话可能带着之前的回答或工具结果。检索规则的变化不会自动重写模型已经收到的历史。用一个全新会话重问,并对照实际输入:如果新会话正确、旧会话错误,先查历史内容;如果两者候选都含旧版,继续查绑定、复制文档与筛选条件。
应用自己实现了答案缓存时,缓存也应纳入内容更新流程,例如把知识版本加入缓存身份,或按影响范围失效。这是应用设计建议,不是 Dify 已经替你做过的保证。不要把Embedding 缓存与维度迁移的故障处理直接套过来;答案缓存、查询向量和旧索引是不同对象。
保留三份验收记录:新检索实际返回哪些来源、全新会话使用了哪些证据、原有会话如何提示规则已经更新。来源本身是否支持答复,可继续看引用链检查;没有可用证据时的测试见无答案验收题。
本文于 2026 年 11 月 21 日核对 Dify 当前文档,仅用合成列表验证旧文档 ID 检查,没有执行真实禁用、归档、删除或缓存失效。Nbility 的接入基础解决模型连接;知识资料的撤回与应用历史需要在知识库和应用侧各自验收。


