dsh-proxy-control

在运行中控制 DeepSeek Harness 的出站代理：三种来源三选一，改完立即生效，不用重启。

English ｜ 中文

「系统代理」只在桌面版提供：它读的是运行 dsh 那台机器的 Windows 设置，Web 端（dsh web）会禁用这一项。

特性

• 三种来源：内置（启动环境）/ 系统（Windows 代理设置）/ 手动，三选一。
• 立即生效：改地址、改直连名单、切来源，下一次请求就走新配置。
• 如实上报：显示此刻实际会怎么走，而不是"插件装了什么"。
• 覆盖面：走 fetch 的（LLM 对话、web 搜索、HTTP MCP）、web_fetch、子进程；回环地址永远直连。
• 自测按真实调用路径发一次请求，直连也算有效结果。
• 分流用直连名单。

安装

需要 DSH 0.2 系列（Desktop 或 Web）与 Node.js 22+。

dsh plugin --profile desktop add "/绝对路径/dsh-proxy-control"

也可以在 设置 → 插件 → 添加插件 里选目录。装完重启一次（bundle 列表只在启动时读），之后所有代理改动都是实时的。

本包带 cordis.patch.yml，条目会自动插入 profile。想直接改配置就编辑 profile 的 cordis.patch.yml：

- id: proxy-control
  name: dsh-proxy-control
  config:
    mode: env          # env 内置 / system 系统 / manual 手动
    proxy: ''          # 仅手动模式使用
    noProxy: ''        # 直连名单
    testUrl: ''        # 留空用默认自测地址

早期版本的 enabled 与 autoDetect 已删除；配置里还留着会被忽略，并在下次保存时清掉。

使用

设置页在 设置 → 代理。

• 三行来源常驻，未选中的只是置灰并标「未选中」；切来源会强制重读那一边。
• 标题旁的 ? 放说明，行内只放结果。
• 三个动作是图标按钮，功能看悬停提示：重新读取（内置行）、重新探测（系统行）、测试（自测地址行）。
• 手打的三个字段失焦即存，回车也行 —— 没有保存按钮。
• 三处结果（内置的来源、生效中的代理、自测结果）都显示在各自那一行的下方。

「测试」按 Harness 自己的调用路径（全局 fetch）发一次请求，所以它回答的是"这份配置生效后会怎样"。测的是你眼前这份配置：点之前若有没落盘的改动，会先写下去。

配置项

配置项	说明
代理来源	内置 / 系统 / 手动 三选一。默认 内置，是惰性的 —— 装上不会改变任何行为。
代理地址	仅手动模式。例如 http://127.0.0.1:7890，只接受 http:// 与 https://。
直连名单	这里的主机不走代理。仅手动/系统模式；内置模式以环境里的 NO_PROXY 为准。
自测地址	「测试」访问的地址，留空用 https://www.gstatic.com/generate_204。

三种来源

界面上的名字	从哪读	什么时候用
手动	你填的地址	最常见
系统	Windows 注册表 Internet Settings（仅桌面版；不解析 PAC）	代理软件开了系统代理
内置	$DSH_HOME/.env 或启动前导出的变量	已经在 .env 里配好，想让插件只读不干预

内置 = 不插手：插件什么都不装，路由交给 DSH 启动时构建的那一层。所以「生效中的代理」会点名是哪一层：

生效中的代理：http://127.0.0.1:7890（启动环境（.env 或已导出的变量））

括号里是「本插件的配置」就是在走插件的策略；是「启动环境…」就是启动器那层（选内置时的正常样子）。没有代理就写「生效中的代理：直连」。

两点：.env 只在启动时读一次，改它要重启；官方解析器在只设 HTTPS_PROXY 时 http:// 目标仍直连，要两者都走就一起写。

已知限制

• 不支持 SOCKS：策略只接受 http: / https:，填了会被明确拒绝并说明原因。
• 系统代理只在桌面版提供（Web 端禁用），且只在选中它时读取、要手动点「重新探测」才跟上系统里的改动；不解析 PAC。
• 系统 bypass 列表被整份忽略：127.*、<local> 这类通配写法本 Harness 的匹配器不支持；回环地址本来就被强制直连。
• 直连名单不支持 CIDR（10.0.0.0/8 这类会被丢弃并提示）。
• 不做按类别开关：LLM 对话与 web 搜索打的是同一个 URL，传输层分不开；更细的规则交给代理软件。
• 自定义 CA：做 TLS 拦截的代理需要在启动前设 NODE_EXTRA_CA_CERTS。
• Electron 自身流量（自动更新、登录页）在另一个进程的网络栈里，插件管不到。
• 子进程跟随策略；但 .env 里也配了代理时，子进程会跟随 .env 那份值。界面与日志会提示这个分叉。

安全性

设置页接口能改流量走向，所以只接受本机请求（403）、要求 Host 是回环地址（挡 DNS 重绑定，403），并拒绝可免预检跨站发送的请求体形态（415）。DSH 的 Web 服务器自身不带认证或来源策略，第三方路由必须自己设防。

排错

「生效中的代理」那一行是权威读数。想知道子进程拿到了什么：

$env:HTTPS_PROXY; $env:NODE_USE_ENV_PROXY

这两个只在策略安装后才会发布给子进程。日志里：

proxy-control：出站请求经由 http://127.0.0.1:7890（手动指定），直连名单 api.deepseek.com
proxy-control：不干预路由（启动环境里没有代理设置（查过 C:\Users\Joker\.dsh\.env），按直连处理）
proxy-control：不干预路由（启动环境里有 http://127.0.0.1:7890，插件不插手（那就是启动器那层在生效））
proxy-control：无法使用 <地址>（<原因>），出站请求保持直连

用不了的代理不会弄死 agent：记一行警告并保持直连。卸载插件会还原启动器自己的策略。

许可

MIT