前言¶
DeepSeek Harness（dsh）採用插件化架構，將各種能力以插件形式掛載到 ctx.web 之上。在開發或使用 DSH 時，如果需要從全網檢索信息或抓取網頁正文，通常會用到內置的 search 與 fetch provider。官方計費的 deepseek-official 搜索在成本控制上並不友好，而許多第三方免費插件在多引擎支持、結果過濾與抓取噪聲處理上又各有限制。
wsjb114514/dsh-plugin-free-web 是一個免編譯、零依賴的本地預編譯插件，直接打包好 dist/index.js 與自動接管配置 cordis.patch.yml，安裝一次後即可自動接管 ctx.web.search 與 ctx.web.fetch，將搜索與抓取能力切換爲免費、多引擎並行、帶噪聲過濾的方案。
是什麼¶
這是一個爲 DeepSeek Harness 打包好的本地插件，包含預編譯的 dist/index.js 與自動覆蓋配置 cordis.patch.yml。安裝後，插件會自動禁用官方計費的 deepseek-official 搜索，並將 searchProvider 設爲 free-search-pfw、將 fetchProvider 設爲 free-fetch-pfw。這兩個 provider 的 ID 帶有 -pfw 後綴，可與其它使用相同 free-search/free-fetch 註冊名的免費 web 插件共存，不會觸發 WEB_DUPLICATE_PROVIDER。
插件提供兩種核心能力：多引擎並行競速搜索與增強型免費網頁抓取。
核心功能¶
多引擎並行競速搜索（free-search-pfw）¶
- 支持的搜索引擎：
- 360 搜索：中文查詢精度較高，作爲中文首選。
- Bing：英文/全球查詢首選，使用
www.bing.com並設置setlang=en，可命中 GitHub、官方文檔等原始資料。 - DuckDuckGo：作爲兜底，因本機常被限流，默認排在最後。
- 語言自動分流：
- 中文查詢優先走 360，英文查詢優先走 Bing。
- 任一引擎失敗時自動切換到另一個，互爲兜底。
- 並行競速與提前返回：
- 多個引擎同時發起請求，拿到優質結果後立即返回，不等待慢引擎超時。
- 相關性閘門：
- 搜索引擎偶爾會對某些 IP 返回與查詢無關的「串號」結果（HTTP 200、結構正常）。
- 當結果集的相關性低於閾值時，判定該引擎失效，切換到下一個引擎，不把垃圾結果交給模型。
- 引擎熔斷：
- 對連續失敗的引擎（如被限流的 DuckDuckGo）進行短期跳過，避免每次搜索都等待超時。
增強型免費網頁抓取（free-fetch-pfw）¶
- 默認使用 Jina Reader（
r.jina.ai）將網頁提取爲乾淨的 Markdown 正文。 - Jina 不可用時回退原生 HTTP，並自動將 HTML 轉爲純文本，避免把大量標籤噪聲交給模型。
- 導航噪聲剝離：
- GitHub 等站點的導航菜單可能佔用頁面 90% 以上的字符。
- 插件會剝離導航噪聲，只保留正文內容（實測 GitHub 倉庫頁 100000 字符 → 約 5000 字符正文）。
- 內置校驗與容錯：
- 拒絕空 URL、非 http(s) URL 以及包含內嵌賬號密碼的 URL。
- 對網絡瞬時故障進行重試。
- 對 Unicode 碼點進行安全截斷，避免截斷後產生亂碼。
安裝與啓用¶
安裝方式任選其一。
方式 A：從 GitHub 一鍵安裝（推薦）¶
在 DeepSeek Harness 聊天框中發送：
請調用
plugin_manager工具（action: install_bundle）幫我安裝這個 GitHub 插件：github:wsjb114514/dsh-plugin-free-web
DeepSeek Harness 會自動克隆、安裝並掛載，刷新頁面即可永久生效。
方式 B：聊天框本地安裝¶
- 從本倉庫下載源碼（Code → Download ZIP）並解壓到固定文件夾。
- 在 DeepSeek Harness 聊天框中發送（將路徑替換爲你的實際路徑）：
請調用
plugin_manager工具（action: install_bundle）幫我安裝這個本地插件：<你解壓後的文件夾絕對路徑>
方式 C：雙擊一鍵安裝腳本¶
- 下載源碼並解壓到固定目錄。
- Windows 用戶：雙擊運行
雙擊安裝插件_Windows.bat。 - Mac 用戶：雙擊運行
雙擊安裝插件_Mac.command。 - 看到“✅ 安裝完成”提示後重啓一次 DeepSeek Harness 即可。
典型用法¶
安裝完成後，在 DSH 的 ctx.web 中調用 search 與 fetch 時，即可直接使用 free-search-pfw 與 free-fetch-pfw。
- 搜索示例（僞代碼）：
const result = await ctx.web.search({
query: 'DeepSeek Harness 插件開發',
provider: 'free-search-pfw'
});
- 抓取示例（僞代碼）：
const content = await ctx.web.fetch({
url: 'https://github.com/wsjb114514/dsh-plugin-free-web',
provider: 'free-fetch-pfw'
});
適用場景與注意¶
- 適合需要零成本、多引擎並行檢索與網頁正文抓取的場景，特別是對 GitHub 等外國站點的檢索需求。
- 本插件以當前 dsh 進程的權限運行，請確保來源可信。
- 安裝前建議檢查源碼與許可證（MIT）。
- 插件依賴第三方公開搜索接口（360、Bing、DuckDuckGo）與 Jina Reader、GitHub 社區鏡像，這些服務的可用性與反爬策略不受本倉庫控制。
- 搜索結果準確性取決於搜索引擎；插件內置相關性閘門過濾明顯無關的結果，但不保證內容完全可靠。
- 請遵守目標網站的服務條款，勿用於高頻爬取。
結尾¶
該插件在免費方案中提供了多引擎並行搜索與增強型網頁抓取能力，能夠滿足本地開發與使用中的基礎需求。更多細節可參考：
- 插件目錄頁：https://www.skillhub.cn/plugins/wsjb114513/dsh-plugin-free-web
- GitHub 倉庫：https://github.com/wsjb114514/dsh-plugin-free-web
