dsh-tavily

为 DeepSeek Harness（DSH）提供 Tavily 网页搜索，支持多个 Tavily API Key、自动轮换/故障转移、实时用量仪表盘和完整的设置卡片。

亮点

• 🔑 多 Tavily API Key — 在 DSH 设置界面中管理扁平化 Key 列表。
• 🔁 Key 轮换与故障转移 — 多 Key 轮询；遇到 HTTP 401/429 自动切换下一个 Key。
• 📊 用量仪表盘 — 服务端获取每个 Key 的 Tavily 用量与汇总，不暴露 Key。
• 🎛️ 设置卡片 — 添加/删除/查看 Key、选择用量策略、切换 web_search 提供方。
• 🧩 两个可安装的 DSH 包 — 模型工具 + 本地 HTTP 后端。

包

包	作用
@moguiyu/dsh-tool-tavily-search	tavily_search 模型工具 + Tavily Search 设置卡片
@moguiyu/dsh-tavily-backend	用量、Key 管理和提供方切换的本地路由

安装

dsh plugin --profile web add @moguiyu/dsh-tool-tavily-search
dsh plugin --profile web add @moguiyu/dsh-tavily-backend

或直接从 GitHub 安装：

dsh plugin --profile web add github:moguiyu/dsh-tavily

然后在 $DSH_HOME/profiles/web/cordis.patch.yml 中添加：

- insert:
  - id: web-search-tavily
    name: '@crayonlu/dsh-web-search-tavily'
  - id: tool-tavily-search
    name: '@moguiyu/dsh-tool-tavily-search'
  - id: tavily-backend
    name: '@moguiyu/dsh-tavily-backend'
- id: web
  config:
    searchProvider: tavily

刷新浏览器后，卡片会出现在 Settings → Plugins → plugin configuration（tavily-search）。

凭据

• TAVILY_API_KEYS — tavily_search 使用的逗号分隔 Key 列表
• TAVILY_API_KEY — 自动同步为首个 Key 的主 Key，供 web_search 使用

两者都由设置卡片自动管理。

Key 用量策略

• 轮流使用每个 Key — 轮询；遇到 401/429 自动尝试下一个。
• 按用量最少优先 / 用量最多优先 — 保存时按 Tavily 实时用量重新排序。

开关

在内置 web_search 的 tavily 与原生 deepseek-official 提供方之间切换。选择会持久化到 ~/.dsh/tavily-toggle.json。

状态文件

• ~/.dsh/tavily-manager.json — Key 保存日期 + 策略
• ~/.dsh/tavily-toggle.json — { "enabled": boolean }

权限 600，不保存密钥。

开发

pnpm install
pnpm test
pnpm build

许可证

MIT

---

English