dsh-network-settings

English | 简体中文

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

---

Highlights

• Three runtime models — automatically detects WINDOWS_NATIVE, WSL_DISTRIBUTION, or MACOS_NATIVE.
• 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; macOS (CI-verified, real-machine validation pending)
• All network checks are local and read-only unless you explicitly confirm a change.

Privacy

No telemetry. Reports and snapshots are redacted locally before persistence.

License

MIT