前言¶
在 DeepSeek Harness（DSH）裏做智能體時，網頁搜索是常見能力。DSH 的 web capability seam 暴露 ctx.web，內置 web_search 工具默認走 shipped DeepSeek route。如果你希望同一套 web_search 工具改走 Tavily，並且不想一開始就強制配置 API key，可以看一下 dsh-web-search-tavily。
這是什麼¶
dsh-web-search-tavily 是 cnChenKai 維護的 DSH 插件，許可證爲 MIT。
它給 DeepSeek Harness 的 web seam（ctx.web）提供一個 Tavily-backed WebSearchProvider，讓內置 web_search 工具在運行時調用 Tavily 的 search API，而不是默認的 DeepSeek route。
核心能力¶
- Keyless mode：沒有配置 API key 時，插件會發送官方 header
X-Tavily-Access-Mode: keyless，可以直接使用，不需要TAVILY_API_KEY。 - Keyed upgrade：如果設置
TAVILY_API_KEY，插件會切換到 keyed 模式；key 可以從環境變量或~/.dsh/.credentials.yaml讀取，並且每次搜索都會重新解析。 - 官方默認參數：
search_depth: basic（1 credit）、include_answer: false、max_results: 5、chunks_per_source: 3。 - 替換默認搜索路由：插件讓內置
web_search工具走 Tavily search API，而不是 DSH 自帶的 DeepSeek route。
安裝與啓用¶
插件要求 Node >= 22。
先安裝插件：
dsh plugin --profile web add dsh-web-search-tavily
安裝後，如果不想配置 API key，可以直接使用 keyless mode。
如果要使用 keyed 模式，在 ~/.dsh/.credentials.yaml 中配置：
# ~/.dsh/.credentials.yaml
TAVILY_API_KEY: tvly-...
這裏的 key 會在每次搜索時重新解析。
插件的 bundle patch 會自動設置 provider。如果你希望手動切換，也可以在自己的 cordis.patch.yml 中設置：
# cordis.patch.yml
- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: tavily
典型用法¶
下面的步驟可以先跑通最小路徑：
- 確認環境是
Node >= 22。 - 執行安裝命令：
dsh plugin --profile web add dsh-web-search-tavily
- 不設置
TAVILY_API_KEY時，web_search會走 Tavily 的 keyless mode。 - 如果需要更高配額，把
TAVILY_API_KEY寫入~/.dsh/.credentials.yaml或環境變量。 - 如果插件沒有自動選中 provider，在
cordis.patch.yml中手動設置searchProvider: tavily。
默認請求參數爲：
search_depth: basic
include_answer: false
max_results: 5
chunks_per_source: 3
適用場景與注意¶
適合以下情況：
- 你正在使用 DSH，並需要讓內置
web_search走 Tavily。 - 你希望先無 key 試用，再按需切換到 keyed 模式。
- 你的運行環境滿足
Node >= 22。
注意：
- 插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
- 該插件屬於 DSH 社區插件，不應寫成 DeepSeek / 幻方官方應用商店應用。
- Keyed 模式可參考 Tavily 提供的免費額度：
app.tavily.com提供 1,000 free credits/month。
結尾¶
dsh-web-search-tavily 的價值在於給 DSH 的 web_search 提供一個可選的 Tavily 後端：無 key 時可以直接跑，有 key 時可以繼續提升配額與使用層級。
GitHub：
https://github.com/cnChenKai/dsh-web-search-tavily
目錄頁可在 DSH 社區目錄中按 dsh-web-search-tavily 搜索。
