Introduction¶
The DeepSeek Harness plugin ecosystem allows developers to extend functionality. When using an unofficial DeepSeek API (for example, GLM or a gateway), the default built-in web_search tool often returns 401 errors due to authentication configuration issues, preventing online search from completing. The dsh-plugin-search plugin is specifically designed for this scenario and provides a solution that does not require complex configuration.
Plugin Positioning¶
dsh-plugin-search is a web search tool plugin designed for DeepSeek Harness and maintained by user shinjiyu. Its core purpose is to take over the web_search tool in environments that do not rely on the official DeepSeek API, using a zero-configuration approach to bypass authentication restrictions and enable normal web search.
Core Features¶
- Zero-configuration startup: It can run immediately after installation without any additional configuration.
- Takeover of the built-in tool: It automatically disables the official
web-search-deepseekmechanism to avoid conflicts. - Compatibility preservation: The tool name remains
web_search, enabling seamless integration with existing workflows. - Keyless mode support: It supports Tavily’s keyless mode by default and can be used without an API Key.
- Authentication error fix: Once properly configured, it returns search result links instead of 401 errors.
Installation and Enablement¶
- Run the following command to install the plugin:
dsh plugin --profile web add github:shinjiyu/dsh-plugin-search
- After installation, restart the
dsh webprocess.
Note: The tool table in old sessions will not automatically update after restart. New sessions will automatically use the new plugin.
Typical Usage¶
-
Environment variable configuration:
- If you have a Tavily account, set the environment variable
TAVILY_API_KEY. - If you do not have an account, leave this variable unset and the plugin will use keyless mode.
- If you have a Tavily account, set the environment variable
-
Model and Key settings:
- Ensure that the main model uses an unofficial DeepSeek API (such as GLM or a gateway).
- Do not set
DEEPSEEK_API_KEY.
-
Function verification:
- In the conversation, ask about the latest content on DeepSeek Harness Discussions.
- If the plugin is effective,
web_searchwill return search result links instead of 401 errors.
Notes¶
- Do not modify system files: Do not modify the
runtime/directory or the officialweb-search-deepseekplugin files. - Positioning limitation: Do not promote it as a full search engine suite.
- Community status: The corresponding WeChat group QR code expired on 2026-08-22.
- Session updates: The tool table in old sessions will not automatically update after restart; start a new session.
Conclusion¶
dsh-plugin-search solves the problem of web_search being restricted by authentication when using third-party APIs. The project is open-sourced under the MIT license, with its source code hosted on GitHub for developers who need to integrate third-party DeepSeek services.
- Project homepage: https://github.com/shinjiyu/dsh-plugin-search