In use cases of DeepSeek Harness (DSH), version upgrades of the core program often lack rollback mechanisms. A failed upgrade or introduced incompatibility can cause service disruption or even make the Web UI inaccessible. The dsh-versions plugin aims to solve this pain point by providing a complete version management solution for the DSH core program.

Plugin Role

dsh-versions is a version management plugin for the DeepSeek Harness core program, maintained by user shangdi178. It runs in the dsh Web UI and allows users to view the current version, check for updates, and perform upgrades, downgrades, or reinstallation of the core program directly from the Web UI. It also provides automatic snapshot and instant rollback capabilities.

Core Features

  1. Version overview and check: In “Settings → Version Management”, view the current dsh core program version and its channel (latest/next/alpha). Supports one-click npm update checks (10-minute cache).
  2. Online operations: Supports online installation, reinstallation, or downgrade to any published version.
  3. Automatic snapshot and rollback: Automatically creates a local version snapshot before upgrading. Supports instant rollback to any historical version without network requests.
  4. History and restart: Logs local upgrade history and supports manually restarting the dsh web service.

Installation and Enablement

Installing this plugin requires dsh ≥ 0.1.0.

  1. Use the dsh plugin command to install the plugin.
  2. After installation, restart the dsh web service to load the plugin.
  3. Open the Web UI and find the “Version Management” entry in the settings menu.

Installation command:

dsh plugin --profile web add dsh-versions

Typical Usage

  • Web UI operations: In the dsh Web UI, go to Settings → Version Management to view the current version, channel information, or click “Check for Updates”.
  • Upgrading on non-Windows platforms: Because the plugin relies on Windows tools, non-Windows users who need to upgrade must manually run the npm command:
npm install -g @deepseek-ai/dsh@<版本>

Use Cases and Considerations

  • Platform limitations: The upgrade/reinstall/restore/restart functions rely on Windows tools (robocopy/schtasks/PowerShell 5.1) and are only available on Windows. On other platforms, the corresponding buttons are disabled and the reason is shown.
  • Access and security: The plugin is accessible only from the local machine and includes cross-site protections (loopback address + Host whitelist). It only manages the dsh core program itself; installation and update of other plugins are centrally managed by the dsh plugin command.

Summary

This plugin reduces the risks of upgrading the DSH core program through automatic snapshot and rollback mechanisms. For developers who frequently debug different versions, this is an essential tool. Plugin details and source code are available in its GitHub repository.