前言¶
DeepSeek Harness (DSH) 在運行時依賴網絡進行 LLM 調用、網頁搜索和 HTTP MCP 交互。在受限網絡環境下，直接修改系統環境變量既繁瑣又容易出錯。本插件提供了一個圖形化的配置入口，允許用戶在 DSH 的設置界面中定義全局出站代理，並將配置持久化到 ~/.dsh/.env 文件中。
插件定位¶
這是一個 DeepSeek Harness (DSH) 插件，由 naitoupi 維護。它解決了在 DSH 界面中集中管理代理配置的需求，確保 LLM、網頁搜索和 HTTP MCP 流量遵循統一的網絡策略。
核心功能¶
- 設置 → 出站代理：在設置界面輸入
http(s)://格式的代理地址並保存。 - 恢復默認：點擊恢復默認按鈕將清空代理配置，恢復直連。
- 持久化寫入：配置會合並式寫入
~/.dsh/.env，保留文件中原有的其他行。 - 協議與路由限制：
- 僅支持
http(s)://協議，拒絕 SOCKS 代理。 - 本地地址（
localhost/127.0.0.1）強制直連，不走代理。
安裝與啓用¶
- 添加依賴：將插件包添加到 web profile 的依賴中。
dsh plugin --profile web add github:naitoupi/dsh-outbound-proxy
- 配置 Bundle：編輯
~/.dsh/profiles/web/package.json，在dsh.profile.bundles字段中添加"dsh-outbound-proxy"。 - 安裝並重啓：執行安裝命令並重啓 DSH。
dsh plugin --profile web install
典型用法¶
- 打開 DSH 設置面板。
- 找到「出站代理」選項。
- 輸入代理地址（例如
http://127.0.0.1:7890）。 - 保存配置並重啓 DSH。重啓後，代理將對所有網絡請求生效。
適用場景與注意¶
- 適用場景：需要在受限網絡環境（如公司內網、防火牆後）訪問外部 API 的 DSH 用戶。
- 生效機制：DSH 內置了
@deepseek-ai/dsh-http-proxy，啓動時會讀取環境變量或~/.dsh/.env中的http_proxy/https_proxy。修改配置後必須重啓 DSH 才能生效。 - 生態規範：DSH 理念是「一切皆插件」。本插件遵循這一生態規範，由社區維護，不屬於官方組件。安裝前建議檢查源碼與許可證（MIT）。
