前言¶
DeepSeek Harness（DSH）裏，模型要查資料、打開鏈接，通常依賴 web_search 與 web_fetch 兩類能力。官方 DeepSeek Search/Fetch 自 2026-11-01 起按量計費；社區裏也有自行接搜索引擎、Reader 服務的做法，但往往要編譯、配環境變量，或與其他免費插件搶同一套 provider 名稱。
下面介紹的是維護者 yachio-suki 在 SkillHub 分類「聯網工具」下的 dsh-plugin-free-web：預編譯 bundle，安裝後可自動把搜索切到 free-search-pfw、抓取切到 free-fetch-pfw，用 360 / Bing / DuckDuckGo 並行競速搜索，抓取側優先 Jina Reader，並帶相關性過濾與 GitHub 頁噪聲剝離。費用與 API Key 均爲零；README 中自測對比顯示，外國站（含 GitHub）檢索佔比與官方接近或略高，搜索中位延遲約 420 ms，略高於官方約 305 ms。
這是什麼¶
dsh-plugin-free-web 是面向 DSH 的本地預編譯插件（已含 dist/index.js 與 cordis.patch.yml），當前 package 版本 1.0.1，許可證 MIT，要求 Node >= 20。
它解決兩類問題：一是聯網搜索不依賴付費官方 API；二是網頁抓取儘量返回乾淨正文，而不是整頁 HTML 或站點導航。插件通過帶 -pfw 後綴的 provider id（free-search-pfw / free-fetch-pfw）註冊能力，可與環境中其他註冊 free-search / free-fetch 的插件共存，避免 WEB_DUPLICATE_PROVIDER。
核心功能¶
自動接管官方搜索與抓取¶
內置 cordis.patch.yml 與運行時邏輯：安裝後自動禁用計費的 deepseek-official 搜索，並將 searchProvider 設爲 free-search-pfw、fetchProvider 設爲 free-fetch-pfw。無需再靠命令行環境變量手工切換。
free-search-pfw：多引擎並行競速¶
- 360 搜索：中文查詢優先。
- Bing：英文與全球查詢優先（
www.bing.com+setlang=en）；中文查詢走cn.bing.com（README 說明曾修復www.bing.com對部分中文查詢「串號」的問題）。 - DuckDuckGo：兜底；本機易被限流時默認排在最後。
機制要點：
- 按查詢語言調整引擎順序，失敗時互爲兜底。
- 多引擎並行發起，先拿到優質結果即返回。
- 相關性閘門：HTTP 200 但內容與查詢無關的結果集會判爲引擎失效，換下一個引擎。
- 引擎熔斷：連續失敗的引擎短期跳過，減少無效等待。
free-fetch-pfw：增強抓取¶
- 默認優先經 Jina Reader（
r.jina.ai）提取 Markdown 正文。 - Jina 不可用時回退原生 HTTP，並將 HTML 轉爲純文本。
- 對 GitHub 等站點做導航噪聲剝離（README 舉例：倉庫頁約 10 萬字符可壓到約 5000 字符正文）。
- URL 校驗（拒絕空 URL、非 http(s)、內嵌賬號密碼）、網絡瞬時故障重試、Unicode 安全截斷。
README 註明：隨包 dist/index.js 在本副本中已修復 Bing 正則、相關性、空 URL 抓取等問題；第三方搜索與 Jina 的可用性不受倉庫控制。
安裝與啓用¶
任選 README 中的一種方式；不要使用未在文檔中出現的 CLI 拼接安裝命令。
方式 A：GitHub 一鍵安裝（推薦）¶
在 DSH 聊天框發送（原文 install 指向的倉庫 slug 如下）：
請調用 plugin_manager 工具（action: install_bundle）幫我安裝這個 GitHub 插件：github:wsjb114514/dsh-plugin-free-web
Harness 會克隆、安裝並掛載；刷新頁面後生效。
方式 B：本地目錄安裝¶
- 從 GitHub 下載源碼 ZIP 並解壓到固定目錄。
- 在聊天框發送（路徑改爲你本機絕對路徑）：
請調用 plugin_manager 工具（action: install_bundle）幫我安裝這個本地插件：<你解壓後的文件夾絕對路徑>
方式 C：一鍵腳本¶
解壓後：Windows 雙擊 雙擊安裝插件_Windows.bat；Mac 雙擊 雙擊安裝插件_Mac.command。出現安裝完成提示後重啓一次 DSH。
發佈包主要文件包括 dist/index.js、cordis.patch.yml、locale/zh.json / locale/en.json 等；免 npm install / npm run build。
典型用法¶
安裝並完成自動接管後，無需單獨配置 provider：在對話中讓模型搜索或打開 URL，即走 free-search-pfw 與 free-fetch-pfw。例如：
- 中文技術問題：依賴 360 優先與 Bing 兜底。
- 查 GitHub 倉庫、英文文檔：Bing 優先，README 自測外國站佔比較高。
- 給定 https 鏈接：優先 Jina 正文，失敗則 HTTP + 去噪文本。
具體工具名與參數以當前 DSH 內置的 web_search / web_fetch 爲準；插件在後臺替換實現，不改變你習慣的對話方式。
適用場景與注意¶
適合：希望 DSH 聯網但不想買官方 Search/Fetch 配額；需要中文與 GitHub/外文站兼顧；希望開箱即用、少碰編譯與環境變量。
注意：
- 插件以當前 DSH 進程權限訪問網絡與讀本地 bundle；安裝前請閱讀源碼與 MIT 許可證，並知悉免責聲明（遵守目標站點條款、勿高頻爬取）。
- 結果準確性取決於搜索引擎；相關性閘門只能過濾明顯無關頁，不保證內容完全可靠。
- SkillHub 目錄頁與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；星標等元數據以各站點當時顯示爲準。
結尾¶
dsh-plugin-free-web 把 DSH 的搜索與抓取接到免費多引擎與 Jina/HTTP 抓取鏈路上，並用 bundle 補丁固定 provider，降低與官方計費能力及其他免費插件的衝突成本。若要在 Harness 里長期零 Key 聯網，可按上文任選一種安裝方式啓用。
