前言¶
在 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,profiledesktop(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 默认联网一致:
- 提问需要检索的内容,模型调用
web_search,返回带来源标题、URL、摘要的 citation card(与付费 provider 呈现形式一致,资料说明)。 - 粘贴链接或询问某页内容时,模型调用
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 为准。