DeepSeek Harness Plugin

SZMY-haruhi/dsh-tavily

Stars ★ 3 Downloads (30d) 799 Category Browser & Web Added 2026-08-17 npm dsh-tavily

Tavily web search for DSH with a settings toggle, keyless by default, and a connection test.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-tavily

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

中文 | English

Tavily web search for DeepSeek Harness. Adds Tavily Search API as a web search provider for DSH.

Install

npm (stable, official recommendation):

dsh plugin --profile web add dsh-tavily
dsh web

Or follow GitHub (latest commit on the repo):

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily
dsh web

Sidebar Plugins → installed dsh-tavily → the web-search-tavily row’s configuration page: turn the toggle on. The key is optional; leave it blank for keyless. Test connection on that page checks that search works now (including keyless).

Please update to 0.3.2. 0.3.1 and earlier mount the card with DSH 0.1’s settings.register and settings.plugin.item. DSH 0.2 removed that API and slot, so the plugin fails during startup and the card has no entry. 0.3.2 registers plugins.row.config on the Plugins page. npm:

dsh plugin --profile web update dsh-tavily

GitHub installs: run add github:SZMY-haruhi/dsh-tavily again.

Pin a commit:

dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily#<commit>

Remove:

dsh plugin --profile web remove dsh-tavily

dsh.bundle · prebuilt lib/ · git install does not need allowBuilds

Features

  • Plugins-page toggle: off = official DeepSeek, on = Tavily — no uninstall to switch back
  • No key uses Tavily keyless; a key uses Authorization: Bearer
  • Bottom-left connection test: one real Tavily search (max_results: 1); keyless if no key, account quota if a key is saved (1 credit)
  • Timeout, abort, official host lock, drop results without a url
  • Key and toggle live on the credentials plane, not the settings file

Behavior

Toggle Key web_search
Off (default) — official DeepSeek
On empty Tavily keyless
On set Tavily account quota

Provider id: tavily.

Credentials

Ref Meaning
TAVILY_API_KEY Optional. Present = account quota; absent = keyless
TAVILY_SEARCH_ENABLED Present = on; unset = off

You can also put these in $DSH_HOME/.credentials.yaml. Do not commit real keys.

The Plugins-page card always reads and writes TAVILY_API_KEY and TAVILY_SEARCH_ENABLED. The cordis field apiKeyEnv only changes which reference the host resolver and the connection test use when there is no draft key. They name the same reference only while apiKeyEnv stays at the default TAVILY_API_KEY. A different apiKeyEnv leaves the card on TAVILY_API_KEY while search and the test read the new name.

Updates

  • 2026-10-12 0.3.2 (please update) DSH 0.2: drop the removed settings.register; move the card from settings.plugin.item to plugins.row.config on the Plugins page (dsh-tavily#web-search-tavily); read and write credentials through remote.credentials and refresh on credentials/reference-updated; snapshot store is the peer @deepseek-ai/dsh-client-store so it shares the host instance. Peers stay on 0.2.x (including 0.2.0-rc.2 and 0.2.1-alpha) and cordis 4.x. A failed save shows its error code; a failed credential read locks the toggle. The connection test is a POST-only connection.fetch route, so an anonymous request gets the host's 401. @deepseek-ai/dsh-client-connection is a peer because the plugin injects connection. Toggle and key still live on credentials.
  • 2026-08-17 0.3.1 Fix: installing alongside other client plugins could freeze Web on “Failed to load plugins / dsh-tavily” (the then-current settings.plugin.item needed key). That slot is gone in DSH 0.2; use 0.3.2.
  • 2026-08-17 Configuration page: Test connection at the bottom-left. Works without a key (Tavily keyless). A saved key uses the account path and 1 credit. Does not change the toggle or Save.

Author

Thanks for the star ❤️ tonkatsu258 · personal site

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.