← 返回列表
需源码安装
awesome · DSH plugin 推荐 dshfind
暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。 · 最近上游提交 2026/9/16 · 已提供中文文档
Tavily-powered optional search tool for DeepSeek Harness (rc.7 plugin management): multi-key rotation/failover, usage gauge, settings card in Plugins → configuration; the built-in web_search is never replaced. | DSH Tavily 可选高级搜索工具（rc.7 插件管理）：多 Key 轮换/故障转移、用量仪表盘、插件配置页设置卡片；内置 web_search 永不替换。
综合分
40.3
GitHub 分
40.3
用户评分
—
★ Stars
8
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add moguiyu/dsh-tavily缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装，改用 GitHub 源安装
数据截至 2026/9/18（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-tavily-workspace（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 09:26:04
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-tavily
awesome · DSH plugin 推荐 dshfind
为 DeepSeek Harness（DSH）提供基于 Tavily 的可选高级搜索工具——支持多个 API Key、轮换/故障转移、实时用量仪表盘、直接的 extract / map / crawl 工具，以及一个接入插件配置页的设置卡片。
内置的 web_search 工具永远不会被替换：Tavily 是默认搜索之外的选项，而不是替代品。本插件不注册任何 web 搜索提供方，也绝不改写 web.searchProvider。
亮点
- 🔑 多 Tavily API Key — 在 DSH 设置界面中管理扁平化 Key 列表。
- 🔁 Key 轮换与故障转移 — 轮询多 Key；遇到 HTTP 401/429 自动切换下一个 Key。
- 📊 实时用量仪表盘 — 服务端获取每个 Key 的 Tavily 用量与汇总，不暴露 Key。
- ⚡ 直接 Tavily 工具 — tavily_extract 读取已知 URL 的内容，tavily_map 发现站点链接，tavily_crawl 抓取整个站点，均使用同一套 Key 轮换。
安装
以下任一条命令都会安装 dsh-tavily 行（两者装的是同一个插件，安装时用 --profile 指定 profile）：
从仓库安装 —— 始终是最新源码
dsh plugin --profile web add github:moguiyu/dsh-tavily
从 npm 发布版安装 —— 稳定且计入市场下载量
dsh plugin --profile web add @moguiyu/dsh-tavily
刷新浏览器后，Tavily Search 卡片会出现在 Settings → Plugins → plugin configuration。只有当 Host 半身确实被组合时卡片才会出现——配置页只按 Host 已提供（served）的命名空间派发对应键的卡片。
要求 — DSH 为开发者预览版（0.1.x-rc/alpha）；keyed 插件配置卡片需要 0.1.0-rc.7 或更新（含 0.1.2-alpha.x、0.1.3 版本线、0.1.5 版本线，以及截至 0.1.6-alpha.1 的 0.1.6 版本线）。npm 名为作用域包 @moguiyu/dsh-tavily，并非同名社区 dsh-tavily 提供方替换插件。
兼容性 — 同一个包覆盖当前所有 host 版本线：DSH 0.1.0-rc.7 – 0.1.1-rc.x 使用 rc.7/rc.8 settings 通道；DSH 0.1.2-alpha.2+（覆盖整个 0.1.3 版本线以及 0.1.5/0.1.6 版本线，含 alpha/RC）使用 installSection 通道——运行时自动探测，无需额外安装步骤。peer 范围为每个 host 版本元组各列一个比较器（^0.1.0-rc.7、^0.1.1-rc.1、^0.1.2-alpha.2、^0.1.3-alpha.1、^0.1.5-0、^0.1.6-0），因为预发布比较器不会级联——新增一条 host 版本线要新增比较器，而不是放宽旧的。已在 0.1.0-rc.8、0.1.2-alpha.2、0.1.3-alpha.2、0.1.5-rc.2、0.1.6-alpha.1 上实测。
包
| 包 | 作用 |
|---|---|
| @moguiyu/dsh-tavily | 推荐插件：tavily_search + tavily_extract / tavily_map / tavily_crawl 工具 + 设置卡片 + 本地后端 + tavily-search 命名空间 |
| @moguiyu/dsh-tavily-backend | 独立设置后端（Key 管理、用量、工具开关） |
| @moguiyu/dsh-tool-tavily-search | 独立高级 Tavily 工具 — tavily_search、tavily_extract、tavily_map、tavily_crawl（无界面） |
凭据
- TAVILY_API_KEYS — 逗号分隔 Key 列表；tavily_search 轮换使用，遇到 HTTP 401/429 自动重试。
- TAVILY_API_KEY — 自动同步为首个 Key 的主 Key。
两者都由设置卡片自动管理。Key 不会以明文离开服务器，任何状态文件都不保存密钥。
Key 用量策略
- 轮流使用每个 Key — 轮询；遇到 401/429 自动尝试下一个。
- 按用量最少优先 / 用量最多优先 — 保存时按 Tavily 实时用量重新排序。
高级 Tavily 工具
高级模型工具默认关闭，按需开启。它们用于直接访问 Tavily 操作，与 web_search 相互独立：
- tavily_search — 完整搜索面（search_depth、topic、days、域名过滤、include_answer、include_raw_content）；
- tavily_extract — 提取已知 HTTP(S) URL 的完整内容；
- tavily_map — 不抓取正文，发现站点的链接；
- tavily_crawl — 抓取站点并返回其各页面的已提取内容。
- 开启它们不会改变默认的 web_search（内置 DeepSeek 提供方及其原生 schema 保持不变）；
- 关闭它们只会注销额外的 Tavily 工具。
开关保存在 tavily-search 设置命名空间（settings.yaml）中，并镜像到 ~/.dsh/tavily-tool.json，保证每次重启读到相同值。
状态文件
- ~/.dsh/tavily-manager.json — Key 保存日期 + 策略
- ~/.dsh/tavily-tool.json — 高级工具 { "enabled": boolean }（设置命名空间的镜像）
- ~/.dsh/tavily-toggle.json — 旧版工具状态，仅用于迁移读取
权限 600，不保存密钥。
开发
pnpm install
pnpm test
pnpm build
许可证
MIT扫码进群