@AhYi8/dsh-agent-recycle-guard avatar

@AhYi8/dsh-agent-recycle-guard

DSH 删除防护插件:拦截 Agent 的 rm/del/Remove-Item 等删除命令,强制转入 Windows 回收站,fail-closed 无永久删除退路,安装即用零配置。

PluginSecurityDesktopFileTerminal / Shell
Verification
L5 · Run tested
Verified
Risk
Medium
Health
Active
Trust
Silver

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

Intercepts Agent delete commands like rm/del/Remove-Item and forces them into the Windows Recycle Bin with fail-closed protection.

  • Intercepts rm, del, Remove-Item and similar delete commands
  • Forces deletions into the Windows Recycle Bin instead of permanent removal
  • Fail-closed design, install-and-use with zero configuration
securityAIfileAIterminalAI

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:AhYi8/dsh-agent-recycle-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
1205fe✓✓✓
Install compatibility (by plugin version, dsh versions within)
Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed
1205fegithub✓ 3 runtime-verified2026-10-19

https://github.com/AhYi8/dsh-agent-recycle-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/AhYi8/dsh-agent-recycle-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-agent-recycle-guard@1205fe@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:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 1.8s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 1.8s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 1.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:AhYi8/dsh-agent-recycle-guard · install mode reused L4 scratch
check took: 112ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-19
ready line dsh web: http://127.0.0.1:61648/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-19
path / · HTTP 200 · took 112ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-19
verdict active · entries 150
match: include:agent-recycle-guard · dsh-agent-recycle-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-17L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.4
  • • Plugin artifact: github · https://github.com/AhYi8/dsh-agent-recycle-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-agent-recycle-guard@1205fe@dsh0.2.1-alpha.4 · profile: l4-sandbox

Issued: 2026-10-17 · expires: 2026-10-24

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-17
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 2.1s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-17
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 2.1s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-17
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 2.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-17
spec github:AhYi8/dsh-agent-recycle-guard · install mode reused L4 scratch
check took: 178ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-17
ready line dsh web: http://127.0.0.1:60365/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-17
path / · HTTP 200 · took 178ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-17
verdict active · entries 150
match: include:agent-recycle-guard · dsh-agent-recycle-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-14L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.2
  • • Plugin artifact: github · https://github.com/AhYi8/dsh-agent-recycle-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-agent-recycle-guard@1205fe@dsh0.2.1-alpha.2 · profile: l4-sandbox

Issued: 2026-10-14 · expires: 2026-10-21

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-14
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 2.4s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 2.4s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec github:AhYi8/dsh-agent-recycle-guard · channel GitHub source · outcome ran · exit 0
check took: 2.4s
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-14
spec github:AhYi8/dsh-agent-recycle-guard · install mode reused L4 scratch
check took: 122ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-14
ready line dsh web: http://127.0.0.1:60282/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-14
path / · HTTP 200 · took 122ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-14
verdict active · entries 150
match: include:agent-recycle-guard · dsh-agent-recycle-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-agent-recycle-guard.svg)](https://www.dsh.so/artifact/dsh-agent-recycle-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-agent-recycle-guard@0.2.1-rc.2.svg)](https://www.dsh.so/artifact/dsh-agent-recycle-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-agent-recycle-guardAutomated review · daily

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

static medium→dynamic medium→overall medium
0 critical·1 high
mediumoverall · medium
1static scan · vet primaryvet AST static analysis (npm artifact or git source)
plugin versionv1.2.0dsh manifest
scanned version1.2.0git2026-10-21
current version1.2.0same version
vet verdictsuspicious · npm

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

show static findings (4)
  • criticalshellExec · shelllib/runtime.js:13

    + "exec('from win32com.shell import shell' if sys.platform == 'win32' else ''); print(json.dumps(sys.executable))";

  • warningbase64Decode · obfuscationguard/script_checks.py:90

    text = "# AgentRecycleGuard UTF-8\n& ([ScriptBlock]::Create([Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('" + payload + "')))

  • warningchildProcess · code-execlib/plugin.js:16

    const child = spawn(python, ['-X', 'utf8', guardPath, 'analyze', '--agent', 'dsh'], {

  • warningchildProcess · code-execlib/runtime.js:67

    const child = spawn(command, args, {windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'], ...options});

2model reads redacted source context · never executes plugin code
highest grademedium
merged intooverall medium
audited at2026-10-17
findings0 critical·0 high1 medium / 1 low hidden
show 2 audit findings
  • mediumAutomatic dependency install from unhashed third-party PyPI mirrors (Tsinghua/Aliyun/Tencent tried first)lib/runtime.js:18

    On first use the plugin silently creates a venv and installs requirements.txt (bashlex, send2trash, pywin32) from third-party mirrors chosen before pypi.org, with no hash pinning or user confirmation. Whoever controls a mirror (or its TLS termination) can run arbitrary code in the user's context as a dependency install step, in the same environment that the delete guard runs in.

  • lowScript inspection only detects direct delete APIs: .py/.js scripts deleting via os.system/subprocess are allowed to runguard/script_checks.py:107

    python_deletes only matches os.remove/os.unlink/os.rmdir/shutil.rmtree (and unlink/rmdir attributes). A referenced script such as `python cleanup.py` where cleanup.py calls subprocess.run(['rm','-rf',...]) or os.system('rm -rf ...') produces no match, inspect() returns None and the original command runs unchanged, so real permanent deletion happens despite the guard. The same holds for the JS_DELETE regex on JavaScript.

Defensive delete-guard plugin that rewrites rm/del into recycle-bin operations; fail-closed design, but it auto-installs Python deps from unhashed third-party PyPI mirrors.

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-12 · activity: Active

• Repo created: 2026-10-11

• Stars: ★ 0 · Forks: 0

• Health: Active — committed within last 30 days

Source

GitHub: github.com/AhYi8/dsh-agent-recycle-guard

Was this page helpful?