Preface¶

In DSH’s plugin-based usage model, developers often need to confirm the current running version in the web interface: Is the current dsh the latest npm version? If not, what is the update command? dsh-update-notifier addresses this exact issue: it persistently displays the installed DSH version at the bottom of the sidebar and shows a red dot and update panel when npm latest is updated. Below, we introduce its positioning, core capabilities, installation method, and considerations.

What It Is¶

dsh-update-notifier is a community plugin, maintained by arvin-yd, licensed under MIT. It is not an official DeepSeek product, nor is it an application in the official app store.

Its positioning is: to provide a persistent version badge for DeepSeek Harness (dsh), always showing the currently installed version; when the latest version of @deepseek-ai/dsh in the npm registry is updated, it displays a red dot and opens the update panel.

Core Features¶

The plugin’s capabilities focus on version display, update checking, and update operations:

• Provides a persistent badge at the bottom of the sidebar, always showing the current installed DSH version.
• Polls the npm registry to check the latest dist-tag for @deepseek-ai/dsh.
• Provides a GET /dsh-update-check endpoint with an updateHint.
• Clicking the badge opens a panel showing the current version, latest version, last check time, and available actions.
• Provides actions such as copying the update command, ignoring, and reminding later.
• Supports one-click updates for both npx-cache installations and global npm installations.
• Supports manual immediate checks via a button or ?force=1, with a 2-second cooldown.
• No telemetry is collected, and no third-party calls outside the npm registry are made.

Installation and Enablement¶

First, install it into the web profile:

dsh plugin --profile web add dsh-update-notifier

After installation, DSH needs to be restarted for the plugin to take effect:

dsh --profile web --port <port>

Runtime environment requirements:

• Node.js >=22.0.0
• Depends on @deepseek-ai/cordis ^4.0.1

To remove the plugin, execute:

dsh plugin --profile web rm dsh-update-notifier

Typical Usage¶

After following the steps above, you can first confirm whether the web endpoint is available:

curl http://127.0.0.1:<port>/dsh-update-check

This step is used to verify that the update check endpoint is already available on the host side. The endpoint returns update check related results with an updateHint.

Then, view the sidebar bottom badge in the browser:

1. The badge will display the currently installed DSH version.
2. If the npm latest version is updated, the badge will show a red dot.
3. Click the badge to open the panel, view the current version, latest version, last check time, and choose to copy the update command, ignore, or remind later.
4. If using one-click update, you need to provide two explicit confirmations in the panel.

Configuration Overrides¶

The plugin supports overriding two configuration items: checkIntervalMs and timeoutMs. You can write a configuration similar to the following in $DSH_HOME/profiles/web/cordis.patch.yml:

- id: dsh-update-notifier
  config:
    checkIntervalMs: 21600000
    timeoutMs: 5000

Data, Permissions, and Considerations¶

The plugin runs related check logic along with the DSH process. Before installation, it is recommended to review the GitHub source code and the MIT license before deciding whether to enable it.

Its behavior boundaries are as follows:

• Reads metadata from the public npm registry via HTTPS, without sending credentials.
• Does not write to disk; on the browser side, only ignored version information is saved in localStorage.
• One-click update only executes npm commands under your user account after two explicit confirmations from you.
• For npx-cache installations, one-click update will terminate the current dsh process so that the new version can bind to the port.
• For global npm installations, one-click update will execute the corresponding npm update command.
• No telemetry, analytics, or third-party calls outside the npm registry.

Scenarios suitable for using this plugin include: frequently switching DSH versions, using npm latest updates, and wanting to quickly confirm the current version and update status in the web interface. Note that this is a community plugin, and DSH needs to be restarted after installation for it to take effect.

Compatibility and Verification¶

In the verified information, the last verification date was 2026-08-15, validated against DSH 0.1.0-rc.5 and 0.1.0-rc.6.

Links¶

• GitHub: https://github.com/arvin-yd/dsh-update-notifier
• Plugin Directory: https://www.skillhub.cn/plugins/arvin-yd/dsh-update-notifier