前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」，內置的 web_search 和 web_fetch 工具通常依賴宿主後端。當官方後端遇到限流或故障時，直接調用可能會失敗。
dsh-hydrasearch 插件旨在解決這個問題。它通過註冊 TinyFish 與 AnySearch 兩個後端，構建了一個自動故障切換的鏈路，讓 DSH 的搜索與抓取請求在兩個免費服務之間自動流轉，提供更穩定的網頁檢索能力。
插件定位¶
這是一個 TinyFish + AnySearch 搜索與抓取後端插件，支持雙後端自動故障切換，由 dgagf111 維護，遵循 MIT 協議。
核心功能¶
- 雙後端自動故障切換：當其中一個後端超時、限流或出錯時，自動切換至另一個，保證請求不中斷。
- 網頁搜索：支持語言、地區、時間範圍、站點黑白名單過濾，以及翻頁控制。
- 網頁抓取：支持將目標網頁抓取爲 Markdown、HTML 或 JSON 格式，並可提取頁面內的鏈接。
- 資源與限流：提供免費額度與高頻率限制，支持網頁搜索與抓取。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add github:dgagf111/dsh-hydrasearch
- 重啓 DSH 後，進入「插件頁 → 已安裝 → dsh-hydrasearch → 行內配置」。
- 首次使用需在卡片中填寫 TinyFish 的 API Key（AnySearch 可先不填）。
- 使用 DSH 內置的
web_search或web_fetch驗證：如果返回結果正常，說明請求已走 TinyFish / AnySearch 鏈路。
典型用法¶
安裝並配置後，無需修改 DSH 的核心調用代碼。在行內配置卡片中，你可以調整後端的順序（排在前面優先使用），設置故障切換開關，並填寫後端參數（如搜索語言、抓取格式、超時時間等）。
適用場景與注意¶
- 版本要求：僅支持 DSH 0.2.0-rc.2 及以上版本。舊版本已廢棄，無法加載。
- API Key 安全：Key 僅存儲在本地憑據中心，不上傳雲端，不參與第三方統計，僅發送至所調用的搜索服務。
- 版本升級注意：從 0.3.0 版本起，憑據引用名稱變更爲
HYDRASEARCH_TINYFISH_API_KEY/HYDRASEARCH_ANYSEARCH_API_KEY。如果從舊版本升級，需在卡片中重新填寫 Key。 - 代碼運行環境：插件以 DSH 進程權限運行，安裝前請檢查源碼與許可證。
總結¶
dsh-hydrasearch 通過引入 TinyFish 和 AnySearch 兩個免費後端，解決了 DSH 內置搜索工具的可用性問題。其自動故障切換機制確保了高可用性，適合需要大量網頁搜索與抓取的開發場景。
