dsh-search-failover

v0.2.0 · 1 天前发布

Provider-level web search failover pool for DeepSeek Harness: rotate across 8 free/paid backends (Exa / Tavily / Serper / SerpApi / Jina / DuckDuckGo / SearXNG / Brave) with quota-aware circuit breaking, keeping the native web_search tool.

deepseekharnessdshdsh-pluginsearchfailovercircuit-breakerweb-search

README

dsh-search-failover

DSH 的 provider 级搜索池: 原生 web_search 工具不变, 内部自动在多个
免费/付费搜索后端间 failover / rotate, 带额度感知熔断。

状态: v0.2 (8 个后端适配器) · 设计文档见 dsh-config/docs/search-failover-design.md

为什么

dsh-search-mcp 能配多个服务器但没有自动 failover

dsh-web-search-pro 有自动回退但是重依赖的工具套件, 不是 provider 级

本插件: 轻量(纯 HTTP) + provider 级(保留原生工具) + 额度感知熔断

架构


web_search (原生工具)
  └── ctx.web → searchProvider: "search-pool"
        └── SearchPoolProvider.search(query)
              ├─ failover: 按 priority 依次尝试, 首个成功返回
              ├─ rotate:   健康后端轮询 (分散免费额度)
              ├─ 熔断: QUOTA→长冷却(1h) / TRANSIENT→阈值3次/5min→短冷却(60s)
              └─ 冷却到期半开探活, 成功即恢复

开发安装 (link:)

```bash

1. 装进 web profile (link: 改代码即时生效)

package.json 声明 dsh.bundle.patch → 自动加入 profile bundle 层

dsh plugin -

查看完整 README →

版本兼容矩阵

DSH 版本	状态	说明
`dsh@0.1.0-rc.6`	✅ 兼容	cordis patch ✅
`dsh@0.1.0`	✅ 兼容	标准 patch ✅
`dsh@0.2.0`	⚠️ 待验证	待实测（API 可能在变）
`dsh@0.3.0+`	❓ 未知	尚未发布

💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

元数据

License: MIT
npm: dsh-search-failover
Repo: git+https://github.com/Walvez/dsh-search-failover.git
Engines: {"node":">=22"}
Weekly DL: 0
Monthly DL: 0
dsh.bundle: {"bundle":{"patch":"cordis.patch.yml"}}