The core design philosophy of DSH is “everything is a plugin.” In the Web interface under “Settings → Plugins,” the native “Plugin List” tab typically only provides viewing functionality and does not allow plugins to be enabled or disabled. This article introduces an open-source plugin that adds a start/stop control tab to the Web settings, enabling dynamic management of Cordis Loader plugins.

Plugin Positioning

  • Name: dsh-plugin-ctl
  • Maintainer: LinscStef
  • License: MIT
  • Core value: Adds a start/stop control tab to the DSH Web UI for starting or stopping any Cordis Loader plugin.

Core Features

  1. New control tab
    Adds a “Start/Stop Control” tab to the “Settings → Plugins” interface, positioned after the native “Plugin List” tab.

  2. List non-Group Loader entries
    Lists all non-group Loader entries. Each row displays the module name, entry ID, configuration status (enabled / disabled), and Cordis status (unmounted / waiting for dependencies / loading / mounted / mount failed / unmounting).

  3. One-click start/stop
    Supports starting or stopping a plugin with one click. For core plugins (such as dsh-web-app, dsh-base), the stop action requires secondary confirmation to prevent accidental unloading of functionality.

  4. Persistent configuration
    The result of start/stop actions is written to the Loader configuration. After DSH is restarted, plugins will retain their previous start/stop state.

  5. Interaction details
    Supports search functionality, the interface language follows the system language, and inline prompts are displayed when an operation fails.

Installation and Enabling

Before using this plugin, ensure that the target machine has DSH installed (the dsh command is available) and pnpm installed, and that the @deepseek-ai/cordis version in the environment is no lower than ^4.0.1.

Run the installation command:

dsh plugin --profile web add git+https://github.com/LinscStef/dsh-plugin-ctl.git

After installation, restart DSH, open “Settings → Plugins,” and you will see the new “Start/Stop Control” tab.

Typical Usage

  1. Restart the DSH process to load the new plugin.
  2. In the settings interface, switch to the “Start/Stop Control” tab.
  3. Find the target plugin entry and click the “Start” button.
  4. If stopping a core plugin is required, click “Stop” and confirm again in the popup dialog.

Notes

  • Dependency environment: Ensure that DSH and pnpm are installed locally.
  • Core plugin risk: Disabling core plugins (such as dsh-web-app, dsh-base) will immediately unload the corresponding functionality. Please operate with caution; stopping core plugins requires secondary confirmation.
  • Authentication scope: The /plugin-ctl/api route uses unauthenticated routing, just like other local plugins, and is intended only for the local Web UI, so there is no risk of remote access.
  • GitHub repository: https://github.com/LinscStef/dsh-plugin-ctl
  • Community directory: https://www.skillhub.cn/plugins/LinscStef/dsh-plugin-ctl