Preface

When running agents in DeepSeek Harness (DSH), connectivity issues often stem not from the code itself: Windows system proxies, WSL environment variables, TUN/VPN virtual network adapters, or DNS cache—any layer experiencing anomalies can cause request timeouts or incorrect egress paths. Manually tracing each layer is time-consuming and makes it difficult to clarify the “actual path taken by the DSH process.”

Below introduces the community plugin dsh-network-settings (maintainer kanneiren). It performs network path visualization, layered diagnostics, and controlled remediation within the DSH settings interface, organizing results into an Agent-readable Markdown report. This is ideal for developers needing stable access to targets like DeepSeek.

What It Is

dsh-network-settings is a networking utility plugin for DSH, supporting Windows native, WSL distributions, and macOS. It provides network status display, link diagnosis, and safe remediation. The plugin runs with the current DSH process privileges; all checks are read-only by default, and configuration modifications occur only after explicit user confirmation.

Core Features

The plugin automatically identifies whether DSH is running on Windows native, WSL, or macOS. The interface displays the real network path of the DSH process, DNS side branches, and the first failure point. If the path traverses a TUN/VPN virtual adapter, it automatically appends the physical egress and actual gateway.

A typical WSL path is: DSH → Distribution → WSL NAT → Windows Host → Proxy TUN → Physical NIC → Gateway → Target. For Windows native, the path similarly connects to the physical egress after the virtual adapter.

Diagnostics and Reports

Two detection modes are supported:

  1. Single Detection: Captures current configuration, performs probing on selected targets, and draws the DSH link map.
  2. Stability Detection: Repeated sampling for TCP/HTTP.

The default probe target is DeepSeek, which can be switched at any time. Each layer and the overall detection have timeout limits to prevent indefinite hangs during network issues.

“Copy Network Report” generates Markdown suitable for Agents: fixed English section titles and report-version, a TL;DR summary first, along with machine-readable diagnostic codes and layered probe latencies.

Network Configuration and Drift

“Network Configuration” groups settings by source, with each item traceable, primarily including:

  • Windows Proxy: WinINet/WinHTTP status, and proxy environment variables across three scopes (including case variants).
  • DSH Process Environment: Runtime model, egress method (direct or via proxy with address), actual proxy port listening process, process-level proxy variables.
  • WSL: Distribution environment variables, network mode (NAT/mirrored), /etc/wsl.conf and .wslconfig.
  • Advanced Network: DNS cache, interface routing, Hosts, system emergency operations.

If configuration differs but the network remains functional, the plugin only notes “configuration drift” without issuing a warning.

“Recommended Remediation” appears only when high-confidence diagnoses map to common low-risk actions, such as clearing residual proxy environment variables, disabling system proxies, or refreshing DNS cache. Items requiring administrator privileges or higher risks remain in the manual directory and are not automatically recommended.

Persistent changes follow a fixed procedure: Snapshot → Preview → Confirm → Apply → Re-detect → Rollback available. Reports and snapshots are automatically sanitized before local writing; the plugin includes no telemetry.

The interface uses DSH native components and --dsw-* tokens, without establishing an independent theme.

Installation and Enabling

Prerequisites (from README):

  • DSH: @deepseek-ai/dsh >= 0.1.0-rc.6 (tested 0.1.0-rc.7 – 0.1.1-rc.2, Web profile)
  • Node.js: >= 22.19.0 (from engines in package.json)
  • Platforms: Windows 10/11 + WSL; macOS (CI-verified, on-device validation pending)

Install from npm (recommended, includes prebuilt artifacts):

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

Re-run the same command to update to the latest version. If a recently released version is delayed by pnpm’s minimumReleaseAge policy, specify the version number or retry later:

dsh plugin --profile web add dsh-network-settings@<version>

After installation, access via DSH Settings → Plugins → Network.

For direct installation from GitHub, the official alternative command is:

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

This method requires running the prepare build script on-site. If you encounter ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED, add the full allowBuilds key to %UserProfile%\.dsh\profiles\<profile>\pnpm-workspace.yaml as prompted by the error, then retry. The npm repository installation does not require this step.

Before installation, review the source repository and MIT license to ensure compliance with your security and compliance requirements.

Typical Usage

Opening the plugin page by default shows only the cached summary without initiating detection. Common operations include:

Open page             → Shows cached summary, no detection
[Single Detection]    → Capture + Current target probe + DSH link map
[Stability Detection] → TCP/HTTP repeated sampling
[Copy Network Report] → Generates Agent-usable Markdown report

For complex issues, the copied network report can be provided to an Agent or cross-referenced with repository documentation for further troubleshooting:

Documentation Content
Architecture Modules, runtime models, probes, remediation guarantees
Diagnostics How diagnostic results are generated and displayed
Network First Aid Operations, risks, reliability
Agent Guide Development commands and extension points

Use Cases and Considerations

Who it’s for:

  • Developers using DSH Web profile on Windows or WSL who need to confirm the actual outbound path of the Agent.
  • Scenarios suspecting system proxies, WSL network modes, or DNS cache causing DeepSeek access issues, requiring layered diagnostics and rollback-capable remediation.
  • Situations needing to structure network state into Markdown for collaborative troubleshooting with an Agent.

Usage notes:

  • The plugin runs with the current DSH process privileges; remediation actions modify local network configurations—review previews and risk warnings before execution.
  • macOS support has been CI-verified, but on-device validation is incomplete; verify before use in production environments.
  • The DSH ecosystem follows an “everything is a plugin” philosophy; SkillHub is an independent community directory, not officially affiliated with DeepSeek / High-Flyer.

Conclusion

dsh-network-settings consolidates common proxy, WSL, and virtual adapter issues in DSH scenarios into a single settings page: first view the link, then perform layered diagnostics, apply low-risk remediation via snapshot procedures when necessary, and export results for the Agent. If you’re struggling with unstable DSH connectivity, you can install and try it from the directory or GitHub.

  • Directory: https://www.skillhub.cn/plugins/kanneiren/dsh-network-settings
  • GitHub: https://github.com/kanneiren/dsh-network-settings