Preface¶

In DSH, web search uses the official DeepSeek by default. If you want to switch to Tavily, the common approach is to adjust the search source or reinstall the plugin, which makes switching costly. dsh-tavily provides Tavily as a web search service provider for DSH, and offers a settings card toggle: when disabled, it continues to use the official DeepSeek; when enabled, it switches to Tavily, eliminating the need to repeatedly uninstall and reinstall packages.

As of 2026-08-30, it is recommended to update the plugin to 0.3.1. Below are the features, installation commands, enabling methods, and important considerations.

What This Is¶

dsh-tavily is a Tavily web search plugin for DeepSeek Harness (DSH). It targets DSH’s Web client and provides optional Tavily web search: when the toggle is off, it uses the official DeepSeek; when the toggle is on, it uses keyless or account-tier mode depending on whether a Key is provided.

The repository owner is SZMY-haruhi, and the license is MIT.

Core Features¶

• Settings card toggle: Off = official DeepSeek, On = Tavily, with no need to uninstall packages when switching.
• Uses Tavily keyless when no Key is provided; uses Authorization: Bearer when a Key is available.
• The bottom-left of the settings card has a connectivity test: it makes a real call to Tavily with the request parameter max_results: 1; without a Key it uses keyless, with a Key it uses the account tier and consumes 1 credit.
• Handles timeouts, aborts, official Host locking, and drops results without a url.
• Key / toggle are stored in credentials, not in settings files.
• The settings card namespace is web-search-tavily, which does not override the official web search card.

Installation and Enabling¶

First, install the stable version with npm:

dsh plugin --profile web add dsh-tavily

If an older version is already installed, update to 0.3.1 first:

dsh plugin --profile web update dsh-tavily

You can also install from the GitHub repository:

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

If you need a specific version, you can pin a commit for installation:

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

After installation, navigate to the plugin configuration via the following path:

Settings → Plugins → Plugin Configuration → Tavily Web Search

Enable it by turning on the “Tavily Web Search” toggle. The Key is optional; if no Key is provided, it uses Tavily keyless. The connectivity test at the bottom-left confirms whether search is currently available. With a Key, the connectivity test consumes 1 credit.

To uninstall:

dsh plugin --profile web remove dsh-tavily

Typical Usage¶

Follow the steps below in order.

1. Install the plugin:

dsh plugin --profile web add dsh-tavily

2. Go to Settings:

Settings → Plugins → Plugin Configuration → Tavily Web Search

3. Turn on the toggle. Once enabled, web search switches from the official DeepSeek to Tavily.

4. Leave the Key empty, or enter your Tavily Key. Without a Key, it uses keyless; with a Key, it uses the account tier.

5. Click the connectivity test at the bottom-left. It can be tested without a Key; with a Key, it confirms whether the account tier is currently available.

6. After the above steps, if the version is outdated, run the update:

dsh plugin --profile web update dsh-tavily

Credential Location¶

The Key / toggle is not written in settings files, but rather in credentials. Credentials can be written in:

$DSH_HOME/.credentials.yaml

Do not commit real keys to the repository.

Version and Compatibility Notes¶

• Update to 0.3.1.
• 0.3.0 may cause the entire Web to hang on “Failed to load plugins” when installed alongside other client plugins.
• 0.3.1 fixes the issue where settings.plugin.item requires key, and can no longer use id or order.
• The settings card namespace for 0.3.1 is web-search-tavily, which does not override the official web search card.

Applicable Scenarios and Notes¶

Suitable for the following use cases:

• Want to use Tavily web search in DSH’s Web client.
• Want to switch between the official DeepSeek and Tavily via a toggle without repeated installation and uninstallation.
• Want to first confirm connectivity in keyless mode without providing a Key.

It is recommended to review the source code and license before installation. dsh-tavily runs as a plugin for the DSH Web client, and plugin code executes with the permissions of the current dsh process; please ensure its implementation meets your project requirements before introducing it. The license is MIT.

Links¶

• Directory page: https://www.skillhub.cn/plugins/SZMY-haruhi/dsh-tavily
• GitHub: https://github.com/SZMY-haruhi/dsh-tavily