多源网页搜索 Rainpomelo/dsh-anysearch

dsh-web-search-anysearch

DeepSeek Harness (DSH) 的多源级联网页搜索插件。

当智能体触发网页检索时，本插件按优先级依次尝试可用的搜索源；首选源请求超时、限流、报错或返回零结果时，自动降级到备用源，避免单点故障导致搜索中断。

级联顺序

1. AnySearch（首选）
- 使用 AnySearch Search API 获取结构化检索结果。
2. Tavily（备用源）
- AnySearch 未配置、报错或零结果时自动切换。

为什么没有 DeepSeek 兜底

早期版本有第三层「DeepSeek 官方搜索」，已移除——它实现错了：它往 https://api.deepseek.com/chat/completions 发一个 search: true 参数，而 DeepSeek 的联网检索并不是聊天接口上的参数，而是 Anthropic 格式的 /messages 端点 + web_search_20250305 服务器工具。结果是那一层永远拿不到 sources，却把模型的一段聊天回复当作搜索结果返回。

如果你想要 DeepSeek 检索，DSH 自带正确的实现，把 web.searchProvider 指回 deepseek-official 即可：

- id: web
config:
searchProvider: deepseek-official

安装与接入

在 profile 的 package.json 里加依赖，并在 dsh.profile.bundles 里登记（用 dsh plugin add 或桌面端「添加插件」都会自动完成这两步）：

{
"dependencies": {
"dsh-web-search-anysearch": "github:Rainpomelo/dsh-anysearch"
},
"dsh": { "profile": { "bundles": ["dsh-web-search-anysearch"] } }
}

仓库已改名为 dsh-anysearch（原 deepseek-harness-anysearch）。旧地址会自动 301 跳转，已发布的安装 spec 继续可用。
包内名字 dsh-web-search-anysearch 刻意未改——它是既有 profile 已经解析的身份，也是 bundle patch 里 insert 的那个名字。

然后确认 patch 生效：
- insert:
- id: web-search-anysearch
name: dsh-web-search-anysearch

- id: web
config:
searchProvider: anysearch
fetchProvider: http

不需要另外安装 @deepseek-ai/dsh-web-fetch-http。DSH 0.2.0-rc.2 的基础包已经自带它，且注册的 id 就是 http。
如果你此前按旧版本文档手动装过一份（file: 指向本地目录），请卸掉：它的 patch 会再 insert 一次同一个 id web-fetch-http，与基础包冲突，插件列表会把那一条标成「异常」。

配置参数

API Key 可以通过插件配置或环境变量提供，两者都行。

方式 A：在 profile 的 patch 里配置

- id: web-search-anysearch
config:
apiKey: "as_sk_your_anysearch_key" # AnySearch API Key
tavilyKey: "tvly-your_tavily_key" # 可选：Tavily 备用 Key maxResults: 5 # 单次搜索返回条数（默认 5）

方式 B：使用环境变量

| 环境变量 | 说明 |
| ANYSEARCH_API_KEY | AnySearch 的认证密钥 |
| ANYSEARCH_BASE_URL | 自定义 AnySearch 接口地址（默认 https://api.anysearch.com/v1） |
| TAVILY_API_KEY | Tavily API Key |
| TAVILY_BASE_URL | 自定义 Tavily 接口地址（默认 https://api.tavily.com） |

两个 Key 至少要有一个，否则 available() 会返回 false，seam 会以 WEB_PROVIDER_CONFIGURED_UNAVAILABLE 拒绝这次搜索——这是刻意的：有凭据的 provider 谎报可用，只会让每次搜索都变成一个专属报错。

运行日志说明

插件在后台运行时会通过标准控制台输出当前命中的搜索源：

- [dsh-web-search] AnySearch 返回结果 (5 条) | 关键词: "..."
- [dsh-web-search] Tavily 返回结果 (5 条) | 关键词: "..."
- [dsh-web-search] AnySearch 请求异常，降级到下一个源: HTTP 429 ...

当所有源都没结果时，抛出的错误会逐条说明每个源到底发生了什么（未配置 API Key / 请求成功但没有结果 / 具体报错），而不是笼统地说一句「未配置有效的搜索 API Key」。

开发

node --test tests/*.test.mjs

tests/patch.test.mjs 检查 bundle patch 与模块导出的 id 是否仍然一致； tests/provider.test.mjs 用打桩的 fetch 驱动级联逻辑（降级、零结果、Key 缺失、 maxResults 透传、取消信号透传等）。

License

MIT