dsh-free-websearch: Keyless web_search and web_fetch for DSH

前言

在 DeepSeek Harness(DSH)里,模型需要联网时通常会走 Harness 自带的 web_search 和 web_fetch,背后可能是 DeepSeek 官方的付费搜索与抓取接口。若你本地跑的是自有模型、或不想为每次检索消耗平台额度,就需要一套不依赖 API Key、且不会悄悄回退到付费链路的替代方案。

下面介绍社区插件 @jamolpe88/dsh-free-websearch(维护者 JaMoLpE88,分类:联网工具)。它在 Harness 现有的 ctx.web 接缝上注册免费 provider,并通过 bundle patch 关闭 deepseek-official、deepseek-search-api、deepseek-fetch-api,使 web_search / web_fetch 的工具形态不变,但流量走五条免密钥通道,且零配置。

这是什么

一句话:web_search 由五条免密钥搜索引擎按序 failover 承担;web_fetch 优先本地 HTTP,遇墙或空壳页再升到 Firecrawl 免密钥抓取;DeepSeek 付费搜索与 fetch 被禁用,无 signup、无 settings、无付费回退。

插件以 npm 包 @jamolpe88/dsh-free-websearch 发布(当前资料中版本为 0.1.1),许可证 MIT,在 dsh-plugin.org 有收录。目录页:https://www.skillhub.cn/plugins/JaMoLpE88/dsh-free-websearch;源码:https://github.com/JaMoLpE88/dsh-free-websearch。

核心功能

搜索:五条通道、按序尝试

web_search 在冷却中的通道会被跳过,否则按下列顺序调用,第一个有结果即停止,一次搜索只消耗一条通道的配额(不是五条各打一遍):

通道 端点 匿名配额(资料原文)
keenable api.keenable.ai/v1/search/public 约 1000 次/小时/IP
firecrawl api.firecrawl.dev/v2/search 约 1000 credits/月
bing www.bing.com/search?format=rss 无公开上限
ddg html.duckduckgo.com/html/ 无公开上限
you api.you.com/v1/agents/search 约 100 次/天/IP

预算:单通道约 7 秒、整次搜索约 30 秒;结果缓存 5 分钟(50 条)。遇墙冷却 5 分钟;某通道月度池用尽则在当前进程内冷却。失败时会列出尝试过的通道及原因,并说明未调用付费 API。

抓取:本地优先,必要时升级

web_fetch 先走 Harness 自带的本地 HTTP provider;页面是墙、空内容或 JavaScript 壳时,再升到 Firecrawl 免密钥 scrape。插件不在本地渲染 JavaScript,仅对公开目标升级。

替换关系与明确不做的事

插件不新增工具(无 x_search、read_page 等),不读取任何凭证服务,不调用 api.deepseek.com,不抓 cookie、不存历史、不发遥测。禁用或卸载 bundle 后,Harness 默认 DeepSeek 联网行为可恢复。

环境与要求

  • DSH Desktop >= 0.2.1-rc.3,profile desktop(README 注明在 0.2.1-rc.3、Windows 11 上测试)。
  • 出站 HTTPS;无需 DeepSeek API Key、无需注册账号。
  • Node:包本身要求 >= 20.3;README 另写 DSH 自带运行时,Node 22+(以你安装的 DSH 为准)。

安装与启用

桌面端:Plugins → Add plugin,输入 @jamolpe88/dsh-free-websearch。

命令行(desktop profile):

dsh plugin --profile desktop add @jamolpe88/dsh-free-websearch

web profile 使用同一包:

dsh plugin --profile web add @jamolpe88/dsh-free-websearch

从 GitHub 添加(README 原文):

dsh plugin --profile desktop add github:JaMoLpE88/dsh-free-websearch

添加后刷新 DSH 窗口。在 live profile 下 bundle 无需重启即可生效;Plugins 页会列出 Free Web Search,官方 Web search 卡片不再出现(对应 provider 已被卸载)。

典型用法

没有单独命令、药丸或面板,用法与 Harness 默认联网一致:

  1. 提问需要检索的内容,模型调用 web_search,返回带来源标题、URL、摘要的 citation card(与付费 provider 呈现形式一致,资料说明)。
  2. 粘贴链接或询问某页内容时,模型调用 web_fetch;多数静态页由本地 HTTP 完成,复杂页由链式升级处理。

若搜索失败,错误信息会类似 keenable: HTTP 429; bing: no results。可重试,或检查 VPN 是否改变了出口 IP(匿名池按 IP 共享)。

适用场景与注意

适合:希望在 DSH 里用 web_search / web_fetch 做日常检索与读页,但不想配置 Key、也不想误触 DeepSeek 付费搜索/fetch 的开发者;本地或非 DeepSeek 端点模型同样适用(资料写明:安装后 DeepSeek 平台不在环路内)。

注意:

  • 五条通道均为第三方匿名配额,高峰或共享 IP 下可能 429 或空结果,属预期行为,failover 与冷却由插件处理。
  • 插件以当前 DSH 进程权限运行,会向上述公网端点发起 HTTPS 请求;安装前请阅读 GitHub 仓库 源码与 MIT 许可证,自行评估合规与隐私需求。
  • SkillHub / dsh-plugin.org 为社区目录,与 DeepSeek、幻方无官方从属关系;星标等元数据以各站点当时展示为准(线索中 GitHub 星标为 0)。

结尾

dsh-free-websearch 把 Harness 原生的 web_search、web_fetch 接到五条免密钥搜索链与「本地 fetch → 可选 Firecrawl」上,并硬性关闭 DeepSeek 付费 provider,避免配置失误产生费用。需要细节、failover 示意图与 bundle patch 说明时,以 README 为准。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye