DSH Plugins
返回列表
🖥️

search-failover

客户端 更新于 2026.11.15

在终端中运行以下命令:

dsh plugin install crisweb1994/search-failover

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install crisweb1994/search-failover 安装插件,源码仓库为 https://github.com/crisweb1994/search-failover。

插件介绍

Agent 的搜索往往只接一家 API:月度额度用完、被限流,或网络一抖,这次搜索就失败。更糟的是,工具若把失败吞掉只返回空列表,模型会误以为网上没有相关信息,转而用训练数据作答,语气还很笃定。search-failover 把多家搜索能力收进同一个 web_search 工具,按优先级依次尝试;第一家有结果即结束,且每一步成败都写进返回值,让 Agent 分清「没搜到」和「没搜成」。

默认链覆盖博查、Tavily、Brave、Exa、SearXNG、DuckDuckGo 等来源,只配置了凭据的才会参与;DuckDuckGo 免 key 可作兜底。各家错误按真实信号归成八类并各有冷却策略,不在同一家死磕重试。返回值面向模型设计,带完整 fallback_chain;链里全是 no_results 才算真没结果,否则 MCP 用 isError 标明搜索未完成。支持 include_domains 时优先能过滤的来源,并在 note 里说明限制。

一份配置可服务所有宿主:凭据与顺序可用环境变量或 ~/.config/search-failover/config.json,各端往往只需一行 npx。本地 Claude Code、Cursor、Codex 等走 stdio;只支持远程 MCP 的平台可用 Streamable HTTP,多客户端共享额度计数、冷却与缓存。付费或一次性额度来源须显式列入链,网关还带本地请求预算与限速,并支持 HTTPS_PROXY 等代理。

适合需要稳定网页检索、又不想被单一供应商绑死的开发者与团队:既要可观测的兜底过程,又希望发布包小而可审计、无运行时依赖。

使用场景

  • 日常编码或调研时需要稳定可用的网页检索,不能接受单一 API 额度耗尽即全线失败
  • 需要让模型看清搜索走过哪些来源、为何跳过,避免把失败误判为「网上没有信息」
  • 多宿主或多客户端共用搜索额度,希望本地 stdio 与远程 HTTP 都能接同一套配置

适合人员

  • 在 Cursor、Claude Code、Codex、dsh 等环境里接 MCP 的开发者
  • 为多模型 Agent 编排搜索能力、希望降低单点供应商风险的技术团队
  • 需要可观测兜底链、本地预算与代理支持的自托管或企业内部用户