Install verification: runtime verified (L5) · tested on dsh 0.2.2-rc.1 · last checked Install verification details →
Data as of (UTC)
What it doesAI
Integrates Headroom context-compression proxy into DeepSeek Harness with auto-setup and route switching.
- Detect, install, and start Headroom
- Auto-configure DeepSeek compressed route
- One-click route-switch UI
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:wjxn13/dsh-headroomInstall method: GitHub · runtime verified (L5) · verified on dsh 0.2.2-rc.1
Trends
Four lines, four questions: total stars, stars gained this week, cumulative downloads, downloads this week. The GitHub pair comes from real-read sampling — a rotating daily shard, so one plugin is re-read roughly every 5–14 days, sparser than npm; the npm pair has a value on every snapshot day. The two cumulative panels are smoothed curves with no sample markers; the two weekly panels keep their raw bars and add a 4-week moving-average trend line that strips single-week noise down to the direction of travel.
10 samples (roughly every 7 days), 5 of them reconstructed (dashed runs); a smoothed curve through every sample — not a daily series
09-17 → 11-13 · 10 points
Bars = the delta between two samples 5–14 days apart (negative points down, faint bars contain reconstructed points); line = 4-week moving-average trend
09-24 → 11-13 · 9 points
Reconstructed backwards from the current total using daily downloads (gaps are not interpolated)
Only 0 points (< 3): no chart yet
no data yet
Bars = the snapshot’s last-week rolling window (official npm + npmmirror combined); line = 4-week moving-average trend — the shape of weekly demand, not a user count
Only 0 points (< 3): no chart yet
no data yet
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
○ The author declares no dsh version requirement — install is not blocked by version.
| plugin \ dsh | dsh 0.2.2-rc.1 | dsh 0.2.1-rc.5 | dsh 0.2.1-rc.3 | dsh 0.2.1-rc.2 | dsh 0.2.1-alpha.4 |
|---|---|---|---|---|---|
| f3778c | · | · | · | · | · |
| cf730b | · | · | · | · | · |
| 9cb0a7 | ✓ | ✓ | ✓ | ✓ | ✓ |
f3778cgithub2026-09-04
github:wjxn13/dsh-headroom
○dsh 0.1.2-rc.12026-09-04not tested
- • Node.js: v24.14.0
- • DSH: 0.1.2-rc.1
- • Plugin artifact: github · github:wjxn13/dsh-headroom#f3778c
ID: dsh-headroom@f3778c@dsh0.1.2-rc.1 · profile: l5-web-smoke
Issued: 2026-09-04 · expires: 2026-12-03
View checks & evidence
ecosystem plugin: no dsh.bundle declaration
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
cf730bgithub2026-08-28
https://github.com/wjxn13/dsh-headroom
No runtime install test for this version (static scan only) — compatibility unknown, never assumed.
9cb0a7github✓ 7 runtime-verified2026-11-14
https://github.com/wjxn13/dsh-headroom
✓dsh 0.2.2-rc.12026-11-06L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.2-rc.1
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.2-rc.1 · profile: l4-sandbox
Issued: 2026-11-06 · expires: 2026-11-13
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
✓dsh 0.2.1-rc.52026-10-31L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.1-rc.5
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.1-rc.5 · profile: l4-sandbox
Issued: 2026-10-31 · expires: 2026-11-07
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
✓dsh 0.2.1-rc.32026-10-27L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.1-rc.3
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.1-rc.3 · profile: l4-sandbox
Issued: 2026-10-27 · expires: 2026-11-03
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
✓dsh 0.2.1-rc.22026-10-19L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.1-rc.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.1-rc.2 · profile: l4-sandbox
Issued: 2026-10-19 · expires: 2026-10-26
View checks & evidence
active in loader tree (150 entries)
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
- • Node.js: v24.14.0
- • DSH: 0.2.1-alpha.4
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.1-alpha.4 · profile: l4-sandbox
Issued: 2026-10-16 · expires: 2026-10-23
View checks & evidence
active in loader tree (150 entries)
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-10L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.1-alpha.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.1-alpha.2 · profile: l4-sandbox
Issued: 2026-10-10 · expires: 2026-10-17
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
✓dsh 0.2.0-rc.22026-10-08L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.0-rc.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.2.0-rc.2 · profile: l4-sandbox
Issued: 2026-10-08 · expires: 2026-10-15
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.7-rc.22026-09-27not tested
- • Node.js: v24.14.0
- • DSH: 0.1.7-rc.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.7-rc.2 · profile: l4-sandbox
Issued: 2026-09-27 · expires: 2026-10-04
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.7-rc.12026-09-24not tested
- • Node.js: v24.14.0
- • DSH: 0.1.7-rc.1
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.7-rc.1 · profile: l4-sandbox
Issued: 2026-09-24 · expires: 2026-10-01
View checks & evidence
This level was not executed in this scan.
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.6-alpha.22026-09-20not tested
- • Node.js: v24.14.0
- • DSH: 0.1.6-alpha.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.6-alpha.2 · profile: l4-sandbox
Issued: 2026-09-20 · expires: 2026-09-27
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.6-alpha.12026-09-17not tested
- • Node.js: v24.14.0
- • DSH: 0.1.6-alpha.1
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.6-alpha.1 · profile: l4-sandbox
Issued: 2026-09-17 · expires: 2026-09-24
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.5-rc.22026-09-13not tested
- • Node.js: v24.14.0
- • DSH: 0.1.5-rc.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.5-rc.2 · profile: l4-sandbox
Issued: 2026-09-13 · expires: 2026-09-20
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.3-alpha.22026-09-09not tested
- • Node.js: v24.14.0
- • DSH: 0.1.3-alpha.2
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.3-alpha.2 · profile: l4-sandbox
Issued: 2026-09-09 · expires: 2026-09-16
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.3-alpha.12026-09-07not tested
- • Node.js: v24.14.0
- • DSH: 0.1.3-alpha.1
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dsh0.1.3-alpha.1 · profile: l4-sandbox
Issued: 2026-09-07 · expires: 2026-09-14
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○dsh 0.1.2-alpha.12026-09-02not tested
- • Node.js: v24.14.0
- • DSH: 0.1.2-alpha.1
- • Plugin artifact: artifact unstated (historical)
ID: dsh-headroom@9cb0a7@dsh0.1.2-alpha.1 · profile: l5-web-smoke
Issued: 2026-09-02 · expires: 2026-12-01
View checks & evidence
ecosystem plugin: no dsh.bundle declaration
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
○prehistory2026-10-04not tested
- • Node.js: v24.14.0
- • DSH: unknown
- • Plugin artifact: github · https://github.com/wjxn13/dsh-headroom (version unstated)
ID: dsh-headroom@9cb0a7@dshunknown · profile: l4-sandbox
Issued: 2026-10-04 · expires: 2026-10-11
View checks & evidence
not present in web-profile loader inventory
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
Author badges
Embed the dsh.so badges in your README to show this plugin's automated security-scan and install-test status:
`[](https://www.dsh.so/artifact/dsh-headroom/?ref=badge)``[](https://www.dsh.so/artifact/dsh-headroom/?ref=badge-install)``[](https://www.dsh.so/artifact/dsh-headroom/?ref=badge-install)``[](https://www.dsh.so/artifact/dsh-headroom/?ref=badge-install)``[](https://www.dsh.so/artifact/dsh-headroom/?ref=badge-install)``[](https://www.dsh.so/artifact/dsh-headroom/?ref=badge-install)`dsh.so is an independent community project, not affiliated with or endorsed by DeepSeek AI. Badges are maintained by dsh.so; embed links carry a ?ref= attribution parameter.
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.
Static low; dynamic medium (authoritative when present) → overall medium.
v0.1.0dsh manifest0.1.0git2026-11-140.1.0same versionclean · gitVet is an AST static scan (npm artifact or git source).
show static findings (12)
- warningchildProcess · code-exec
lib/index.js:129const child = spawn(command[0], command.slice(1), { - warningchildProcess · code-exec
lib/index.js:195const child = spawn(venvHeadroom(), args, { - warningshellExec · shell
lib/index.js:100execFile(candidate.split(" ")[0], [...candidate.split(" ").slice(1), "--version"], { timeout: 8e3 }, (error, stdout, stderr) => { - warningshellExec · shell
lib/index.js:226execFile("powershell", [ - warningshellExec · shell
lib/index.js:241execFile("taskkill", ["/PID", String(owner), "/T", "/F"], { timeout: 8e3 }, () => resolve()); - warningnetIp · network
lib/index.js:12var HEADROOM_BASE_URL = `http://127.0.0.1:${HEADROOM_PORT}/v1`; - warningnetIp · network
lib/index.js:15var HEADROOM_LIVEZ_URL = `http://127.0.0.1:${HEADROOM_PORT}/livez`; - warningnetIp · network
lib/index.js:43const stats = running ? await fetchJson(`http://127.0.0.1:${HEADROOM_PORT}/stats`) ?? null : null; - warningnetIp · network
lib/types/constants.d.ts:13export declare const HEADROOM_BASE_URL = "http://127.0.0.1:8787/v1"; - warningnetIp · network
lib/types/constants.d.ts:19export declare const HEADROOM_LIVEZ_URL = "http://127.0.0.1:8787/livez"; - warningnetIp · network
src/constants.ts:16export const HEADROOM_BASE_URL = `http://127.0.0.1:${HEADROOM_PORT}/v1` - warningnetIp · network
src/constants.ts:25export const HEADROOM_LIVEZ_URL = `http://127.0.0.1:${HEADROOM_PORT}/livez`
show 5 audit findings
- mediumDeepSeek API key transits an unauthenticated fixed loopback port that any local process can squat
lib/index.js:116The plugin writes HEADROOM_BASE_URL (`http://127.0.0.1:8787/v1`, line 12) into llm-deepseek.baseURL, so the host sends LLM requests including the DeepSeek Authorization header to port 8787. There is no shared secret or identity check: probeHealth treats any HTTP 200 response whose JSON parses as a healthy Headroom (lines 117-119), and startProxy then reports 'Headroom already running' (line 176) without spawning the real proxy. A local process that binds 8787 first therefore silently receives the user's API credentials for as long as the route stays switched.
- lowWindows install path runs spawned commands through cmd.exe (shell: true) with homedir-derived arguments
lib/index.js:131run() is used by ensureInstalled with `[systemPython, "-m", "venv", venvDir()]` (line 155) and the pip argv (line 162), where venvDir() derives from homedir(). With shell:true on Windows, Node joins the argv into a single cmd.exe command line, so cmd metacharacters in an unusual home-directory path would be interpreted by the shell rather than passed literally. Precondition is a locally crafted user profile path, so the practical impact is limited to the same user.
- lowstopProxy unconditionally shells out to Windows-only PowerShell/taskkill and can kill an unverified port owner
lib/index.js:225stopProxy is platform-agnostic on the command channel, but its implementation only works on Windows: on Linux/macOS execFile('powershell') fails and the fallback `taskkill` (lines 240/244) also does not exist, yet the function still returns { ok: true, message: 'Headroom proxy stopped.' } (line 248) although the proxy keeps running. On Windows it first resolves whatever process owns port 8787 via Get-NetTCPConnection and kills it with `taskkill /PID <pid> /T /F` (line 240) without verifying that the process is actually Headroom; if the PID cannot be resolved it falls back to killing every proc
- lowUnpinned PyPI package is installed at runtime and then executed with the full process environment
lib/index.js:162The /headroom-install command causes the host to fetch and execute `headroom-ai[proxy]` from PyPI with no version or hash pin (--disable-pip-version-check), and the resulting binary is later spawned detached with `env: { ...process.env }` (line 199), placing it in the path of every LLM request and its Authorization header. A future or compromised upstream release would therefore run and observe credentials on this machine. No malicious behaviour is present in the audited code itself.
- lowRead-only status route is mounted without any origin or authorization check
lib/index.js:62mountHeadroomRoutes registers GET /headroom/status on the host webServer with no origin, token or session check (src/routes.ts documents 'No origin check needed for a pure read'). The handler proxies livez plus the raw /stats body, exposing proxy presence, version and token/cache usage counters. Exposure is bounded: the route is server-side, returns no Access-Control-Allow-Origin header, and leaks only low-sensitivity local metrics that a local client could also read directly on 8787.
No critical/high issues; the plugin manages a local Headroom proxy, but API traffic carrying the DeepSeek key goes through an unauthenticated fixed loopback port.
Rule (2026-10-28): when a dynamic conclusion exists it is authoritative (it may raise or lower the level); the static scan tier (vet primary, dsh backstop) applies only when there is none (not queued / audit failed / withdrawn). The audit never writes the exemption list (exemptions are manual only); a wrong conclusion is withdrawn by human review and the tier falls back to the static scan tier.
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-05 · activity: Stable
• Repo created: 2026-08-14
• Stars: ★ 5 · Forks: 0
• Health: Stable — committed within 90 days
Source
GitHub: github.com/wjxn13/dsh-headroom
Author README
View on GitHub ↗The author's original README from the repository — fetched live, unedited (the English page loads the default README).
Frequently asked questions
What is dsh-headroom?
dsh-headroom is a DeepSeek Harness (dsh) plugin listed on dsh.so — an independent community registry that indexes public source repositories and publishes automated security-scan and install-verification results for each entry.
Is dsh.so or this plugin page official?
dsh.so is an independent community registry and is not affiliated with, endorsed by, or sponsored by DeepSeek AI.
How do I install dsh-headroom?
Run dsh plugin --profile web add github:wjxn13/dsh-headroom in a DeepSeek Harness (dsh) environment. That exact command passed a real install inside an isolated sandbox (L4) plus web smoke testing (L5).
How does the security scan relate to a manual audit?
Both layers are automated, not a manual audit. The static scan is heuristic analysis of the repository source, so it can produce false positives and miss context. The model-driven dynamic security audit only covers plugins static-flagged at warn or above, never executes plugin code, and its conclusion is authoritative when there is one (it may raise or lower the static tier); exemptions stay manual. Neither layer is an endorsement: review the repository and the permissions it asks for before installing, together with the verification level and health signals.
How fresh is the data on this page?
The data on this page is as of 2026-11-14 (UTC) — the most recent valid timestamp among the registry refresh, install verification, security scan and dynamic audit. Build time is never used as a data date.
