@skyjjgw/dsh-version-guard avatar

@skyjjgw/dsh-version-guard

DSH 版本守卫:记录插件版本与配置快照,插件冲突导致 DSH 崩坏后可脱离 DSH 进程回退到上一个可用版本 · Out-of-process rollback for DeepSeek Harness plugins

PluginStorageStorageFile
Verification
L5 · Run tested
Verified
Risk
LowRisk
Health
Active
Trust
Gold

Install verification: runtime verified (L5) · tested on dsh 0.2.1-rc.2 · last checked Install verification details →

Install verification badge dsh 0.2.1-rc.2

What it doesAI

Records DSH plugin versions and config snapshots so you can roll back out-of-process to the last working version after plugin conflicts break DSH.

  • Snapshots plugin versions and configuration state
  • Out-of-process rollback works even when DSH is broken
  • Recovers from plugin conflicts and bad upgrades
storageAIfileAI

Capability tags are AI-inferred or rule-extracted from the README (see badge) — vocabulary-limited, not install-verified. AI = inferred; README = literal keyword from the readme.

Installation

dsh plugin --profile web add github:skyjjgw/dsh-version-guard
verified

Install method: GitHub · runtime verified (L5)

Verification & Compatibility

Grouped by plugin version: each card lists the dsh versions actually tested against that artifact version and their install verdicts (L5 wins). Untested combinations are omitted — absence means untested, never assumed compatible. L1–L3 are a plugin-level static archive (independent of the dsh version — the same verdict on every dsh row): they sit in each row's level grid next to L4/L5, marked "static", while their evidence is stored once per plugin inside that row's "checks & evidence" instead of being duplicated per version.

External credentials (plugin-level): none detected

Declared DSH compatibilityfrom package.json · peerDependencies
author declared no dsh version requirement

○ The author declares no dsh version requirement — install is not blocked by version.

Install compatibility matrix (rows = plugin versions〔latest 5〕, columns = dsh versions〔latest 5〕)
At-a-glance → evidence in the cards below
plugin \ dshdsh 0.2.1-rc.2
current
dsh 0.2.1-alpha.4dsh 0.2.1-alpha.2
b9f293✓✓✓
Install compatibility (by plugin version, dsh versions within)
Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed
b9f293github✓ 3 runtime-verified2026-10-19

https://github.com/skyjjgw/dsh-version-guard

✓dsh 0.2.1-rc.2current2026-10-19L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-rc.2
  • • Plugin artifact: github · https://github.com/skyjjgw/dsh-version-guard (version unstated)
Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)
L1 static
Passed
L2 static
Passed
L3 static
Passed
L4 sandbox
Passed
L5 runtime
Passed
Install + runtime smoke verified in the dsh sandbox — installs and runs
L5 · runtime verified · valid for dsh 0.2.1-rc.2

ID: dsh-version-guard@b9f293@dsh0.2.1-rc.2 · profile: l4-sandbox

Issued: 2026-10-19 · expires: 2026-10-26

View checks & evidence
L1 · Found✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L2 · Structured✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L3 · Install spec✓ Passed
Install command parsed✓ Passed
Source: registry verification · Method: install spec parse · Captured 2026-10-18
DSH version declared✓ Passed
Source: registry verification · Method: DSH version declaration · Captured 2026-10-18
L4 · Install tested✓ Passed
Install executed in confined sandbox✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 2.8s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 2.8s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 2.8s
L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec github:skyjjgw/dsh-version-guard · install mode reused L4 scratch
check took: 121ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-19
ready line dsh web: http://127.0.0.1:53386/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-19
path / · HTTP 200 · took 121ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-19
verdict active · entries 150
match: include:version-guard · dsh-version-guard · phase active
phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

✓dsh 0.2.1-alpha.42026-10-16L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.4
  • • Plugin artifact: github · https://github.com/skyjjgw/dsh-version-guard (version unstated)
Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)
L1 static
Passed
L2 static
Passed
L3 static
Passed
L4 sandbox
Passed
L5 runtime
Passed
Install + runtime smoke verified in the dsh sandbox — installs and runs
L5 · runtime verified · valid for dsh 0.2.1-alpha.4

ID: dsh-version-guard@b9f293@dsh0.2.1-alpha.4 · profile: l4-sandbox

Issued: 2026-10-16 · expires: 2026-10-23

View checks & evidence
L1 · Found✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L2 · Structured✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L3 · Install spec✓ Passed
Install command parsed✓ Passed
Source: registry verification · Method: install spec parse · Captured 2026-10-18
DSH version declared✓ Passed
Source: registry verification · Method: DSH version declaration · Captured 2026-10-18
L4 · Install tested✓ Passed
Install executed in confined sandbox✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-16
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 2.2s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-16
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 2.2s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-16
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 2.2s
L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-16
spec github:skyjjgw/dsh-version-guard · install mode reused L4 scratch
check took: 379ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-16
ready line dsh web: http://127.0.0.1:52796/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-16
path / · HTTP 200 · took 379ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-16
verdict active · entries 150
match: include:version-guard · dsh-version-guard · phase active
phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

