Introduction

When developing DeepSeek Harness (DSH) plugins, dependency topology conflicts often cause runtime crashes. These issues typically stem from duplicate copies of core packages or version drift, which ultimately lead to Symbol key conflicts. dsh-depguard aims to help developers avoid such risks through pre-installation prediction and post-installation detection.

What Is This?

dsh-depguard is a DSH plugin maintained by DeLightor. It focuses on pre-installation prediction and post-installation detection to identify dependency topology conflicts and prevent crashes caused by dependency issues.

Core Features

This plugin provides the following capabilities:

  • dsh_depguard_predict: Pre-installation prediction. Before installing a new plugin, it statically fetches its manifest and compares it against the current runtime’s @deepseek-ai/dsh-* baseline.
  • dsh_depguard_check: Post-installation detection. It scans the dependency topology on disk and checks for potential issues.
  • Detect duplicate core package copies: Identifies multiple physical copies of the same core package.
  • Detect version drift: Checks whether copy versions deviate from the runtime baseline.
  • Detect private packages: Finds references to private packages.
  • Zero runtime dependencies: Introduces no runtime dependencies by itself.
  • Read-only operations: Does not modify configuration files or automatically run build commands.
  • Provide remediation suggestions: Offers repair solutions for detected issues.

Installation and Enablement

Use the official install command to add the plugin:

dsh plugin --profile web add dsh-depguard

After installation, the plugin starts with the process.

Typical Usage

Developers can use the plugin in the following ways:

  1. Pre-installation prediction: Before installing a new plugin, statically fetch its manifest and compare it against the current runtime’s @deepseek-ai/dsh-* baseline to identify risks early.
  2. Session commands: Enter commands in a DSH session, such as “check my plugin dependencies” or “predict conflicts before installing X,” to trigger the detection features.

Applicable Scenarios and Notes

This plugin is suitable for any developer who needs to manage DSH dependency topology. Keep in mind:

  • Read-only mode: The plugin only performs detection and provides suggestions. It never automatically fixes issues, nor does it write to any profile files or modify configurations.
  • Permission requirements: The plugin runs with the permissions of the current DSH process.

Summary

dsh-depguard provides end-to-end dependency checking capabilities, from prediction to detection, helping developers identify potential risks without modifying configurations.