dsh-tavily-pool
由 Tavily 提供支持的 DeepSeek Harness 网页搜索和页面获取：支持多密钥池、基于余额的调度、自动故障转移、冷却以及官方 /usage 余额报告。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-tavily-pool@0.2.0Tavily Pool 以 dsh-tavily-pool 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
Tavily-backed web search and page fetching for DeepSeek Harness: multi-key pool with balance-aware rotation, automatic failover, cooldown, official /usage balance reporting, and independent toggles for search and fetch — configurable from the DSH settings panel.
Not to be confused with
szmy-haruhi/dsh-tavily(single key / keyless, no scheduling) or@yuuz12/dsh-tavily(multi-key, but no fetch takeover and it rewrites internal fields at runtime). This plugin manages a pool of keys, schedules by remaining balance, and takes over bothweb_searchandweb_fetch.
limit === null → unlimited first, unknown → last)Retry-After; cooled keys are hard-excluded until it expires, and when every key is cooling the request waits for the earliest one within a bounded budget432 / 433 treated alike: the key stays out of rotation until /usage confirms a positive balance)/usage reading (limit − used, both official numbers). The plugin keeps no credit accounting of its own: Tavily's billing rules can change at any time, so a locally computed figure could silently become wrong. Balance-aware ordering is still kept fresh between refreshes using a deliberately rough per-call estimate that is never displayed/usage with per-key sliding-window quota reservation, so it never trips the 10-per-10-minutes limitweb_fetch to Tavily /extract, returning plain text (never HTML, which DSH would convert a second time); extraction depth and output format are configurable. Turn it on in settings when you want Tavily to handle fetching toorequest_id) and drawn as a 14-day call-count chart; the file is bounded by both an entry cap and a 30-day windowShipped: everything the spec asked for — search takeover and its toggle, the key pool (one key at a time or a whole pasted batch), failover with cooldown, search parameters, the scheduling policy, balance refresh, fetch takeover with its own toggle (off by default), call history with its chart, and the settings card with its HTTP API.
From the npm registry:
dsh plugin add dsh-tavily-pool
Or straight from GitHub, which needs no registry account. Pin a released tag when you want a reproducible version — see the tags for the ones that exist:
dsh plugin add github:stormbuf/dsh-tavily-pool
dsh plugin add github:stormbuf/dsh-tavily-pool#vX.Y.Z
Both routes install the same files: the files whitelist in package.json applies to git installs too, so no test/ or scripts/ directory comes along.
Then open Settings → Plugins → dsh-tavily-pool and paste your Tavily API key(s). Keys are entered through the panel only — the plugin does not read environment variables or the DSH credentials service.
See docs/usage.md for configuration, scheduling behaviour, billing, and manual rollback steps.
DeepSeek Harness is in preview, so its architecture and plugin interfaces may change between releases. This plugin isolates all host-specific knowledge in one thin adapter layer (lib/dsh/) and probes host capabilities at load time, so that adapting to a breaking change stays cheap.
Tested against DSH 0.1.5-rc.2. On a newer release, the plugin may need re-adaptation; it will report a clear error naming the missing capability rather than failing silently. The step-by-step checklist lives in docs/dsh-upgrade.md.
Installing through dsh plugin add makes this package a bundle layer of the target profile (it lands in that profile's dsh.profile.bundles, after the DSH bundles), which is what lets its cordis.patch.yml pin the providers. Your own profile patch is applied after every bundle layer, so it can always override or disable what this plugin does — see Manual rollback.
MIT