前言¶

这是为 DeepSeek Harness（DSH）设计的网络代理路由插件，由 liqiaohuia 维护。它解决了一个特定场景下的技术痛点：当同一模型服务商（如 Anthropic 或 NVIDIA NIM）存在多个账号时，这些账号需要走不同的代理策略——例如免费额度号走代理，付费主力号直连——但它们都打向同一个 API 域名。传统的按域名分流无法区分账号，本插件通过识别请求携带的 API 密钥，在 Fetch 层拦截并实现按账号级别的精确路由。

插件核心能力¶

该插件提供以下功能：

按提供商（账号）分流：根据 DSH 配置的 LLM 账号，为每个账号指定代理或直连。
命名代理池：支持 SOCKS5、HTTP、HTTPS 协议，支持认证（如 socks5://user:pass@host:port）。
图形化管理：所有配置在 DSH 设置页完成，支持配置热生效。
直连模式控制：默认为“绝对直连”（v0.5.0 起），强制绕过 DSH 全局代理；也可切换为“遵循全局代理”。
内置联网工具代理：v0.5.0 起，支持将 DSH 内置的 web_fetch、MCP 子进程等未认领流量代理出去。
Fetch 层拦截：在 DSH 的 globalThis.fetch 层面介入，不影响其他插件。

安装与启用¶

安装前请确保已安装 DSH 且版本大于等于 0.1.3，并已运行代理客户端（如 Clash、v2ray 等）。

安装插件
打开终端，执行以下命令：

    dsh plugin add dsh-proxy-routes

*注意：命令行用户（`dsh web`）可能需要指定 profile，请参考 DSH 文档。*

启用并打开设置
安装后，需完全退出 DSH（桌面版请从托盘完全退出）再重新启动。启动后，打开设置 → 代理路由。

入口说明：
* 设置 → 代理路由（通用入口）
* DSH Desktop 2.0.14+：侧栏「插件」页 → dsh-proxy-routes → 详情

配置与使用¶

1. 配置代理池¶

在设置页的代理池区域，为每个代理起名并填写地址。例如：

main = socks5://127.0.0.1:50939
backup = http://user:pass@127.0.0.1:7890

支持协议包括 socks5、http、https。混合端口（同一端口同时收 HTTP 和 SOCKS）使用时需根据实际协议指定。

2. 配置按提供商分流¶

在“按提供商分流”列表中，选项会自动来源于 DSH「模型」页配置的账号（如 claude1、nvidia-01）。
每行可选择：
* 直连
* 代理池中的某个名字
* 规则：不单独设置，走默认走向。

3. 设置默认走向与直连行为¶

默认走向：未单独设置的账号或非 LLM 流量走哪条路。建议默认为 direct（直连）。
直连的行为（v0.5.0 默认）：
- 绝对直连：直连请求由本插件强制直连，无视系统环境变量 HTTP(S)_PROXY 和 DSH 全局代理设置。
- 遵循全局代理：直连请求不干预，交回 DSH 原生出站策略。

4. 内置联网工具代理（v0.5.0）¶

勾选此项，可将 web_fetch 抓取、MCP 子进程等未认领流量统一代理。
* 配置：只支持 http:// 代理，地址格式为 host:port（如 127.0.0.1:10000）。
* 生效：保存即生效，无需重启 DSH。关闭或卸载插件时自动还原。

5. 保存配置¶

点击保存按钮，配置立即生效。

验证生效¶

发送一条消息后，在日志中查找带有 [proxy-routes] 前缀的记录，格式如下：

[proxy-routes] POST api.anthropic.com/v1/messages -> claude1=>main:socks5://127.0.0.1:50939

日志查看路径：
* DSH Desktop (Windows)：%APPDATA%\DSH Desktop\logs\host\dsh-<日期>.log
* dsh web：运行控制台窗口

注意：日志只记录去向，绝不包含 API 密钥。

技术细节与兼容性¶

工作原理：DSH 请求携带的 x-api-key 或 authorization 头被插件提取，在内存中匹配映射关系，从而识别账号。
版本要求：DSH >= 0.1.3。
文件模式：除了图形化管理，也可通过创建 $DSH_HOME/proxy-routes.jsonc 文件手动配置（JSONC 语法，热生效）。

注意事项¶

密钥安全：API 密钥仅在内存中匹配，不写入日志，不外发。
启动客户端：本插件不负责启动 Clash、v2ray 等代理客户端，只负责分发流量。
Windows 重装：在 Windows 上重装或升级插件前，必须完全退出 DSH，否则可能遇到文件锁错误。
直连测试：默认探测地址 https://www.gstatic.com/generate_204 在大陆直连可能被墙，建议在 DSH 设置的“其他选项”中改为 https://www.baidu.com。

结尾¶

dsh-proxy-routes 是 DSH 生态中处理多账号代理分流的实用工具，通过图形化管理降低了配置复杂度，同时提供了灵活的路由策略。更多细节与源码，请访问 GitHub 仓库。

dsh-proxy-routes

前言¶