dsh-free-websearch:爲 DSH 提供免密鑰的 web_search 與 web_fetch

前言

在 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 爲準。

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

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

小夜