Introduction¶

The philosophy of DSH is “Everything is a plugin.” After installing many plugins, several issues gradually emerge: why a certain plugin is not taking effect, whether it is compatible with the current DSH version, which plugin has been completely unused yet still occupies a process, and how much Token a specific plugin actually costs. DeepSeek Harness’s built-in plugin manager allows for installation and uninstallation but does not provide hints for health status, compatibility, usage frequency, and cost. dsh-plugin-supervisor fills this gap: it gathers this information into a sidebar panel and supports updating, disabling, uninstalling, and rolling back versions directly within the page.

What is this¶

dsh-plugin-supervisor is a DeepSeek Harness plugin. The repository is located at 2033453490/dsh-plugin-supervisor, the package name is dsh-plugin-supervisor, the current version is 1.0.0, the license is MIT, and the README author is CYKshaozi. It is targeted at DSH Desktop users who have installed multiple plugins, using a single panel to centrally answer “What is the current status of the plugin, can it be updated, and how much is it worth?”

Its category on the directory page is admin-security, belonging to the management and security side of plugins.

Core Features¶

The following lists the capabilities explicitly mentioned in the README.

Health Status and Conflict Warnings¶

• Summarizes whether a plugin row is active, disabled, or failed to activate.
• Detects duplicate tool names, activation failures, version incompatibility, and plugins with overlapping category functions.

DSH Compatibility¶

Compares the package’s declared engines.dsh / peerDependencies against the current DSH version to determine compatibility; plugins without declarations are marked as unknown. Update suggestions compare the npm latest version with the compatible version to avoid installing versions that do not support the current DSH.

Usage Frequency and Token Costs¶

• Usage frequency is calculated from local session logs, counting tool calls, session counts, and last used time; interface-only plugins are marked as “Unobservable”.
• Token costs are estimated based on tool result content and the overhead of the tool Schema, provided per plugin; users can enter a rate to convert it into currency.

Version Backup and In-Page Operations¶

• Automatically backs up old packages before updating; history versions can be viewed, restored, and deleted in the plugin row and detail page.
• Updating, disabling, uninstalling, and restoring are all completed within the page; there is no need to jump to the plugin marketplace.

Plugin Marketplace¶

Reads the awesome-dsh-plugin public index, displays the weekly download rankings, rising plugins, and newly added plugins, and supports in-page installation. Note that this is a community directory and has no official affiliation with DeepSeek or Fangfang.

Installation and Enablement¶

Install from npm (available after release):

dsh plugin --profile desktop add dsh-plugin-supervisor

Install from GitHub:

dsh plugin --profile desktop add github:2033453490/dsh-plugin-supervisor

Local source code method:

git clone https://github.com/2033453490/dsh-plugin-supervisor.git
dsh plugin --profile desktop add ./dsh-plugin-supervisor

After installation, a shield icon will appear in the left sidebar. The Host-side HTTP prefix is /__plugin-supervisor/api/.

A common pitfall here is: after modifying index.js (Host-side), you need to disable and then enable this plugin in the plugin manager for the new module to load; modifying client.js simply requires refreshing the page.

Typical Usage¶

1. Open the sidebar shield icon to enter the supervision panel, first review the health status and conflict warnings, and handle activation failures and duplicate tool names.
2. Check the compatibility and update suggestions for each plugin row; for plugins marked “Unknown”, go back to the package declaration to confirm engines.dsh.
3. For unused plugins, disable them first to observe for a period of time. Confirm they are no longer needed before uninstalling; you can check version history before uninstalling.
4. Before updating, confirm that the automatic backup covers the target plugin; if behavior is abnormal after updating, restore from the history versions.
5. When calculating costs, enter the rate in the panel and view the per-plugin Token estimate.

Data and Privacy¶

The plugin only reads local data: plugin manifests, package declarations in node_modules, and session logs in ~/.dsh. It only writes locally, with settings and version backups located in ~/.dsh/plugin-supervisor/.

Network requests are only used to query the npm registry and https://awesome-dsh-plugin.com/plugins.json; it does not upload plugin manifests, session content, or usage data. Operations such as update, uninstall, and restore are executed by the local DSH plugin manager and will be confirmed within the page before execution.

Environment Requirements¶

• DeepSeek Harness Desktop, with a Web UI.
• Completed development and testing on DSH 0.2.1-rc.5.
• Node.js >= 20 (Host-side).

Applicable Scenarios and Notes¶

Suitable for DSH Desktop users and plugin developers who have installed multiple plugins and need to maintain a plugin list long-term. It runs with the permissions of the current DSH process; update, disable, and uninstall operations directly call the local plugin manager, so you should check the source code and license before installation. This plugin itself uses the MIT license, has no build steps for scripts, and is pure ESM. index.js is responsible for Host-side data collection, HTTP routing, and plugin operations, while client.js is responsible for the sidebar panel UI.

Directory: https://www.skillhub.cn/plugins/2033453490/dsh-plugin-supervisor
GitHub: https://github.com/2033453490/dsh-plugin-supervisor