dsh-free-search-lite:無需 API Key 的輕量聯網搜索與網頁正文讀取

前言

在 DeepSeek Harness(dsh)裏讓模型查公網資料,常見做法是接 MCP、Python 子進程或帶 Key 的搜索 API。部署和維護成本不低,預設裏還可能和內置工具疊在一起。社區插件 dsh-free-search-lite(維護者 ayakadaisuki,分類:聯網工具)走另一條路:純 Node 插件、兩個原生工具、零配置,不啓動瀏覽器、Python 或 MCP 子進程。下面介紹它是什麼、裝好後能做什麼,以及安裝與試用方式。

這是什麼

dsh-free-search-lite 是爲 dsh 提供的社區插件,不是 DeepSeek 官方產品,也與 npm 上已有的 dsh-free-search 不是同一個項目。定位是 Key-free 的中英文公網搜索,以及靜態網頁正文抽取;安裝並啓用後,工具由 dsh 自動發現,不要求單獨選專用預設。

安裝後得到什麼

插件註冊兩個工具:

工具 作用
free_search 中英文公網搜索,返回標題、原始網址、摘要、來源和引擎狀態
free_search_fetch 讀取 HTML/文本頁面正文,長內容按字符分頁,儘量保留代碼塊

搜索側:360 與 Bing RSS 並行查詢,結果不足時回退 DuckDuckGo;去重、合併來源並丟棄明顯離題條目。運行時不需要 Python、虛擬環境、瀏覽器、Playwright、MCP 子進程、管理網頁、數據庫或 API Key。無需配置文件——啓用即可。

與本插件無關的舊鏈路:它不是舊 Python MCP 免費搜索服務的啓動器;不會改寫默認模型、預設或已有 MCP。原有 free-search 預設可繼續用,新工具會與舊工具並存;確認本插件可用後,可按需手動停用舊 mcp-free-search,避免重複。若某預設限制了工具列表,需在該預設中允許 free_search 與 free_search_fetch。

兼容版本

README 寫明已在 DeepSeek Harness 0.2.1-rc.3、Node.js 24.21.0、Windows x64 上驗證;最低 Node.js 24.14.0。package.json 中 engines.dsh 與該預覽版精確匹配——其他 dsh 版本需重新驗證後再用,不能靠跳過兼容性檢查強行安裝。項目僅有 Node 代碼、無平臺原生依賴;macOS/Linux 尚未在資料中宣稱實測。

安裝與啓用

倉庫保留預構建的 lib/,一般無需本地構建。可選預構建包:v0.1.1 / dsh-free-search-lite-0.1.1.tgz。

dsh 桌面端(desktop profile)

在官方桌面端打開 插件 → 添加插件,使用 GitHub 倉庫地址:

https://github.com/ayakadaisuki/dsh-free-search-lite

也可選擇上述 dsh-free-search-lite-0.1.1.tgz。確認安裝來源並啓用「輕量免費搜索」;若界面提示重啓,按提示操作。README 強調:desktop profile 應通過桌面界面安裝,不要用外部 CLI 改它。

CLI 管理的 Web profile

dsh plugin --profile web add github:ayakadaisuki/dsh-free-search-lite

項目不依賴 npm 發佈;README 未宣稱已被插件市場收錄,收錄以市場維護者結果爲準。

典型用法

README 給出的試用思路:先用 free_search 搜索 DeepSeek Harness 官方 GitHub 倉庫,再用 free_search_fetch 打開結果中的官方介紹頁,用兩句話摘要並附上原始鏈接。

工具參數(摘自 README):

free_search

參數 說明
query(必填) 1–500 字符
count(可選) 1–15,默認 8
refresh(可選) 繞過緩存

free_search_fetch

參數 說明
url(必填) 公網 HTTP(S)
start(可選) 起始字符,默認 0
length(可選) 1000–20000,默認 12000
refresh(可選) 重新抓取

分頁:將上次返回的 nextStart 作爲下次的 start;nextStart: null 表示緩存內正文已讀完。正文最多保留 200000 字符,超出時 sourceTruncated: true。返回中的時間字段是抓取時間,不是網頁發佈日期。

適用場景與注意

適合誰

  • 希望在 dsh 裏做中英文聯網檢索、讀靜態頁正文,又不想維護 MCP/Python/瀏覽器棧的開發者。
  • 已在使用 dsh 0.2.1-rc.3 且 Node ≥ 24.14.0 的環境(資料中 Windows 已驗證;其他系統需自行驗證)。

能力與邊界(資料原文要點)

  • 搜索詞會發往 360、Bing,必要時 DuckDuckGo;抓取 URL 會訪問對應站點;結果可能進入模型上下文。零 API Key 不等於離線或完全本地。
  • 無遙測、登錄、Cookie 持久化;緩存在插件進程內存中約 5 分鐘,卸載或重啓即清空(cacheScope: process)。
  • 僅公網 HTTP(S) 與標準端口;內網、迴環、含賬號密碼的 URL 會被拒絕;不執行 JavaScript,不替代登錄態 SPA、PDF/Office 等。
  • 搜索引擎接口非穩定官方 API,失敗或 no_reliable_results 不能理解爲「信息不存在」。
  • 插件在 dsh 宿主進程執行,不等於工作區沙箱;調用仍走 dsh 工具策略。安裝前應閱讀源碼與 MIT 許可證;搜索適配思路部分移植自 sweetcornna/free-search-mcp 0.13.1,其餘能力未移植。

DeepSeek Harness 生態強調「一切皆插件」;SkillHub 等社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。

結尾

dsh-free-search-lite 用兩個原生工具把「搜」和「讀頁」收進 dsh 插件進程:無 Key、無 MCP 子進程、安裝後零配置。若你的 dsh 版本與 README 聲明一致,可從桌面端或 Web profile 的上述命令安裝,再按 README 試用 free_search 與 free_search_fetch。

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

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

小夜