klarkxy's DSH plugins

Update and Changelog Preview

@klarkxy/dsh-update
Plugin Plugin development includes a Web UI

Intercepts automatic version downloads and adds plugin-level updates: preview the release changelog across the version range first, then apply after confirmation.

Install

 dsh plugin --profile web add @klarkxy/dsh-update

Replace web with your profile name. Restart the profile after installing; the plugin then shows up under Settings → Plugins.

About

From README.en.md in 0.1.0.

Preview GitHub Release changelogs between your installed version and the latest target version before updating DeepSeek Harness or any installed third-party plugin, starting and applying updates only after explicit confirmation.

Overview

  • Intercept immediate Desktop "New version" downloads: Clicking the sidebar "New version" pill opens a changelog modal showing every Release log between the running DSH build and the target release instead of starting an immediate download.
  • Per-plugin and batch update previews: Adds an Updates tab to the Plugins page and a Check updates / View update action on each third-party plugin detail page, resolving versions and Release logs across both npm registry and Git-installed plugins.
  • Read the log, then let the host approve: Update checks are read-only. The confirmation button asks the host to approve the write. Nothing is installed or upgraded when the host does not approve. Desktop downloads stay on the host's own update button.

Installation

While this package is still in draft before its first npm release, install it from a pinned Git commit subdirectory or a built local checkout:

dsh plugin add "git+https://github.com/klarkxy/dsh-plugins.git#<commit-sha>&path:/plugins/dsh-update"

Or from a local built directory:

dsh plugin add ./plugins/dsh-update

Usage

  1. Preview and confirm DSH core updates:
    • Click the Desktop New version button when an update is offered, or use Plugins → Updates to inspect Release logs between your current build and the latest release (with a toggle between active-language excerpts and full release notes when bilingual notes are available).
    • Click Download & Update in the modal to begin downloading; dismissing the modal leaves the running installation untouched.
  2. Preview and confirm plugin updates:
    • Open Plugins → Updates to check all installed third-party plugins at once, or click Check updates / View update in any plugin's detail header.
    • Review the Release logs and click Update & Apply. The host installs and hot-reloads the target only after it approves (or asks you to restart when the profile has no HMR). A rejected or unavailable host confirmation leaves the installed plugin as it is.

Limitations

  • Relies on GitHub Releases metadata: Changelogs are read from GitHub Releases of the repository declared by DSH or each plugin; if a plugin omits repository metadata or publishes versions without GitHub Releases, the modal notes that no Release logs were found in range and links to the repository.
  • Writes require host approval: The confirmation button in the page cannot authorize an install by itself. When the host provides no confirmation, the update is refused and neither the plugin manager nor a global install runs.
  • Local linked plugins stay local: Plugins mounted via link: or file: are not overwritten online; rebuild them in their local checkout instead.
  • Anonymous GitHub API rate limits: When neither an authenticated gh CLI nor GITHUB_TOKEN is present on the host, requests use unauthenticated GitHub REST calls and share GitHub's anonymous rate limit.