dsh-proxy：DeepSeek Harness 代理插件

前言¶

DeepSeek Harness (DSH) 的開發者在調試或部署智能體時，通常需要控制網絡流量走向，例如通過代理訪問特定 LLM 提供商，或對內網地址走直連。dsh-proxy 插件提供了一套集中的網絡代理配置方案，支持全局代理與按提供商路由。

核心功能¶

全局代理配置：支持配置 HTTP(S) 全局代理，並可通過 noProxy 列表指定繞過代理的主機。
按提供商路由：可以爲單個模型提供商（如 deepseek-official, anthropic, openai）單獨設置代理或直連模式。
即時生效：修改設置並保存後，無需重啓 DSH 即可應用，適用於下一輪請求。
優先級邏輯：遵循 provider setting > global proxy > launch environment 的優先級。
系統代理檢測：支持從環境變量（如 HTTP_PROXY）或系統設置中自動檢測代理。

安裝¶

在終端執行以下命令安裝插件：

dsh plugin --profile web add @copylee/dsh-proxy

安裝完成後，重啓 dsh web，在設置中即可找到 Network proxy 頁面。

使用方法¶

進入 Settings → Network proxy：

Global proxy：勾選 Enabled 並輸入代理 URL（例如 http://127.0.0.1:7890）。在 Hosts that bypass the proxy 中填寫主機名（支持子域名匹配），localhost 和 127.0.0.1 默認直連。
Per-provider proxy：在列表中勾選需要的提供商 ID（例如 deepseek-official, anthropic），並選擇 Use proxy 或 Direct。
保存：點擊保存按鈕，設置將在下一次請求中生效。

配置文件¶

插件的配置保存在 Web Profile 的 cordis.patch.yml 文件中，路徑通常爲 $DSH_HOME/profiles/web/cordis.patch.yml。

- id: dsh-proxy
  config:
    global:
      enabled: true
      url: http://127.0.0.1:7890
      noProxy: [internal.example.com]
    providers:
      anthropic:
        enabled: true
        mode: proxy
        url: http://127.0.0.1:7890
      deepseek-official:
        mode: direct

字段說明：
* global.enabled：啓用全局代理。
* global.url：全局代理地址。
* global.noProxy：全局代理繞過列表。
* providers.<id>.enabled：啓用該提供商的獨立配置。
* providers.<id>.mode：proxy（使用代理）或 direct（直連）。
* providers.<id>.url：該提供商的代理地址。

注意事項¶

協議限制：僅支持 HTTP(S) 代理，不支持 SOCKS5。Clash 等工具的 HTTP 端口（如 7890）可用。
作用域：請使用 @copylee/ 作用域。未加作用域的同名包屬於其他人。
憑證安全：用戶名和密碼以明文形式存儲在 cordis.patch.yml 中。
路由範圍：按提供商的代理設置僅影響模型請求和模型發現，Web 搜索和 Web Fetch 等網絡請求仍使用全局路由。
遙測直連：插件的遙測流量保持直連，不經過代理。

生態背景¶

DSH 的理念是「一切皆插件」。本插件由社區開發者 copylee711 維護，代碼託管於 GitHub，許可證爲 MIT。