Introduction

DSH’s philosophy is “everything is a plugin”. For DSH agent developers, as the number of web plugins grows, it is often difficult to quickly distinguish whether a plugin is a built-in capability, a third-party capability, or only responsible for a specific UI/runtime capability.

dsh-web-plugin-explain addresses this with a concrete action: it enhances the “Plugin List” tab in the Web settings, making each plugin card display the description from the plugin’s own package.json when expanded, tagging third-party plugins, and supporting search by description.

What is it

dsh-web-plugin-explain is a DSH Web plugin maintained by 2710165659, licensed under MIT, with package version 0.1.0.

It enhances the settings page in DSH Web:

Settings → Plugins → "Plugin List"

After opening a plugin card, you can see the original description from that plugin’s package.json; if the description cannot be parsed, is displayed. The plugin is published to npm, so normal installation does not require cloning the repository or building locally.

Core Features

Below are the verified capabilities of the plugin.

Unified Description Source

Built-in and third-party plugins use the same display rule: when the card is expanded, the original description from the plugin’s own package.json is shown.

When description cannot be parsed, the description line displays:

Third-Party Tags

Plugins whose module names do not start with @deepseek-ai/ or cordis: will display a “Third-Party” small tag after their name.

Built-in entries like @deepseek-ai/* and cordis:* will not be mistakenly labeled as third-party even if they are not covered by the dictionary.

Search by Description

The search box matches:

  • id
  • module name
  • description

For rows with the “Third-Party” tag, the tag text is also matched.

Fault-Tolerant Display

When description parsing fails (e.g., Remote is unavailable), it only affects the description line; the plugin list itself renders normally.

Package Declaration Info

The name in package.json is:

"name": "dsh-web-plugin-explain"

dsh.client.platform is declared as:

"web"

dsh.client.inject declares multiple @deepseek-ai/dsh-client-* packages. dependencies includes:

"zod": "^4.4.3"

peerDependencies includes:

"@deepseek-ai/cordis": "4.0.1"

Documentation states that dependencies like zod and @deepseek-ai/dsh-client-* are installed automatically by pnpm.

Installation and Activation

npm Installation

The plugin is published to npm; the installation command is:

dsh plugin --profile web add dsh-web-plugin-explain

After installation, restart dsh web.

When restarting dsh web, the typert-loader registers the plugin’s strict endpoint at startup.

dsh plugin add automatically recognizes the dsh.bundle declaration in the package and appends it as a layer to the web profile.

Installation from Source

When developing, modifying code, or needing to build locally, you can first clone the repository:

git clone https://github.com/2710165659/dsh-web-plugin-explain.git
cd dsh-web-plugin-explain
npm install
npm run build          # Build lib/ (index.js + client.js + typert.host.js)
dsh plugin --profile web add ./dsh-web-plugin-explain

The build generates index.js, client.js, and typert.host.js in lib/.

It also requires restarting dsh web to take effect.

Typical Usage

  1. Install the plugin:
dsh plugin --profile web add dsh-web-plugin-explain
  1. Restart dsh web.

  2. Open:

Settings → Plugins → "Plugin List"
  1. Expand any plugin card to view the description from package.json.

  2. In the search box, enter the plugin id, module name, or description to locate the target plugin; for third-party plugins, you can also search for “Third-Party”.

Uninstallation

The uninstall command is:

dsh plugin --profile web remove dsh-web-plugin-explain

After restarting dsh web, the built-in plugin list is restored.

Use Cases and Notes

This plugin is suitable for the following scenarios:

  • Maintaining multiple DSH Web plugins and needing to quickly view plugin package descriptions.
  • Distinguishing between built-in and third-party plugins.
  • Searching for plugins by description in the “Plugin List” on the settings page.
  • Installing from source and building locally for verification when developing DSH Web plugins.

Notes before use:

  • License is MIT.
  • The plugin runs with the permissions of the current dsh process; check the source code, dependencies, and license before installing.
  • This plugin is a Web client plugin listed in the Community Plugin Clues; the Community Directory is an independent site and does not constitute an official affiliation with DeepSeek / Hypersphere.
  • Displays when the description cannot be parsed; description parsing failure will not cause the plugin list itself to fail rendering.

Links

  • GitHub: https://github.com/2710165659/dsh-web-plugin-explain
  • Directory Page: https://www.skillhub.cn/plugins/2710165659/dsh-web-plugin-explain (from Plugin Clues, verify yourself)