asdshuaishuai/websearch-plugins

README 摘要

websearch-plugins 个人用的 DeepSeek Harness 搜索插件包： 聚合搜索 （16 个国内+海外引擎，结果层过滤）+ 目标网址直接抓取 ，全部 不依赖任何 API Key 。注册后 web search / web fetch 工具在 没有 DEEPSEEK API KEY 的环境里也能真实可用。 基座思路：PhantomJS 式无头抓取 基座是最上游的 ariya/phantomjs（ BSD-3-Clause ）的无头抓取 思想——“scriptable headless browser”：不渲染 GUI、不依赖浏览器，直接用代码把网页数据拿给 agent 用。 （本地基座素材来自我的 fork asdshuaishuai/phantomjs， 与上游是同一份源码。）这里把同一哲学在 Node 里落地为 全方面适配 的聚合搜索：不针对某台机器/某个网络， 而是把国内 + 海外的引擎全部配上；谁通谁用，网络异常/被墙/验证码/空结果的引擎直接在 结果层过滤 。 引擎清单（16 个，全部注册、按需过滤） 区域 引擎（provider id = phantom- ） 国内 domestic baidu 百度、 sogou 搜狗、 so360 360搜索、 smcn 神马、 bingcn 必应中国 海外 overseas bing 必应国际、 google 、 duckduckgo 、 brave 、 mojeek 、 qwant 、 ecosia 、 yahoo 、 yandex 、 startpage 、 searx （SearXNG searx.be） 每个引擎既可单独用（ phantom- ），也默认全部汇入聚合 phantom-aggregate 。 三个 provider - phantom-aggregate （ web search 默认选中）：16 个引擎并行 fan-out，能通就收， 留在结果层的只有成功项——失败/超时/被墙/空结果的引擎被过滤并把原因写进摘要； 跨引擎按 URL 归一化去重（同一条目优先保留带摘要的），轮询交错排序让 top-N 覆盖多个引擎， 按 maxResults 封顶。 - phantom- ：16 个单引擎 provider，可单独指定。 - phantom-http （ web fetch ）：直接抓取目标网址。手工逐跳处理重定向，每跳做 SSRF 防护 （拒绝环回/私网/链路本地/CGNAT/保留地址，域名先解析再校验）； 非 2xx 视为结果而非错误；HTML 上限 1MB / 文本 512KB，超出截断并置 truncated 。 实现原理 一条搜索请求怎么走 关键设计 - 能力接缝，不是工具 ：插件只做 ctx.web.registerSearchProvider({id,…

分类