English | 中文
dsh-hydrasearch
给 DeepSeek Harness 加上两个免费、几乎不限量的网页搜索后端。
装好之后，DSH 内置的 web_search / web_fetch 背后就多了一层保障：TinyFish 与 AnySearch 两个后端轮流待命，一个不行自动换另一个。
当前版本 0.4.0，已支持 DSH 0.2.0-rc.2。 已在本机 0.2.0-rc.2 桌面版实测：插件正常加载，web_search 与 web_fetch 都通过 TinyFish / AnySearch 链路返回结果。旧版本（0.1.x-rc.6、0.1.6-alpha.2、0.1.7-alpha.1、0.1.7-rc.1）已不再支持，原因见「支持的 DSH 版本」。
优势
- 都免费，频率限制极高。 TinyFish 与 AnySearch 都提供免费额度，日常搜索与抓取基本用不完。AnySearch 甚至不必先申请 key，匿名即可使用（只是额度低一些）。
- 双后端自动故障切换。 某个后端超时、限流或出错，自动切到下一个，搜索不会因为一个后端的问题而整体失败。
免费额度与限流
| 后端 | 费用 | 限流 |
|---|
| TinyFish 搜索 | 免费，不消耗账户余额 | 30 次/分钟 · 500 次/小时 |
| TinyFish 抓取 | 免费，不消耗账户余额 | 150 个网址/分钟 · 1000 个网址/天 |
| AnySearch（已填 key） | 免费档 1000 次/天 | 20 QPS |
| AnySearch（匿名） | 共用每日免费额度 | 按客户端 IP 限流，低于上者 |
TinyFish 的搜索与抓取在任何账户余额下都免费，余额为 0 也照常工作。AnySearch 不填 key 也能用，填 key 后升到免费档。数据来自两家官网，可能调整，以官网为准。
功能
- 搜索：网页搜索，可按语言、地区、时间范围、站点黑白名单、垂直领域筛选，并控制每次翻几页。
- 抓取：把指定网址抓成 Markdown、HTML 或 JSON，可选同时带出页面内的链接与图片链接。
安装
一条命令添加本仓库，然后重启 DSH：dsh plugin --profile web add github:dgagf111/dsh-hydrasearch
重启后打开 插件页 → 已安装 → dsh-hydrasearch → 行内配置入口。首次使用需要在卡片里给 TinyFish 填一个 key；AnySearch 可以先不填。
装好后可直接用 DSH 的 web_search / web_fetch 验证：两者都应正常返回，说明请求确实走了 TinyFish / AnySearch 链路，而不是内置的官方搜索。
支持的 DSH 版本
| DSH 版本 | 状态 |
|---|
| 0.2.0-rc.2 | ✅ 已支持 — peerDependencies 声明为 ^0.2.0-rc.2，manifestVersion 为 1，dsh.engines.dsh 为 >=0.2.0-rc.2；已在本机桌面版实测通过 |
| 0.1.6-alpha.2 / 0.1.7-alpha.1 / 0.1.7-rc.1 / 0.1.x-rc.6 | ❌ 不再支持（有意放弃，非遗漏） |
旧代际为什么放弃：DSH 会按插件的 @deepseek-ai/dsh-* peer 范围做一次兼容性闸门检查，只要有一个 peer 范围不满足，整个 bundle 会被直接跳过——插件不会出现在「已安装」列表里（连灰色不可用的一行都没有），界面上也没有任何提示，唯一的痕迹是启动时 stderr 上的一行 skipping profile bundle "dsh-hydrasearch": ... is incompatible with dsh 0.2.0-rc.2。旧版本的 peer 是 ^0.1.0-rc.6，在 0.2.0-rc.2 上不满足，于是整包消失；0.4.0 把 peer 提到 ^0.2.0-rc.2 即修复。
从旧版本升级
- 升级 DSH 到 0.2.0-rc.2。
- 重跑安装命令，让 profile 拿到 0.4.0：
dsh plugin --profile web add github:dgagf111/dsh-hydrasearch（dsh plugin 只是把你给的参数转发给 profile 目录里的 pnpm 并重新对齐 bundle 列表，所以这个命令重复执行是安全的）。
- 重启 DSH。
API key 需要重新填写一次。 0.3.0 起凭据引用改成了插件自有命名（HYDRASEARCH_TINYFISH_API_KEY / HYDRASEARCH_ANYSEARCH_API_KEY）——旧名字会被常见的环境变量名遮蔽，导致卡片能存不能改、能存不能清。旧引用下的 key 不会被读取，请在卡片里重新填入。
本版本变更的完整说明见 CHANGELOG.md，机制层面的记录见 docs/。
配置
全部在插件页的 dsh-hydrasearch 卡片里完成：
- 后端顺序：拖动调整，排在前面的先用。
- 故障切换：默认开启；关闭后只使用第一个可用的后端，它的失败就是最终结果。
- 后端参数：搜索地址、语言、地区、时间范围、站点过滤、翻页数、抓取格式、超时、缓存策略等，按需填写，留空即不发送。
API Key 与隐私
- key 只存在你自己机器上的凭据中心（DSH 的本地凭据文件），不上传、不同步、不写进日志。
- 插件只把 key 放进请求头，发给你所调用的那个搜索服务本身，除此之外没有任何第三方接收方；插件自身也不包含遥测或使用统计上报。
- 读取、写入、清除三个动作指向同一个存储位置。
License
MIT
