Introduction

One of the core philosophies of DeepSeek Harness (DSH) is “everything is a plugin,” and network proxying is a common aspect that can easily impact request availability. Existing approaches often require manually modifying proxy environment variables or relying on system proxy settings; when system proxies, local proxies, and direct connection strategies are inconsistent, configuration and troubleshooting can become scattered.

dsh-network-proxy addresses this issue centrally within the DSH settings interface: allowing users to switch between three network exit modes—system following, manual proxy, and direct connection—and apply them immediately via DSH’s live settings mechanism.

What is this

kriskite/dsh-network-proxy is a DSH network proxy management plugin. It provides a graphical settings interface that allows users to select a proxy mode within DSH and applies the proxy settings to DSH’s network request exits.

This repository is licensed under the MIT License, with the License attribution © 2026 Kirskite.

Core Features

Three Proxy Modes

The plugin provides proxy mode configuration under the network-proxy namespace, with the main field being mode:

  • system: Follow system. Windows reads the Internet Settings registry; other platforms read the HTTP(S)_PROXY environment variable.
  • manual: Manual proxy. Configure an HTTP/HTTPS proxy address, for example http://127.0.0.1:7890.
  • direct: Direct connection. Clears the proxy environment variables read by DSH to force a direct connection; it only clears the environment variables read by DSH and does not modify the system proxy settings.

The default value of mode is system.

Instant Application

Setting changes are applied in real-time via DSH’s live settings mechanism, without requiring a restart.

Unified Request Handling

Based on undici’s ProxyAgent / EnvHttpProxyAgent, the plugin takes over the global Dispatcher, applying uniformly to both fetch and undici requests.

Windows System Proxy Parsing

On Windows, the plugin parses the http=...;https=... multi-protocol syntax of ProxyServer and ProxyOverride (NO_PROXY).

Interface and Settings Items

The plugin includes built-in Chinese/English copy and automatically switches based on the DSH language environment.

The plugin injects the network-proxy plugin point via cordis.patch.yml and registers the “Network Proxy” setting item in the client’s settings.general.item slot.

Installation and Enablement

Dependencies and System Requirements

  • Node.js >=20.18.1 (required by undici@7)
  • DeepSeek Harness runtime must support DSH plugins and settings / client injection
  • @deepseek-ai/dsh-settings 0.1.0-rc.7
  • @deepseek-ai/schemastery 3.18.1
  • undici ^7.18.2

Installation

npm install dsh-network-proxy

When adding this repository as a DSH plugin to your Harness configuration, the specific method depends on the DSH distribution or plugin loader you are using.

Typical Usage

Configure the following fields under the network-proxy namespace:

Field Type Default Description
mode system | manual | direct system Proxy Mode
url string "" Proxy address in manual mode, must be an http:// or https:// URL

When manual is selected, url is validated: it must be a valid http:// or https:// address; otherwise, saving will be rejected with an error message.

If you need to run tests, execute the following in the repository directory:

npm install
npm test

Applicable Scenarios and Notes

This plugin is suitable for users who need to switch network exit strategies within DSH, such as toggling between system proxy, local proxy, and direct connection, or who wish to avoid directly modifying system proxy settings.

Notes before use:

  • The plugin runs with the permissions of the current DSH process; check the source code and license before installing.
  • The direct mode only clears the proxy environment variables read by DSH and does not modify system proxy settings.
  • The manual mode only accepts http:// or https:// addresses.
  • You must meet the Node.js, DSH injection environment, and peer dependency version requirements mentioned above.

References

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

The directory page above is an independent community directory with no official affiliation to DeepSeek / Horizon Quantum Computing.