DSH Plugins Marketplace

DSH Plugins

Plugins

/

Security & Audit

/

dsh-vpn-guard

d

dsh-vpn-guard

Manifest valid

Provider-agnostic egress monitor. Reports exit IP, country, ASN and latency, plus a per-service view of how that IP looks to AI services; an optional Clash or Mihomo adapter adds node lists, switching

UI (client)hasBundlePatch

VPN Guard for DSH

A provider-agnostic egress and AI-risk monitor for DeepSeek Harness (DSH).

It answers three questions without locking you into a particular VPN vendor:

  1. Is my traffic actually leaving through the expected exit? — exit IP, country, ASN/ISP, latency.
  2. Would AI services treat this IP as normal? — per-service view for Claude, ChatGPT, Gemini, Gemini API, Codex and Muse.
  3. Is the IP suitable for social platforms? — IP-side suitability only; account/device risk is explicitly out of scope.

Privacy first: the plugin does not read subscription links, credentials, cookies or browser profiles. It stores only compact probe results in ~/.dsh/vpn-guard/.

Design: generic core, optional adapters

CapabilityGeneric coreClash / Mihomo adapter
Exit IP / country / ASN / latency✅ direct, HTTP proxy or TUN✅
Controller reachability—✅ HTTP controller (host:port) or Clash Verge named pipe (auto)
Node list / selector groups—✅ if the controller exposes /proxies
Node switching—✅ allow-list + two-step confirm
Subscription traffic / expiry—✅ when info nodes are exposed
Process / service countersoptional, user-defined namesoptional

This means WireGuard, OpenVPN, Tailscale, sing-box, v2rayN, Clash Verge, Mihomo, SDKDNS and “system proxy only” setups can all use the same page. Vendor-specific features simply stay hidden when the adapter cannot provide them.

Requirements

  • DSH desktop with the webServer service.
  • Node.js 20.11+ (provided by DSH).
  • A working VPN/proxy route or a Clash/Mihomo-compatible controller.
  • Optional: ipjudge and ipcheck binaries. Without them, the page still works using generic egress checks; AI per-service rows fall back to — / 证据不足.

Scoring model (v2, 0.5.0)

  • Light checks only refresh live state; they never clear or overwrite AI scores.
  • Only a complete full run replaces the last-known-good AI snapshot; incomplete runs keep the previous complete result and are labeled as incomplete.
  • Missing evidence is null (shown as — / 证据不足), never converted into a low score.
  • Stable AI KPI uses a rolling median of the last 3 complete runs; history keeps the raw value, score version and coverage/confidence.
  • The last complete full snapshot is persisted in ~/.dsh/vpn-guard/last-full.json, so a restart does not blank the page.

See docs/SCORING.md for the exact rules.

Install

plugin_manager install_bundle target="<absolute path to this directory>"

Restart DSH once after the first install. A VPN 守卫 / VPN Guard entry appears in the sidebar.

Configure

Open 设置 / Settings:

KeyMeaningDefault
providerauto, clash, system, noneauto
proxyModeauto, http, tun, noneauto
controllerClash/Mihomo controller: host:port, auto (auto-detect Clash Verge), or empty = no controllerempty
proxyHost / proxyPortlocal HTTP proxy for egress probes127.0.0.1:7890
selectorGroupgroup shown as “current node”; empty = first group / GLOBALempty
allowedSwitchGroupscomma-separated groups the switch button may touch; empty = switching disabledempty
processNamescomma-separated process names to count, e.g. clash.exe, mihomo.exeempty
serviceNameWindows service name to queryempty
ipjudgePath / ipcheckPathoptional enrichment toolsempty
nodesCsvPath / keyNodesPathoptional node-health / reference-score filesempty

Everything except the egress probe is optional. Missing adapters produce a neutral “not configured” state, never a fake zero or a red alert.

Examples

Clash Verge / Mihomo

Clash Verge Rev usually exposes its controller on a Windows named pipe (\\.\pipe\verge-mihomo-...) and leaves external-controller disabled. The plugin detects the running verge-mihomo.exe, reads its pipe and mixed-port, and uses them automatically. In the settings page click 检测 Clash Verge (Detect Clash Verge) to fill controller: "auto", proxyPort and process names; no Clash Verge setting needs to be changed.

{
  "provider": "clash",
  "proxyMode": "http",
  "controller": "auto",
  "proxyPort": 7900,
  "selectorGroup": "节点选择",
  "allowedSwitchGroups": ["节点选择"]
}

