DeepSeek Harness (DSH) 採用插件化架構,旨在通過擴展滿足多樣化需求。在開發或測試環境中,有時需要通過代理訪問 GitHub,但並不希望長期佔用系統配置。wjt0321/dsh-git-proxy 提供了一個 Web UI 開關,允許用戶按需配置 git 和 SSH 代理,並在下載完成後恢復直連。
核心功能¶
該插件主要解決 GitHub 訪問的代理配置問題,具體能力包括:
- 一鍵開關代理:在 Web UI 中控制 git 和 SSH 代理的開啓與關閉。
- 保存代理地址:輸入並保存代理地址,按 profile 存儲於本地。
- 下載前測試連通性:在下載前驗證代理端口與 GitHub 隧道的連通性。
- 自動配置:
- 配置
git的 https 代理。 - 配置
ssh的ProxyCommand。
- 配置
- 地址校驗與移除:校驗代理地址格式,並在關閉時移除配置。
安裝與啓用¶
通過插件市場安裝,或使用命令行:
dsh plugin --profile web add github:wjt0321/dsh-git-proxy
重啓 Web UI 後,打開 設置 → Git 代理。
典型用法¶
- 輸入代理地址:在界面中輸入代理地址(如
127.0.0.1:10808)並點擊保存。 - 開啓代理:點擊開啓代理,插件會執行以下配置:
- Git (HTTPS):執行
git config --global http.https://github.com.proxy http://<地址>。 - SSH:在
~/.ssh/config的Host github.com塊寫入ProxyCommand(使用 Git for Windows 自帶的connect工具)。
- Git (HTTPS):執行
- 驗證連通性:點擊測試連通性,驗證代理端口與
github.com:443/github.com:22的隧道是否暢通。 - 執行下載:進行 git 拉取或克隆操作。
- 關閉代理:下載完成後點擊關閉代理,兩項配置立即被移除,恢復直連。
注意事項與限制¶
- 依賴環境:SSH 代理功能依賴 Git for Windows 自帶的
connect工具,缺失時 SSH 部分將標記爲不可用。 - 代理要求:不支持認證代理(用戶名/密碼)和 IPv6 代理地址。代理軟件必須處於運行狀態,否則開啓代理會導致 git 操作失敗。
- 作用範圍:僅影響
github.com的 git 操作(HTTPS 和 SSH),npm/pnpm 包下載不受影響。 - 配置衝突:如果用戶在
~/.ssh/config中已存在ProxyCommand行,插件會將其插入在其前,並優先讀取插件行。若存在Match段或多主機github.com行,插件會提示並保留原狀。 - 格式處理:編輯 ssh config 會把行尾統一爲 LF。
生態背景¶
DSH 理念是「一切皆插件」,該插件由社區開發者維護,安裝前建議檢查源碼與許可證。