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。