dsh-network-settings
部署运维 活跃维护

dsh-network-settings

kanneiren/dsh-network-settings

自动检测Windows与WSL子系统的网络路径异常,提供安全修复选项,保留配置备份,支持一键回滚,帮助开发环境快速恢复网络连接

2
Stars 标星
0
Forks 分支
2
Watchers 关注
0
Open Issues
TypeScript
主要语言
MIT
开源协议
1.4 MB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:kanneiren/dsh-network-settings
git clone https://github.com/kanneiren/dsh-network-settings.git
git clone git@github.com:kanneiren/dsh-network-settings.git
README.md main

dsh-network-settings

English | 简体中文

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

MIT License Platform


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) The plugin inside the DSH settings UI
DSH network path in WSL DSH inside a WSL distribution: DSH → distro → WSL NAT → Windows Host → proxy TUN → physical NIC → gateway → target DSH network path on Windows Windows-native DSH path, chaining the physical uplink behind a TUN/VPN adapter
Network configuration 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.

Privacy

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

License

MIT