检索的手感变了,因为我让 Agent 自己去查文档
先说结论。装上这个搜索 Provider 之后,我的检索动作从「我搜、我读、我判断、我贴给模型」变成了「我给判断标准,它自己去找来源」。真正变化的是分工——检索主体从我变成了 Agent。
它的 Star 是 422,周下载 1,837。这些数字我扫过就忘了,真正让我改掉旧习惯的是动线本身。
一段很具体的工作流:让 Agent 去查一个刚发布的库
我手上有一类活儿,共同特征是「文档是活的」:库刚发新版本,API 面还在动,README 是英文,社区里散着几条 issue,官方文档和实际行为之间可能差一版。另一类是「文档是陌生的」:一份我没用过的 API 文档,字段含义只能靠上下文推。
这两类活儿以前都长一个样——我开浏览器,搜,点进去,读,判断哪条最新,再把结论贴回 Agent。它能写代码、能改文件,但一碰到「外面发生了什么」,就得停下来等我。
现在我的提示词变成了这样一句:「这个库的新版本里,那个参数还生效吗?找到官方来源再回答。」关键在后半句:我把判断标准交给它,把找来源这个动作也交给它。
动线变化一:我不再喂链接,只喂判断标准
旧动线里,链接是我的活:我得先知道去哪儿找,再把 URL 塞进去。
新动线里,我可以只描述「我要什么级别的来源」:官方仓库、官方文档站,还是任何能被引用的一手页面。这一条能成立,是因为插件把 AnySearch 接成了 Harness 的搜索与抓取 Provider,覆盖公开网页,也覆盖代码、金融、学术、法律、安全等专业数据源。查刚发布的库时,我不需要先猜它在哪个站点上。
有个细节值得单独说:普通网页搜索走的是 Harness 原生的 web_search,返回带标题、摘要和 URL 的结果,URL 在那里,所以引用得出来。这件事看着小,却决定了这条动线能不能闭环。
动线变化二:被替换掉的其实是 web_search 与 web_fetch 本身
这是我觉得最舒服的地方:不需要改变 Harness 的使用方式。
插件做的事是把 AnySearch 设为现有 ctx.web 的搜索与抓取 Provider。也就是说,我调用的还是 web_search 和 web_fetch,形状、参数、返回的位置都没变,变的只是背后供数的人。抓取那条链路走的是 AnySearch Extract,抓取并清洗公开 HTTP(S) URL 的正文。
顺带一个容易一开始就踩的点:你会找不到 anysearch_extract 这个工具,因为插件刻意不再增加一个重复的提取工具,网页提取统一从 web_fetch 出去。我一开始翻了半天工具列表,后来才在兼容性说明里看到这一句。
动线变化三:遇到垂直领域,我会主动切到参数化检索
公开网页搜索解决的是一般问题。真正省时间的是另一类场景:我关心的不是「网上怎么说」,而是「代码这个域里怎么说」。
这时动线会多一步。先用 anysearch_capabilities 看一眼当前有哪些可搜索领域、垂直分类和支持的参数,再用 anysearch_search 带着标签、地区、语言和结构化参数去查。这些领域和参数是实时发现的,不是一份写死的固定清单。
动线变化四:一次问好几件事,走批量
我经常一口气攒出好几个独立问题,比如「A 库这个 API 变了没」「B 服务这个字段还叫这个名字吗」。这些问题彼此没有依赖,用 anysearch_batch_search 一次并发执行 1~5 个搜索就够了,而且单项失败不影响其他结果。范围是一次 1~5 个,超过 5 个要自己分批。
有一种情况我仍然自己下场
动线变短了,但没有变没。需要登录态,或者需要浏览器自动化的时候,我还是自己开浏览器:插件替换的是 web_search / web_fetch 这条链路,它不做浏览器自动化,也不处理登录态抓取。后台页面、登录后可见的文档、要点几下才出现的动态内容,都得我自己来。这是边界,不是缺陷。
坑一:所有搜索请求一起超时
现象。 装完之后第一次试,不是偶发失败,是全部搜索都不通——普通搜索、抓取、高级工具,一个都不行。
原因。 这个插件的所有能力都要打到 api.anysearch.com。详情页对这点有明确警示:插件运行需访问外部网络 / 远程 API,部署在国内无外网环境时可能无法正常使用。
怎么处理。 先确认实例或主机有可用的出网通路。如果是云上环境,按域名做一次白名单很有用——它的价值不在于放行,而在于把「出网被拦」和「凭据不对」区分开。
坑二:免 Key 用了几天开始失败
现象。 快速体验不需要 API Key,我就这么用了,前几天一切正常,然后开始失败。
原因。 未配置凭据时走的是 AnySearch 匿名额度,额度有限,用完就没了。
怎么处理。 去 anysearch.com 注册账号、拿一个 API Key 配进来,会得到每天 1000 次免费搜索调用额度。要长期依赖它,就别停在匿名模式上。
坑三:配置里冒出了第二个 AnySearch Provider
现象。 我想顺手改点东西,加了一条自己的配置,结果搜索行为变得不可预期。
原因。 配置层的要求是保持 id: web-search-anysearch 不变、完整替换 config。用另一个 ID 新增第二个 Provider,会把它重复挂载一遍。
怎么处理。 覆盖时保持 id 不动,整段替换 config,不要用新 ID 再加一个。
总结
它换掉的是我的检索动线,而不是一个工具按钮:链路还是 Harness 原生的 web_search / web_fetch,但找来源这件事从我这搬到了 Agent 那边;想对照同类插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:已经在用 DeepSeek Harness、希望 Agent 能自己去查实时资料的人;经常要查刚发布的库、陌生 API 文档这类「活文档」的开发者;需要代码、学术、法律等垂类数据源,而不只是普通网页搜索的场景;一次要问好几个互不依赖问题、希望并发检索的人。
不适合:运行环境没有出网通路——插件所有能力都要访问外部网络与远程 API,部署在国内无外网环境时直接用不了;需要浏览器自动化或登录态抓取——它替换的是 web_search / web_fetch 链路,不提供这两样;把它当成零维护的稳定依赖——本站实装验证未通过(unsupported_dep_spec),信任档位是「需留意」,站点也尚未对它做风险分级,装前建议先到 GitHub 仓库确认最近更新与 issue。
标签:anysearch-dsh、DeepSeek Harness、搜索 Provider、Agent 检索动线
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。