dsh-proxy-switch

DSH（DeepSeek Harness）网络代理开关插件：直连网络不通时，自动改用配置的 HTTP/SOCKS5 代理重试，代理地址可在 DSH 设置面板中随时修改。

功能

• 🔌 直连失败自动回退：LLM 请求、网络搜索、web_fetch 等所有对外请求（均走 host 全局 fetch）直连失败（连接拒绝 / DNS 失败 / 超时 / 连接重置）时，自动用配置的代理重发一次。
• 🎛️ 设置面板分区：DSH Web 设置弹窗新增「代理」分区，可配置：
  • 总开关（启用 / 停用代理回退）
  • HTTP(S) 代理地址（默认 http://192.168.31.2:7890）
  • SOCKS5 代理地址（默认 socks5://192.168.31.2:7891）
  • 代理选择模式（自动 / 始终 HTTP / 始终 SOCKS5）
• 💾 持久化：设置写入 ~/.dsh/settings.yaml，修改后立即生效，无需重启 DSH。
• 🧹 零第三方依赖：CONNECT 隧道与 SOCKS5 握手均自实现，不引入任何外部包。

安装

dsh plugin --profile web add link:<本目录绝对路径>
# 例如：
dsh plugin --profile web add link:D:\deepseek\dsh-proxy-switch

安装后 重启 dsh web 生效（dsh web），然后打开 Web 设置 → 代理。

使用

1. 重启后在设置面板找到「代理」分区。
2. 打开「启用代理回退」开关。
3. 按需修改代理地址（HTTP 与 SOCKS5 可同时保留，模式选「自动」时 https 目标优先 HTTP 代理）。
4. 保存即生效：此后任何对外请求直连不通时会自动走代理。

配置项

字段	类型	默认值	说明
enabled	boolean	false	总开关，关闭时所有请求保持直连
httpProxy	string	http://192.168.31.2:7890	HTTP(S) 代理地址
socksProxy	string	socks5://192.168.31.2:7891	SOCKS5 代理地址
mode	string	auto	auto 自动（https 优先 HTTP）/ http 始终 HTTP / socks5 始终 SOCKS5

对应 ~/.dsh/settings.yaml 中的 proxy: 段。

工作原理

• host 端（lib/index.js）注册 proxy 设置命名空间，并包装 globalThis.fetch。
• 包装逻辑：先直连 → 抛网络层错误且 enabled=true 时 → 用配置的代理重发（lib/proxy-fetch.js）。
• 代理通道自实现：HTTP 代理走 CONNECT 隧道（RFC 7230），SOCKS5 走 RFC 1928 握手；TLS 由 Node tls 处理，响应保持流式（SSE 正常）。
• client 端（lib/client.js）通过设置面板 slot（settings.section）注册「代理」分区 UI。

开发

# 本地改动后（host 端 / client 端均无需构建，直接生效）
# host 端改动需要重启 dsh web；client 端 bundle 内容变更会被 HMR 热载

许可

MIT