不用学新工具也能用:anysearch-dsh 双核心入口 web_search 与 web_fetch 实战指南
不用学新工具也能用: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。
进阶入口:专业搜索三连问
需要垂直数据(金融、代码、学术、法律、安全等)或批量查询时,按“先发现、再搜索”的顺序使用进阶入口:
anysearch_capabilities:读取实时能力目录,返回领域、子领域与参数定义,不要自行猜测tag或参数名;anysearch_search:携带tag、params、zone(cn/intl)、language发送完整搜索,结果数量最多 20 条;始终保留请求 ID 与搜索耗时,单次搜索正文累计上限 200,000 字符(实现见 src/tools/search.ts);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 后端完成。
延伸阅读
- 中文使用指南:docs/user-guide.zh-CN.md
- DSH 插件 / Skill / MCP / HTTP 四种接入方式对比:docs/integration-options.zh-CN.md
- DSH 版本兼容矩阵:docs/dsh-compatibility.md
- HTTP 客户端、凭据解析与错误处理源码:src/client.ts