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 機制，並結合自定義的繞過匹配器，解決了原生環境變量配置繁瑣的問題。