← 返回列表
未验证
为模型接入 Tavily 实时联网搜索与网页内容抓取
尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/24 · 已提供中文文档
通过 Tavily API 为 DSH 提供网页搜索功能
综合分
27.6
GitHub 分
27.6
用户评分
—
★ Stars
0
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add xjcloudy/tavily-web-search该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-credentials@deepseek-ai/dsh-launch-environment@deepseek-ai/dsh-settings@deepseek-ai/dsh-tools@deepseek-ai/dsh-web@deepseek-ai/schemastery用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
面向 DeepSeek Harness 的 Tavily 网络搜索插件
通过 Tavily API 为 DSH 提供网络搜索能力——既作为 WebSearchProvider(用于 ctx.web),也作为面向模型的工具(tavily_search)。
你将获得
1. tavily_search 工具
完全控制每一个 Tavily 搜索参数。像调用其他任何工具一样调用它:
await ctx.tools.call('tavily_search', {
queries: ['your search query'], // required (uses first)
searchDepth: 'advanced', // 'basic' | 'advanced'
topic: 'news', // 'general' | 'news' | 'finance'
days: 7, // lookback
maxResults: 10, // 1–50
includeImages: true, // image results as markdown
includeAnswer: true, // generated answer
includeRawContent: 'markdown', // raw page content
includeFavicon: true, // favicon URLs in results
includeDomains: ['example.com'], // domain filter
excludeDomains: ['spam.com'], // domain exclusion
country: 'united states', // geo filter
startDate: '2024-01-01', // ISO 8601
endDate: '2024-12-31',
includeUsage: true, // credits used
});
返回原始的 Tavily 响应,包含答案、结果、图片和用量信息。
2. WebSearchProvider(tavily)
用于 ctx.web.search() 的标准 WebSearchProvider。当它是唯一配置的提供者时会自动选择。由来自 dsh-tool-web 的 web_search 工具使用。
注意:web_fetch 使用单独的 WebFetchProvider 接口(此处未实现)。
设置
1. 在你的 DSH 配置文件中安装(本地开发)
Clone & build
git clone
cd tavily-web-search && pnpm install && pnpm run build
Link into your profile
cd ~/.dsh/profiles/your-profile
pnpm add file:/path/to/tavily-web-search
2. 添加到 cordis.patch.yml
- id: tool-web
disabled: false
- id: tavily-web-search
name: '@deepseek-ai/tavily-web-search'
config:
apiKeyEnv: TAVILY_API_KEY
maxResults: 10
Make tavily the active search provider
- id: web
config:
searchProvider: tavily
3. 提供 API 密钥(任选其一)
A. DSH Credentials(推荐——加密、多租户)
Edit the credentials file directly:
~/.dsh/.credentials.yaml
version: 1
refs:
TAVILY_API_KEY: tvly-xxxxxxxx
B. 环境变量(仅限开发/CI)
export TAVILY_API_KEY=tvly-xxxxxxxx
C. 配置中的字面值(不推荐——以明文可见)
config:
apiKey: "tvly-xxxxxxxx"
解析顺序: 字面值 apiKey → Credentials(apiKeyEnv 引用)→ process.env[apiKeyEnv]。
只有第一个匹配项生效。生产环境首选 Credentials 文件。
4. 重启 DSH
pnpm run dev # or whatever starts your DSH profile
就这样。
搜索查询通过 tavily_search 工具调用进行,并支持完整的 Tavily 参数。注册后,ctx.web.search() 会自动生效。扫码进群