前言¶
DeepSeek Harness (DSH) 的 ctx.web 接口爲智能體提供了聯網能力。在沒有代理或 API Key 的環境下，直接調用搜索引擎或抓取網頁通常面臨反爬蟲、網絡受限或 SSRF 風險。websearch-plugins 插件通過內置 16 個國內外搜索引擎的聚合能力與帶 SSRF 防護的抓取功能，將這一過程封裝爲標準 DSH 插件，讓 web_search 和 web_fetch 工具在不依賴外部 Key 的情況下可用。
核心功能¶
聚合搜索與結果過濾¶
插件內置 16 個搜索引擎，包括百度、搜狗、360、神馬、必應中國等國內引擎，以及 Google、Bing、DuckDuckGo、Yahoo、Yandex 等海外引擎。默認使用 phantom-aggregate 提供聚合搜索，系統會並行發起請求，並自動過濾掉超時、被牆、403 或解析爲空的失敗結果，最終返回去重後的有效條目。
直接抓取與 SSRF 防護¶
通過 web_fetch 工具可以直接抓取目標 URL。插件實現了基於 DNS 解析與跳轉檢測的 SSRF 防護，拒絕訪問環回地址 (127.0.0.0/8)、私有網段 (10.x/172.16.x/192.168.x)、鏈路本地地址及保留地址。同時，對 HTML 限制 1MB，文本限制 512KB，超出部分會截斷並標記爲 truncated。
瀏覽器模擬與零依賴¶
插件不依賴任何外部運行時庫，直接使用 Node.js 內建的 fetch。在請求層，它模擬了真實瀏覽器的行爲：攜帶完整的 Chrome 桌面級標頭 (sec-ch-ua 等) 並維護進程內的 Cookie Jar。針對 JS 渲染的反爬頁面，插件提供 fetchMode: auto 模式，會自動調用常駐的無頭 Blink 渲染器（基於 CDP）進行解析。
安裝與啓用¶
本插件是一個標準 DSH 插件，通過 dsh plugin 命令安裝。
dsh plugin --profile web add github:asdshuaishuai/websearch-plugins
安裝後，需要重啓 DSH Web 進程（Ctrl+C 後重新運行 dsh web）並刷新頁面，配置纔會生效。
使用方式¶
安裝完成後，在 Harness 環境中即可直接調用以下接口：
- 聚合搜索：調用
web_search(query)，默認選中phantom-aggregate。 - 單引擎搜索：調用
web_search(query)並指定 provider，如baidu或google。 - 網頁抓取：調用
web_fetch(url)，使用phantom-httpprovider。
注意事項¶
- 環境依賴：插件依賴
@deepseek-ai/dsh-webpeer dependency。如果本地未安裝，插件可能無法正常解析WebError或相關類型定義。 - SSRF 限制：
web_fetch會攔截所有私網與環回請求，如需訪問本地服務需繞過此插件，直接使用底層網絡工具。 - 網絡與風控：搜索引擎的可用性取決於當前機器的出口網絡環境。對於被本地網絡限制或觸發 IP 風控的引擎（如神馬、Yandex），插件會在結果層自動過濾，不會導致整體請求失敗。
