dsh-proxy-config

DeepSeek Harness 代理配置插件：配置代理后自动生效，让 Harness 访问外网（LLM API / Web 搜索 / MCP / 插件安装等）以及它拉起的 pnpm / git 子进程都自动走 HTTP / SOCKS 代理；本机 / 回环 / 内网（127.0.0.1 / localhost / ::1 / 私有网段 / .local）直连不绕代理。

解决场景：国内访问 codeload.github.com 等目标被墙/限速导致插件安装卡死，或 Harness 自身出网（DeepSeek API、网页抓取、MCP）走不了代理。

安装

dsh plugin --profile web add github:lhf6623/dsh-proxy-config

安装后重启 harness，在 设置 → 插件 → 网络代理 里填写代理地址即可。

该插件是 host 端 bundle 插件，改动后需要重启 harness 才会加载；Web 页面本身不会自动热更新。

快速开始

1. 打开设置页 设置 → 插件 → 网络代理。
2. 填写代理地址（HTTP 或 SOCKS 任选其一即可）：
   • HTTP/HTTPS：http://127.0.0.1:7890
   • SOCKS5：socks5://127.0.0.1:7891
3. 点 保存。默认「启用代理」为打开，填了有效代理地址就自动生效。

关闭：把「启用代理」开关关掉再保存即可（保留代理地址，仅暂停使用）；点 清除配置 会删除配置并清空代理变量。

配置项

• 两个字段可只填一个；同时填时 HTTP 代理优先用于进程内请求（HTTP 与 HTTPS 目标）。
• 配置持久化到 $DSH_HOME/proxy-config.json。
• 未配置代理时插件完全透明，不影响现有网络。

生效范围

工作原理

1. 子进程：插件把 http_proxy / https_proxy / all_proxy / no_proxy 写入 process.env，pnpm / git 等子进程自动继承。
2. Harness 自身出网：宿主 Node 进程的全局 fetch（undici）本不读环境变量代理，插件安装了一个 undici 全局 Dispatcher 作为出口路由：
   • 命中 no_proxy 的目标 → 直连；
   • 其余目标 → 走 HTTP / HTTPS CONNECT 隧道或 SOCKS5。
   • 底层是 undici 原生 fetch 引擎，因此保留标准 Response 语义（含 SSE 流式 body）、重定向、默认请求头与证书校验。
3. 即时生效：每次保存设置后立即重建并应用 Dispatcher / 环境变量。

注意

• 新增依赖 undici，安装时由 pnpm 自动拉取。
• Harness 启动环境若已另有代理，本插件会用配置的代理覆盖对应的进程内出口与子进程环境变量；不需用时可用「启用代理」开关临时关闭，或点「清除配置」彻底移除。
• no_proxy 默认合并了回环、链路本地、私有网段（10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、169.254.0.0/16、fc00::/7、fe80::/10）及 *.local，并保留你已有的 NO_PROXY 条目。

卸载 / 清理

1. 在「网络代理」设置页先点 清除配置。
2. 执行：

dsh plugin --profile web remove dsh-proxy-config

「清除配置」会删除 $DSH_HOME/proxy-config.json、移除进程内代理变量，并还原全局 dispatcher；插件被停止时也会自动清理，不残留。

许可证

MIT