yanglaofish/dsh-proxy-pro

dsh-proxy-pro

一个 DeepSeek Harness（DSH）插件的代理管理器：把整个运行时（模型请求、web_search / web_fetch、spawned 工具）统一路由到 Windows 系统代理或自定义地址，并提供随时可见、一键切换、可诊断的体验。

区别于原 dsh-plugin-proxy 的核心差异：

• web_fetch / web_search 真正走代理。原插件只换 undici 全局 dispatcher + env，而 dsh-web-fetch-http 的 proxyRouteFor() 只读 @deepseek-ai/dsh-http-proxy 的模块级策略——本插件通过 installProxyFromEnvironment() 纳入这条通道，web_fetch 的网络故障（fetch failed）被根治。
• 对话头部一键开关：每会话头部胶囊按钮（绿 = ON / 红 = OFF），点击即切换；「关→开」兼作手动重检——触发 host 现读注册表并重新应用，代理出问题时直接在头部拨一下即可。
• 设置页「代理配置」：显示运行时事实（生效地址 / 原因 / 直连名单）而非设置推断；模式仅「系统代理（Windows）/ 自定义地址」两个选项；内置按 URL 的路由诊断（PROXIED / DIRECT 判定 + 强制走代理 / 强制直连双通道探测 + NTLM 提示）。
• 单一传输通道：env + dispatcher + 策略由 dsh-http-proxy 一体管理，插件不直接触碰 undici，杜绝双实例错版（UND_ERR_INVALID_ARG）。
• 幂等内核：effKey 相同只刷快照、绝不重装 dispatcher——读型 API 与轮询永不触发重组（修复过"每次拉都重装导致桌面卡顿"的根因）；「拉时现读」让页面看到的永远是新鲜事实而无需任何定时器。
• 干净卸载：卸除时恢复 env / dispatcher / 策略，fire-and-forget 后台排空 keep-alive。

全部踩坑与设计决策见 docs/LESSONS.md（必读），规格与验收清单见 docs/SPEC.md。

安装

两种方式任选其一（npm 包已发布，拉取即用、免构建授权）：

方式 A：npm 安装（推荐）

dsh plugin --profile web add @yanglaofish/dsh-proxy-pro
dsh plugin --profile test add @yanglaofish/dsh-proxy-pro

方式 B：GitHub 源安装

dsh plugin --profile web add github:yanglaofish/dsh-proxy-pro

安装完成后直接启动：

dsh web

使用

对话头部胶囊按钮 —— 每会话头部右侧的「代理 · ON system / OFF」：绿点 = 代理生效、红点 = 关闭；一点切换总开关。头部按钮为配置驱动（打开即绿、零轮询），「关→开」操作触发 host 现读系统注册表并重新应用——代理状态异常时，直接在头部拨一下即可重检修复。

设置 → 代理配置 ——

• 状态行（置顶）：生效地址 + 原因说明；右侧短小启用开关，切换立即生效。
• 代理地址来源：仅「系统代理（Windows）」与「自定义地址」两个选项。「不使用代理」模式已从界面与 proxy_config 工具移除（scheme 保留 none 仅解析旧配置残留）。
• 自定义地址：http://host:port 或裸 host:port。
• 直连名单（NO_PROXY）：编辑框下方显示当前生效名单；system 模式自动并入 Windows 系统 ProxyOverride（标注「含并入」），custom 模式只保留你自己的名单（不并入系统白名单）。
• 路由诊断：输入 URL，勾选「使用代理」= 强制走代理探测 / 不勾 = 强制直连探测；对比两次结果即可判断该域名该不该加进直连名单。

模型侧 —— 系统提示实时标注代理状态；四个工具：

• proxy_status — 查询当前状态：是否走代理、生效地址、NO_PROXY 名单、来源。
• proxy_set — 一键开/关整个运行时（改配置持久化并立即生效）。
• proxy_test — 单 URL 路由诊断：PROXIED / DIRECT 判定、NO_PROXY 命中、连通探测；HTTP 407 归类为 NTLM 认证失败并给出 keepalive 提示。
• proxy_config — 读/改配置：开关、模式（system / custom）、自定义地址、NO_PROXY；可只传任意子集。