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 搜索接入点。通过开关控制和安全的凭证管理，可以在不改变平台默认行为的前提下，灵活调用外部搜索能力。
