全局网络代理 TTsdzb/dsh-global-proxy

dsh-global-proxy

可安装插件，让 DSH（DeepSeek Harness）进程的所有网络请求走 HTTP 代理：模型端点、联网搜索、MCP 等全部 fetch / http / https 流量。

Node.js 默认不跟随系统的 *_proxy 环境变量，DSH 又禁止在 .env 中设置代理类变量，因此开箱时所有请求都是直连。本插件在进程内开启 Node.js 内建代理支持（http.setGlobalProxyFromEnv，Node.js ≥ 24），并把配置接入 DSH 设置服务与 WebUI。

零插件替代：NODE_USE_ENV_PROXY（Node.js ≥ 24）

如果你的需求只是「跟随 shell 环境变量」，不需要安装本插件——Node 自带启动开关，与本插件是同一套内建机制：

NODE_USE_ENV_PROXY=1 https_proxy=http://127.0.0.1:7890 dsh web

实测（Node v26.7）官方路径的行为：

- 支持 http_proxy / https_proxy / no_proxy 及大写形式（大小写都认，小写不是插件的差异点）；
- 只设 HTTP_PROXY 时 HTTPS 请求会回退走它；
- NO_PROXY 命中即直连；
- 不支持 ALL_PROXY / all_proxy——完全不认；
- 开关与变量都必须在启动 DSH 的 shell 里 export：Node 在进程引导早期解析该开关，DSH 的 .env 分层加载发生在那之后，写进 .env 来不及生效（代理变量本身也被 DSH 列入 .env 黑名单）。

本插件额外解决什么

对照官方路径，本插件的增量是：

- all_proxy / ALL_PROXY 兜底：Clash 等工具习惯只导 all_proxy 的环境，官方路径会静默直连；插件将其作为 http/https 的兜底来源。
- 手动模式：在 WebUI 里直接填代理地址（可细分 HTTP/HTTPS、no_proxy 列表），不需要 export、不需要重启；配置写入 DSH 设置文档，持久化，重启自动生效。
- 热切换：跟随环境变量 / 手动 / 关闭三种模式保存即生效，一键恢复直连，不用为改代理重启进程。
- 状态面板：「设置 → 网络代理」展示当前生效组合、检测到的环境变量（密码脱敏）、Node 版本，并内置连通性测试（任意 HTTP 状态码即链路通）。
- 与官方开关不冲突：插件的运行时设置覆盖启动值，停止/卸载时还原回启动状态。

功能

- 跟随环境变量（默认）：读取 http_proxy / https_proxy / all_proxy / no_proxy 及全部大写形式；all_proxy 兜底，HTTPS 缺省时回退到 HTTP 代理。
- 手动设置：统一代理地址 + 可选的 HTTP/HTTPS 细分 + no_proxy 例外列表。写入 DSH 设置文档，重启后自动生效。
- 关闭：一键恢复全直连。
- WebUI 设置页：「设置 → 网络代理」，含当前生效状态、环境变量检测（密码脱敏）、连通性测试。
- 作用域：进程内全局 fetch（undici）、http、https（CONNECT 隧道）。WebSocket 不受影响。

安装

从 npm（若已发布）
dsh plugin --profile <name> add dsh-global-proxy

或从 GitHub：pnpm ≥10 需要先在 profile 的 pnpm-workspace.yaml 中允许构建 allowBuilds: dsh-global-proxy: true
dsh plugin --profile <name> add github:<you>/dsh-global-proxy

本地检出
dsh plugin --profile <name> add ./dsh-global-proxy

安装/更新后重启 DSH，打开 WebUI →「设置 → 网络代理」。（Host 半在启动时加载；若设置页提示「命名空间未提供」，说明 Host 半未激活——先重启，仍异常则查看启动日志中 dsh-global-proxy 的加载错误。）

从 GitHub 更新

dsh plugin --profile <name> update dsh-global-proxy # 重新拉取 git 分支头部并触发 prepare 构建
更新失败时：remove 后重新 add（allowBuilds 允许保留）

要求

- Node.js ≥ 24（插件探测不到 setGlobalProxyFromEnv 时会在设置页显示「不支持」，请求保持直连）。
- 环境变量模式下，代理变量必须在启动 DSH 的 shell 中 export（DSH 禁止 .env 设置此类变量）。

注意

- 仅支持 http:// / https:// 代理地址（Node 内建限制，socks5 不受支持）。
- Node 内建代理不会自动绕过 localhost / 127.0.0.1：本地服务（Ollama、本地 MCP 等）需要直连时，请把 localhost,127.0.0.1 加入 no_proxy。
- 代理地址中的账号密码会以明文存入 DSH 设置文档（与 npm 配置代理的惯例一致）；状态展示时会脱敏。

结构

├── cordis.patch.yml # bundle 层：插入 Host 插件行 ├── src/ │ ├── index.ts # Host 半：settings 命名空间 + setGlobalProxyFromEnv + 状态/测试路由 │ ├── shared.ts # 两半共享的类型与常量 │ └── client/index.tsx # Client 半：settings.section 设置页 ├── tsdown.config.ts # 构建 lib/index.js（ESM）与 lib/client.js（__ModuleLoader__ 闭包格式） └── smoke-test.mjs # Host 半冒烟测试：node smoke-test.mjs（四种模式 + 路由 + 逃逸验证）

开发

pnpm installbash
pnpm build # 产出 lib/index.js + lib/client.js
pnpm typecheck # tsc --noEmit

prepare 脚本会在 git 安装时自动构建，因此从 GitHub 安装无需预构建产物；npm 发布则在发布时携带 lib/。