An explicit HTTP controller such as 127.0.0.1:9097 still works for other Clash/Mihomo builds.

The plugin page also includes a Clash subpage. It reads the live controller and shows:

  • core status (version, mode, mixed-port, TUN, LAN, system proxy);
  • every proxy group and its current node;
  • active connections with host, network, chain, rule and byte counters;
  • the full node list with delay and group membership.

Groups in allowedSwitchGroups can be switched from this page; everything else is read-only. The page refreshes every 15 seconds while open. It never edits Clash YAML or subscription files.

GET /__dsh-vpn-guard/clash returns the same aggregation for scripts or diagnostics.

WireGuard / OpenVPN / Tailscale (TUN, no local HTTP port)

{
  "provider": "system",
  "proxyMode": "tun",
  "controller": "",
  "allowedSwitchGroups": []
}

System proxy only

{
  "provider": "system",
  "proxyMode": "http",
  "proxyPort": 7890
}

Safety boundaries

  • No VPN configuration files, system proxy settings or firewall rules are modified.
  • Switching is only PUT /proxies/<group> on a controller, restricted to allowedSwitchGroups, with a two-step token and an explicit confirmation dialog.
  • The plugin never switches automatically; monitoring is read-only.
  • The DSH client page is local-only and sends no data to third parties beyond the public IP-intelligence endpoints used for probing.

Open-source layout

index.js              Host half: HTTP routes + timers
lib/probe.js          Generic egress, Clash controller, platform probes, optional tools
lib/score.js          Four-dimension scoring
lib/nodes.js          Optional node list / CSV / reference merging
lib/store.js          history.jsonl + config.json
client.js             Client half: sidebar + tabbed page
cordis.patch.yml      Bundle patch
docs/DETAIL.md        Longer design notes

Development

node --check index.js
node --check client.js
node --check lib/probe.js
node --check lib/score.js
node --check lib/nodes.js
node --check lib/store.js

License

MIT — see LICENSE.

中文简介

这是一个不绑定任何 VPN 厂商的 DSH 插件:只要能测到出口 IP(直连、系统代理或 TUN 均可),页面就能工作;Clash/Mihomo 控制器、节点列表、流量信息、进程/服务检测都是可选增强。SDKDNS 只是可配置的一种用法,不是核心前提。

Comments

Loading…

Similar plugins

dsh-egress-guard

by tancheng33

Runtime security gate on the tool pipeline: denies calls naming hosts outside an egress allowlist, redacts credentials from results at the canonical value rather than only the rendered content, and ap

Security & AuditDevelopment & InfrastructureManifest valid

★ 1

↓ 95/wk

MIT

TypeScript

Sep 22, 2026

dsh plugin --profile web add dsh-egress-guard

Taints the agent when tool results carry untrusted content, gates the privileged calls that follow, and refuses credentials passed to network-capable tools in every mode.

Security & AuditDevelopment & InfrastructureManifest valid

★ 0

dsh plugin --profile web add dsh-taintguard

by qingshuiliuyun

Multi-node DSH monitor and control hub: per-node status and read-only sessions, zero-config LAN networking via UDP discovery, one-click/embedded access to a real DSH UI, cross-network remote hub via o

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 18, 2026

dsh plugin --profile web add dsh-node-monitor

by rand0wn

Real AST-based scan of installed plugins for malicious-intent patterns (dynamic eval, cross-plugin writes, exfiltration-shaped network calls), with an optional periodic schedule and auto-quarantine on

Development & InfrastructureManifest valid

★ 0

MIT

TypeScript

Aug 21, 2026

dsh plugin --profile web add dsh-malware-audit

by 863683348

Installation safety gate for DSH plugins: antivirus-style scan of install scripts, permissions, secrets and network callbacks on local directories or npm tarballs, returning a BLOCK/WARN/PASS verdict

Security & AuditTools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 0

MIT

JavaScript

Sep 11, 2026

dsh plugin --profile web add dsh-plugin-gate

by ZSeven-W

DeepSeek Harness (DSH) plugin: a read-only ledger for the plugins you already have installed — a capability inventory with file:line evidence, declared-vs-detected reconciliation, cross-profile versio

Security & AuditManifest valid

★ 29

↓ 204/wk

MIT

JavaScript

Nov 18, 2026

dsh plugin --profile web add @zseven-w/dsh-harbor