dsh-model-proxy

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-model-proxy

让 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) 的**模型 API 请求走本地代理端口**、并在请求失败命中指定词汇时**无限重试**的插件，带本地端口探测和设置页。

面向的场景：你的模型 API 需要经过本地代理（Clash、v2rayN、Clash Verge、Privoxy 等）才能访问时，不用在系统层面改环境变量，直接在 DSH 设置里点几下就切过去。

## 功能特性

- **真正的流量路由**：在 host 进程里把 undici 全局 dispatcher 指到代理端口。模型适配器（如 `dsh-llm-deepseek`）用的是 Node 内置 `fetch`，走的正是这个 dispatcher，所以模型请求会被真正改走代理。
- **快速端口探测**：只探测常见代理软件的预设端口（Clash 7890/7891、Clash Verge 7897/7898、v2rayN 10808/10809、Shadowsocks 1080、Privoxy 8118、Sing-box 2080），并行做 TCP → HTTP/SOCKS5 三级判断，响应快，只显示确实能转发流量的代理并给出延迟。
- **关键词无限重试**：请求失败信息命中指定词汇/句子（支持逗号或换行分隔多个）时，把默认的有限重试改成无限重试，等待时间可配置。
- **设置页**：打开「设置 → 模型请求 (Model)」自动探测；用明确的开关一键启用/禁用代理，点结果即可切换端口；下方独立配置重试规则。
- **持久化**：代理与重试规则都写入包内 `config.json`，重启 DSH 后自动恢复。

## 原理

DSH 的模型适配器直接调用全局 `fetch()`，而 Node 22 的 `fetch`（undici）默认**不理会** `HTTP_PROXY`/`HTTPS_PROXY` 环境变量，也没有任何代理挂钩。要拦截它，唯一干净的办法是安装一个 undici `ProxyAgent` 作为进程全局 dispatcher：

```js
import { ProxyAgent, setGlobalDispatcher } from 'undici'
setGlobalDispatcher(new ProxyAgent('http://127.0.0.1:7890'))
```

这必须发生在 host 进程里，所以本插件是一个 **host 平面**的 composition 行（和模型路由同一平面），不是一个 agent preset，也不是临时动态插件。

**关键词无限重试**的原理：DSH 在每次模型请求失败时触发 `agent/request-error` waterfall。内置的 `dsh-llm-retry` 按重试策略（默认有限次）处理，超限后把决策交给后续监听器。本插件注册在它之后，检查失败信息的 `message`/`code`/`status` 是否命中关键词，命中则等待配置的时长后返回 `{ kind: 'retry' }`，从而持续重试，直到成功或用户中止（尊重 turn 的 abort signal）。

## 目录结构

```
dsh-model-proxy/
├── package.json        # 包清单；dsh.client 声明 + exports["./client"]
├── lib/
│   ├── index.js        # host 半边：代理 dispatcher + 端口探测 + /model-proxy/* JSON RPC
│   └── client.js       # 浏览器半边：设置页（settings.section）
├── README.md
├── LICENSE
└── .gitignore
```

## 安装到 DSH

> 环境要求：DSH `>= 0.1.0-rc.6`，`web` profile（本插件注入 `webServer` 并注册设置页）。

```powershell
dsh plugin --profile web add dsh-model-proxy
```

然后编辑 `/profiles/web/cordis.patch.yml`（`DSH_HOME` 默认 `~/.dsh`），加一行 insert：

```yaml
- insert:
    - id: model-proxy
      name: dsh-model-proxy
```

重启 DSH，打开 **设置 → 模型请求 (Model)**。

## 使用

1. 打开 DSH 设置，进入「模型请求 (Model)」——页面会自动探测预设端口。
2. 在结果列表点某个端口的 **使用**（或手动填端口后点 **应用**）。
3. 用顶部开关切换 **启用/禁用**：绿色「已启用」表示代理已生效，状态区会显示 `已生效 · http://127.0.0.1:7890`。
4. 之后模型请求就会走这个代理；关闭开关即恢复直连。
5. 在「重试规则」里填命中词汇（多个用逗号/换行分隔）和等待毫秒数，点 **保存重试规则**。之后一旦失败信息命中，就会按该间隔无限重试。

## 探测逻辑

- 候选端口 = 固定预设列表（见 `lib/index.js` 的 `PROXY_PORTS`），仅 9 个，因此探测很快：
  - Clash 7890 / 7891、Clash Verge 7897 / 7898、v2rayN 10808 / 10809、Shadowsocks 1080、Privoxy 8118、Sing-box 2080。
- 全部端口**并行**做 500ms TCP 连通测试，只对「开放」端口继续。
- 对开放端口并行做两类实测（各 2s 超时，通常几十毫秒内出结果）：
  - **HTTP**：向代理发绝对 URI 的 `GET http://www.baidu.com/`，返回 2xx 即视为可用 HTTP 代理。
  - **SOCKS5**：原始 socket 完成 greeting + CONNECT 握手，REP=0 即视为可用 SOCKS5 代理。
- 测试目标 `www.baidu.com`（纯 HTTP、无需 TLS、国内可达），可用 `TEST_HOST` 常量替换；预设端口可在 `PROXY_PORTS` 里增删。

## 配置与持久化

运行期状态保存在包内 `config.json`（已加入 `.gitignore`）：

```json
{
  "enabled": true,
  "port": 7890,
  "type": "http",
  "retryKeywords": ["rate limit", "429", "timeout"],
  "retryDelayMs": 3000
}
```

host 插件启动时读取并应用它，因此重启 DSH 会自动恢复。禁用代理时写入 `enabled: false` 并恢复初始 dispatcher。

## 限制

- **只支持 HTTP/HTTPS 代理路由**。`undici` v6 没有 SOCKS5 dispatcher（`Socks5ProxyAgent`），所以 SOCKS5 端口**只探测展示、不参与路由**；应用 SOCKS5 会返回明确错误。要支持 SOCKS5 路由，需升级到带 `Socks5ProxyAgent` 的 undici 版本或加一个 SOCKS→HTTP 转发层。
- 只适用于 `web` profile（依赖 `webServer` 服务和浏览器设置页）。
- 代理一旦启用是**进程全局**的：DSH 进程内所有走 `fetch` 的请求（模型、以及任何用 Node `fetch` 的组件）都会走该代理。
- **无限重试会一直进行直到成功或用户中止**：命中关键词且请求持续失败时会反复重试（尊重 turn 的 abort signal，用户停止对话即可中断）。

## 兼容性

| 依赖 | 说明 |
| --- | --- |
| `undici` ^6 | 唯一运行时依赖，通过 `setGlobalDispatcher` 接管 Node 内置 `fetch` |
| `@deepseek-ai/cordis` ^4 | 宿主提供（运行时注入 `ctx`） |
| `@deepseek-ai/dsh-host-webserver` | 宿主提供 `webServer` 服务 |
| `@deepseek-ai/dsh-client-runtime` / `@deepseek-ai/dsh-client-ui-settings` | 浏览器侧提供 `slots` 服务与 `settings.section` 槽位 |

## License

[MIT](./LICENSE)