DeepSeek Harness 插件

copylee711/dsh-proxy

Star 数 ★ 9 下载量(近 30 天) 1,723 分类 工具与能力 收录于 2026-10-05 npm @copylee/dsh-proxy

DeepSeek Harness 网络代理设置页:配置全局 HTTP(S) 代理及免代理主机,或为单个 LLM 提供商单独指定代理或直连;保存即生效,无需重启。

安装

# npm 包(预构建)

dsh plugin --profile web add @copylee/dsh-proxy

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:copylee711/dsh-proxy

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

English | 中文

DeepSeek Harness(dsh)的网络代理插件:

  • 全局代理:在「设置 → 网络代理」里填 http://127.0.0.1:7890,模型请求、联网搜索、网页抓取、HTTP MCP 以及 Agent 启动的命令都走这个代理;
  • 按提供商代理:给某个模型提供商单独指定代理地址,或强制直连,例如 Anthropic 走 http://127.0.0.1:7890、DeepSeek 直连;
  • 保存即生效:不需要重启 dsh。

优先级:提供商设置 > 全局代理 > 启动时的 HTTP(S)_PROXY 环境变量。

安装

dsh plugin --profile web add @copylee/dsh-proxy

重启 dsh web 后,「设置」中会出现「网络代理」页面。

请带上 @copylee/ 作用域。npm 上无作用域的 dsh-proxy、dsh-network-proxy 是别人的无关包。

也可以直接从 GitHub 安装(仓库已提交构建产物,不需要构建脚本或 allowBuilds):

dsh plugin --profile web add github:copylee711/dsh-proxy

使用

打开「设置 → 网络代理」:

设置中的「网络代理」页面:全局代理,以及设为「直连」或「使用代理」的提供商

区域 说明
全局代理 勾选「启用」,填写代理地址(如 http://127.0.0.1:7890)。「不走代理的主机」每行一个,会同时匹配子域名;localhost / 127.0.0.1 始终直连。
按提供商代理 列出已配置的模型提供商,每个可选「跟随全局 / 使用代理 / 直连」。未列出的提供商可以在下方输入 id 添加(如 deepseek-official、anthropic、openai,或你在「模型」页自定义的 Provider ID)。

点「保存」后立即对后续请求生效,包括「模型」页的「获取可用模型」。

系统代理

全局代理方式可选择「关闭(沿用启动设置)」「系统代理(自动检测)」或「手动代理」。每个提供商也可独立选择系统代理,优先于全局代理。菜单采用与 dsh-free-search 一致的浮层卡片、悬停高亮和选中勾号,支持方向键、Home/End、Enter、Esc 和 Tab。

系统检测按 HTTPS_PROXY / https_proxy、HTTP_PROXY / http_proxy、ALL_PROXY / all_proxy 的顺序尝试可用的 HTTP(S) 地址,再读取 Windows 当前用户 Internet 设置或 macOS scutil 设置。Linux 使用环境变量。插件保留启动环境快照,避免把自身安装的代理误当成系统代理;系统设置每 30 秒重新检测,页面也可点击「重新检测」。只支持 HTTP(S),不执行 PAC/WPAD,也不使用 SOCKS 端口。检测不到时,全局恢复启动设置;提供商回退到全局路由,并记录警告。显示和日志遮蔽代理认证信息。

global:
  enabled: true
  mode: system
  noProxy: []
providers:
  openai:
    enabled: true
    mode: system

旧配置省略 mode 时继续使用手动代理,默认不启用全局代理。

强调色

页面底部可选择强调色(陶土橙 / 蓝色 / 黑色),决定主按钮和焦点框的颜色。这个选择与 copylee 的其他插件共用,在任意一个插件里改,其余插件一起变。

直接写配置文件

也可以编辑 $DSH_HOME/profiles/<profile>/cordis.patch.yml(Web UI 默认 profile 为 web),效果相同:

- id: dsh-proxy
  config:
    global:
      enabled: true
      url: http://127.0.0.1:7890
      noProxy: [internal.example.com]
    providers:
      anthropic:
        mode: proxy
        url: http://127.0.0.1:7890
      deepseek-official:
        mode: direct
字段 说明
global.enabled 是否启用全局代理,默认 false(沿用启动环境变量)。
global.url 全局代理地址。
global.noProxy 全局代理下直连的主机列表。
providers.<id>.enabled 是否启用该提供商的单独设置,默认 true;false 时跟随全局。
providers.<id>.mode proxy(走 url)或 direct(强制直连,连全局代理也绕过)。
providers.<id>.url 该提供商的代理地址。

代理地址支持 http:// 和 https://,可以写成 127.0.0.1:7890(自动补 http://),需要认证时写 http://user:password@host:port。

工作原理

  • 全局代理 通过 dsh 自带的 @deepseek-ai/dsh-http-proxy 安装(启动器处理 HTTP(S)_PROXY 用的就是它),因此本机回环直连、NO_PROXY 匹配、web_fetch 的路由判断、子进程的代理环境变量都与官方行为一致。关闭全局代理会恢复启动时的设置。
  • 按提供商代理 挂在 llm/stream 中间件上:该提供商的一次模型调用在一个异步上下文里进行,插件把对应的 undici ProxyAgent(或直连 Agent)放进 AsyncLocalStorage,fetch 在这个上下文里就会使用它;其他请求不受影响,并发的不同提供商请求互不干扰。
  • 两部分配置都是 Cordis 的 volatile 字段:设置页保存后,dsh 触发 loader/volatile-update,插件原地切换路由,不会重载。

限制

  • 只支持 HTTP(S) 代理,不支持 SOCKS5。Clash、v2rayN 等的「混合端口」(如 7890)同时支持 HTTP,填这个端口即可。
  • 按提供商代理只作用于该提供商的模型请求(含获取模型列表)。联网搜索、网页抓取等其他请求走全局代理。
  • 用户名和密码会以明文保存在 profile 的 cordis.patch.yml 中,全局代理的地址还会通过环境变量传给 Agent 启动的命令。
  • 遥测上报使用 Node 的 http 模块,不经过代理(与 dsh 官方行为一致)。

开发

npm install
npm run typecheck
npm test        # 用本地假代理验证全局 / 提供商 / 直连路由
npm run build   # 生成 lib/ 与 client/(需提交)

在本地 dsh 中调试:dsh plugin --profile web add /path/to/dsh-proxy。

许可证

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。