前言¶
在 DeepSeek Harness（DSH）裏做需要實時信息的任務時，模型往往只能依賴訓練數據或你手動粘貼的網頁內容。若要爲智能體接上聯網檢索，常見做法是單獨申請各搜索引擎或聚合服務的 API key，再寫一層調用與結果合併邏輯，部署和維護成本都不低。
下面介紹社區插件 dsh-tool-websearch（維護者 leolee9086，分類：聯網工具）。它在 DSH 內提供多引擎併發搜索、結果去重與評分，以及瀏覽器側結果卡與進度展示，搜索實現無需自備 API key。
這是什麼¶
dsh-tool-websearch 是獨立的 DSH 多引擎搜索插件：通過 Host 工具 web_search_meta、web_search_status、web_search_proxy 與瀏覽器搜索結果卡，直接調用 DuckDuckGo、Bing、Google、百度、搜狗等約 200 個搜索引擎（完整清單由 web_search_status 報出）。併發執行、結果去重聚合，並按引擎權重與時效性評分。搜索邏輯移植自 s-code，構建期打包爲 lib/search.bundle.mjs，運行時零 npm 依賴，僅通過 Cordis 服務契約與 DSH 交互。
- 目錄頁：skillhub.cn/plugins/leolee9086/dsh-tool-websearch
- 源碼：github.com/leolee9086/dsh-tool-websearch
- 許可證：MIT
- 當前包版本（資料）：0.1.1
核心功能¶
Host 工具¶
模型側可調用三個工具：
- web_search_meta：發起元搜索，可指定查詢詞與引擎列表。
- web_search_status：查看可用引擎、權重、超時、速率限制、緩存與各引擎健康狀態。
- web_search_proxy：查看或切換本地代理（例如探測
127.0.0.1:7890等）。
瀏覽器側¶
搜索結果在瀏覽器中以結果卡展示，各引擎進度顯示在同一張卡片上；代理開關位於會話輸入區左側。
HTTP 接口（Web 環境）¶
GET /api/dsh-websearch/progress?sessionId=…&callId=…：讀取某次調用的運行進度（需sessionId與callId，不提供列表查詢；沿用 DSH 登錄與 Host/Origin 檢查）。/api/dsh-websearch/proxy：查看或切換代理。
運行中的結果卡約每 500ms 輪詢進度接口；最終檢索文本仍通過工具返回值寫入會話，歷史結果卡讀取該結果。進度僅保存在插件實例內存中，進程重啓或插件卸載後不恢復。
安裝與啓用¶
環境要求：Node.js 22.19.0 或更高、pnpm，以及兼容的 DeepSeek Harness Web 環境。
方式一：在 Web profile 中按 git 依賴安裝¶
在 DSH Web profile 目錄（默認 ~/.dsh/profiles/web，Windows 通常爲 %USERPROFILE%\.dsh\profiles\web）執行官方命令（帶標籤，避免版本隨分支漂移）：
pnpm add "github:leolee9086/dsh-tool-websearch#v0.1.1"
構建產物 lib/（含 search.bundle.mjs）已隨倉庫提交，裝完即可用，無需額外構建。
在該 profile 的 cordis.patch.yml 中註冊插件。若已有 insert 列表，只追加一項，勿重複註冊：
- insert:
- id: dsh-tool-websearch
name: dsh-tool-websearch
包內自帶 cordis.patch.yml，也可作爲 bundle 掛載：
- name: dsh-tool-websearch
方式二：放入插件目錄¶
將整個目錄放進 $DSH_HOME/plugins/。開發時同樣可放該路徑後重啓 dsh。
完成配置後重載插件或重啓 DSH，並刷新瀏覽器頁面。
典型用法¶
在對話中讓模型調用工具，示例（來自 README）：
web_search_meta(query="rust async runtime 對比", engines=["duckduckgo","bing","baidu"])
web_search_status() # 可用引擎、權重、超時、速率限制、緩存與健康狀態
web_search_proxy() # 查看/切換本地代理（探測 127.0.0.1:7890 等本地代理）
先用 web_search_status 確認當前網絡下哪些引擎可用；境外引擎在部分環境下需代理，可用 web_search_proxy 處理。
適用場景與注意¶
適合誰：在 DSH Web 環境中開發或運行智能體、需要免 API key 的多源網頁檢索，並希望在瀏覽器裏看到分引擎進度與聚合結果卡的開發者。
運行權限：插件以當前 DSH 進程權限發起對外 HTTP 請求。安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認行爲符合你的安全與合規要求。
已知邊界（README 摘要）：
- 結果卡依賴 DSH 會話快照與結果卡結構，DSH 大版本升級時插件可能需要跟進；DSH 插件接口仍處預發佈階段。
- 進度爲臨時展示狀態，不寫入會話投影；重啓或卸載後歷史調用無進度回放。
- 部分引擎在特定網絡下不可用；以
web_search_status健康狀態爲準。 - 界面文案目前爲簡體中文。
社區插件目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本包是其中一項聯網工具實現。
結尾¶
dsh-tool-websearch 把約 200 個搜索引擎的併發檢索、去重與評分收進 DSH 的三個 Host 工具與 Web 結果卡，安裝命令與 Cordis 配置以 README 爲準。需要細節、測試說明與 HTTP 行爲時，請直接查閱倉庫文檔。
