@ffyfox/dsh-linux-integration avatar

@ffyfox/dsh-linux-integration

DeepSeek Harness 的 Linux 原生桌面集成:XDG 桌面入口、无边框独立窗口、关窗自动停服务。Linux native desktop integration for DeepSeek Harness: XDG desktop entry, borderless standalone window, and automatic service shutdown on window close.

PluginDesktop
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

Linux native desktop integration for DeepSeek Harness: XDG desktop entry, borderless standalone window, and auto service shutdown on close.

  • Adds an XDG desktop entry so the app launches like a native Linux program
  • Runs DeepSeek Harness in a borderless standalone window
  • Automatically stops the background service when the window is closed
desktopAI

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 dsh-linux-integration
verified 0.7.0

Install method: npm · 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
0.7.0✓✓✓
v0.7.0···
Install compatibility (by plugin version, dsh versions within)
Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed
0.7.0npm✓ 3 runtime-verified2026-10-20

dsh-linux-integration

✓dsh 0.2.1-rc.2current2026-10-20L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-rc.2
  • • Plugin artifact: npm · dsh-linux-integration@0.7.0
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-linux-integration@0.7.0@dsh0.2.1-rc.2 · profile: l4-sandbox

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

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-20
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 3.3s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 3.3s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 3.3s
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-20
spec dsh-linux-integration · install mode reused L4 scratch
check took: 19ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-20
ready line dsh web: http://127.0.0.1:55279/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-20
path / · HTTP 200 · took 19ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-20
verdict active · entries 150
match: include:dsh-lxi · dsh-linux-integration · 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-18L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.4
  • • Plugin artifact: npm · dsh-linux-integration@0.7.0
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-linux-integration@0.7.0@dsh0.2.1-alpha.4 · profile: l4-sandbox

Issued: 2026-10-18 · expires: 2026-10-25

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-18
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 3.3s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 3.3s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 3.3s
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-18
spec dsh-linux-integration · install mode reused L4 scratch
check took: 218ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-18
ready line dsh web: http://127.0.0.1:52803/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-18
path / · HTTP 200 · took 218ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-18
verdict active · entries 150
match: include:dsh-lxi · dsh-linux-integration · 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-15L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.2
  • • Plugin artifact: npm · dsh-linux-integration@0.7.0
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-linux-integration@0.7.0@dsh0.2.1-alpha.2 · profile: l3-fullscan

Issued: 2026-10-15 · expires: 2026-10-22

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 dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 4.4s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 4.4s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-linux-integration · channel npm package · outcome ran · exit 0
check took: 4.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 dsh-linux-integration · install mode reused L4 scratch
check took: 812ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-14
ready line dsh web: http://127.0.0.1:52635/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-14
path / · HTTP 200 · took 812ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-14
verdict active · entries 150
match: include:dsh-lxi · dsh-linux-integration · 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.

v0.7.0github2026-10-14

https://github.com/ffyfox/dsh-linux-integration

No runtime install test for this version (static scan only) — compatibility unknown, never assumed.

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-linux-integration.svg)](https://www.dsh.so/artifact/dsh-linux-integration/)`
dsh 0.2.1-rc.2 install verified
`[![dsh.so install · dsh 0.2.1-rc.2](https://www.dsh.so/badge/install/dsh-linux-integration@0.2.1-rc.2.svg)](https://www.dsh.so/artifact/dsh-linux-integration/)`

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-linux-integrationAutomated 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.7.0dsh manifest
scanned version0.7.0npm2026-10-21
current version0.7.0same version
vet verdictclean · npm

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

show static findings (12)
  • criticalshellExec · shellsrc/gnome.js:216

    const out = exec('gdctl', ['show'], { encoding: 'utf8', timeout: 5000, env })

  • criticalshellExec · shellsrc/gnome.js:234

    const out = exec('gsettings', ['get', MUTTER_SCHEMA, AUTO_MAXIMIZE_KEY], {

  • criticalshellExec · shellsrc/hyprland.js:96

    const out = exec('Hyprland', ['--version-json'], { encoding: 'utf8', timeout: 5000, env })

  • criticalshellExec · shellsrc/hyprland.js:264

    const out = exec('Hyprland', ['--verify-config', '-c', file], { encoding: 'utf8', timeout: 15000, env })

  • criticalshellExec · shellsrc/hyprland.js:300

    exec('hyprctl', ['reload'], { stdio: 'ignore', timeout: 5000, env })

  • warningchildProcess · code-execsrc/cli.js:448

    const child = spawn(paths.launcherFile, [], { detached: true, stdio: 'ignore' })

  • warningfsWrite · filessrc/config.js:261

    fs.writeFileSync(tmp, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 })

  • warningfsWrite · filessrc/hyprland.js:204

    fs.writeFileSync(file, updated, { mode: 0o600 })

  • warningfsWrite · filessrc/hyprland.js:233

    fs.writeFileSync(file, updated, { mode: 0o600 })

  • warningfsWrite · filessrc/hyprland.js:263

    fs.writeFileSync(file, `${block}\n`)

  • warningshellExec · shellsrc/kwin.js:250

    execFileSync(cmd, args, { stdio: 'ignore', timeout: 5000 })

  • warningfsWrite · filessrc/kwin.js:181

    fs.writeFileSync(file, updated, { mode: 0o600 })

2model reads redacted source context · never executes plugin code
highest gradelow
merged intooverall low
audited at2026-10-16
findings0 critical·0 high0 medium / 2 low hidden
show 2 audit findings
  • lowRuntime dir falls back to a predictable /tmp path when XDG_RUNTIME_DIR is unsetsrc/paths.js:128

    When XDG_RUNTIME_DIR is absent (non-systemd or unusual login), the token-bearing runtime.env / runtime.json and the log file live under a name an local attacker can predict and pre-create. mkdirSync(recursive:true, mode:0o700) does not fix the mode of a pre-existing directory, so the attacker would own the parent directory and could delete/replace the files (e.g. point the launcher at a different URL) or plant a symlink where runtime.env.tmp-<pid> is about to be written. Normal systemd sessions (XDG_RUNTIME_DIR=/run/user/<uid>) are unaffected.

  • lowZombie-process check in isProcessAlive is unreachable dead codesrc/runtime.js:144

    Both branches of the try/catch return, so the /proc/<pid>/stat state==='Z' check is never executed, contradicting the documented intent. A zombie dsh process is therefore reported as alive: `dsh-lxi stop` waits 10 s + 3 s and then reports '进程在 SIGKILL 之后仍然存在', and inspectRuntime can treat a stale runtime record as fresh. Robustness/UX issue only — no privilege or data-exposure impact.

Refuted the heuristic warn: every subprocess, file and socket use is fixed-command and confined to user-owned paths; only two low-severity robustness issues.

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

• Repo created: 2026-09-20

• Stars: ★ 1 · Forks: 0

• Health: Active — committed within last 30 days

Source

GitHub: github.com/ffyfox/dsh-linux-integration

Was this page helpful?