DreamRift/dsh-web-search-pool

Plugin插件 Native原生 ⭐ 5 MIT Search & Web Access搜索与联网

DeepSeek Harness 网页搜索插件:多个 Tavily/Exa key 按限流负载均衡,429 自动切换 key,附带设置页 UI 与 Tavily 额度总览。

Project Overview项目介绍

This is a native web search load balancing plugin built exclusively for DeepSeek Harness (DSH), that ships a native DSH bundle manifest and integrates natively with DSH's plugin system. It adds a web_search capability to DSH that lets users group multiple Tavily and Exa API keys into a single managed pool, and routes search requests based on the current rate limit of each key. If a key hits rate limits, runs out of quota, throws a network error, or times out, the plugin automatically fails over to another working key or even another provider to complete the request. It also supports two scheduling algorithms: weighted round-robin based on permitted requests per minute, and least-used.

This plugin is designed for DSH users who want to use multiple search API keys to increase total allowed search requests, and avoid being blocked when a single key hits its rate limit. After you install the plugin, it automatically takes over DSH's web search function, so you don't need to manually select a search provider every time you run a search. To get started, all you need to do is add your API key references to the plugin's settings card in DSH and save your changes. If you don't have an Exa key, you can still use the plugin's anonymous free tier hosted by the official project, which has a rate limit of 1 request per second.

The plugin is released under the open source MIT license, and requires DSH version 0.1.1-rc.x or 0.1.2+ to work correctly. You need to have pnpm available in your system PATH to complete the local installation, and you need at least one valid search API key (unless you only use the Exa anonymous free tier). To install, you run npm pack to build the plugin archive, then use the DSH CLI to add the packed tgz file to your profile, then dump your config to confirm searchProvider is set to search-pool. All API keys are stored only via DSH's credential service, and are never written to plaintext config files or exposed in logs.

这是一个专为DeepSeek Harness(DSH)开发的原生网页搜索负载均衡插件,为DSH提供原生web_search能力。它支持将多个Tavily或Exa的API密钥组成智能密钥池,按照各密钥的限流规则智能调度请求,遇到密钥限流超额、网络错误或超时会自动切换密钥,不同服务商之间也可以自动兜底切换。它支持按每秒请求数加权轮询或最少使用两种调度策略,还提供了使用仪表盘查看额度。

适合需要使用多个搜索API密钥提升整体请求限额、避免单密钥限流阻塞搜索的DSH用户使用。安装完成后插件会自动接管DSH的网页搜索能力,用户无需手动选择搜索提供者,只需要在设置面板的插件卡片中添加密钥信息保存即可,不填Exa密钥也可以直接使用官方提供的匿名免费层,速率限制为每秒1次请求,满足基础搜索需求。

本插件遵循MIT许可证开源,依赖DSH 0.1.1-rc.x或0.1.2+版本,需要系统PATH中包含pnpm才能完成安装,至少需要一个搜索API密钥(Exa可用匿名免费层)。密钥仅通过DSH的凭据服务存储,不会写入配置文件,日志也不会记录密钥明文,安全性有保障。安装后需要转储配置确认searchProvider已设置为search-pool,遇到问题可查看官方文档排查。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:DreamRift/dsh-web-search-pool

把 DreamRift/dsh-web-search-pool 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-web-search-pool

为 DSH 提供 Tavily / Exa 多 key 搜索:按限流调度、失败切换及额度门禁;支持 Exa 匿名通道。密钥仅以凭据引用保存,不写入设置和日志。

适配基线为 DSH 0.1.7-rc.2 与 0.2.0-rc.1 双线(后者 2026-09-28 依桌面版 app.asar 源码核对 + e2e 实测);不要据此推定所有后续宿主兼容。当前包版本、peer 范围和命令以 package.json 为准。

按任务读取

需要 入口
安装、配置、升级、回滚或排障 安装与升级
调度策略、Bundle、设置与凭据机制 架构与机制
改入口、事件、宿主适配或发布 开发规范与事故复盘
查已发布变更 CHANGELOG

开发

在本项目目录运行 npm run test:local,或按改动运行对应测试。npm pack --dry-run 用于包内容检查。

真实宿主 E2E 是单独验证,不是日常文档检查;使用真实凭据及联网选项前先核对 安装与升级 中的副作用。不要把旧测试计数当作当前通过记录。

MIT License。

← 上一个 Prev dsh-connect 下一个 Next dsh-subagent-library →