Introduction

When using search-related capabilities in DSH, if you want the model to directly invoke tools like s1_search, s1_news, s1_crawl, etc., dsh-s1 provides a more direct plugin path: it registers s1-related capabilities as first-level tools in DSH, rather than requiring the model to execute shell commands. Below is an introduction to its positioning, capabilities, installation methods, and considerations.

What is it

dsh-s1 is a DeepSeek Harness (DSH) plugin maintained by superagents-lab for registering s1 capabilities as first-level tools in the s1_* format.

Basic Information:

  • License: MIT
  • Node Requirements: >=20.0.0
  • GitHub: https://github.com/superagents-lab/dsh-s1

Core Capabilities

dsh-s1 registers the following tools:

  • s1_search
  • s1_news
  • s1_crawl
  • s1_sitemap
  • s1_trending

It also registers a bundled s1 skill to help the model understand how to select the appropriate s1 tools and parameters.

Currently Unimplemented:

  • s1_screenshot
  • s1_deepcrawl

Installation and Enabling

If using a published or directly installable package, run:

dsh plugin --profile web add dsh-s1

If using a local checkout, you can first build it, then add it to a specific profile using a file path:

cd /Volumes/More/Products/search1api/ecosystem/dsh-s1
npm run build
cd ~/.dsh
dsh plugin --profile web add file:/Volumes/More/Products/search1api/ecosystem/dsh-s1

Here, npm run build is used to generate local build artifacts; the subsequent dsh plugin command is responsible for registering the local path to the web profile.

Authentication

dsh-s1 uses a credential variable:

export S1_KEY=...

Note: When S1_KEY is missing, tool invocation will fail, rather than the plugin activation failing.

The OAuth flow has not been implemented yet.

Development and Build

For local development, you can execute the following steps:

npm install
npm run typecheck
npm run build

npm run typecheck is used for type checking, and npm run build is used to generate loadable build artifacts.

Use Cases and Notes

dsh-s1 is suitable for scenarios where you need to integrate s1 search, news, crawling, sitemap, and trending capabilities into a DSH profile.

It is recommended to check the source code, license, and dependency environment before installation; the plugin will run with the permissions of the current dsh process.

Additionally, do not treat s1_screenshot and s1_deepcrawl as available capabilities.

Links

GitHub:

https://github.com/superagents-lab/dsh-s1