前言¶
在 DeepSeek Harness（DSH）中做智能體工具鏈時，有時需要額外引入 Tavily 搜索能力，但又不希望把內置 web_search 替換掉。moguiyu/dsh-tavily 面向這個場景：它把 Tavily 作爲一組可選增強工具接入 DSH，同時保留 DSH 原有的搜索路徑。
這是什麼¶
moguiyu/dsh-tavily 是 moguiyu 維護的 DSH 插件，許可爲 MIT。它主要提供：
- 多 Tavily API key 管理
- key 輪換與故障轉移
- 用量查看
tavily_search、tavily_extract、tavily_map、tavily_crawl等直接 Tavily 工具
這裏的關鍵邊界是：它不替換內置 web_search，不註冊 web-search provider，也不改寫 web.searchProvider。
核心功能¶
- 多 Key 列表：從 DSH 設置界面維護一份扁平的 Tavily API key 列表。
- 輪換與故障轉移：支持 round-robin；遇到 HTTP 401/429 時自動重試。
- 用量查看：展示各 key 的 Tavily 用量和總量，服務端獲取，密鑰不會以未脫敏狀態暴露。
- 直接 Tavily 工具：提供
tavily_search、tavily_extract、tavily_map、tavily_crawl。 - 設置卡片：刷新瀏覽器後，可在 Settings → Plugins → plugin configuration 下看到 Tavily Search 卡片。
- 高級工具默認關閉：高級 Tavily 工具是 opt-in；開啓後不會改變默認
web_search。
安裝與啓用¶
先確認版本要求：
DSH: 0.1.0-rc.x
keyed plugin-config card: 0.1.0-rc.7 或更新版本
從 GitHub 倉庫安裝：
dsh plugin --profile web add github:moguiyu/dsh-tavily
從 npm 發行包安裝：
dsh plugin --profile web add @moguiyu/dsh-tavily
npm 包名是 scoped 的 @moguiyu/dsh-tavily，不是同名社區 dsh-tavily provider-swap 插件。
安裝後刷新瀏覽器，Tavily Search 卡片會出現在 Settings → Plugins → plugin configuration 下。
典型用法¶
1、配置 key 列表：
TAVILY_API_KEYS=<key1>,<key2>,<key3>
TAVILY_API_KEY 會自動同步到第一個 key。
2、選擇 key 使用策略：
Rotate each key
Lowest usage first
Highest usage first
3、如需使用直接 Tavily 工具，可在 tavily-search settings namespace 中開啓。開啓後提供 tavily_search、tavily_extract、tavily_map、tavily_crawl；這些工具不會改變默認 web_search。
本地狀態與密鑰處理¶
狀態文件包括：
~/.dsh/tavily-manager.json
~/.dsh/tavily-tool.json
~/.dsh/tavily-toggle.json
其中 ~/.dsh/tavily-toggle.json 爲 legacy 狀態文件。文件權限爲 mode 600，不保存密鑰材料。密鑰不會以未脫敏狀態離開服務器。
適用場景與注意¶
適合在 DSH 中使用 Tavily，同時希望保留內置 web_search 的開發者。若主要需求是多 key 輪換、故障轉移和用量查看，先配置 TAVILY_API_KEYS；若還需要直接 Tavily 工具，再在 tavily-search settings namespace 中開啓。
插件會以當前 dsh 進程權限運行，安裝前應檢查源碼、許可證和即將調用的第三方搜索服務。該插件採用 MIT 許可。
獲取與鏈接¶
GitHub：
https://github.com/moguiyu/dsh-tavily
目錄頁可在獨立插件目錄中按 moguiyu/dsh-tavily 或 @moguiyu/dsh-tavily 查找；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應視爲官方應用商店。
