Introduction¶

When building agents in DSH (DeepSeek Harness), it is often necessary to confirm whether a certain capability already has an existing DSH plugin. This kind of information is usually scattered across npm, GitHub repositories, and the awesome-dsh-plugin list, requiring frequent checking of package names, versions, repositories, and authors.

dsh-plugin-search brings “finding plugins, querying metadata, and browsing curated lists” inside the DSH agent, reducing the cost of manual lookup outside the agent workflow.

What is it¶

It provides three categories of capabilities within the DSH agent:

Search for DSH plugins in npm and the awesome-dsh-plugin curated list;
Query npm package metadata, falling back to GitHub repository search if not found;
Browse the current awesome-dsh-plugin curated list.

Core Functions¶

Below are the three tools it provides.

dsh_search_plugins¶

dsh_search_plugins is used to search for DSH plugins.

It searches both npm and the awesome-dsh-plugin curated list simultaneously, prioritizes npm results, deduplicates them, and includes version and source tags.

Suitable for questions like:

Whether a certain capability already has a DSH plugin;
Which plugin names are similar and need distinction;
Whether a plugin comes from npm or the awesome-dsh-plugin list.

dsh_plugin_lookup¶

dsh_plugin_lookup is used for precise plugin package queries.

It queries npm metadata, including:

Latest version;
Description;
Homepage;
Repository;
Author.

If not found in npm, it falls back to GitHub repository search.

dsh_awesome_top¶

dsh_awesome_top is used to browse the current awesome-dsh-plugin curated list.

It allows for a quick view of plugins in the current curated list within DSH, helping to understand the scope of available DSH plugins.

Installation & Enablement¶

Install the v1.1.0 tarball from GitHub Release to the web profile:

dsh plugin --profile web add https://github.com/zoahdev/dsh-plugin-search/releases/download/v1.1.0/dsh-plugin-search-1.1.0.tgz

If a tarball has already been built locally, you can also add it as shown in the README:

dsh plugin --profile web add ./dsh-plugin-search-1.1.0.tgz

The peerDependencies declared in package.json are as follows:

{
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
}

In other words, the environment used needs to provide @deepseek-ai/cordis ^4.0.1 and @deepseek-ai/dsh-tools ^0.1.0-rc.6.

Typical Usage¶

After installation, you can directly ask the agent in DSH:

帮我找一个能监控 GitHub release 的 dsh 插件。

Or you can use English:

Find me a dsh plugin that tracks GitHub releases.

These examples are used to let the agent search for relevant DSH plugins within DSH, rather than manually leaving DSH to search on npm or GitHub.

Applicable Scenarios & Notes¶

Suitable for the following scenarios:

Judging whether a certain capability already has an existing DSH plugin within DSH;
Viewing npm metadata for a specific DSH plugin;
Continuing to view the GitHub repository if not found in npm;
Browsing the current awesome-dsh-plugin curated list.

Notes:

Plugins run with the current DSH process permissions;
Source code and license should be checked before installation;

The value of dsh-plugin-search lies in bringing the plugin discovery process into the DSH workflow: searching, querying, and browsing lists can be completed inside the agent.

GitHub Repository:

https://github.com/zoahdev/dsh-plugin-search

dsh-plugin-search: Search for dsh plugins in the DSH agent