173787247/dsh-wsl-fetch

dsh-wsl-fetch

套件： dsh-wsl-kit。KIT_SET=daily 或 llm 都会安装本插件。

版本 / 兼容一行： 见下方 兼容性（与 dsh-wsl-kit 同步）。

让官方 web_fetch 从 WSL 走 Windows HTTP 代理，而不是直连公网 IP。

English → README.md

在套件里的位置

让官方 web_fetch 走 Windows HTTP 代理。dsh-wsl-net 只诊断，本插件才真正去抓。

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

整套关系图和版本快照：dsh-wsl-kit 中文说明。本插件是 0.1.2（daily，也在 llm）。不要把那份总表抄进本 README。

兼容性

| 项 | 值 |
|----|----|
| 插件 | dsh-wsl-fetch 0.1.2 |
| 最低 dsh | ≥ 0.1.2（Windows 中继 :3081 一次性 ?token=） |
| 最新验证 | 以 dsh-wsl-kit 兼容性 为准（当前 0.1.5-rc.1）— 套件唯一真源 |
| 套件档位 | daily（亦含于 github / full；fetch+net 亦在 llm） |
| 云端 Flash | settings / llm-deepseek 使用 deepseek-flash（V4.1 Flash）；本插件不配置模型 id |
| Agent Teams | 上游实验包；本插件不依赖 |

套件版本地板：check-plugin-versions.sh。故障树：TROUBLESHOOTING.zh.md。

范围： 进程内官方 web_fetch 走 undici ProxyAgent。需要 HTTP(S)_PROXY。经 Clash 遇到 Cloudflare 403/1010 需对该域名 DIRECT——不在本插件能力内。

为什么

官方 dsh-web-fetch-http 在 WSL 解析 DNS 后，用自定义 undici Agent 直连该 IP，从而绕过 NODE_USE_ENV_PROXY。DeepSeek API 可以通，Mattermost / 文档站的 web_fetch 却报 TypeError: fetch failed。

dsh-wsl-net 只给 bash/npm 子进程注入代理，管不到进程内的 web_fetch。

本插件注册 wsl-proxy；存在 HTTPS_PROXY / HTTP_PROXY 时选中它，用 ProxyAgent 抓公网 HTTPS。内网和 localhost 仍然拒绝。

安装

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

或经套件：KIT_SET=daily bash install.sh（已含本插件）。

本地目录：

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

用套件 restart-dsh-web.sh 重启（带 NODE_USE_ENV_PROXY=1 和代理环境）。新开会话。

awesome 已收录：条目（#4736 已合）。

配置

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

| 键 | 默认 | 含义 |
|----|------|------|
| timeoutMs | 30000 | 单次抓取超时 |
| maxRedirects | 5 | 同站重定向（允许 www ↔ 裸域） |
| retries | 2 | 代理/网络瞬时失败后的额外重试 |
| retryDelayMs | 400 | 重试基础间隔（× 次数） |
| maxResponseBytes | 5000000 | 响应体字节上限 |
| maxBodyChars | 100000 | 解码后字符上限 |
| userAgent | 产品 UA | 请求 User-Agent |

没有 HTTP(S)_PROXY 时插件保持注册但不可用，继续走官方 http。

成功 / 失败怎么判断

- 日志出现 [dsh-wsl-fetch] web_fetch via proxy (...:端口) provider=wsl-proxy → 后端已启用。
- UI 变红但有上述日志 → 单个 URL 的代理/TLS/站点问题，换源再抓；不是「没装插件」。
- 经 Clash 遇到 Cloudflare 403 / 1010 → 站点 WAF；对该域名加 Clash DIRECT。本插件改不了 WAF。

测试

npm test
走真实代理（与 dsh web_fetch 同路径）
bash scripts/stress.sh

变更记录

见 CHANGELOG.md。

许可

MIT