✓dsh 0.2.1-alpha.22026-10-13L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.2
  • • Plugin artifact: github · https://github.com/skyjjgw/dsh-version-guard (version unstated)
Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)
L1 static
Passed
L2 static
Passed
L3 static
Passed
L4 sandbox
Passed
L5 runtime
Passed
Install + runtime smoke verified in the dsh sandbox — installs and runs
L5 · runtime verified · valid for dsh 0.2.1-alpha.2

ID: dsh-version-guard@b9f293@dsh0.2.1-alpha.2 · profile: l4-sandbox

Issued: 2026-10-13 · expires: 2026-10-20

View checks & evidence
L1 · Found✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L2 · Structured✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L3 · Install spec✓ Passed
Install command parsed✓ Passed
Source: registry verification · Method: install spec parse · Captured 2026-10-18
DSH version declared✓ Passed
Source: registry verification · Method: DSH version declaration · Captured 2026-10-18
L4 · Install tested✓ Passed
Install executed in confined sandbox✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-13
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 4.1s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-13
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 4.1s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-13
spec github:skyjjgw/dsh-version-guard · channel GitHub source · outcome ran · exit 0
check took: 4.1s
L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-13
spec github:skyjjgw/dsh-version-guard · install mode reused L4 scratch
check took: 261ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-13
ready line dsh web: http://127.0.0.1:59211/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-13
path / · HTTP 200 · took 261ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-13
verdict active · entries 150
match: include:version-guard · dsh-version-guard · phase active
phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

Author badges

Embed the official badges in your README to showcase security & install-test status:

dsh.so risk
`[![dsh.so risk](https://www.dsh.so/badge/dsh-version-guard.svg)](https://www.dsh.so/artifact/dsh-version-guard/)`
dsh 0.2.1-rc.2 install verified
`[![dsh.so install · dsh 0.2.1-rc.2](https://www.dsh.so/badge/install/dsh-version-guard@0.2.1-rc.2.svg)](https://www.dsh.so/artifact/dsh-version-guard/)`

Security Report

Two automated layers, neither a manual review: a static scan (per-plugin rule checks) and a model-driven dynamic security audit that covers only the subset static-flagged at warn or above and never executes plugin code.

dsh-version-guardAutomated review · daily

Static low, dynamic low — stricter wins → overall low.

static low→dynamic low→overall low
0 critical·0 high
lowoverall · low
1static scan · vet primaryvet AST static analysis (npm artifact or git source)
plugin versionv0.1.1dsh manifest
scanned versionv0.1.1git2026-10-21
current versionv0.1.1same version
vet verdictclean · git

Vet is an AST static scan (npm artifact or git source).

show static findings (5)
  • criticalnewFunction · code-execlib/core/yamlio.js:149

    fn = new Function(...Object.keys(scope), `"use strict"; return (${expr});`)

  • warningchildProcess · code-execlib/core/pnpm.js:68

    const child = spawn(pnpm.command, args, {

  • warningnewFunction · code-execlib/tools/verify-package.js:91

    new Function(clientSource)

  • warningnetIp · networklib/tools/verify-package.js:144

    const origin = `http://127.0.0.1:${server.address().port}`

  • warningnetIp · networklib/tools/verify-package.js:176

    const prefixOrigin = `http://127.0.0.1:${prefixServer.address().port}`

2model reads redacted source context · never executes plugin code
highest gradelow
merged intooverall low
audited at2026-10-19
findings0 critical·0 high0 medium / 1 low hidden
show 1 audit findings
  • lownew Function() evaluates the bundled client script, but only inside a developer self-checklib/tools/verify-package.js:91

    The only eval construct in the plugin runs when a developer executes `node lib/tools/verify-package.js`; its input is the repository's own lib/client/client.js, never remote or user-supplied data, and cordis.patch.yml never loads this file, so it is unreachable at runtime. This is what the heuristic scan flagged as critical, and it does not hold in context.

Static scan's critical is a false positive: the only eval is a dev-only syntax check on the plugin's own bundle; no reachable critical/high risk found.

Rule: the dynamic audit can only raise risk, never lower it (raise-only, never an exemption); a wrong raise is withdrawn by human review and the tier falls back to the static verdict. Overall verdict = the stricter of the two layers.

Disclaimer: the static scan and the dynamic security audit are both automated analysis, not a security guarantee. Always review what you install.

Activity

Last commit 2026-10-20 · activity: Active

• Repo created: 2026-10-13

• Stars: ★ 1 · Forks: 0

• Health: Active — committed within last 30 days

Source

GitHub: github.com/skyjjgw/dsh-version-guard

Was this page helpful?