dsh-plugin-network-proxy
Verifieddsh-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