dsh-wsl-fetch

Kit: dsh-wsl-kit. Use KIT_SET=daily or llm (both install this plugin).

Version / Works-with one-liner: see Compatibility below (kept in sync with dsh-wsl-kit).

DeepSeek Harness plugin: make official web_fetch use the Windows HTTP proxy from WSL.

中文说明 → README.zh.md

Where it sits

Sends the official web_fetch through the Windows HTTP proxy. dsh-wsl-net only diagnoses; this plugin does the fetch.

flowchart LR
  agent["web_fetch"] --> fetch["dsh-wsl-fetch"] --> proxy["Windows HTTP proxy"] --> web["HTTPS"]

Suite diagram and version snapshot: dsh-wsl-kit. This plugin is 0.1.2 (daily; also in llm). Do not copy that matrix into this README.

Compatibility

Suite floor versions: kit check-plugin-versions.sh. Fault tree: TROUBLESHOOTING.md.

Scope: in-process official web_fetch via undici ProxyAgent. Requires HTTP(S)_PROXY. Cloudflare 403/1010 through Clash needs a DIRECT rule — outside this plugin.

Why

Official dsh-web-fetch-http resolves DNS in WSL, then connects directly to that public IP with a custom undici Agent. That bypasses NODE_USE_ENV_PROXY. DeepSeek API can work (global fetch + proxy) while Mattermost/docs web_fetch fails with TypeError: fetch failed.

dsh-wsl-net only injects proxy env into child bash/npm. It cannot fix in-process web_fetch.

This plugin registers fetch provider wsl-proxy and, when HTTPS_PROXY / HTTP_PROXY is set, selects it so web_fetch uses undici ProxyAgent.

Private/localhost URLs stay blocked.

Install

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

Or via kit: KIT_SET=daily bash install.sh (includes this plugin).

Local checkout:

dsh plugin --profile web add /path/to/dsh-wsl-fetch

Restart with kit restart-dsh-web.sh (NODE_USE_ENV_PROXY=1 + proxy env). Open a new session.

Awesome listing: awesome-dsh-plugin entry (#4736 merged).

Config

- id: dsh-wsl-fetch
  name: dsh-wsl-fetch
  config:
    timeoutMs: 30000
    maxRedirects: 5
    retries: 2
    retryDelayMs: 400

If HTTP(S)_PROXY is missing, the plugin stays registered but unavailable; official http remains selected.

What success / failure look like

• Log: [dsh-wsl-fetch] web_fetch via proxy (...:port) provider=wsl-proxy → provider is active.
• Red fetch UI with that log line → per-URL proxy/TLS/site failure (retry another source). Not “plugin missing”.
• Cloudflare 403 / 1010 through Clash → site WAF; add Clash DIRECT for that host. This plugin cannot override WAF.

Test

npm test
# live proxy path (same as dsh web_fetch)
bash scripts/stress.sh

Changelog

See CHANGELOG.md.

License

MIT