前言¶
在 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 文档。
