Skip to content

dsh-plugin-network-proxy

Verified

dsh-plugin-network-proxy · v0.1.3 · MIT · Web UI

DeepSeek Harness plugin: live on/off switch for the Harness outbound HTTP(S) proxy — settings page, /proxy command and switch_network_proxy tool, no restart required

Install

dsh plugin add dsh-plugin-network-proxy

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-plugin-network-proxy

中文 | English

给 DeepSeek Harness 加一个运行时开关:一键开启/关闭 Harness 自己的出站 HTTP(S) 代理, 立即生效、不用重启。

  • 设置面板一行开关(「网络代理」页)
  • 斜杠命令 /proxy on|off|toggle|status
  • 模型工具 switch_network_proxy({ state })
  • 状态持久化,重启后自动恢复
  • 不修改你的 .env,与启动器读取的环境变量策略互不覆盖

版本要求

组件 要求 本机验证版本
DSH 桌面端 随附下列 host 包的任一版本 0.2.1-rc.3(nightly)
@deepseek-ai/dsh-http-proxy ≥ 0.1.5-rc.2(必须导出 installProxyFromEnvironment) 0.1.5-rc.2
@deepseek-ai/dsh-tools ≥ 0.1.5-rc.2(defineTool) 0.1.5-rc.2
@deepseek-ai/cordis ^4.0.2 4.0.2
Node.js ≥ 22.19(随 DSH 自带,本机 24.21.0) 24.21.0

这些下限写进了 package.json 的 peerDependencies / engines;装到更老的 Harness 上时 pnpm/npm 会给出警告,插件在切换代理时也会直接报出明确错误,而不是一个模糊的 import 失败。

判断依据:插件走的是 @deepseek-ai/dsh-http-proxy 的进程级 dispatcher 安装接口; 更老的 Harness 只有启动时读环境变量的策略,没有可在运行时重装的入口。

安装

方式 A:从 npm 安装(推荐)

在 DSH profile 里安装(profile 用 pnpm 管理依赖):

cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm add dsh-plugin-network-proxy

DSH_HOME 不在默认位置时换成 <你的 DSH_HOME>\profiles\desktop;也可以看环境变量 DSH_PROFILE_DIR。

然后用 npm 的话等价于:

npm install dsh-plugin-network-proxy --prefix "$env:USERPROFILE\.dsh\profiles\desktop"

注册 bundle(所有安装方式都必须做一次)

编辑 <profile>\package.json,把包名加进 dsh.profile.bundles:

{
  "dsh": {
    "profile": {
      "bundles": [
        "...",
        "dsh-plugin-network-proxy"
      ]
    }
  }
}

方式 B:从 GitHub 源码安装(想改代码 / 尚未发布时)

git clone https://github.com/QuincyX/dsh-plugin-network-proxy.git
cd dsh-plugin-network-proxy
pwsh -File sync.ps1

sync.ps1 会把插件复制进 <profile>\node_modules 并自动登记 dsh.profile.bundles (改前备份 package.json)。也支持指定 profile:

pwsh -File sync.ps1 -ProfileName web
pwsh -File sync.ps1 -ProfileDir "D:\other\.dsh\profiles\desktop"

也可以让 pnpm 直接从仓库装:

cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm add github:QuincyX/dsh-plugin-network-proxy

仓库里不包含 .tgz / .zip 产物(dist/ 在 .gitignore 里)。需要本地压缩包时 自己构建:npm pack 会生成 dsh-plugin-network-proxy-<version>.tgz。

生效

Host 半体通常由 cordis loader 热加载,装完即可用(/proxy status 能验证); 设置面板那一页需要刷新页面,刷新后仍看不到就彻底退出 DSH(含托盘图标)再启动。

使用

入口 操作
设置面板 Settings → 「网络代理」:开关、代理地址、「测试连接」
斜杠命令 /proxy on、/proxy off、/proxy(切换)、/proxy status
模型工具 switch_network_proxy({ state: "on" | "off" | "toggle" | "status" })

生效范围

  • 生效:Node 内置 fetch 的一切调用——模型请求(LLM provider)、web_search、 HTTP MCP、插件里的 fetch。
  • 会写回 process.env 的代理变量,因此之后由 Harness 启动的子进程(终端命令)会继承同样的代理。
  • 不生效:右侧浏览器(Electron/WebView 自己的网络栈)、进程里已有的长连接、worker 线程、遥测。
  • loopback 永远直连(dsh-http-proxy 保证),本地 Web UI 不会绕进代理。

配置

cordis.patch.yml 里的条目:

- insert:
    - id: network-proxy
      name: dsh-plugin-network-proxy
      config:
        proxyUrl: http://127.0.0.1:7890                  # 默认 Clash 混合端口
        probeUrl: https://www.google.com/generate_204    # 「测试连接」的目标
        persist: true                                    # 记住开关状态

这些是默认值。按部署覆盖请写在自己 profile 的 cordis.patch.yml 里(同 id 的条目会覆盖 bundle 层),不要改包内的 cordis.patch.yml——重装/同步会覆盖它。

probeUrl 只要返回任何 HTTP 状态码就算「可达」(401 也算,说明网关连上了)。

状态与持久化

  • 状态文件:$DSH_HOME/network-proxy.json,内容 { enabled, proxyUrl }。
  • 插件激活时若记录为开启,会立刻重新安装一次代理。
  • 不写 .env。如果 .env 里也配了代理,启动时启动器先装、插件再按自己的状态覆盖,两者互不修改。

安全

设置面板走 POST /plugins/network-proxy/state,Host 侧按下面的规则判断请求是否来自 Harness 自己的界面,不满足一律 403;GET 只返回状态,不改任何东西。

  • sec-fetch-site: cross-site → 拒绝(浏览器自动带,页面伪造不了);
  • 带 Origin → 必须与请求的 Host 同源,或等于 Desktop 的 dsh-app://app;
  • Origin: null(file://、sandbox iframe)→ 拒绝;
  • 没有 Origin → 放行:Desktop 版把页面 fetch 交给 Electron 主进程转发到 Host 时, 会删掉 Origin/cookie/sec-fetch-site 再注入 Host cookie,所以桌面端点开关时 本来就看不到 Origin。

正常浏览器里的同源页面、Desktop 页面都能用;任意第三方网站发起的跨站请求会被拒。

卸载

cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm remove dsh-plugin-network-proxy

再从 <profile>\package.json 的 dsh.profile.bundles 删掉 dsh-plugin-network-proxy, 重启 DSH(可顺手删掉 $DSH_HOME/network-proxy.json)。

仅关掉开关即可恢复直连,不必卸载。

目录

lib/index.js         Host 半体:/proxy、HTTP 路由、switch_network_proxy、持久化
lib/client.js        Client 半体:设置面板「网络代理」页(经典脚本 + 模块工厂)
cordis.patch.yml     bundle 层:插入 network-proxy 条目与默认配置
sync.ps1             从源码复制安装 + 登记 bundle(Windows)

开发

npm run check        # node --check 两个入口
npm pack             # 产出可分发的 tarball

发布:npm publish --registry=https://registry.npmjs.org/(账号开了 2FA 时需要 --otp=<6 位码>)。

License

MIT