# dsh-wsl-net
> **套件安装：** 见 [dsh-wsl-kit](https://github.com/173787247/dsh-wsl-kit)。推荐 `KIT_SET=daily` | `llm` | `github` | `full`。故障树：[TROUBLESHOOTING.zh.md](https://github.com/173787247/dsh-wsl-kit/blob/master/docs/TROUBLESHOOTING.zh.md)。


DeepSeek Harness **工具**插件：`net_doctor` 诊断「Windows 浏览器 HTTPS 正常、WSL 里 Agent 却失败」的原因，并返回**可复制粘贴的修复脚本**。

与 [dsh-wsl-env](https://github.com/173787247/dsh-wsl-env) 搭配。属于 **[dsh-wsl-kit](https://github.com/173787247/dsh-wsl-kit)**。

[English → README.md](./README.md)

---

## 为什么需要

Clash / V2Ray 常跑在 Windows 上，环境变量是 `HTTP_PROXY=http://127.0.0.1:…`。Node **24** 的 `fetch` 默认不读代理环境变量，除非设置 `NODE_USE_ENV_PROXY=1`。浏览器看起来正常，Agent 却打不通 DeepSeek 或 npm。

## 功能

- 报告 `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` / `NO_PROXY`（隐藏 userinfo）、`NODE_USE_ENV_PROXY`、可选 npm registry
- **TCP 探测代理端口**（`proxyListen`）：端口没开会直接指出
- 探测 DeepSeek API 与 npm / ModelScope（HTTP 状态码 < 500 视为可达，含 401）
- 针对 DeepSeek Search `TypeError: fetch failed` 给出 `NODE_USE_ENV_PROXY=1` + `restart-dsh-web.sh` 修复脚本
- 可选：给 bash/npm **子进程**注入 `NODE_USE_ENV_PROXY=1` 与小写 `http_proxy` 别名（`injectChildProxy`）

**不会**打印 API Key、不会改 Clash 端口、也不会在未配置时代造一个代理 URL。

## 安装

```sh
dsh plugin --profile web add github:173787247/dsh-wsl-net
```

重启 `dsh web`。新会话的 Tools 应列出 `net_doctor`。示例：「检查 DeepSeek API 和 npm 通不通。」

检查子进程注入：

```sh
node -e "console.log(process.env.NODE_USE_ENV_PROXY, process.env.http_proxy || process.env.HTTP_PROXY)"
```

被包装的 bash/npm 子进程应看到 `1` 和你的代理 URL。

## 工具参数

| 参数 | 取值 | 含义 |
|------|------|------|
| `target` | `all`（默认）、`env`、`deepseek`、`npm` | 检查范围 |

## 配置

```yaml
- id: dsh-wsl-net
  name: dsh-wsl-net
  config:
    timeoutMs: 20000
    probeTimeoutMs: 5000
    injectChildProxy: true
```

| 键 | 默认 | 含义 |
|----|------|------|
| `timeoutMs` | `20000` | 工具超时 |
| `probeTimeoutMs` | `5000` | 单次探测超时 |
| `injectChildProxy` | `true` | 是否包装 `subprocess.spawn` / `spawnTerminal` |

## 更新摘要

- **0.3.0** — `fix` 可复制脚本
- **0.2.x** — 子进程代理注入；隐藏代理 userinfo；`ALL_PROXY`

## 测试

```sh
npm test
```

## 许可

MIT