前言¶
在 DSH 裏，網頁搜索默認使用官方 DeepSeek。若希望切換到 Tavily，常見做法是調整搜索來源或重裝插件，切換成本較高。dsh-tavily 將 Tavily 作爲 DSH 的網頁搜索服務提供商，並提供設置卡開關：關閉時繼續使用官方 DeepSeek，打開時改用 Tavily，不需要反覆卸載安裝包。
截至 2026-08-30，建議將插件更新到 0.3.1。下面介紹功能、安裝命令、啓用方式和需要注意的問題。
這是什麼¶
dsh-tavily 是 DeepSeek Harness（DSH）的 Tavily 網頁搜索插件。它面向 DSH 的 Web 客戶端，提供可選的 Tavily 網頁搜索：開關關閉時使用官方 DeepSeek；開關打開後，根據是否填寫 Key 分別走 keyless 或賬號檔。
倉庫 owner 爲 SZMY-haruhi，許可證爲 MIT。
核心功能¶
- 設置卡開關：關 = 官方 DeepSeek，開 = Tavily，切換時不用卸包。
- 無 Key 時走 Tavily keyless；有 Key 時走
Authorization: Bearer。 - 設置卡左下有連通測試：真實調用一次 Tavily，請求參數爲
max_results: 1；無 Key 走 keyless，有 Key 走賬號檔，並消耗 1 積分。 - 處理超時、中止、官方 Host 鎖定，並丟掉無
url的結果。 - Key / 開關寫在
credentials，不寫設置文件。 - 設置卡命名空間爲
web-search-tavily，不覆蓋官方網頁搜索卡。
安裝與啓用¶
先用 npm 安裝穩定版：
dsh plugin --profile web add dsh-tavily
如果已經安裝舊版本，先更新到 0.3.1：
dsh plugin --profile web update dsh-tavily
也可以用 GitHub 倉庫安裝：
dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily
如果需要固定版本，可以釘 commit 安裝：
dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily#<commit>
安裝完成後，按下面路徑進入插件配置：
設置 → 插件 → 插件配置 → Tavily 網頁搜索
打開“Tavily 網頁搜索”開關即可啓用。Key 可選；不填 Key 時走 Tavily keyless。左下的連通測試用來確認現在能不能搜。有 Key 時，連通測試會消耗 1 積分。
如需卸載：
dsh plugin --profile web remove dsh-tavily
典型用法¶
按下面順序操作即可。
1、安裝插件：
dsh plugin --profile web add dsh-tavily
2、進入設置：
設置 → 插件 → 插件配置 → Tavily 網頁搜索
3、打開開關。開啓後，網頁搜索從官方 DeepSeek 切換到 Tavily。
4、保持 Key 爲空，或填入 Tavily Key。不填時走 keyless；填寫後走賬號檔。
5、點擊左下連通測試。無 Key 時也能測試；有 Key 時用於確認賬號檔當前是否能用。
6、經過上面的步驟後，如版本較舊，執行更新：
dsh plugin --profile web update dsh-tavily
憑證位置¶
Key / 開關不寫在設置文件裏，而是寫在 credentials 中。憑證可寫在：
$DSH_HOME/.credentials.yaml
不要把真實鑰匙提交進倉庫。
版本與兼容注意¶
- 請更新到
0.3.1。 0.3.0在和其它客戶端插件一起安裝時，可能讓整個 Web 停在 “Failed to load plugins”。0.3.1修復了settings.plugin.item需key，不能再用id或order的問題。0.3.1的設置卡命名空間爲web-search-tavily，不覆蓋官方網頁搜索卡。
適用場景與注意¶
適合以下使用方式：
- 想在 DSH 的 Web 客戶端中使用 Tavily 網頁搜索。
- 希望在官方 DeepSeek 與 Tavily 之間用開關切換，不反覆安裝和卸載。
- 想先不填 Key，用 keyless 模式確認連通性。
安裝前建議檢查源碼與許可證。dsh-tavily 會作爲 DSH Web 客戶端的插件運行，插件代碼會隨當前 dsh 進程權限執行；引入前請確認其實現符合項目要求。許可證爲 MIT。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/SZMY-haruhi/dsh-tavily
- GitHub：https://github.com/SZMY-haruhi/dsh-tavily
