← 返回列表
未验证
将 Tavily 配置为 DeepSeek HarnessDSH网页搜索提供方的持久化插件。注册搜索提供方…
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/16 · 已提供中文文档
DeepSeek Harness (DSH) 的 Tavily 网络搜索提供程序：提供程序 + tavily_search 工具 + 带启用开关的设置卡片
综合分
27.6
GitHub 分
27.6
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add faettt/dsh-web-search-tavily该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
数据截至 2026/9/17（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-credentials@deepseek-ai/dsh-launch-environment@deepseek-ai/dsh-settings@deepseek-ai/dsh-tools@deepseek-ai/dsh-web用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-web-search-tavily
将 Tavily 配置为 DeepSeek Harness（DSH）网页搜索提供方的持久化插件。注册搜索提供方 tavily（接管 web_search 路由）、tavily_search 模型工具，并在「设置 → 插件 → 插件配置」提供配置卡片，可随时开关 Tavily、切换回 DeepSeek 默认搜索通道。
特性
- 搜索提供方：注册 tavily provider，web_search 工具整体走 Tavily（answer + 来源 + 可选图片）。
- 模型工具：tavily_search 工具，模型可显式调用。
- 设置卡片：设置 → 插件 → 插件配置 →「Tavily 搜索」卡片，可视化配置全部选项。
- 一键开关：关闭后 web_search 自动回退 DeepSeek 默认搜索通道，无需改动组合配置。
- 凭据安全：API Key 走 DSH 凭据服务（环境变量 / ~/.dsh/.credentials.yaml），配置端不落盘密钥。
- 重启持久：配置存于 ~/.dsh/settings.yaml，随 profile 持久化。
安装
1. 将本包加入 profile 依赖（~/.dsh/profiles/web/package.json）：
{
"dependencies": {
"dsh-web-search-tavily": "github:faettt/dsh-web-search-tavily"
}
}
然后 pnpm install。
2. 在 cordis.patch.yml 追加两段（接管搜索路由 + 加载插件）：
- insert:
- id: web-search-tavily
name: 'dsh-web-search-tavily'
config:
apiKeyEnv: TAVILY_API_KEY
- id: web
config:
searchProvider: tavily
3. 配置 API Key（二选一）：
- 环境变量：export TAVILY_API_KEY=tvly-xxxx（加到 ~/.zshrc）
- 或直接在设置卡片「API Key」字段填写保存
4. 重启 DSH。
配置项
| 字段 | 默认 | 说明 |
| --- | --- | --- |
| enabled | true | 开关；关闭后搜索走默认通道 |
| apiKeyEnv | TAVILY_API_KEY | 凭据引用名（环境变量/凭据服务） |
| apiKey | — | 字面 API Key（secret，不走设置文档） |
| searchDepth | basic | basic / advanced |
| maxResults | 5 | 每次搜索最多来源条数（1-20） |
| includeAnswer | true | 是否生成总结 answer |
| includeImages | false | 是否附带图片结果 |
| topic | general | general / news / finance |
| days | — | 仅搜索最近 N 天内容 |
| registerTool | true | 是否注册 tavily_search 模型工具 |
架构说明
- Host 半部（lib/index.js）：Tavily provider（ctx.web.registerSearchProvider）、tavily_search 工具、设置命名空间 web-search-tavily（installSettingsSection）、配置端点 GET/POST /api/tavily-settings（webServer 路由，host 直读写 settings，避开 wire 层命名空间暴露白名单）。
- Client 半部（lib/client.js）：设置卡片（settings.plugin.item 槽位），通过同源 fetch 读写配置端点。
- 开关原理：enabled=false 时 provider available() 返回 false，并将 web.searchProviderId 置为 undefined——dsh-web 的选择逻辑自动落到唯一可用通道（DeepSeek 默认搜索）。
开发
本地验证 host 半部
node --input-type=module -e 'import("dsh-web-search-tavily").then(m => console.log(Object.keys(m)))'
client bundle 为手写 ModuleLoader 格式，修改后同步两份：
cp lib/client.js ../../node_modules/dsh-web-search-tavily/lib/client.js
修改 host 半部后需重启 DSH；修改 client bundle 后由 HMR 自动生效（刷新浏览器即可）。
License
MIT扫码进群