多源搜索路由 chenyuhao0628/dsh-web-search-router

dsh-web-search-router

一个免费的多服务商网页搜索路由器，用于 DeepSeek Harness (DSH)。

插件保留 DSH 内置的 web_search 工具，并注册 multi-search 服务商。它先走无需密钥的 Parallel 端点，只有在需要更多结果或某个服务商失败时，才回退到已配置的搜索 API。

功能

- 无需密钥的 Parallel 搜索作为第一路由。
- 可选回退到 Tavily、Exa、Brave Search、Serper 和 SerpApi。
- 动态回退顺序，兼顾预估免费额度和实测延迟。
- 实时刷新 Tavily 和 SerpApi 配额，并从响应头读取 Brave 配额。
- 收集到足够的不重复结果后立即退出。
- URL 规范化、去重，以及倒数排名融合（RRF）。
- 遇到限流、配额、认证或临时错误后，服务商进入冷却。
- DSH 设置页里只写不读的 API 密钥控件。
- 不依赖付费的 DeepSeek 网页搜索服务商。

路由

每个请求按以下顺序处理：

1. 不带 API 密钥查询 Parallel。
2. 如果返回的不重复结果已经够用，立即停止。
3. 按剩余预估免费额度和指数加权的实测延迟，给已配置密钥的服务商排序。
4. 一次查询一个服务商，达到请求的结果数量就停止。
5. 用 RRF 去重并合并所有收集到的结果。

目前对带密钥服务商的初始预估，按容量/延迟得分排序，依次偏向 Tavily、Exa、Brave Search、Serper 和 SerpApi。运行时实测可以自动改变这个顺序。

进入带密钥的回退链之前，如果 Tavily 和 SerpApi 的十分钟缓存已过期，路由器会刷新它们的账户用量。Brave 配额直接从正常搜索响应头里读取，无需额外请求。Exa 和 Serper 目前使用进程内预估，因为它们没有公开的余额查询端点。已知余额为零的服务商会被跳过，直到用量快照发生变化。

冷却时间：HTTP 429 为 10 分钟，配额或额度耗尽为 6 小时，认证失败为 1 小时，其他临时故障为 1 分钟。这些是进程内的健康提示，不是实时配额计数。

安装

在 DSH web 配置档目录下，安装 GitHub 仓库：

cd ~/.dsh/profiles/web
pnpm add github:chenyuhao0628/dsh-web-search-router

把 dsh-web-search-router 加入该配置档 package.json 里的 dsh.profile.bundles，然后重启 DSH。如果尚未选中，把网页搜索服务商选为 multi-search。

本地开发时，用 link 依赖也可以：

{
"dependencies": {
"dsh-web-search-router": "link:/absolute/path/to/dsh-web-search-router"
}
}

API 密钥

打开 DSH 设置，选择 网络搜索。每个字段直接写入 DSH 的凭据服务，绝不把存储的密钥读回页面。
同一页面会显示实时、响应头、估算和冷却四种状态。点 刷新额度 可以强制重新检查 Tavily 和 SerpApi 的账户用量。

| 服务商 | 凭据引用 | 是否必填 |
| Parallel | 无 | 否 |
| Tavily | TAVILY_API_KEY | 否 |
| Exa | EXA_API_KEY | 否 |
| Brave Search | BRAVE_SEARCH_API_KEY | 否 |
| Serper | SERPER_API_KEY | 否 |
| SerpApi | SERPAPI_API_KEY | 否 |

API key 不会存进 Cordis 配置，也不会存进这个仓库。不要把凭据写进 package.json、提交记录、issue 报告或截图里。
浏览器状态接口只接收归一化后的额度元数据；第三方账户的原始数据，以及解析出来的凭据值，都不会越过这条边界。

开发

需要 Node.js 20 或更高版本，以及 pnpm。

pnpm install
pnpm check
pnpm test

测试覆盖 URL 归一化、RRF 合并和服务商排序。插件面向 peerDependencies 中声明的 Cordis 和 DSH web API。

许可证

MIT