idoall/dsh-update-status ↗★ 2

dsh-update-status

DeepSeek Harness Web plugin for version status, copy-only upgrade guidance, and safe restart when an explicit user-level supervisor is installed.

套件
dsh-update-status
相容性
待驗證
Harness 依賴範圍
>=0.1.7-alpha.2 <0.3.0
Cordis 依賴範圍
^4.0.4
版本
0.5.1
授權
MIT
最近更新
2026年11月14日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-update-status@latest

Usage

  1. Open the DSH sidebar drawer. The official fish remains in place; the name row shows DeepSeek plus the current version badge.
  2. Tap the badge. The update panel opens without triggering the parent New Session action.
  3. Read the running version. When nothing newer is published, the panel says the running release is the newest and there is no card to act on.
  4. Otherwise every newer published version has its own card, newest first. A card shows the version, the dist-tag that carries it when npm reports one, its release line and publish date.
  5. Copy the command from the card you want — each one is pinned to that card's exact version — and run it yourself in a terminal on the computer hosting DSH.
  6. After the package-manager command completes, use the panel's Restart control only if you have completed supervised restart; otherwise restart DSH yourself.

Example command on a card for a global install:

npm install -g @deepseek-ai/dsh@0.2.2-rc.3

Each card shows one command that matches the detected installation kind and names that card's exact release. The plugin does not run it. When the installation kind cannot take a package-manager command — a source checkout, for example — the panel shows that guidance once instead of a copy button on every card, rather than inventing a command.

What the dot means

The dot beside the version carries the whole status, and only the update state animates:

DotStateMeaning
green circleup to dateNothing newer is published. The chip keeps its normal fill.
grey pulsecheckingA status read is in flight (first mount or Check for updates).
amber dot with a haloupdateAt least one newer release exists. Copy a card's command, run it yourself, restart DSH.
chip turns redfailed readThe plugin could not determine the state: the registry read failed or two versions are not SemVer-comparable.

The version chip in a light shell (grey chip, dark text) and a dark shell (dark grey chip, white text), each showing the green up-to-date dot

The chip itself is a neutral second-level surface — grey in both themes, with the theme's own label colour — so the amber halo always reads against it, and it never changes colour to announce an update.

Configuration

OptionDefaultRange / behavior
cacheTtlMinutes36030–1,440 minutes; expires only for the next on-demand read, never a background timer
sidebarEnabledtrueHides only this plugin's sidebar entry; the brand row falls back to DSH's own mark and wordmark

The plugin shows version status and update notices by default after installation. Click the sidebar version chip for the running version, check result, upgrade guidance and cache-duration input. There is no separate Settings → Version & updates menu. Existing sidebarEnabled profile values remain supported; set it to true or remove the override if an older configuration hid the chip. Changing the duration does not issue a request; only a later normal read can refresh an expired cache, while Check for updates always performs an immediate manual refresh.

A cache preference is written only by your own selection in the panel. The plugin has no automatic write path — no effect, timer, or mount-time write — and tests/client/entry.spec.ts mounts the real client entry to keep it that way. On DSH 0.1.7 the two preferences above are the volatile fields of this plugin entry's Config, so they persist as that entry's config in the active profile's patch (~/.dsh/profiles/ /cordis.patch.yml); edit or remove that block to reset a preference, and DSH reloads the profile on the next change. The remaining Config fields are deployment-only and never appear in the form: cacheTtlHours (default 6), timeoutMs (default 15000) and autoCheckOnMount (default true), all set in the same profile patch.