dsh-network-config：DeepSeek Harness 网络代理配置插件

前言¶

DeepSeek Harness 默认从环境变量（如 http_proxy、https_proxy 等）读取代理策略。这意味着用户必须在启动应用前设置这些变量，且每次更改策略都需要重启应用。

该插件在 DeepSeek Harness 的设置中新增了一个“网络”页面。它解决了上述痛点，允许用户直接在应用内切换代理模式，且更改无需重启即可立即生效。

核心功能¶

• 跟随系统代理：读取 Windows 系统代理设置及其开关状态。
• 直连模式：不使用任何代理直接连接网络。
• 自定义代理：指定自定义的 HTTP(S) 代理地址，并支持配置绕过列表。
• 内置绕过规则：自动对以下地址走直连，无需手动配置：
  • 回环地址（Loopback）
  • 私有 IP 地址（RFC 1918）
  • 链路本地地址（Link-local）
  • CGNAT 地址
• 尊重系统绕过列表：同时支持系统代理配置中的绕过条目（如通配符前缀、无点主机名等）。
• 即时生效：无需重启应用或修改环境变量，保存设置后立即生效。

安装与启用¶

环境要求¶

• DeepSeek Harness 桌面版（推荐 Windows 以支持“跟随系统”模式）。
• PowerShell。

安装步骤¶

1. 下载插件包并解压。
2. 进入解压后的目录，执行安装脚本：

powershell -ExecutionPolicy Bypass -File .\install.ps1

3. 完全关闭并重新打开 DeepSeek Harness。插件在启动时挂载，运行中的应用无法加载新插件。

4. 验证安装：

powershell -ExecutionPolicy Bypass -File .\verify.ps1

卸载¶

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Uninstall

卸载后需重启应用。

典型用法¶

通过界面配置¶

1. 打开 DeepSeek Harness，进入 Settings（设置）。
2. 点击 Network（网络）。
3. 在模式选择中选择：
   - Follow system：跟随系统代理。
   - Direct：直连。
   - Custom：自定义代理。
4. 点击 Save（保存）。

通过 API 配置¶

使用 POST 请求修改代理状态。例如：

Invoke-RestMethod -Uri "http://127.0.0.1:19387/dsh-network-config/state" -Method POST -Body '{"mode": "system"}'

注意事项与限制¶

• 不支持 SOCKS 代理：仅支持 HTTP(S) 协议。
• 不支持 PAC 脚本：PAC 脚本配置被视为直连。
• 子进程策略：子进程（Child processes）仅在 Node.js 22.21+ 或 24+ 版本上完全遵循策略。
• 依赖项：插件依赖 undici 包，需确保其在应用配置中可解析。
• 数据文件：插件配置数据存储在 %USERPROFILE%\.dsh\network-config.json。

总结¶

该插件为 DeepSeek Harness 提供了一个无需重启的代理配置方案。它通过复用 @deepseek-ai/dsh-http-proxy 机制，并结合自定义的绕过匹配器，解决了原生环境变量配置繁琐的问题。