DeepSeek Harness（DSH）是一個插件化的智能體開發平臺。在開發或使用過程中，若需要更可控的網頁搜索能力，可以通過插件引入外部服務。ceilcelia/dsh-travily-api 是一個爲 DSH 提供的插件，它通過 Tavily 接口執行網頁搜索，並提供了開關控制、憑證存儲與連通測試功能。
核心功能¶
該插件將 Tavily 的搜索能力集成到 DSH 的 web_search 接口中。它不直接修改 DSH 的核心邏輯，而是作爲一個獨立的 profile bundle 裝載。核心價值在於提供可開關的搜索策略，以及將 API Key 安全地存儲爲憑證而非明文配置。
安裝與啓用¶
安裝插件需要重啓 DeepSeek Harness，因爲該插件作爲 profile bundle 裝載，僅在下一次啓動時生效。
- 打開 DeepSeek Harness 的「插件」面板。
- 點擊「添加插件」。
- 在「包名或地址」中填入：
github:CeilCelia/dsh-travily-api
或者通過命令行安裝：
dsh plugin --profile desktop add github:CeilCelia/dsh-travily-api
- 安裝完成後，重啓 DeepSeek Harness。
配置與使用¶
重啓後進入「插件」面板的「已安裝」列表，找到「Tavily 網頁搜索」並打開設置頁。
- 在 tavily.com 申請 API Key 並填入。留空則使用 Tavily 的無 Key 模式。
- 啓用「使用 Tavily 進行網頁搜索」開關。
- 點擊「連通測試」驗證配置是否生效。
回退機制： 禁用開關後，web_search 會回退到平臺自帶（默認）的搜索提供方，因此安裝本身不改變現有行爲。開關與 API Key 的修改保存後立即生效，無需再次重啓。
API Key 存儲方式¶
API Key 不會出現在設置文件或會話記錄中。它以憑證形式保存在 $DSH_HOME/.credentials.yaml，內容如下：
TAVILY_API_KEY: tvly-xxxxxxxx
此外，也支持通過啓動環境變量注入 TAVILY_API_KEY，該方式的優先級高於憑證文件。
配置項說明¶
設置頁寫入 profile patch 中的 web-search-tavily 行。也可以直接編輯該行。可用的配置項包括：
- id: web-search-tavily
config:
enabled: true
maxResults: 8
searchDepth: basic
searchTimeoutMs: 30000
| 字段 | 默認值 | 說明 |
|---|---|---|
enabled |
false |
是否通過 Tavily 執行搜索；關閉時回退到平臺搜索 |
apiKeyEnv |
TAVILY_API_KEY |
讀取 API Key 的憑證引用名 |
baseURL |
https://api.tavily.com |
Tavily 接口地址 |
allowCustomBaseURL |
false |
是否允許使用非官方接口地址 |
maxResults |
5 |
請求未指定時返回的結果數 |
searchDepth |
basic |
basic 或 advanced |
searchTimeoutMs |
30000 |
單次請求超時（毫秒） |
注意事項¶
該插件基於 MIT 許可證開源，部分代碼派生自 SZMY-haruhi/dsh-tavily。在安裝前，請確保已閱讀源碼與許可證聲明（見項目根目錄的 THIRD-PARTY-NOTICES.md）。
該插件爲 DSH 提供了標準化的 Tavily 搜索接入點。通過開關控制和安全的憑證管理，可以在不改變平臺默認行爲的前提下，靈活調用外部搜索能力。
