kriskite/dsh-network-proxy

Plugin插件 Native原生 ⭐ 8 MIT Approval & Security审批与安全

DeepSeek Harness plugin to manage network proxy (system / manual / direct) with a live settings UI. [dsh-plugin]

Project Overview项目介绍

kriskite/dsh-network-proxy is a native network proxy management plugin built exclusively for DeepSeek Harness (DSH). It adds a dedicated graphical settings UI to DSH that lets users switch between three proxy modes at any time: system default, manual proxy, and direct connection. All setting changes are applied immediately via DSH’s live settings mechanism, so users do not need to restart DSH after adjusting proxy configurations. Version 1.0.1 is compatible with DSH Desktop 2.0.10 and has been updated to match the interface specifications of @deepseek-ai/dsh 0.1.5-rc.2. To install the plugin, users can run npm install dsh-network-proxy and add it to their DSH profile’s bundles list.

This plugin is designed for DSH users who need flexible proxy configuration across different network environments. Each proxy mode works to fit different use cases: in system mode, the plugin automatically pulls proxy settings from your operating system — it reads the Internet Settings registry on Windows, and pulls the HTTP(S)_PROXY environment variable on other platforms. For manual mode, users only need to input a valid HTTP or HTTPS proxy URL, which the plugin validates before saving. Direct mode clears all proxy environment variables that DSH reads, forcing all requests to connect directly without a proxy.

dsh-network-proxy is released under the permissive open-source MIT license. It requires Node.js version 20.18.1 or higher, due to its dependency on version 7 of the undici library. It also requires a DSH environment that supports plugin injection and settings injection, and has additional dependencies on @deepseek-ai/dsh-settings (version 0.1.0-rc.7 or higher) and @deepseek-ai/schemastery (version 3.18.1 or higher). Smoke tests are included to verify core functionality like proxy parsing and URL validation across platforms. Currently, the plugin does not support PAC automatic proxy scripts on Windows, and will prompt users to switch to manual mode if an AutoConfigURL is detected.

kriskite/dsh-network-proxy 是专为 DeepSeek Harness (DSH) 开发的原生网络代理管理插件,提供图形化设置界面,支持在设置页面随时切换跟随系统、手动代理、直连三种网络出口模式,修改配置后无需重启 DSH 即可立即生效。当前 1.0.1 版本适配 DSH Desktop 2.0.10,接口已经按 @deepseek-ai/dsh 0.1.5-rc.2 的规范调整完成。

本插件面向需要灵活调整 DSH 网络代理配置的用户,可满足不同网络环境下的访问需求。跟随系统模式下,会自动读取当前系统的代理配置:Windows 平台从注册表读取 Internet 设置,其他平台读取 HTTP(S)_PROXY 环境变量,无需用户手动填写。手动模式下用户只需填入合法的 HTTP/HTTPS 代理地址即可生效,直连模式则会清空所有代理环境变量强制直连。

本插件采用 MIT 开源许可证,系统要求 Node.js 版本不低于 20.18.1,同时需要 DSH 支持插件与 settings/client 注入的运行环境,依赖 @deepseek-ai/dsh-settings (>=0.1.0-rc.7) 和 @deepseek-ai/schemastery (^3.18.1)。目前暂不支持 Windows 下的 PAC 自动代理脚本,检测到 AutoConfigURL 时会提示用户改用手动模式,安装可通过 npm 命令加入 DSH 配置 bundles。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 8 stars - very few users, little community feedback星标只有 8,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:kriskite/dsh-network-proxy

把 kriskite/dsh-network-proxy 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-network-proxy

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/dsh 0.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 直连:清空所有代理环境变量,强制直连。
  • 即时生效:设置变更通过 DSH 的 live settings 机制实时应用,无需重启。
  • 多协议支持:基于 undici 的 ProxyAgent / EnvHttpProxyAgent 接管全局 Dispatcher,对 fetch 与 undici 请求统一生效。
  • Windows 系统代理解析:正确解析 ProxyServer 的 http=...;https=... 多协议写法与 ProxyOverride(NO_PROXY)。
  • 双语界面:内置中文 / 英文文案,跟随 DSH 语言环境自动切换。

📦 系统要求

依赖 版本
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 而非失败。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugins 下一个 Next dsh-better-archive →