Windsland52/dsh-auto-retry

dsh-auto-retry

DSH 的有界后备恢复插件。它不会替换官方 @deepseek-ai/dsh-llm-retry，而是在官方提供方策略不再重试后接手。

它解决的是一类容易混淆的问题：中转方把可恢复的瞬时 429 标成 QUOTA，或者模型请求“正常结束”但没有可见输出。插件只在有明确证据时接手，并把重试次数、总等待时间和自动续行次数全部限制在配置预算内。

安装

从 GitHub 安装到 Web profile：

dsh plugin --profile web add "github:Windsland52/dsh-auto-retry#main"

安装器会把包含 dsh.bundle.patch 的依赖加入 profile bundle。GitHub 安装会通过包的 prepare 脚本构建 lib/；如果 pnpm 提示阻止构建脚本，按提示把该包加入 profile 的 pnpm-workspace.yaml allowBuilds 后重新执行安装。

安装后重启 DSH。配置写在 profile 自己的 cordis.patch.yml，不要直接修改 node_modules 里的 bundle 文件。

默认行为

- 额外重试 RATE_LIMIT、HTTP 429、EMPTY_RESPONSE、STREAM_CLOSED。
- 中转方把瞬时 429 误标成 QUOTA 时，只在错误详情包含 rate_limit_exceeded、rate limit、allocated quota exceeded 等特征时重试；真正的余额/credits 耗尽不会重试。
- 最多额外重试 8 次，总等待时间不超过 15 分钟。
- 优先使用提供方的 Retry-After，否则使用带抖动的指数退避（1.5 秒至 60 秒）。
- 正常结束但没有可见文本/工具调用时，自动续行。
- max-tokens 截断时自动续行。
- 每个 turn 最多自动续行 2 次，避免空响应死循环。
- AUTH、QUOTA、上下文超限、无效请求和用户取消不会被默认重试。

配置

- id: dsh-auto-retry
name: '@dsh-external/dsh-auto-retry'
config:
空数组表示所有 provider；也可以只写 [scnet]
providers: []
retryCodes:
- RATE_LIMIT
- EMPTY_RESPONSE
- STREAM_CLOSED
retryQuota: true
quotaRetryPatterns:
- rate_limit_exceeded
- rate limit
- too many requests
- allocated quota exceeded
- temporarily unavailable
maxRetries: 8
maxElapsedMs: 900000
initialDelayMs: 1500
maxDelayMs: 60000
jitterRatio: 0.2
maxAutoContinuations: 2
continueOnMaxTokens: true

每次后备重试都会复用 DSH 已有的 llm/retry 和 llm/retry-started 持久事件，因此会话重放和现有重试状态 UI 仍能理解它。内部自动续行使用 plugin 来源的 user message，不会伪装成人类输入。

和其他插件的边界

| 插件 | 主要职责 | 是否覆盖本插件的核心场景 |
| --- | --- | --- |
| 官方 @deepseek-ai/dsh-llm-retry | provider 自己声明的请求错误重试策略 | 它先处理；本插件只在它放弃后接手 |
| dsh-llm-bounded-retry | 对结构化 LLM 请求错误统一做有界重试 | 不处理静默成功响应、max-tokens 续行或 relay QUOTA 识别；不要和本插件同时接管同一 profile 的请求重试 |
| dsh-retry-override | 覆盖指定 provider 的 retry policy | 不处理输出续行；适合需要按 provider 改策略的用户 |
| dsh-client-auto-retry | Web 客户端监听 turn/end 后发送“继续” | 和本插件的 max-tokens/错误续行有重叠，不建议同时启用 |
| dsh-autofix | 工具调用错误的单次恢复动作 | 不处理模型请求或模型输出 |

本插件的定位是 Host 侧、provider-aware 的后备恢复：保留官方重试优先级，专门补齐中转方瞬时限流误报、空可见输出和输出截断这三个缺口，而不是再提供一个无限重试器。

兼容性

- 已针对 DSH 0.1.0-rc.7 的 Web profile 验证。
- 插件不切换模型或 provider，不修改请求内容，也不把自动续行伪装成人类消息。
- 同一个 profile 只应有一个插件负责 agent/request-error 的全局重试预算；需要使用其他重试策略时，应按 provider 划分责任范围。

GitHub 发布

发布仓库后建议添加 dsh GitHub topic，方便社区目录发现。当前 package 保留了 private: true，表示只支持 GitHub 源码安装；如果以后要发布到 npm，需要删除该字段并改用正式的 npm 发布流程。

开发

npm install
npm test
npm pack --dry-run