DeepSeek Harness (DSH) 内置的 web_search 工具依赖付费提供商。dsh-web-search-router 插件在 DSH 中注册了一个 multi-search 提供商。它首先尝试无密钥并行搜索，然后根据需要或提供者失败回退到配置的搜索 API。
核心功能¶
该插件提供以下能力：
- 无密钥并行搜索作为第一路由：使用 Parallel 的 Keyless Parallel 端点。
- 可选回退提供商：支持 Tavily, Exa, Brave Search, Serper, 和 SerpApi。
- 动态回退排序：根据估算的免费容量和观测到的延迟对回退提供商进行排序。运行时测量可能会改变此顺序。
- 实时额度刷新：刷新 Tavily 和 SerpApi 账户使用情况，以及 Brave 响应头额度。
- 提前退出：一旦收集到足够的唯一结果，立即停止。
- 结果处理：URL 规范化，去重，以及倒数排名融合 (RRF)。
- 提供者冷却：速率限制，配额，认证或瞬时错误后的冷却。
- 仅写入 API 密钥：在 DSH 设置页面中管理密钥。
- 无付费依赖：不依赖 DeepSeek 的付费 Web 搜索提供商。
安装与启用¶
- 进入 DSH Web 配置目录：
cd ~/.dsh/profiles/web
- 使用 pnpm 安装 GitHub 仓库：
pnpm add github:chenyuhao0628/dsh-web-search-router
- 编辑该配置目录下的
package.json，在dsh.profile.bundles中添加依赖项：
{
"dsh.profile.bundles": ["dsh-web-search-router"]
}
- 重启 DSH。
- 在 Web 搜索提供商选择中，确保选择了
multi-search。
典型用法¶
在 DSH 设置中，选择 multi-search 作为网络搜索提供商。如果需要，可以在设置中输入 Tavily, Exa, Brave Search, Serper, 或 SerpApi 的 API 密钥。插件会在后台自动处理路由、去重和排名。
注意事项¶
- 安全性：API 密钥由 DSH 设置页面管理，不存储在 Cordis 配置或此仓库中。请勿将凭据放入
package.json、提交记录、问题报告或截图中。浏览器状态端点仅接收规范化后的额度元数据；第三方账户负载和解析后的凭据值不会跨此边界。 - 额度管理：Tavily 和 SerpApi 支持实时刷新，Exa 和 Serper 目前使用进程本地估算（因为它们不公开余额端点）。
- 冷却机制：提供者在遇到错误后会进入冷却状态（例如：HTTP 429 为 10 分钟，配额耗尽为 6 小时，认证失败为 1 小时）。
结语¶
dsh-web-search-router 提供了一个灵活、免费的搜索路由替代方案，适合需要回退或管理多个搜索提供商的场景。作者为 chenyuhao0628，许可证为 MIT。
