断线重连 mrbeandev/dsh-reconnect

dsh-reconnect

为 DeepSeek Harness 提供安全的模型请求重试，支持指数退避、中继/代理恢复，以及集成的设置面板。

- 源代码： github.com/mrbeandev/dsh-reconnect
- npm 包： npmjs.com/package/dsh-reconnect

概述

dsh-reconnect 会重试可恢复的模型请求，使临时的网络、网关或提供商故障不会中断智能体回合或长时间运行的任务。

该插件监听 DSH 的 agent/request-error 瀑布流。在内置的 normal Provider 重试策略耗尽后，或者当 always 策略将恢复委托给下游时，ReConnect 会使用自己的策略重新提交相同的模型请求。

重试策略

| 条件 | 行为 |
| EMPTY_RESPONSE、RATE_LIMIT、SERVER、STREAM_CLOSED、TIMEOUT、TRANSPORT | 无限重试 |
| 模型缺失或未配置 | 在配置恢复期间无限重试 |
| QUOTA | 默认不重试；通过 retryQuota 启用 |
| 未知错误，例如 PI_AI_ERROR | 默认无限重试；禁用 retryUnknown 以应用限制 |
| 工具、参数、身份验证、凭据、上下文溢出和已中止错误 | 不重试 |

tool/result 中的工具执行失败不在此插件的重试范围内。ReConnect 使用来自 agent/request-error 的机器可读失败代码；它不会根据任意工具输出推断模型失败。

退避与取消

- 指数退避：1s → 2s → 4s → …，默认上限为 60s
- 遵循正的 Provider Retry-After 值，作为无上限的最小等待时间
- 发出标准的 llm/retry 和 llm/retry-started 会话事件
- 在 Harness 对话 UI 中显示重试次数和倒计时
- 当回合中止或插件卸载时立即停止
- 在热重载和关闭期间安全地排空待处理的等待

设置面板

打开 设置 → 插件 → 插件配置 → ReConnect 自动重试。

- 最大重试延迟：1、2、5、10、30、60 或 120 秒，或自定义值
- 重试配额错误：默认禁用
- 无限重试未知错误：默认启用
- 最大未知错误重试次数：默认为 3，仅在禁用无限未知重试时适用

设置更改会立即生效。

配置

- insert:
- id: reconnect
name: dsh-reconnect
config:
maxDelayMs: 15000
retryQuota: false
retryUnknown: true
unknownMaxRetries: 3

| 设置 | 类型 | 默认值 | 描述 |
| maxDelayMs | integer | 60000 | 本地指数退避的最大延迟，以毫秒为单位 |
| retryQuota | boolean | false | 无限重试配额或余额耗尽错误 |
| retryUnknown | boolean | true | 无限重试未知错误代码 |
| unknownMaxRetries | integer | 3 | 当 retryUnknown 被禁用时的连续未知错误上限 |

maxDelayMs 仅限制本地指数退避延迟。它不会限制 Provider 的 Retry-After 值或总重试时长。

安装

npm（推荐）

在 DSH web 配置文件中安装并激活该包：

dsh plugin --profile web add dsh-reconnect

然后重启正在运行的 DSH web 进程。打开 Settings → Plugins → Plugin configuration → ReConnect automatic retry 以确认该插件及其设置卡片已激活。

dsh plugin 命令会转发到配置文件包管理器。由于该包声明了 dsh.bundle 补丁，DSH 还会将其添加到所选配置文件的激活 bundle 列表中；无需手动编辑 cordis.yml。

稍后更新或移除它：

dsh plugin --profile web update dsh-reconnect
dsh plugin --profile web remove dsh-reconnect

GitHub

dsh plugin --profile web add github:mrbeandev/dsh-reconnect

固定到确切的 release 或 commit 以实现可复现的安装：

dsh plugin --profile web add github:mrbeandev/dsh-reconnect#v2.0.0

本地检出

git clone https://github.com/mrbeandev/dsh-reconnect.git
dsh plugin --profile web add ./dsh-reconnect

DSH 插件管理器会自动将声明了 dsh.bundle 的包添加到所选配置文件。安装插件后重启 DSH。

要求

- 带有 Host settings 服务的 DeepSeek Harness
- Node.js ^22.19.0 或 >=24.0.0
- 用于可视化设置卡片的 Web 配置文件

客户端设置卡片从不读取凭据。

开发

npm test
npm pack --dry-run

发布时会通过 prepublishOnly 运行测试套件。

致谢

英文版基于 MIT 许可的 MistRain-1/dsh-reconnect 项目。原始版权声明保留在 LICENSE 中。

许可证

MIT