Introduction

When using DeepSeek Harness (DSH), the core and profile plugins might be scattered across different packages, and their version status isn’t always easy to see at a glance. dsh-update-check centralizes the version information of the DSH core and installed profile plugins: the model tool can actively query it, the Settings page allows manual viewing, and periodic checks allow for continuous status updates.

It only performs version checking and reporting; it does not execute upgrades. Upgrade decisions are still made by the user.

What is this

dsh-update-check is the update check plugin for DeepSeek Harness, used to check the current and latest versions of the DSH core (@deepseek-ai/dsh) and installed profile plugins.

Maintained by knlght, license is MIT.

Core Features

Version Check

The plugin checks against npm registry dist-tags for:

  • DeepSeek Harness core: @deepseek-ai/dsh
  • The current version and latest version of currently installed profile plugins

Registry queries use Node native fetch with a timeout of 15 seconds.

On failure, the plugin preserves the last successful snapshot and records errors; if a single package query fails, it is isolated as an unknown entry and does not affect the results of other packages.

Model Tool

The plugin provides a model tool:

dsh_check_updates

The agent can actively query the version status of the DSH core or installed plugins in any session. The default check scope includes the DSH core plus installed plugins within the profile; the tool parameters support temporarily passing in additional package names.

Settings Page

The plugin adds an “Update Check” page to the Settings sidebar. The page content includes:

  • Version table: Package name, current version, latest version, status
  • Last check time
  • “Check Now” button

The UI references DSH theme tokens:

--dsw-alias-*

Supports adaptive light/dark themes.

Periodic Check

The plugin supports periodic automatic checks with optional intervals:

30 seconds / 1 minute / 30 minutes / 1 hour / 12 hours / 24 hours / Disabled

The default interval is 1 hour, with the first check automatically performed 30 seconds after startup.

Browser Endpoints

The plugin provides the following browser endpoints:

GET  /_dsh/update-check/snapshot
GET  /_dsh/update-check/refresh
POST /_dsh/update-check/set-interval

Corresponding functions:

  • /_dsh/update-check/snapshot: Get snapshot
  • /_dsh/update-check/refresh: Trigger check
  • /_dsh/update-check/set-interval: Set check interval

Installation and Enablement

The installation command is as follows:

dsh plugin --profile web add <this repository / npm package name>

After executing the installation command, restart dsh web for the changes to take effect.

Typical Usage

  1. Install and restart dsh web to load the plugin.
  2. Call dsh_check_updates in the agent session to query the version status of the DSH core or installed plugins. If needed, pass additional package names as required.
  3. Open the Settings “Update Check” page to view the version table, last check time, and click “Check Now”.
  4. Set the periodic check interval in Settings as needed:
30 seconds / 1 minute / 30 minutes / 1 hour / 12 hours / 24 hours / Disabled
  1. If programmatic access is needed, use the browser endpoints mentioned above:
GET  /_dsh/update-check/snapshot
GET  /_dsh/update-check/refresh
POST /_dsh/update-check/set-interval

Scenarios and Notes

This plugin is suitable for those who need to view version status in DSH sessions or need to continuously track version changes of the DSH core and profile plugins.

Notes when using:

  • The plugin only reports version status; it does not perform upgrades.
  • The plugin runs with the current dsh process permissions; source code and license should be checked before installation.
  • License: MIT.
  • Runtime requirements:
engines:
  node: ^22.19.0 || >=24.0.0

peerDependencies:
  @deepseek-ai/cordis: >=4.0.0-rc.7 <5.0.0
  @deepseek-ai/dsh-tools: >=0.0.1-rc.1 <0.2.0
  react: ^18.2.0
  • Client injection information:
dsh.client.inject:
  @deepseek-ai/dsh-client-runtime
  @deepseek-ai/dsh-client-ui-settings

dsh.client.platform:
  web

Conclusion

The value of dsh-update-check lies in transforming the version status of the DSH core and profile plugins into queryable, viewable, and periodically reviewable information. It does not make upgrade decisions for the user but only provides version visibility.

Links:

GitHub：https://github.com/knlght/DSH-update-check
Directory Page (Resource Link)：https://www.skillhub.cn/plugins/knlght/DSH-update-check