dsh-wsl-wslconfig: Parse .wslconfig and Suggest a DSH :3081 Relay

Introduction¶

When developing agents in the DeepSeek Harness (DSH) environment, network configuration is often a fundamental but error-prone area. The Windows .wslconfig file determines the WSL2 network mode (Mirrored or NAT). If this configuration does not match DSH’s relay service (:3081), it may cause connection failures or prevent startup. The dsh-wsl-wslconfig plugin is designed to solve this alignment issue. It parses the configuration in read-only mode and provides recommendations to help developers ensure the network environment is correct.

Plugin Introduction¶

This is the wslconfig_hint tool from DeepSeek Harness, part of the dsh-wsl-kit suite. The plugin version is 0.2.0. Its core responsibility is to read the Windows-side .wslconfig file, determine the current mirrored network or memory settings, and verify whether these settings are suitable for DSH’s :3081 relay service.

Core Features¶

The plugin mainly provides the following capabilities:
1. Read-only parsing: Reads the Windows .wslconfig file and extracts configuration items related to mirrored networking and memory.
2. Relay recommendations: Recommends using DSH’s :3081 port for relaying, avoiding direct use of dsh --host 0.0.0.0.
3. Mode matching check: Checks whether the current Mirrored or NAT network mode is consistent with the :3081 relay requirements.

Installation and Dependencies¶

Before installing, make sure the DSH version meets the requirements.

1. Check the DSH version:

   dsh --version

The dsh version must be ≥ 0.1.2.

2. Install the plugin:

   dsh plugin --profile web add github:173787247/dsh-wsl-wslconfig

Usage¶

After installation, the plugin intervenes at runtime. It reads the current .wslconfig configuration and informs the user whether the network mode is suitable for DSH’s :3081 relay. If the configuration does not match, it suggests the appropriate direction for adjustment. This tool requires Web UI one-shot ?token= mode on Windows relay :3081.

Notes¶

1. Read-only access: The plugin only reads the configuration and does not write files, so it is safe.
2. Environment dependencies: It must run in a Windows environment, and dsh version must be ≥ 0.1.2.
3. Cloud Flash configuration: If the Cloud Flash model is required, use the deepseek-flash (V4.1 Flash) model ID in ~/.dsh/settings.yaml or llm-deepseek. This plugin is not responsible for that configuration.
4. Suite membership: It is part of the dsh-wsl-kit suite.

Summary¶

dsh-wsl-wslconfig focuses on network configuration alignment in WSL environments. By parsing .wslconfig in read-only mode and recommending the standard relay port, it helps developers avoid common network connection issues. See dsh-wsl-kit for more details and troubleshooting paths.