[Bug]: Go: auto/semi_auto meta_data_filter reports “no match” for an empty filter, and callers handle it in opposite ways

快速结论：该报错通常出现在 RAGFlow Go 后端的检索链路中：当 meta_data_filter.method 为 auto 或 semi_auto 时，空的过滤结果（模型未产出条件、或回复无法解析）与“条件匹配不到文档”都以同一个 (nil, true) 返回，导致 agent Retrieval 工具检索不到任何文档，而 chat、/api/v1/retrieval 等调用方却静默忽略过滤。优先排查检索结果为空是否由空条件触发，以及是否运行在修复前的提交上。

适用环境：RAGFlow Go 后端，代码提交 98b48a08；Linux x86_64，Docker；文档引擎 Elasticsearch 8.11.3。Issue 未提供 Python、CUDA、PyTorch、显卡等信息。

最快修复方案：升级到包含 PR #20979（提交 0f6f08ca）的 main 分支版本。修复后 ApplyMetaDataFilter 返回单个 []string：auto/semi_auto 未生成条件时保留调用方原有范围，-999 哨兵仅用于 manual，各调用方读取方式一致。

注意事项：该修复只解决“未产出过滤条件”的情形（原报告 bug 1）；对于“生成了条件但匹配不到文档”的统一行为（bug 2），Issue 中明确说明这是需要另行设计决策的事项，未在本 PR 中处理。修复后这类条件匹配为空的情况也会回退到调用方范围，是否符合你的业务预期需自行确认。

问题场景

用户在 RAGFlow Go 后端（提交 98b48a08）中使用 meta_data_filter 的 auto 或 semi_auto 模式进行检索时触发问题。典型场景包括：agent 的 Retrieval 工具在处理未提及任何元数据的问题（或 LLM 回复无法解析）时检索结果为空；以及通过 POST /api/v1/retrieval 带 meta_data_filter 检索时，过滤条件未命中也会返回文档，返回结果中没有任何信息说明过滤被忽略。

报错原文

[Bug]: Go: auto/semi_auto meta_data_filter reports "no match" for an empty filter, and callers handle it in opposite ways

原因分析

最可能的原因是 internal/service/metadata_filter.go 中的 ApplyMetaDataFilter 在结果为空时统一返回 (nil, true)，但“结果为空”实际包含三种不同情形：LLM 返回 {"conditions": [], ...}、回复无法解析（GenMetaFilter 回退为空条件）、以及条件匹配不到任何文档。三者共用同一个标志位，导致调用方无法区分。

而各调用方对该标志的处理方式相反：chat completion 忽略标志、保留未过滤文档列表；search app 的 RetrievalTest 与 /api/v1/retrieval 的 selectMetadataFilteredDocIDs 保留未过滤列表；agent Retrieval 工具（enhancer.go 的 FilterDocuments）则返回 NoMatchDocIDSentinel，使检索返回空。问题在于过滤提示词（rag/prompts/meta_filter.md 规则 5d）要求模型跳过不在元数据中的属性与值，因此未提及元数据的问题很常见地得到零条件，进而落入这一歧义路径。

环境排查

确认 RAGFlow Go 后端代码提交是否为 98b48a08 或更早，是否已包含 #20979（0f6f08ca）。
确认文档引擎为 Elasticsearch 8.11.3（Issue 中确认的环境）。
确认 meta_data_filter.method 当前设置为 auto、semi_auto 还是 manual；manual 在条件匹配不到时返回哨兵是既有预期行为。
确认触发问题的入口：chat completion、agent Retrieval 工具、/api/v1/retrieval 或 search app 检索测试。
Issue 未涉及 Python、CUDA、PyTorch、显卡版本，无需据此排查。

解决步骤

在复现检索为空的 agent 场景时，先确认问题中的提问是否未提及任何元数据字段（如示例中的 date），或 LLM 回复是否可能解析失败——这类情况属于“未产出过滤条件”。
如需临时缓解，可优先尝试将相关检索的 meta_data_filter.method 改为 manual 或关闭该过滤，以避开 auto/semi_auto 的空条件歧义（此为规避思路，非 Issue 验证方案）。
升级到包含 PR #20979（0f6f08ca）的 main 版本。该 PR 将 ApplyMetaDataFilter 的返回改为单个 []string：auto/semi_auto 未生成条件时保留调用方范围，NoMatchDocIDSentinel（-999）仅由 manual 返回，chat、agent 路径、agent retrieval bridge、retrieval test、dataset search 各调用方读取方式统一。
升级后对于“生成了条件但匹配不到文档”的情况，同样回退到调用方范围；如业务上需要严格无结果，需等待 Issue 中提到的 bug 2 设计决策落地。

验证方法

在 agent Retrieval 工具使用 auto/semi_auto 的场景中，用不涉及任何元数据的提问复测，检索应返回按基础文档范围得到的结果，而不是空结果；同时检查 chat 与 /api/v1/retrieval 路径行为与升级前一致。Issue 中的示例复现方式为：对带 date 元数据字段的数据集发起 POST /api/v1/retrieval（page_size 为 64，method 为 semi_auto），用一个不存在日期的问题（如 “3 January 1990”）观察结果是否仍返回无关会话文档，以对照过滤行为。