前言¶

這是爲 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

前言¶