前言¶

DSH 的插件化方向強調「一切皆插件」：宿主保持基礎能力，具體擴展由插件提供。對智能體開發者來說，網頁搜索和網頁抓取是常見需求，但不同搜索服務的密鑰、接口和結果結構並不一致。dshsearch-multi 將 AnySearch、Bing、DuckDuckGo、Tavily 和 Exa 統一封裝到 DSH 中，並提供網頁正文抓取能力。社區目錄是獨立站點，不屬於官方應用商店。

這是什麼¶

dshsearch-multi 是 abcdream-Lary 維護的 DSH 插件，許可證爲 MIT。它面向 DeepSeek Harness（DSH）提供多引擎網頁搜索與網頁抓取，不修改 DSH 內部源碼，而是通過公開的 Provider 接口註冊功能，因此可以獨立安裝、配置和升級。

核心功能¶

下面介紹幾個明確提供的能力。

多引擎搜索¶

• 統一支持 AnySearch、Bing、DuckDuckGo、Tavily 和 Exa。
• AnySearch、Bing、DuckDuckGo 不需要 API Key。
• Tavily 和 Exa 在配置 API Key 後啓用。
• 搜索失敗或沒有結果時，按順序自動切換到其他可用引擎；未配置密鑰的 Tavily / Exa 會被跳過。

網頁抓取¶

• 提供 web.fetch(url) 網頁正文抓取。
• 抓取會按多個來源自動兜底。
• AnySearch extract 和直接抓取都有正文長度上限，且不支持 PDF、圖片、音視頻和壓縮包等二進制內容。

查詢意圖識別¶

• 內置確定性的查詢意圖識別，不調用 LLM。
• 可在設置中配置查詢意圖模式，例如 intentMode: auto。

Web 與 CLI 配置¶

• DSH Web 設置頁提供中文/英文設置卡片，支持基礎參數和高級參數。
• 附帶 dshsearch-multi 命令行配置工具，適合無界面或腳本化場景。

安裝與啓用¶

先安裝到目標 profile。以 web profile 爲例：

dsh plugin --profile web add dshsearch-multi

如果想快速試用，可以先使用獨立 profile，避免影響現有配置：

dsh plugin --profile test add dshsearch-multi
dsh --profile test --port 4000

然後打開：

http://127.0.0.1:4000

進入“設置 → 插件”。經過上面的步驟後，需要確認插件安裝在當前正在運行的 profile；如果設置卡片沒有出現，先重啓 DSH Web 或刷新頁面，再檢查安裝命令使用的 profile 是否和運行中的 DSH 一致。

典型用法¶

在 DSH Web 中配置¶

打開“設置 → 插件 → 插件配置”，找到“網頁搜索”卡片，可以配置：

• 優先搜索引擎
• 最大結果數
• Tavily/Exa 的 API Key 和接口地址
• 查詢意圖模式

API Key 會通過 DSH 憑據服務保存，不會回傳到瀏覽器。不要將密鑰提交到 Git 倉庫。

使用 settings.yaml¶

也可以在 DSH 的 settings.yaml 中配置 dshsearch-multi 節點。例如：

dshsearch-multi:
  provider: anysearch
  intentMode: auto
  maxResults: 5

上面示例只設置優先引擎、查詢意圖模式和最大結果數；更多配置以設置卡片或插件說明爲準。

配置 API Key¶

Tavily 和 Exa 需要 API Key。可以在 DSH Web 設置卡片中填寫，也可以寫入 .credentials.yaml：

TAVILY_API_KEY: tlv-...
EXA_API_KEY: ...

未配置密鑰時，Tavily 和 Exa 的即時接口能力會被跳過或不可用。

使用命令行工具¶

插件附帶 dshsearch-multi 命令，用於管理獨立的本地配置：

dshsearch-multi config show
dshsearch-multi config set provider anysearch
dshsearch-multi config set maxResults 5
dshsearch-multi config path
dshsearch-multi config reset

注意：CLI 配置文件是獨立的便捷配置。正在運行的 dsh web 讀取的是 DSH 的 dshsearch-multi 設置節點，而不是該 CLI 配置文件。

適用場景與注意¶

dshsearch-multi 適合需要在 DSH 中做網頁搜索、抓取網頁正文，或希望在多個搜索引擎之間自動兜底的場景。

使用前注意：

1、插件以當前 DSH 進程權限運行，會參與外部搜索請求和網頁抓取；安裝前應檢查源碼、許可證和所需權限。
2、Bing 和 DuckDuckGo 使用公共 HTML 頁面，可能受到限流、驗證或頁面變更影響。
3、Tavily 和 Exa 需要 API Key；未配置時相關能力會被跳過或不可用。
4、DSH 當前版本的設置頁對白名單外的第三方 namespace 不提供遠程讀寫；若設置卡片不可見，需要 Host 版本提供第三方設置暴露機制，或由宿主顯式暴露 dshsearch-multi。
5、安裝後需要確認插件安裝在當前正在運行的 profile，並重啓 DSH Web 或刷新頁面。

結尾¶

dshsearch-multi 的價值在於把多引擎網頁搜索與網頁抓取收斂到同一個 DSH 插件中，減少逐個接入搜索服務的成本。許可證爲 MIT，GitHub 地址：dshsearch-multi。目錄頁請在 DSH 插件目錄中檢索 dshsearch-multi，以實際收錄頁面爲準。