使用者：从 npm 安装（推荐）

npx @deepseek-ai/dsh plugin --profile web add @yuuz12/dsh-tavily

使用者：从 GitHub 或 tarball

npx @deepseek-ai/dsh plugin --profile web add github:Yuuz12/dsh-tavily npx @deepseek-ai/dsh plugin --profile web add ./yuuz12-dsh-tavily-0.1.0.tgz # npm pack 产物

使用

打开 设置 → 插件 → 插件配置，展开「Tavily 网页搜索」卡片（与内置「终端」「Agent 循环」「网页搜索」卡片并列）。

使用步骤：

1. 粘贴一个或多个 Tavily API Key（在 app.tavily.com 免费注册即得，每把每月 1000 积分），点击添加密钥。
2. 点击密钥区右上角刷新全部用量拉取每个 Key 的官方余额数据。
3. 打开顶部的替换官方网页搜索开关——状态行显示「已接管网页搜索」即生效。

卡片内还可调整：多密钥策略（余额优先 / 手动顺序）、搜索深度（basic=1 积分、advanced=2 积分、fast、ultra-fast）、单次结果上限（1–20）、类别（general/news/finance）、AI 摘要回答（include_answer）。

多密钥调度规则

场景	行为
余额优先（默认）	剩余积分多的先用；无限额度的计划最优先；从未刷新过用量的 Key 排在已知余额之后作兜底；头部并列的密钥按请求次数轮流
手动顺序	严格按列表自上而下（▲▼ 可调序），不做轮转
失败切换	任一密钥出错即尝试下一把；全部失败才向模型报错
冷却	401/403（鉴权失败）、432/433（超额）→ 5 分钟；429（限流）→ 30 秒；冷却中的密钥沉底但不会拒绝参与 failover

每次成功调用的积分消耗（来自 Tavily 响应的 usage.credits）会即时累加到缓存的已用量上，让余额排序在不刷新的情况下也保持准确。