Introduction¶
DeepSeek Harness (DSH) emphasizes “everything is a plugin.” For developers using dsh web, checking whether the local Harness is behind the new version in the npm registry often requires manual inspection. duntansen/dsh-update-checker is a DSH web plugin designed to perform version checks within the Settings page: it reads the local dsh --version and compares it with the latest / next dist-tags of the npm registry, providing a one-click update entry when a new version is found.
What is this¶
This is a DSH web plugin maintained by duntansen with an MIT license.
It centralizes version checking and updating operations that were originally scattered in the terminal into the DSH Settings page, including:
- Check local version against npm registry version
- One-click run update command
- View version timeline
- View recent check history
- Automatically re-check and trigger browser notifications while the Settings page is open
Core Features¶
Version Check¶
The plugin reads the local dsh --version and compares it with the latest / next dist-tags of the npm registry.
Version comparison supports semantic versioning and can correctly handle rc pre-release segments.
One-Click Update¶
When a new version is detected, you can click the update button on the Settings page to run:
npx -y @deepseek-ai/dsh@latest
During the update process, the page displays real-time installation progress. Once completed, the page prompts to restart dsh web.
Version Timeline¶
The page displays the last 8 published versions and their release dates, highlighting the current version.
Automatic Re-check and Notifications¶
While the Settings page is kept open, the plugin automatically re-checks every 6 hours.
When a new version is detected, the plugin triggers a browser notification. The first time it triggers, the browser will request notification permission.
Check History¶
The plugin saves the last 10 checks to:
~/.dsh/dsh-update-checker-history.json
These records are also displayed on the page.
Installation and Usage¶
Install the plugin from GitHub:
dsh plugin --profile web add github:duntansen/dsh-update-checker
After installation, restart dsh web, open the GUI, and go to:
Settings → Update Check
to use the plugin.
Typical Usage¶
The following describes the common operation sequence.
- Open
Settings → Update Check. - The page will display the current version, latest version,
nextversion, and status badge. - If a new version is detected, click the update button to perform the update.
- After the update is complete, restart
dsh webas prompted on the page. - When a manual re-check is needed, click the
Re-checkbutton.
Implementation and Runtime Details¶
The plugin provides an update interface:
POST /dsh-update-check/update
This interface is protected by the same-origin policy and is single-instance.
The plugin runs cross-platform when executing commands:
- Windows uses
cmd.exe - POSIX uses
/bin/sh
The local version is read via dsh --version, and npm registry data is used to compare latest / next dist-tags.
Applicable Scenarios and Notes¶
Suitable for developers who want to quickly confirm the local Harness version status in the DSH Settings page.
Please note that the plugin runs with the permissions of the current dsh process and will read the local version and execute the update command. It is recommended to check the source code before installation and confirm that the MIT license meets your usage requirements.
Browser notifications rely on browser permissions; if you do not want to enable notifications, you can refuse the permission request. Check history is written to:
~/.dsh/dsh-update-checker-history.json