前言¶
DeepSeek Harness（DSH）的理念之一是「一切皆插件」，网络代理就是其中一个常见但容易影响请求可用性的部分。已有做法往往需要手工修改代理环境变量，或依赖操作系统代理设置；当系统代理、本地代理和直连策略不一致时，配置和排查会比较分散。
dsh-network-proxy 在 DSH 设置界面中集中处理这个问题：让用户切换跟随系统、手动代理、直连三种网络出口模式，并通过 DSH 的 live settings 机制即时应用。
这是什么¶
kriskite/dsh-network-proxy 是一个 DSH 网络代理管理插件。它提供图形化设置界面，让用户在 DSH 内选择代理模式，并把代理设置应用到 DSH 的网络请求出口。
该仓库采用 MIT 许可证，License 署名为 © 2026 Kirskite。
核心功能¶
三种代理模式¶
插件在 network-proxy 命名空间下提供代理模式配置，主要字段为 mode：
system：跟随系统。Windows 读取注册表Internet Settings；其他平台读取HTTP(S)_PROXY环境变量。manual：手动代理。配置一个 HTTP/HTTPS 代理地址，例如http://127.0.0.1:7890。direct：直连。清空 DSH 读取的代理环境变量，强制直连；它只清空 DSH 读取的环境变量，不修改操作系统代理设置。
mode 的默认值为 system。
即时生效¶
设置变更通过 DSH 的 live settings 机制实时应用，无需重启。
统一接管请求¶
插件基于 undici 的 ProxyAgent / EnvHttpProxyAgent 接管全局 Dispatcher，对 fetch 与 undici 请求统一生效。
Windows 系统代理解析¶
在 Windows 上，插件会解析 ProxyServer 的 http=...;https=... 多协议写法，以及 ProxyOverride（NO_PROXY）。
界面与设置项¶
插件内置中文/英文文案，并跟随 DSH 语言环境自动切换。
插件通过 cordis.patch.yml 注入 network-proxy 插件点，并在客户端 settings.general.item 插槽注册「网络代理」设置项。
安装与启用¶
依赖与系统要求¶
- Node.js
>=20.18.1（由undici@7要求） - DeepSeek Harness 运行环境需支持 DSH 插件与
settings/client注入 @deepseek-ai/dsh-settings0.1.0-rc.7@deepseek-ai/schemastery3.18.1undici^7.18.2
安装¶
npm install dsh-network-proxy
将本仓库作为 DSH 插件加入你的 Harness 配置时，具体方式取决于你使用的 DSH 发行版或插件加载器。
典型用法¶
在 network-proxy 命名空间下配置以下字段：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
mode |
system | manual | direct |
system |
代理模式 |
url |
string |
"" |
手动模式下的代理地址，须为 http:// 或 https:// URL |
选择 manual 时，url 会经过校验：必须是合法的 http:// 或 https:// 地址，否则保存会被拒绝并提示错误。
如果需要运行测试，可在仓库目录执行：
npm install
npm test
适用场景与注意¶
这个插件适合需要在 DSH 内切换网络出口策略的使用者，例如在系统代理、本地代理和直连之间来回切换，或希望避免直接修改操作系统代理设置。
使用前注意：
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
direct模式只清空 DSH 读取的代理环境变量，不修改操作系统代理设置。manual模式只接受http://或https://地址。- 需要满足上面的 Node.js、DSH 注入环境和 peer dependency 版本要求。
参考¶
- 目录页：https://www.skillhub.cn/plugins/kriskite/dsh-network-proxy
- GitHub：https://github.com/kriskite/dsh-network-proxy
上述目录页为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
