Preface¶

DSH’s “everything is a plugin” approach means a single profile can contain multiple plugins simultaneously: some enabled, some disabled, some on different versions, and some only active during certain loading phases. In daily development, a common need isn’t just “install another plugin,” but rather first confirming: which plugins are currently loaded, whether a specific plugin is installed, how to install the desired plugin, and where to check its status afterward.

dsh-plugin-browser addresses these issues by consolidating the awesome-dsh-plugin directory, the current profile’s plugin loading status, and dshmarket’s install/update/uninstall actions into a single panel, while also providing two query tools for the agent.

awesome-dsh-plugin is a community directory and should not be interpreted as an official app store from DeepSeek / 幻方. Sources indicate this directory contains 252+ plugins; there are inconsistencies in the retrieved materials regarding the specific maintainers and repository ownership, and this article does not draw conclusions based on unverified information.

What This Is¶

dsh-plugin-browser is a DSH plugin positioned as a “plugin market entry point + operations panel.”

It primarily does three things:

• Browse the awesome-dsh-plugin directory;
• View each plugin’s installed/loaded status in the current profile;
• Execute install, update, and uninstall operations via dshmarket.

The license is MIT; peerDependencies require @deepseek-ai/cordis ^4.0.1.

Core Features¶

Agent Tools¶

You can directly ask the agent to query plugin status in a conversation.

list_plugins lists the current loading/installation status, returning fields including: module name, version, enabled status, Cordis loading phase, entry id, and bundle layer stack.

browse_plugin_market allows searching for plugins by keyword, returning directory matches along with their installed/loaded status in the current profile and installation commands.

GUI Tab¶

The GUI entry point is located at:

Settings → Plugins → Plugin Browser

The tab contains two main sections:

• Market: Displays awesome-dsh-plugin directory cards, supporting category filtering, search, star sorting, and showing installed versions and loading status.
• Installed Plugins: Displays the current profile’s loader snapshot, including version, source, loading status, and homepage.

Action buttons on market cards include: Install, Update, Uninstall, and Open Repository. These actions execute through dshmarket’s /dsh-market/* endpoints; when dshmarket is not installed, the action buttons are disabled with a prompt.

HTTP Routes¶

The plugin provides the following routes:

GET /dsh-plugin-browser/list
GET /dsh-plugin-browser/catalog
POST /dsh-plugin-browser/refresh

list returns the local loader snapshot, catalog returns the merged view of the directory and installed/loaded status, and refresh clears the directory cache.

Directory Loading¶

Directory loading uses a three-level fallback:

1. Online;
2. Built-in snapshot data/registry-snapshot.json;
3. dshmarket snapshot.

The in-process cache duration is 10 minutes.

Sources indicate all data comes from the local machine + the awesome directory JSON, with no additional network access.

Installation and Enablement¶

It’s recommended to first install dsh-plugin-browser into the target profile, for example web:

dsh plugin --profile web add github:CriscolTheCoder/dsh-plugin-browser

If you want to use the install/update/uninstall buttons in the market tab, you also need to install dshmarket:

dsh plugin --profile web add dshmarket

For local development, you can also use file: to point to the source directory. Note that the path should not contain spaces:

dsh plugin --profile web add file:C:/Users/xxx/dsh-plugin-browser

After installation, you can use the agent tools in conversations or open Settings → Plugins → Plugin Browser.

Uninstall command:

dsh plugin --profile web remove dsh-plugin-browser

Typical Usage¶

The following examples come from usage patterns found in verified materials.

1. Ask the agent in a conversation: List all currently loaded plugins.
   This is suitable for checking the current profile’s plugin list and loading status.

2. Ask the agent in a conversation: Help me find TUI-related plugins.
   This is suitable for finding plugins based on requirements and seeing whether they’re installed or loaded.

3. Open Settings → Plugins → Plugin Browser, filter, search, and sort in the market tab, then perform install, update, uninstall, or open repository on the target plugin.

4. If you only want to view the local plugin snapshot, call GET /dsh-plugin-browser/list; if you need the merged directory and status, call GET /dsh-plugin-browser/catalog.

5. If the directory display is abnormal, try POST /dsh-plugin-browser/refresh to clear the cache.

Applicable Scenarios and Notes¶

Suitable for:

• Confirming which plugins are currently loaded in a specific DSH profile;
• Finding plugins via the directory and installing them;
• Delegating plugin status queries to the agent;
• Quickly viewing the loader snapshot when developing DSH plugins locally.

Notes:

• This plugin runs with the current DSH process’s permissions. Check the source code, license, and dependency sources before installation.
• The license is MIT, but there are inconsistencies in the retrieved materials regarding the repository ownership in the install command: the install command uses CriscolTheCoder, while the README mentions qichuang321. Verify the code source you’re using before installation.
• Market actions depend on dshmarket; buttons will be disabled with a prompt if it’s not installed.
• The local file: installation path should not contain spaces.
• Directory loading involves online, local snapshot, and dshmarket snapshot; sources indicate data comes from the local machine and the awesome directory JSON without additional network access, but actual behavior should be verified against your runtime environment.

Conclusion¶

The value of dsh-plugin-browser lies in bringing “query plugins, view status, execute install/update/uninstall” into a single DSH plugin panel while enabling the agent to directly answer questions about current plugin status.

Directory page:

https://www.skillhub.cn/plugins/qichuang321/dsh-plugin-browser

The GitHub repository address has two variants (qichuang321 and CriscolTheCoder) in the retrieved materials, with no single verified repository; the install command is:

dsh plugin --profile web add github:CriscolTheCoder/dsh-plugin-browser