Introduction

Under DSH’s modularization approach, community plugins are usually scattered across different repositories. dsh-plugin-index provides a community plugin index: it allows you to browse repositories with the dsh-plugin topic sorted by GitHub stars, and perform installation, updates, fixes, and uninstalls within the web profile. It addresses the problems of “where to find”, “how to install”, and “how to maintain afterwards”.

What is it

dsh-plugin-index is maintained by GGigHub and is licensed under MIT. It targets the DSH web profile, organizing GitHub repositories with the dsh-plugin topic into a browsable market list, and provides plugin lifecycle operations.

Core Features

  • Browse repositories with the dsh-plugin topic sorted by GitHub stars in descending order.
  • Install, update, fix, and uninstall plugins within the web profile.
  • Market and installed plugins are multi-tag categorized by function.
  • Perform local filtering and searching on loaded directories based on repository name, description, spec, and category.
  • Clicking a category chip displays a list containing that tag.
  • Refreshing re-requests GitHub, bypassing the 15-minute cache.
  • The installation queue executes serially, with status, duration, and logs viewable.
  • Provides installation instructions / copy install command for plugins not in bundles or known to require subdirectory installation.

Installation and Enabling

The installation command is as follows:

dsh plugin --profile web add github:GGigHub/dsh-plugin-index

After installation, restart DSH and open the ‘Plugins’ tab on the left sidebar.

To uninstall this package:

dsh plugin --profile web remove @dsh-external/dsh-plugin-index

Then restart DSH.

The repository comes with a built lib/ directory, so no prepare or pnpm allowBuilds is required for installation.

Typical Usage

  1. The initial screen returns the first page or local cache first, with background completion updating it automatically.
  2. Browse by stars in the list; click category chips to view plugins containing that tag.
  3. After entering keywords, perform local filtering only on loaded directories. The search scope includes repository name, description, spec, and category; clear the input to return to the full list.
  4. Clicking refresh re-requests GitHub, bypassing the 15-minute cache; search keywords do not participate in server-side filtering.
  5. Before clicking install, you will see a confirmation for “unaudited” risk. Installation enters a serial execution queue where status, duration, and logs can be viewed.
  6. After successful install, update, fix, or uninstall, DSH must be restarted.

Use Cases and Notes

Suitable for users who want to find community plugins in the DSH web profile and perform installation, updates, fixes, and uninstalls using a unified entry point.

Notes before use:

  • This project only serves as read-only distribution and does not accept Pull Requests or Issues.
  • Plugins in the community repository index have not been checked for malware, viruses, or malicious code; a confirmation for “unaudited” risk appears before clicking install.
  • One-click installation does not perform a security audit on behalf of the user; it is recommended to clone the repository, review the source code, and then decide whether to install.
  • Plugins run with the permissions of the current dsh process; source code and license should be checked before installation.
  • Market installation only accepts github:owner/repo and installs the repository root directory; repositories known to require subdirectory installation will disable the market “Install” button, requiring a manual process.
  • When a plugin shows “not in bundles” or is known to require a subdirectory, installation instructions / copy install commands can be used.

Supported environment variables:

GITHUB_TOKEN / GH_TOKEN
DSH_HTTPS_PROXY / DSH_HTTP_PROXY
DSH_HOME
DSH_PROFILE
DSH_CHECKOUT

Conclusion

dsh-plugin-index brings the discovery and lifecycle management of community plugins into DSH’s web profile: from browsing GitHub dsh-plugin topic to installation, updates, fixes, and uninstalls. Repository address:

  • https://github.com/GGigHub/dsh-plugin-index

The directory page URL is not provided in verified sources; this article does not provide it. Enter it via the ‘Plugins’ tab on the left sidebar after installation.