issue: Web Search is not triggered when Knowledge base/Documents are attached

快速结论：在 Open WebUI 中同时启用知识库（Knowledge base/Documents）和 Web Search 功能时，系统仅执行基于附件的 RAG 检索，完全忽略 Web Search。优先排查是否开启了“Bypass Embedding and Retrieval”以及 Web Search 是否被后端管道过滤。

问题场景

用户使用 Open WebUI（Docker 安装，v0.9.6，Ollama 0.30.7）新建聊天会话，上传文档或附加知识库，同时启用 Web Search 配置；当输入需要实时外部信息（如今日新闻）的提示词时，系统只检索附件内容，不触发任何 Web Search。

报错原文

Web Search is completely ignored/not triggered.
Only performs a RAG (Retrieval Augmented Generation) search on the uploaded documents.

原因分析

这个行为不是孤立 bug，而是与多个已知问题关联。最可能的原因是：

当知识库被附加上传时，Open WebUI 的管道可能优先选择“legacy RAG pipeline”，而该管道不会触发 Web Search 后端。
Web Search 虽然产生了搜索结果（相关 issue #26119 提到会创建 web-search-* 集合），但检索阶段会把 type=web_search 的条目忽略，导致返回 0 个 source。
如果 “Bypass Embedding and Retrieval” 被启用，RAG 模板仍然可能被使用（#26126），这与 UI 提示的行为冲突，进一步干扰管道选择。

可能原因：核心冲突发生在后端管道调度逻辑——当 attachments 存在时，Web Search 被有条件地跳过。

环境排查

确认 Open WebUI 版本是否为 v0.9.6（或当前最新版）。
确认 Ollama 版本是否为 0.30.7。
检查 Docker 启动命令或 Docker Compose 中是否传入了影响管道的环境变量（如 WEBUI_SECRET_KEY、RAG_EMBEDDING_ENGINE 等）。
检查 Workspace → Chats → 聊天设置 中是否开启了 “Bypass Embedding and Retrieval” 或修改了 RAG 模板。
查看浏览器控制台（F12）和 Docker 容器日志，查找任何关于 web_search 或 pipeline 的警告/错误。本条讨论中用户未提供日志。

解决步骤

以下步骤基于相关 issue 的讨论和已知模式，并非来自本 issue 的直接修复（issue 被标记为无法复现）。可优先尝试：

临时工作流：在不附加任何文档或知识库的情况下新建聊天会话，仅启用 Web Search，验证 Web Search 正常工作。
检查并关闭“Bypass Embedding and Retrieval”：在工作区 → 聊天设置中确保该选项未勾选，以避免 RAG 模板注入冲突（参考 #26126）。
明确禁用知识库：在同一聊天会话中，要么只使用知识库，要么只使用 Web Search，不要同时附加两者。这是目前最可靠的规避方法。
清除 Web Search 缓存：在 Docker 内部或 Open WebUI 数据目录中，删除 web-search-* 相关集合/缓存（需备份后再操作），然后重新测试（参考 #26119 的建议）。
查看管道设计限制：检查你自定义的管道是否覆盖了默认行为，或者是否在使用任何影响路由的第三方插件。如果使用了 chat_completion_files_handler，请阅读其文档确认与 Web Search 的兼容性（参考 #25101）。

验证方法

创建一个仅附加一个简单的文本文件（如“我的名字是测试”）的聊天会话，同时启用 Web Search。
输入一个明确需要实时信息的问题，例如“今天的日期是什么？”。
观察回复中是否包含 Web Search 的结果（通常在回复底部会有 “Sources” 引用，显示 web_url）。如果回复仅引用附件内容而没有外部链接，则问题仍然存在。
作为对照，在不附加任何文档的会话中执行同样的问题，确认 Web Search 正常工作。