Name: dsh-network-settings
Author: kanneiren

Instalar

dsh plugin --profile web add github:kanneiren/dsh-network-settings

README

dsh-network-settings

English | 简体中文

Windows / WSL network path diagnostics and safe repair for DeepSeek Harness.

Highlights

Two runtime models only — automatically detects WINDOWS_NATIVE or WSL_DISTRIBUTION; no manual Windows/WSL mode switch.
DSH path graph — shows the actual DSH network path, DNS side branch and first failing edge; a TUN/VPN adapter is chained with the physical uplink NIC and the real gateway behind it.
Configuration Drift — finds stale proxy configuration without treating healthy configuration differences as errors.
Single / stability checks — one-shot diagnostics plus repeated TCP/HTTP sampling; DeepSeek is the default target and switching is always available. Every probe layer and the whole check carry hard timeouts, so a broken network never stalls the page.
Agent-ready report — one click copies a stable-format Markdown report (fixed English headers, report-version, TL;DR first, machine-readable codes and per-layer probe latency).
Recommended repairs — only high-confidence diagnoses mapped to common low-risk operations (clear proxy-residue env vars, disable system proxy, flush DNS cache); admin and high-risk operations stay in the manual catalog.
Safe repair — snapshot → diff → confirm → apply → re-detect, with rollback for persistent changes.
DSH-native UI — uses DSH primitives and --dsw-* tokens only.

Screenshots

The plugin lives in DSH Settings → Plugins → Network (click images to enlarge)

_{DSH inside a WSL distribution: DSH → distro → WSL NAT → Windows Host → proxy TUN → physical NIC → gateway → target}

_{Windows-native DSH path, chaining the physical uplink behind a TUN/VPN adapter}

_{Grouped network configuration}

Network configuration is grouped by source, every entry traceable:

Windows proxy: WinINet / WinHTTP state, proxy environment variables across all three scopes (both letter cases)
DSH process environment: runtime model, egress (direct / via proxy with address), verified listener process behind the proxy port, process proxy variables
WSL: distribution environment, network mode (NAT / mirrored), /etc/wsl.conf and .wslconfig
Advanced: DNS cache, interfaces & routes, Hosts, first-aid actions

Every persistent change follows snapshot → preview → confirm → apply → rollback.

Install

dsh plugin --profile web add dsh-network-settings

Open Settings → Plugins → Network.

Usage

Open the page
  → cached summary only, no probes run
Click [Single check]
  → full inspection + current target probe + DSH path graph
Click [Stability check]
  → repeated TCP/HTTP sampling
Click [Copy network report]
  → Markdown report for an Agent

Docs

Document	Content
Architecture	modules, runtime models, probes, repair guarantees
Diagnostics	how results are produced and displayed
Network first aid	operations, risks, reliability
Agent guide	development commands and extension points
Release checklist	publishing steps
Network path & drift	graph/UI behavior details

Support

DSH: @deepseek-ai/dsh >= 0.1.0-rc.6 (Web profile)
Platform: Windows 10/11 with WSL
All network checks are local and read-only unless you explicitly confirm a change.