前言¶
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 / 幻方無官方從屬關係。
