前言¶
在 DeepSeek Harness（DSH）裏配置多家模型 Provider 時，請求往往直接走系統默認網絡。若你希望只對部分 API 域名走 Clash、FlClash 等本地 HTTP(S) 代理，其餘流量保持不變，同時又想在桌面端看到「實際走了哪條代理、流式首 token 與吞吐如何」，單靠系統全局代理或手工改 Host 都不順手：前者容易誤傷非模型流量，後者難以對照 DSH 內部的 Fetch 路徑。
DSH Domain Proxy（npm 包名 dsh-domain-proxy）是社區維護者 heywalter 發佈的 DSH 第三方插件，歸類爲「模型推理」。它在 DSH 網絡層按 hostname 攔截模型 API 請求，把匹配到的域名轉發到你指定的本地代理地址，並提供可選的近期調用記錄與性能指標，且說明中明確不會複製或持久化 API Key。
這是什麼¶
一句話：在 DSH 內爲選定的 Provider API 域名配置本地 HTTP(S) 代理，未匹配的請求仍走應用原有路由；並可開啓調用觀測，查看路由匹配與流式性能元數據。
- 倉庫：heywalter/dsh-domain-proxy
- 社區目錄：skillhub.cn/plugins/heywalter/dsh-domain-proxy
- 許可證：MIT（README 與 package 信息一致）
- 運行環境：Node 22.19+；README 標明在 DSH 0.2.1-rc.3、0.2.1-rc.5 上做過兼容與驗證（badge 示例版本 0.1.1；離線包安裝可 pin
@0.1.1）
插件不提供代理服務器、VPN 或訂閱配置，只負責域名級調度；使用前需本地代理客戶端已運行並監聽 HTTP(S)。
核心功能¶
按域名選擇性轉發¶
在插件配置裏添加目標 API 域名（可從 Provider domain 下拉里選已配置 Provider 的主機名，或手填），並填寫本地代理地址，例如：
http://127.0.0.1:7890
匹配到的請求會發往該代理，由你的代理應用選擇出口；未匹配的目的地繼續走 DSH 默認網絡，不被插件改寫。
連接檢查與啓用開關¶
配置完成後可點擊 Check connection 驗證代理 HTTP 可達性（不校驗模型 API 憑證），勾選 Enable domain routing 並 Save settings 後規則生效。README 要求安裝後完全重啓 DSH Desktop。
觀測與診斷¶
可選開啓 Record recent calls。正常使用模型時，在觀測視圖點 Refresh records 即可查看近期數據，無需刻意打 benchmark 流量。
- Actual Routes：查看每次請求的目標 hostname、命中的規則、實際 dispatch 的代理端點，用於覈對規則是否按預期生效。
- Call Performance：單次調用的執行指標，包括首段有效內容等待（TTFT）、流式生成速率（tok/s）、相鄰 chunk 間最長停頓等；詳細定義見倉庫內 User Guide 的 Metrics 章節。
記錄爲 opt-in，僅在內存中保留最多 100 條近期調用的元數據；不記錄 prompt、模型輸出或 API Key。
攔截範圍說明¶
插件說明其覆蓋 DSH 全局 Fetch/Undici 後端棧處理的請求；私有 SDK 傳輸、獨立子進程或直接 WebSocket 等路徑可能繞過 hook。代理協議方面，當前支持本機 loopback 的 HTTP/HTTPS 代理；SOCKS、PAC、需認證的遠程代理暫不支持。同一 hostname 若被多個 Provider 共用（例如統一網關），則共用同一條路由規則。
安裝與啓用¶
下面步驟來自 GitHub README 的 Quick Start，在 DeepSeek Harness Desktop 中操作。
- 打開 Plugins → Add plugin → Install a third-party plugin。
- 在安裝框輸入包名並安裝、啓用：
dsh-domain-proxy
如需固定 README 中的示例版本，可使用：
dsh-domain-proxy@0.1.1
選擇 Install → Enable now 後，完全退出並重啓 DSH Desktop。無網絡時可填寫已下載 .tgz 的絕對路徑進行離線安裝。
典型配置流程¶
安裝並重啓後，進入 Plugins → dsh-domain-proxy（或在 Settings 中同名入口）：
- Add Domains：從 Provider 下拉選擇或手動添加 API hostname。
- Set Proxy Address：填寫與本地代理軟件實際監聽端口一致的地址（如
http://127.0.0.1:7890）。 - Verify and Enable：Check connection → 勾選 Enable domain routing → Save settings。
若需要性能與路由對照，開啓 Record recent calls 保存後，在對話中正常調用模型，再回到插件界面 Refresh records 查看 Actual Routes 與 Call Performance。
README 中附帶一次本地基準對比（原型開發階段觀測，樣本量有限）：未走路由與經代理路由的流式中位 tok/s 差異較大，並註明實際表現取決於出口節點、網絡、Provider 負載與上下文長度；完整分佈見倉庫 docs/performance/。引用這些數據時務必連同上述限制一併理解，不宜當作普遍結論。
適用場景與注意¶
適合誰：已在 DSH Desktop 使用多家 Provider、本地已有 Clash/FlClash 等 HTTP(S) 監聽，且希望「只讓部分 API 域名走代理」並覈對 DSH 內實際 dispatch 與流式指標的開發者。
安裝前建議：第三方插件與 DSH 主程序在同一進程權限下運行；安裝前應自行查看 源碼與 LICENSE，確認符合你的安全與合規要求。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
能力邊界：域名級匹配、本地 HTTP(S) 代理、Fetch/Undici 棧攔截範圍見上文；勿指望插件替代代理客戶端本身的規則訂閱或認證配置。
結尾¶
DSH Domain Proxy 把「選定 API 域名 → 本地代理 → 其餘流量不動」和「可選的調用路由與流式指標」收進一個桌面插件配置流裏，適合在 Harness 生態裏做細粒度出站與可觀測性調試。
- 目錄頁：https://www.skillhub.cn/plugins/heywalter/dsh-domain-proxy
- GitHub：https://github.com/heywalter/dsh-domain-proxy
更多細節見倉庫內的 User Guide、Architecture Design 與 Validation 文檔。
