不用学新工具也能用:anysearch-dsh 双核心入口 web_search 与 web_fetch 实战指南

原创2026-11-05 00:54:472,138 阅读

不用学新工具也能用:anysearch-dsh 双核心入口 web_search 与 web_fetch 实战指南

anysearch-dsh(npm 包名 @anysearch/anysearch-dsh)是面向 DeepSeek Harness(DSH)的实时网页搜索插件:安装后,Harness 原生的 web_search 立即由 AnySearch 提供实时网页搜索,原生的 web_fetch 则通过 AnySearch Extract 抓取并清洗指定 URL 的正文。两个核心入口沿用原有工具名,零学习成本——模型照旧调用原生工具,插件在后台完成请求转发、结果清洗与错误兜底。🎯

“双核心入口”架构:插件在背后做了什么

一句话:anysearch-dsh 把 AnySearch 注册为 DSH web profile 的搜索 Provider 与抓取 Provider,并顺带启用原生 web_fetch。模型可见的完整入口共 5 个:

使用场景 入口工具 说明
普通网页搜索 web_search Harness 原生,只需查询词与结果数量
抓取指定 URL 正文 web_fetch Harness 原生,返回清洗后的 Markdown 正文
查询可用领域与标签 anysearch_capabilities 实时能力目录
垂直/参数化搜索 anysearch_search 支持 tag、params、zone、language
批量并行搜索 anysearch_batch_search 一次 1~5 项,单项失败不影响其他项

双核心 web_search / web_fetch 覆盖日常场景,三个 anysearch_* 进阶入口负责专业检索。搜索 Provider 实现在 src/provider.ts,抓取 Provider 在 src/fetch-provider.ts,注册流程见 src/index.ts。

web_search:实时网页搜索,结果可直接引用

像平时一样提问即可,例如:“搜索 DeepSeek Harness 最近的发布变化,并附上来源链接”。模型调用 web_search 后:

  • 请求只发送 query 与结果数量两个字段,转发到 AnySearch 的 /v1/search;
  • 每条结果返回 title、url、snippet 三个字段,URL 均为合法的绝对 HTTP(S) 地址,可直接作为引用来源;
  • 非法 URL 的条目会被静默过滤,不会导致整次搜索失败;
  • 安装即生效:内置的 profile 层会自动把 AnySearch 设为搜索来源,无需任何手动配置(见 cordis.patch.yml)。

💡 需要正文时交给 web_fetch 或进阶工具——web_search 有意不返回完整正文,以保持 Harness 通用搜索接口的字段一致。

web_fetch:从 URL 到干净正文一步到位

把一个公开的 HTTP(S) URL 交给 web_fetch,插件会将其转发到 AnySearch 的 /v1/extract:

  • 得到的是可读的 Markdown 正文(HTML 已在上游转换),而非原始 HTML;
  • 结果保留最终 URL与源站的 2xx 状态,并带截断标记 truncated;
  • HTTP 请求有 55 秒超时保护;Agent 主动取消时,进行中的抓取会立即中止(超时参数见 src/limits.ts);
  • 插件不注册重复的 anysearch_extract——正文提取只走这个原生入口。

典型提问示例:

核实某个开源项目当前的安装方式,并引用官方文档。

最快安装两步走

环境要求:Node.js 22.19+ 或 24+、pnpm 11.7,且 npx 能直接从 PATH 运行;Windows / Linux / macOS 命令完全相同。

第 1 步:把插件装入 web profile

npx -y @deepseek-ai/dsh plugin --profile web add @anysearch/anysearch-dsh

这一步同时完成三件事:添加插件、把 AnySearch 选为搜索与抓取来源、启用原生 web_fetch。

第 2 步:启动 DeepSeek Harness

npx -y @deepseek-ai/dsh web

即可开用,无需 API Key——请求走 AnySearch 匿名额度(共享池、限流更低),适合快速体验。

可选:配置 API Key 解锁每日免费额度

注册 AnySearch 账号并配置 API Key 后,每天可享 1,000 次免费搜索,建议持续使用者配置。插件只保存引用名 ANYSEARCH_API_KEY,不保存真实值。

方式一(推荐):DSH 受管凭据文件,写入 ~/.dsh/.credentials.yaml(设置了 DSH_HOME 时为 $DSH_HOME/.credentials.yaml):

ANYSEARCH_API_KEY: "as_sk_your_key"

修改该文件后无需重启,下一次搜索自动使用新 Key。⚠️ 若原样保留占位符 as_sk_your_key,插件会拒绝发起请求;想匿名使用则直接删除整条配置。

方式二:启动环境变量(优先级高于凭据文件,但修改后需重启 DSH 进程):

export ANYSEARCH_API_KEY="as_sk_your_key"

安全提醒:不要把真实 Key 写入 Git 仓库、截图、日志或问题报告。

如何验证请求真的走了 AnySearch

运行以下命令查看最终 profile 配置:

npx -y @deepseek-ai/dsh --profile web --dump-config

应看到如下两行(注意:配置里只应出现 apiKeyEnv: ANYSEARCH_API_KEY 引用而非真实 Key,这是预期的安全行为):

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

同时确认存在插件条目 - id: web-search-anysearch,以及 tool-web 配置中的 fetch: true。

进阶入口:专业搜索三连问

需要垂直数据(金融、代码、学术、法律、安全等)或批量查询时,按“先发现、再搜索”的顺序使用进阶入口:

  1. anysearch_capabilities:读取实时能力目录,返回领域、子领域与参数定义,不要自行猜测 tag 或参数名;
  2. anysearch_search:携带 tag、params、zone(cn / intl)、language 发送完整搜索,结果数量最多 20 条;始终保留请求 ID 与搜索耗时,单次搜索正文累计上限 200,000 字符(实现见 src/tools/search.ts);
  3. anysearch_batch_search:并发执行 1~5 个独立搜索项,结果按输入顺序返回,单项失败单独标记、不影响其他项(实现见 src/tools/batch.ts)。

示例提示词:“查询 AAPL 最新行情。先获取 finance 领域能力,再使用准确的标签和参数搜索。”

常见问题速查

问:不配置 API Key 能用吗? 答:可以,走匿名额度;额度耗尽或触发限流后稍候重试,或配置 Key。

问:修改 Key 后需要重启吗? 答:改受管凭据文件不用重启,下次搜索即生效;改启动环境变量需要重启 DSH 进程。

问:出现 WEB_PROVIDER_ERROR 怎么办? 答:依次检查:① baseURL 是否正确;② 当前网络能否访问 api.anysearch.com;③ API Key 是否有效、禁用或过期;④ 匿名或账号额度是否用完;⑤ 上游是否返回 429 / 5xx。报告问题时附错误消息与发生时间即可。

问:为什么结果和直接调 HTTP API 不完全一样? 答:不同入口字段不同——web_search 只保留通用来源字段(title/url/snippet),anysearch_search 保留完整结构化结果与元数据,但搜索计算都由同一个 AnySearch 后端完成。

延伸阅读

登录后查看全文
anysearch-dsh