deepseekplugins

DeepSeek Harness plugin

dsh-client-auto-retry

Auto-resumes interrupted DSH turns: sends a queued 「继续」 after turn/end with error, interrupted or max-tokens reasons, with a grace period, cooldown, a consecutive-attempts cap, boot-time scanning and a settings card; it never switches models or providers.

Sessions & Messages
Jump to install

Source facts

Repository
Frog755/dsh-client-auto-retry
Latest update
Aug 19, 2026
Category
Sessions & Messages
GitHub stars
0

Install

Start with a prompt that asks an agent to read the source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to read the page and repository first.

Do not install anything yet. Read this DeepSeek Harness plugin and explain what it does, which files, networks, or credentials it can access, and how to install and remove it.

Plugin page: https://deepseekplugins.org/plugins/Frog755/dsh-client-auto-retry
GitHub: https://github.com/Frog755/dsh-client-auto-retry
Plugin: dsh-client-auto-retry
Author: Frog755
Install command: dsh plugin --profile web add github:Frog755/dsh-client-auto-retry

Do not run the install command until I confirm.

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@frog755/dsh-client-auto-retry

> DSH 客户端插件：检测到回合被中断 / 出错 / 超长（max-tokens）时，自动发送「继续」重试。 > 只做自动重试，不做模型 / provider 切换。自带设置卡片。

English version: [README-EN.md](./README-EN.md)

<p align="center"> <img src="assets/demo.svg" alt="dsh-client-auto-retry 工作流程" width="720"> </p>

---

它能做什么

DeepSeek Harness（DSH）的回合（turn）偶尔会因为网络抖动、provider 报错、超时、 或输出达到 token 上限而中断。大多数情况下模型其实已经跑完大部分内容，只要再发一句 「继续」就能接着完成，完全不需要人工介入、也不需要切换模型。

这个插件就是干这件事的：

1. 监听会话事件流（api.events.mux）； 2. 发现 turn/end 的 reason.kind 属于 error / interrupted / max-tokens 时， 等一个宽限期（默认 5 秒，给 host 留出重连/恢复的时间）； 3. 宽限期后向该会话自动发送「继续」（可配置文本）； 4. 带冷却期、连续次数上限、启动时扫描最近被中断的会话等防护措施，避免失控循环。

安装

方式 A：通过 npm 安装（推荐）

在 DSH 的 profile 目录（例如 ~/.dsh/profiles/web）里执行：

pnpm add @frog755/dsh-client-auto-retry

然后编辑该目录下的 package.json，把 @frog755/dsh-client-auto-retry 加入 dsh.profile.bundles （插件自带的 cordis.patch.yml 会以 bundle 层的形式把 auto-retry 行插入插件清单）：

{
  "dependencies": {
    "@frog755/dsh-client-auto-retry": "^0.3.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        // ... 其他 bundle ...
        "@frog755/dsh-client-auto-retry"
      ]
    }
  }
}

然后：

pnpm install

重启 DeepSeek Harness（Host 侧插件只在进程内加载一次），再刷新浏览器页面即可。

方式 B：本地 link 开发调试

{
  "dependencies": {
    "@frog755/dsh-client-auto-retry": "link:C:/Users/frog/.dsh/projects/dsh-client-auto-retry"
  }
}

改完 lib/ 下的文件后刷新页面即可（Client 侧即时生效）；Host 侧 lib/index.js 的改动需要重启。

设置项

设置入口：设置 → 通用 → 断联自动重试。所有项都实时生效（applies: "live"）。

字段默认值含义
graceMs5000宽限期：中断后等多少毫秒再自动发送「继续」
cooldownMs20000冷却期：同一会话两次自动继续的最小间隔
maxConsecutive5最多连续自动继续次数，超过后停下等人工介入
continueText继续自动发送的文本内容
scanOnBoottrue页面加载时扫描最近被中断的会话并恢复
freshMs900000扫描窗口：只恢复此时间段内被中断的会话（毫秒）
verbosetrue在浏览器控制台输出 [auto-retry] 调试日志

工作原理

flowchart LR
    A[api.events.mux 事件流] --> B{turn/end?}
    B -- "error / interrupted / max-tokens" --> C[schedule: 宽限期 graceMs]
    B -- "completed / aborted / blocked" --> D[重置连续计数]
    C --> E{冷却期已过? 未超上限?}
    E -- 否 --> F[跳过, 等人工]
    E -- 是 --> G[fire: sessions.prompt 发送「继续」]
    G --> H[连续次数 +1]
    A --> I[user/message 到来] --> D
    A --> J[scanOnBoot: 启动扫描最近中断会话] --> C

