dsh-plugin-proxy
DeepSeek Harness (DSH) 全局代理插件：通过系统代理或自定义地址，让 Agent 工具、模型请求、网页抓取统一走代理 —— 主界面常驻一个开关，设置界面可配置地址来源，并且模型在对话中始终明确感知当前代理状态，避免必须直连的操作被误走代理。
解决的问题
不走代理时，外网操作频繁失败，Agent 会反复重试而白白消耗 token。本插件让整个运行时代理开关一开即全局生效；同时系统提示中实时标注代理状态，并提供了 proxy_status（查询）与 proxy_set（切换）两个工具，模型不会在不知情的情况下被迫走代理。
工作原理
| 对象 | 机制 |
|---|---|
| 模型请求（对话补全、SSE 流式、web_search/web_fetch 提供商） | 替换 undici 全局调度器为 EnvHttpProxyAgent —— 进程内所有 fetch()（所有 LLM 适配器都用全局 fetch）都走代理。 |
Agent 子进程（curl/git/npm/pwsh 等工具） | 向 process.env 写入 HTTP_PROXY/HTTPS_PROXY/ALL_PROXY/NO_PROXY，DSH 的子进程环境会继承。 |
| Agent 感知 | 每次请求时动态重渲染系统提示段落（Proxy status: ON/OFF）；另有 proxy_status（读）与 proxy_set（写）两个模型工具。 |
| 持久化 | 配置存放在 proxy 设置命名空间（设置 → 插件 → 代理），叠加在组合配置之上，实时生效（applies: live），改配置无需重启。 |
界面
- 主界面常驻开关：位于侧边栏底部，始终可见，一键切换代理开关；侧边栏收起为窄栏时保留紧凑开关。
- 设置卡片（设置 → 插件 → 代理）：
- 代理地址来源：
使用系统代理（Windows 设置）/自定义地址/不使用代理。 - 自定义代理地址：如
http://127.0.0.1:7890（仅在「自定义地址」模式下显示）。 - 直连名单（NO_PROXY）：逗号分隔；
localhost/127.0.0.1/::1始终直连。
Agent 侧行为
系统提示中始终标注：当前代理状态、生效地址、直连名单，并指示 Agent：
- 除非目标在直连名单内，否则默认所有外发请求都走代理；
- 本机 / 内网目标直接访问（在直连名单内）；
- 必须直连的操作先调用
proxy_set（enabled=false），完成后恢复（enabled=true）； - 网络操作失败时先查
proxy_status再决定是否重试，不要盲目反复重试。
proxy_set 的改动会被持久化，界面开关随之同步。
安装
# 在 DSH 的 profile 目录（或任意位置），随后重启 DSH
dsh plugin --profile web add dsh-plugin-proxy或手动把包加入 profile 的 package.json 依赖与 dsh.profile.bundles，然后重启 DSH。首次安装需要重启 DSH；之后所有配置均实时生效。
配置项
| 字段 | 类型 | 默认值 | 含义 | ||
|---|---|---|---|---|---|
enabled | boolean | false | 总开关（侧边栏开关 / proxy_set 也改这里）。 | ||
mode | system \ | custom \ | none | system | 代理地址来源。 |
customUrl | string | http://127.0.0.1:7890 | mode: custom 时使用。 | ||
noProxy | string | localhost,127.0.0.1,::1 | 直连名单（<local> 映射为本机回环地址）。 | ||
systemPollMs | number | 30000 | 系统代理轮询间隔（ms）：mode: system 且开关开启时，自动跟随 Windows 系统代理的开/关变化（如 Clash/v2rayN 切换）；0 关闭轮询。 |
mode: system 时，Windows 的 ProxyOverride 直连列表会自动合并进 NO_PROXY（<local> 与 *.domain 生效；127.* 这类 IP 前缀通配因 undici 无法表达会被丢弃）。
开发与测试
node --check lib/index.js && node --check lib/proxy.js && node --check lib/client.js
node test/proxy.test.mjs # 纯逻辑单测
node test/plugin-shape.mjs # 导出形状（对真实 @deepseek-ai 包）
node test/apply.mjs # 端到端：挂载插件、实时切换代理
node test/client-shape.mjs # 浏览器端 inject 契约（只能写服务名）
node test/smoke-undici.mjs # 真实 undici 经本地代理路由测试需要能解析 @deepseek-ai/* peer 依赖与 undici（可 junction 到 DSH 安装 / profile 的 node_modules，或 pnpm install）。
维护者注意：浏览器端exports.inject必须写 Cordis 服务名（slots、settingsScope），绝不能写包名——写包名会让插件永久 pending 并卡死 web boot。详见docs/LESSONS.md与client-shape回归测试。
已知限制
- 调度器替换覆盖进程内
fetch()，不配置桌面端 WebView/Chromium（浏览器流量本就跟随系统代理）。 mode: system读取 Windows 用户代理（HKCU Internet 设置，通过reg.exe）；纯 SOCKS 代理无法被 undici 的 HTTP CONNECT 使用 —— 请使用 HTTP 混合代理地址。- 浏览器端客户端为手写模块（
lib/client.js，无需构建），与 dsh-plugin-focus 相同的加载器格式。
