模型代理 recyvan/dsh-model-proxy

dsh-model-proxy

把 DeepSeek Harness 的模型 API 请求走代理，让海外第三方模型服务商在中国大陆也能用；同时不在你列出的域名范围内的请求仍然直连——网页搜索、页面抓取、MCP 服务器和工具调用都不会走代理，除非你把它们的域名加进去。

- 不改动 harness 的任何文件；卸载后行为完全恢复原样
- 支持系统代理、自定义代理（http / https / socks4 / socks4a / socks5 / socks5h）或基于环境变量
- 支持全局或按域名路由；域名规则接受精确主机名、通配符和后缀
- 三条安全保证，配置无法放宽（见下文）

安装

dsh plugin --profile <your-profile> add github:recyvan/dsh-model-proxy

装完重启 DSH——宿主部分在 harness 进程内加载。

需要 DSH 0.2.1-rc.2 或更新版本。设置页由宿主根据插件的 Config schema 生成（0.2.x 移除了 settings 服务和客户端侧的 settingsScope 服务），所以旧版 harness 会在安装时被拒绝。

配置

打开设置 — 模型代理（设置侧边栏里有独立页面）。

| 字段 | 含义 |
| 模式 | rule（推荐）/ system / custom / off |
| 代理协议 | http / https / socks5 / socks5h / socks4 |
| 代理地址 | socks5h://127.0.0.1:7890，或只写 127.0.0.1:7890（协议从协议字段补全） |
| 仅代理这些域名 | 留空 = 内置预设；填写 = 只代理这些（逗号分隔，.openai.com、.aiplatform.googleapis.com） |
| 排除域名 | 始终直连，优先级最高 |

改动在下一个请求生效——无需重启。

三种常见配置

A. Clash / V2Ray 在 127.0.0.1:7890，只代理海外 API 模式 = rule，协议 = http，地址 = 127.0.0.1:7890，域名列表留空。
预设会把 OpenAI / Anthropic / Gemini / xAI / Groq / OpenRouter 等走代理，DeepSeek、DashScope、智谱、Kimi 等大陆服务商保持直连。

B. 跟随 Windows 系统代理 模式 = system。插件每 30 秒重读 HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings，跟随 Windows 里的改动。

C. 全部走代理，少数例外 模式 = custom，填好地址，把例外列在「排除域名」下。

大陆访问海外 API 的注意事项

- DNS 污染：优先用 socks5h（由代理解析 DNS），或让你的代理客户端接管 DNS。
- 默认拒绝明文 http——API key 不能以明文经代理传输。确实需要时，在设置页勾选相应选项。
- 代理必须监听回环地址；在你的代理客户端里开启本地/局域网监听。

验证

1. 设置页显示实时状态：path A · exit route · N rules · proxied x / direct y。
2. http://127.0.0.1:<port>/dsh-model-proxy/status 返回同样的快照，格式为 JSON（仅限回环地址 / 同源）。
3. 在源码检出目录中运行：npm test（等同于 node test/run-all.mjs）。测试套件随仓库提供，不在 npm 包中，无需安装——它会从你的 DSH 配置档（或 DSH_HOME）中解析宿主自带的 undici 和 @deepseek-ai/schemastery。

安全保障

以下保障不受配置影响，始终成立，也是规则引擎最先检查的内容：

1. 强制直连——回环地址、私有网段（10/8、172.16/12、192.168/16、169.254/16、fc00::/7——localhost 以及 .local/.lan/.internal 这类域名永不经过代理。用户规则可以添加条目，但不能删除这些。
2. 明文拦截——模型请求如果不是 https，会在打开任何 socket 之前被拒绝，除非显式启用该选项（此时页面会持续显示警告）。
3. 数据最小化——插件以流的方式透传请求体和响应体；从不解析它们，从不写入磁盘，也从不读取 Authorization 或任何服务商 API key。默认日志只记录出口 id 和错误类别——不含主机名、不含路径、不含请求体。

出口失败时回退到直连，绝不回退到另一个出口：悄悄把流量切到别的出口，会在用户不知情的情况下改变出站身份。回退会记入日志并显示在设置页上，因此降级状态可见，而非静默发生。

开发

lib/index.js Cordis host entry — the only file that touches the harness API lib/client.js settings page (__ModuleLoader__ browser entry) lib/core/ pure logic, no harness dependency, independently testable test/run-all.mjs test suite: pure-logic groups, then entry-file smoke tests

undici 和 @deepseek-ai/schemastery 都是 peer 依赖——harness 已经自带它们，再装一份意味着会出现两个 dispatcher/Schema 实例。devDependencies 条目只是为了 npm test 能在 DSH 之外运行；测试套件本身优先使用宿主的副本。

限制

- 只覆盖通过 fetch 发出的请求——实际上就是所有模型请求，外加你把域名加入代理列表的其他 fetch 流量。transport: websocket 流式传输和服务商原生 SDK 通道（例如 Amazon Bedrock）不走 fetch，无法在这里代理——这类请使用 harness 内置的环境变量代理。网页抓取属于同一类：harness 的 fetch 工具会自建 undici agent，域名规则永远看不到它。
- 路由按域名进行。一个域名如果同时提供模型 API 和其他流量，它的全部流量都会走代理；这类域名请列在「排除域名」中。
- 代理凭据只能嵌在代理地址里（http://user:pass@host:port），……会把它们以明文形式存进 settings。更推荐让代理接受回环连接，不做认证。
- 支持任意深度的代理链（每一跳的 CONNECT 都经由上一跳转发，按配置顺序）。每一跳都是真实的一跳：链测试套件驱动三个 CONNECT 桩，并断言每个桩拨号到了哪个端口。

验证连接

设置页有 Test proxy 按钮。它会通过当前配置的出口发一个真实请求，报告延迟、HTTP 状态和失败类别——绝不报告主机名或响应体。这回答了诊断页回答不了的问题：是代理的问题，还是别的东西？

卸载

dsh plugin --profile <your-profile> remove dsh-model-proxy
dsh --profile <your-profile>

移除后 DSH 完全恢复直连——没有配置残留，没有监听端口。

License

MIT