前言¶

DeepSeek Harness (DSH) 的內置 web_search 工具通常通過 Anthropic 兼容端點 (web-search-deepseek) 運行，這會消耗 LLM 輪次。dsh-tinyfish-search 插件旨在解決這個問題，它通過 TinyFish Search API 接管 web_search，將請求轉換爲普通的 GET 請求，且不消耗模型調用。

插件定位¶

dsh-tinyfish-search 是 TinyFish 後端 web 搜索提供者。它由 maxwell-feng 維護，旨在解決 web_search 工具依賴 LLM 輪次的問題，提供更直接、無消耗的搜索能力。

核心能力¶

• Provider ID: 註冊爲 tinyfish。
• 請求方式: 每次搜索調用轉換爲 GET https://api.search.tinyfish.ai?query=...，並在 Header 中攜帶 X-API-Key。
• 結果標準化: 返回的 results[] (title / snippet / url / date) 被歸一化爲 seam 的便攜源形狀 WebSearchSource[]。
• 無消耗: 每次搜索不消耗 LLM 輪次。

安裝與啓用¶

安裝該插件會自動接管內置的 web_search 工具。使用以下命令安裝：

dsh plugin --profile web add dsh-tinyfish-search

安裝後，插件會自動啓用宿主級別的 tool-web 行，使 web_search 工具對所有配置文件中的 agent preset 可見。

注意事項¶

• 作用域說明: 重新啓用 tool-web 行會讓工具對所有 agent preset 可見（包括默認不攜帶 web 工具的預設，如 minimal）。如果某個 preset 單獨掛載了 tool-web 行，該行的配置會覆蓋全局註冊。
• 兼容性檢查: DeepSeek Harness 0.2.0-rc.2 會在加載插件前驗證 peerDependencies。如果版本不匹配，DSH 會拒絕加載並提供診斷信息。
• 異常處理: 如果運行環境不在聲明的依賴範圍內，DSH 會拒絕該行並打印具體版本對。若需顯式接受風險，需運行：

    dsh plugin allow-version dsh-tinyfish-search@0.14.0 --dsh-version <your-dsh-version> --accept-risk

• 定價: TinyFish Search 在任何錢包餘額下均免費。

結語¶

該插件通過直接對接 TinyFish Search API，實現了零 LLM 成本的網頁搜索。開發者無需修改代碼，即可通過配置 API Key 啓用該能力。更多詳情可參考 GitHub 倉庫。