前言¶

DeepSeek Harness (DSH) 採用“一切皆插件”的理念。官方 Web 搜索每次觸發都消耗一輪模型調用，且存在性能瓶頸。tavily-search 插件利用 Tavily API 接管模型的 web_search 工具，替換 DeepSeek 官方搜索。Tavily 更便宜、更快。

核心功能¶

1. 註冊 tavily WebSearchProvider 替換官方搜索
2. 密鑰經 credentials 服務實時解析，卸載後無殘留
3. 提供設置頁管理密鑰、搜索行爲（maxResults/searchDepth）與用量統計
4. 支持連接測試與同源校驗路由
5. 按次計費（basic 1 credit/次，advanced 2 credits/次）
6. 服務端 60 秒緩存與 10 req/10min 限流處理

安裝與啓用¶

執行以下命令安裝插件：

dsh plugin --profile web add github:Yinxe/dsh-tavily-search

安裝完成後重啓 web 服務：

dsh web

配置與使用¶

1. 在設置頁粘貼 Tavily API Key 並保存。
2. 使用連接測試框驗證搜索功能。
3. 在 settings.yaml 的 dshp-inx-tavily-search 命名空間配置 maxResults 和 searchDepth：

dshp-inx-tavily-search:
  maxResults: 5
  searchDepth: basic

4. 若存在多個搜索提供方，需在 cordis.patch.yml 顯式配置 searchProvider: tavily。

注意事項¶

• 密鑰寫入憑證庫，不回顯、不進模型上下文。
• 路由帶同源校驗，建議直接從瀏覽器訪問 web 端口。
• 依賴 Node.js >= 20。