dsh-network-proxy
DSH 插件 dsh-network-proxy
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kriskite/dsh-network-proxy#b191f365db02e85e82df207e5b64f27edb9fc628DSH 插件 dsh-network-proxy
Network Proxy 以 dsh-network-proxy 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness (DSH) 的网络代理管理插件。为用户提供图形化设置界面，可随时切换 跟随系统 / 手动代理 / 直连 三种网络出口模式，修改后立即生效。
Network proxy management plugin for DeepSeek Harness. Switch between system / manual / direct proxy modes from the settings UI, applied live.
当前版本 1.0.1 为 DSH Desktop 2.0.10 兼容版：客户端取数路径、
dsh.client声明与 服务端 dispatcher 生命周期已按@deepseek-ai/dsh0.1.5-rc.2 的接口调整（含嵌套服务名remote.settings声明）。适配目标与逐条改动见 PATCHES.md。
system 跟随系统：自动读取系统代理（Windows 读取注册表 Internet Settings；其他平台读取 HTTP(S)_PROXY 环境变量），无需手动配置。manual 手动代理：填写一个 HTTP/HTTPS 代理地址（如 http://127.0.0.1:7890）即可生效。direct 直连：清空所有代理环境变量，强制直连。undici 的 ProxyAgent / EnvHttpProxyAgent 接管全局 Dispatcher，对 fetch 与 undici 请求统一生效。ProxyServer 的 http=...;https=... 多协议写法与 ProxyOverride（NO_PROXY）。| 依赖 | 版本 |
|---|---|
| Node.js | >= 20.18.1（由 undici@7 要求） |
| DeepSeek Harness | 支持 DSH 插件与 settings / client 注入的运行环境；1.0.1 实测于 DSH Desktop 2.0.10（@deepseek-ai/dsh 0.1.5-rc.2） |
@deepseek-ai/dsh-settings | >= 0.1.0-rc.7（实测 0.1.5-rc.2） |
@deepseek-ai/schemastery | ^3.18.1（实测 3.18.2） |
将本仓库作为 DSH 插件加入你的 Harness 配置（具体方式取决于你使用的 DSH 发行版 / 插件加载器）：
npm install dsh-network-proxy
插件通过 cordis.patch.yml 注入 network-proxy 插件点，并在客户端 settings.general.item
插槽注册「网络代理」设置项。
DSH Desktop 的用户 profile（$DSH_HOME/profiles/<name>）里，把它加入
dsh.profile.bundles 并安装为依赖即可，与其他 bundle 插件一致。
插件在 network-proxy 命名空间下提供以下设置：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
mode | system | manual | direct | system | 代理模式 |
url | string | "" | 手动模式下的代理地址（须为 http(s):// URL） |
当用户选择「手动代理」时，URL 会经过校验：必须是合法的 http:// 或 https:// 地址，
否则保存会被拒绝并提示错误。
npm install
npm test # node smoke-test.mjs
smoke-test.mjs 覆盖 Windows 代理字符串解析、显式 scheme 保留、URL 校验、settings
注册形状、live settings 联动驱动的全局 dispatcher 切换，以及（仅在 Windows 平台）读取
活动系统代理的逻辑；依赖缺失时（裸 checkout）报告 SKIP 而非失败。
dsh-network-proxy/
├── index.js # 服务端插件：代理 Dispatcher 管理与环境变量注入
├── client.js # Web 客户端：设置界面 UI 与状态管理
├── cordis.patch.yml # cordis 插件注入声明
├── smoke-test.mjs # 冒烟测试
├── PATCHES.md # DSH Desktop 兼容性补丁明细
├── package.json
└── package-lock.json
MIT © 2026 Kirskite
See docs/ARCHITECTURE.md for how the server plugin, web client, and cordis patch fit together.
Q: Why does manual mode reject my URL?
A: The URL must start with http:// or https://; anything else is rejected before save.
Q: Does direct mode affect the system proxy? A: No — it only clears the environment variables DSH reads; your OS proxy setting is untouched.
Q: Windows 下 PAC 自动代理脚本支持吗？
A: 不支持。检测到 AutoConfigURL 时会提示改用手动代理。