前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」，内置的 web_search 和 web_fetch 工具通常依赖宿主后端。当官方后端遇到限流或故障时，直接调用可能会失败。
dsh-hydrasearch 插件旨在解决这个问题。它通过注册 TinyFish 与 AnySearch 两个后端，构建了一个自动故障切换的链路，让 DSH 的搜索与抓取请求在两个免费服务之间自动流转，提供更稳定的网页检索能力。
插件定位¶
这是一个 TinyFish + AnySearch 搜索与抓取后端插件，支持双后端自动故障切换，由 dgagf111 维护，遵循 MIT 协议。
核心功能¶
- 双后端自动故障切换：当其中一个后端超时、限流或出错时，自动切换至另一个，保证请求不中断。
- 网页搜索：支持语言、地区、时间范围、站点黑白名单过滤，以及翻页控制。
- 网页抓取：支持将目标网页抓取为 Markdown、HTML 或 JSON 格式，并可提取页面内的链接。
- 资源与限流：提供免费额度与高频率限制，支持网页搜索与抓取。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add github:dgagf111/dsh-hydrasearch
- 重启 DSH 后，进入「插件页 → 已安装 → dsh-hydrasearch → 行内配置」。
- 首次使用需在卡片中填写 TinyFish 的 API Key（AnySearch 可先不填）。
- 使用 DSH 内置的
web_search或web_fetch验证：如果返回结果正常，说明请求已走 TinyFish / AnySearch 链路。
典型用法¶
安装并配置后，无需修改 DSH 的核心调用代码。在行内配置卡片中，你可以调整后端的顺序（排在前面优先使用），设置故障切换开关，并填写后端参数（如搜索语言、抓取格式、超时时间等）。
适用场景与注意¶
- 版本要求：仅支持 DSH 0.2.0-rc.2 及以上版本。旧版本已废弃，无法加载。
- API Key 安全：Key 仅存储在本地凭据中心，不上传云端，不参与第三方统计，仅发送至所调用的搜索服务。
- 版本升级注意：从 0.3.0 版本起，凭据引用名称变更为
HYDRASEARCH_TINYFISH_API_KEY/HYDRASEARCH_ANYSEARCH_API_KEY。如果从旧版本升级，需在卡片中重新填写 Key。 - 代码运行环境：插件以 DSH 进程权限运行，安装前请检查源码与许可证。
总结¶
dsh-hydrasearch 通过引入 TinyFish 和 AnySearch 两个免费后端，解决了 DSH 内置搜索工具的可用性问题。其自动故障切换机制确保了高可用性，适合需要大量网页搜索与抓取的开发场景。
