@frost_with_snow/dsh-tavily-search

v1.0.0 · 1 天前发布

Tavily search plugin for dsh with multi-key rotation & usage tracking (personal plugin)

dshdsh-plugintavilyweb-searchsearch

README

@frost_with_snow/dsh-tavily-search

个人 dsh 搜索插件，Tavily API 后端。

功能

web_search 工具：搜索网页

tavily_status 工具：查看所有 API Key 状态

多 API Key 自动轮换

本地用量持久化（~/.tavily-usage.json）

跨月自动重置

阈值切换（默认 50 次）

安装

bash
通过 npm 安装

npm install -g @frost_with_snow/dsh-tavily-search
或通过 link 安装（开发模式）

npx dsh plugin add link:C:\path\to\dsh-tavily-search

配置

bash
单个 key

export TAVILY_API_KEY="tvly-your-key"
多个 key（逗号分隔）

export TAVILY_API_KEY="tvly-key1,tvly-key2,tvly-key3"
或创建 ~/.tavily-keys 文件，每行一个 key
切换阈值（可选，默认 50）

export TAVILY_THRESHOLD=50

技术细节

先搜再说：直接搜索，成功后本地累加用量

失败处理：429/403 → 查远端 /usage → 标记耗尽 → 切下一个 key

跨月自动重置用量

许可证

MIT

版本兼容矩阵

DSH 版本	状态	说明
`dsh@0.1.0-rc.6`	✅ 兼容	cordis patch ✅
`dsh@0.1.0`	✅ 兼容	标准 patch ✅
`dsh@0.2.0`	⚠️ 待验证	待实测（API 可能在变）
`dsh@0.3.0+`	❓ 未知	尚未发布

💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

元数据

License: MIT
npm: @frost_with_snow/dsh-tavily-search
Repo: —
Engines: {}
Weekly DL: 0
Monthly DL: 0
dsh.bundle: {"bundle":{"patch":"cordis.patch.yml"}}