dsh-tavily-cxykyw
基于 Tavily 的 WebSearchProvider，用于 DeepSeek Harness 的 Web 能力接口（ctx.web）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cxykyw/dsh-web-search-tavily#8e4ba095ab1b2ffea6edc80127513bf5195e216bTavily Cxykyw 以 dsh-tavily-cxykyw 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A Tavily-backed WebSearchProvider for the DeepSeek Harness web capability seam (ctx.web).
It routes the built-in web_search tool to Tavily's dedicated search API instead of the shipped DeepSeek model-based search channel, so a search costs no model tokens and the result set comes from a real search engine index rather than an auxiliary model request.
Verified against DSH 0.2.0-rc.2.
Package name note:
dsh-web-search-tavilyon npm belongs to another author. This plugin is published asdsh-tavily-cxykyw; the GitHub repository is stillcxykyw/dsh-web-search-tavily.
tavily on ctx.web;WebSearchResult — results[].url/title/content become sources[].url/title/snippet, and Tavily's optional answer becomes the result content;apiKey → credentials service (~/.dsh/.credentials.yaml) → launch environment / process.env;available() is a cheap local check (key + base URL present) with no network calls — a missing key surfaces as WEB_PROVIDER_CREDENTIAL_MISSING at search time;request.maxResults through the seam, exactly like any other provider.dsh plugin --profile web add dsh-tavily-cxykyw
If your DSH profile is a pnpm workspace root (the default ~/.dsh/profiles/web is), the add must target the workspace root:
dsh plugin --profile web add dsh-tavily-cxykyw -w
The bundled cordis.patch.yml declares dsh.bundle.patch, so adding the package also registers it as a profile bundle: the provider row is inserted and web.searchProvider is set to tavily for you. Restart dsh web afterwards — bundle changes are not hot-reloaded.
From a checkout instead of npm:
git clone https://github.com/cxykyw/dsh-web-search-tavily.git
dsh plugin --profile web add link:/absolute/path/to/dsh-web-search-tavily -w
Get a key at app.tavily.com (there is a free tier). Then pick one of:
1. Credentials file (recommended — outside every repository):
# ~/.dsh/.credentials.yaml
TAVILY_API_KEY: tvly-xxxxxxxxxxxxxxxx
2. Environment variable of the process that launches DSH:
TAVILY_API_KEY=tvly-xxxxxxxxxxxxxxxx dsh web
3. Literal key in your own profile patch (works, but keeps the secret in a plain file — prefer 1 or 2):
# ~/.dsh/profiles/web/cordis.patch.yml
- id: web-search-tavily
config:
apiKey: tvly-xxxxxxxxxxxxxxxx
Never commit an API key. This repository, its
cordis.patch.yml, and its published npm tarball contain no credentials and no default key: the plugin only ever reads them from your machine at search time..gitignorealso excludes.env*,.npmrc, and*.local.yml.
Configurable on the inserted web-search-tavily row:
| Option | Default | Description |
|---|---|---|
apiKey | — | Literal Tavily API key. Prefer apiKeyEnv + credentials/env. |
apiKeyEnv | TAVILY_API_KEY | Credential reference / environment variable name to resolve the key from. |
baseURL | https://api.tavily.com | Tavily API base URL (point it at a proxy if you need one). |
searchDepth | basic | basic (fast, 1 credit) or advanced (deeper crawl, more credits). |
maxResults | 8 | Results requested per search, 1–20. A per-call maxResults still wins. |
Example, overriding just the depth and result count:
# ~/.dsh/profiles/web/cordis.patch.yml
- id: web-search-tavily
config:
searchDepth: advanced
maxResults: 5
The bundle patch already pins the seam:
- id: web
config:
searchProvider: tavily
fetchProvider: http
To fall back to the official DeepSeek search, set searchProvider: deepseek-official (or remove the line only if deepseek-official is the single usable provider — with two usable providers and no pin, the seam fails closed with WEB_PROVIDER_AMBIGUOUS).
Upgrading from a hand-inserted copy in your own profile patch? Delete that
insertblock and keep only the- id: web-search-tavilyconfig override above, otherwise the row id is inserted twice.
0.2 cannot mount this plugin's settings section, so the provider is configured through the profile patch only.fetch (page retrieval) is untouched — it stays on @deepseek-ai/dsh-web-fetch-http.sources[].publishedAt is not set.dsh plugin --profile web remove dsh-tavily-cxykyw -w
MIT © cxykyw