dsh-reconnect

Infinite model-request retry for DeepSeek Harness, with exponential backoff and relay/proxy failure recovery.

为 DeepSeek Harness 提供模型请求无限重试、指数退避和不稳定中转站/代理恢复能力。

English

Project Description

dsh-reconnect is a Host-side plugin for DeepSeek Harness (DSH). It retries failed model requests so temporary network failures do not interrupt an agent turn or a long-running task.

The plugin listens to the DSH agent/request-error waterfall event. After the built-in finite retry handler gives up, the Agent loop sends the same request again until it succeeds or the user stops the turn.

Suitable Use Cases

• Unstable relay stations, reverse proxies, API gateways, or forwarding services
• Relay nodes that disconnect, reset connections, or return incomplete responses
• Intermittent network failures and transport errors
• Temporary provider outages, server-side 5xx errors, rate limits, and timeouts
• Long-running tasks that should survive short-lived provider or network failures

Retry Policy

Permanent authentication, configuration, or context errors may continue retrying. Stop the current turn manually when such an error cannot recover.

Backoff and Cancellation

• Exponential backoff: 1s -> 2s -> 4s -> ..., capped at 60s
• Honors providerRetryAfterMs when available, also capped at 60s
• Logs the provider, error code, turn, step, retry count, and delay
• Emits standard llm/retry events so the Harness conversation UI shows the continuous retry count, ∞ limit, countdown, and failure reason
• Stops when the current turn is aborted or the plugin is stopped

Download

The package is platform-independent. Choose one of the following methods.

Method 1: GitHub Web Download

1. Open https://github.com/MistRain-1/dsh-reconnect.
2. Select Code and then Download ZIP.
3. Extract the archive and use the extracted dsh-reconnect-main directory as the plugin package.

Method 2: Git Clone

Windows PowerShell:

git clone https://github.com/MistRain-1/dsh-reconnect.git "$HOME\dsh-reconnect"

macOS:

git clone https://github.com/MistRain-1/dsh-reconnect.git "$HOME/dsh-reconnect"

Linux:

git clone https://github.com/MistRain-1/dsh-reconnect.git "$HOME/dsh-reconnect"

Method 3: Download the ZIP from a Terminal

Windows PowerShell:

Invoke-WebRequest -Uri https://github.com/MistRain-1/dsh-reconnect/archive/refs/heads/main.zip -OutFile dsh-reconnect.zip
Expand-Archive -Path dsh-reconnect.zip -DestinationPath .

macOS:

curl -L https://github.com/MistRain-1/dsh-reconnect/archive/refs/heads/main.zip -o dsh-reconnect.zip
unzip dsh-reconnect.zip

Linux:

wget https://github.com/MistRain-1/dsh-reconnect/archive/refs/heads/main.zip -O dsh-reconnect.zip
unzip dsh-reconnect.zip

After downloading, register the package in the DSH Cordis composition:

- insert:
    - id: reconnect
      name: dsh-reconnect

Restart DSH after installing a persistent plugin package.

Runtime Requirements

• Host-side DSH plugin
• timer Service and agent/request-error waterfall event
• No Client-side UI, external network requests, or credential access

中文

项目简介

dsh-reconnect 是一个 DeepSeek Harness (DSH) Host 端插件。模型请求失败时,插件会自动重新发送请求,避免临时网络故障、中转站不稳定或服务端波动导致 Agent 回合中断。

插件监听 DSH 的 agent/request-error 瀑布事件。内置有限重试策略放弃后,Agent 循环会重新发送同一个请求,直到请求成功或用户停止回合。

适用场景

• 不稳定的中转站、反向代理、API 网关或转发服务
• 中转节点偶发断开、重置连接或返回不完整响应
• 网络抖动、传输错误和连接超时
• 模型服务临时不可用、5xx 错误、限流或过载
• 需要长时间运行且不能被短暂故障打断的任务

重试策略

永久性的凭据、配置或上下文错误可能持续重试。遇到无法恢复的错误时,请手动停止当前回合。

退避与停止

• 指数退避: 1s -> 2s -> 4s -> ...,最长等待 60s
• 如果服务端提供 providerRetryAfterMs,优先使用该等待时间,同样封顶 60s
• 记录 Provider、错误码、回合、步骤、重试次数和等待时间
• 写入标准 llm/retry 事件,Harness 会话界面显示连续重试次数、∞、倒计时和错误原因
• 用户停止回合或插件停止后立即停止重试

下载方式

本插件与操作系统无关,可以选择以下任意一种方式下载。

方式一:GitHub 网页下载

1. 打开 https://github.com/MistRain-1/dsh-reconnect。
2. 点击 Code,再点击 Download ZIP。
3. 解压后,将 dsh-reconnect-main 目录作为插件包使用。

方式二:Git 克隆

Windows PowerShell:

git clone https://github.com/MistRain-1/dsh-reconnect.git "$HOME\dsh-reconnect"

macOS:

git clone https://github.com/MistRain-1/dsh-reconnect.git "$HOME/dsh-reconnect"

Linux:

git clone https://github.com/MistRain-1/dsh-reconnect.git "$HOME/dsh-reconnect"

方式三:命令行下载 ZIP

Windows PowerShell:

Invoke-WebRequest -Uri https://github.com/MistRain-1/dsh-reconnect/archive/refs/heads/main.zip -OutFile dsh-reconnect.zip
Expand-Archive -Path dsh-reconnect.zip -DestinationPath .

macOS:

curl -L https://github.com/MistRain-1/dsh-reconnect/archive/refs/heads/main.zip -o dsh-reconnect.zip
unzip dsh-reconnect.zip

Linux:

wget https://github.com/MistRain-1/dsh-reconnect/archive/refs/heads/main.zip -O dsh-reconnect.zip
unzip dsh-reconnect.zip

下载完成后,将插件加入 DSH 的 Cordis 组合:

- insert:
    - id: reconnect
      name: dsh-reconnect

安装持久插件包后需要重启 DSH。

运行要求

• DSH Host 端插件
• 使用 timer Service 和 agent/request-error 瀑布事件
• 无 Client 端 UI,不发起额外外部网络请求,不读取凭据

License

MIT