核心逻辑都在 lib/client.js 的 AutoRetryRunner 里；lib/index.js（Host 半边） 只负责注册设置 schema。

兼容性说明（重点）

> 📖 详细版见 [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md)（含排查步骤与修改点索引）。

已适配版本

本插件是针对 DSH 0.1.0-rc.7（web 端 profile；desktop runtime 同版本）编写并验证的。 不同版本 / 不同形态的 DSH（桌面端 App、更新或更旧的 rc、社区构建）接口可能不同， 装不上或不生效时请按下表逐个核对。

插件依赖的 DSH API 面

#依赖点rc.7 中的形态其他版本可能的变化
1事件流打开api.events.mux({}, signal) 返回 AsyncIterable<RpcRequest<MuxFrame>>方法名、参数、返回类型
2mux 帧信封帧是 RPC 信封 { rpcId, payload }，真正内容在 payload 里（session/event 等）有的版本直接推裸帧 { type, sessionId, event }；插件已同时兼容两种（见 onMuxFrame）
3回合结束原因turn/end 的 data.reason.kind ∈ { completed, aborted, blocked, error, 'max-tokens', interrupted }枚举名可能增减；TurnEndReasonMap 本身设计为可被插件 merge 扩展
4发送继续api.sessions.prompt({ sessionId, mode: 'queue', content: [{ type: 'text', text }] }) → { result: { ok } }请求/响应结构可能变
5会话列表api.sessions.list({}) → result.value（或 result.data）数组；字段 s.id/s.sessionId、s.updatedAt/s.lastActivityAt字段名可能变（插件已做兼容取值）
6客户端加载格式window.__ModuleLoader__.load({ id, factory })（@deepseek-ai/dsh-client-runtime）桌面端或其他构建可能用不同的模块加载器
7设置 schema（Host）settingsNamespace(NS) + ctx.settings.register(ns, schema, { applies: 'live' })（@deepseek-ai/dsh-settings）注册 API 或 applies 取值可能变
8设置卡片（Client）ctx.slots.inject('settings.general.item') + slots.register(...) + ctx.locale.register(NS, { zh, en }) + ctx.settingsScope.bind({ namespace: NS }) + runtime.defineStore(...)slot id、locale/scope/store API 可能变
9bundle 机制package.json 的 dsh.bundle.patch 指向 cordis.patch.yml，- insert: { id, name } 插入插件行旧版本可能需要在 profile 的 cordis.patch.yml 里手动 insert，或机制完全不同

遇到问题时怎么排查

1. 打开浏览器 DevTools 控制台，看有没有 [auto-retry] 日志；verbose 默认开着。 2. 如果插件行根本没加载：先确认 package.json 里 dsh.profile.bundles 是否包含 dsh-client-auto-retry，并已重启 DSH。 3. 如果加载了但不触发：在控制台手动调用 api.events.mux({}, signal) 观察帧结构， 对照上表第 2、3 条 —— 你的版本帧信封 / reason.kind 枚举可能不同。 4. 如果触发了但发送失败：对照上表第 4、5 条检查 sessions.prompt / sessions.list 的请求响应结构。 5. 如果设置卡片不出现：对照上表第 7、8 条检查 settings / slots 注册方式。

常见坑

  • Host 侧改动需要重启 DSH：Cordis 插件进程内只加载一次，改 lib/index.js 后必须重启，

否则只是刷新页面不会生效。

  • 别把 maxConsecutive 设太大：如果 provider 持续报错，自动重试只会反复烧 token，

建议保持默认 5 次以内，超限后由插件主动停手等你人工介入。

  • scanOnBoot 只扫 freshMs 窗口内的会话：重启很久之后再打开页面不会误触老会话。
  • 不要把插件当错误兜底：它只发「继续」，不做模型/provider 切换；如果需要故障转移，

请在 DSH 的模型路由配置里做。

开发与调试

# 本地起项目（纯 ESM，无构建步骤，改完直接生效）
# Client 侧：刷新页面
# Host 侧：重启 DSH

日志前缀：[auto-retry]。verbose: false 可关闭非关键日志（连接日志仍会输出）。

致谢

本插件的开发与日常调试使用了阿里云百炼的免费模型额度（学生认证赠送 300 元，国内主流模型基本都能用）：

<https://university.aliyun.com/course/promotion27-activity?clubTaskBiz=subTask..12810055..10280..&userCode=hbs5sljx>

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category