dsh-retry-after
在终端中运行以下命令:
dsh plugin install PandaAQI/dsh-retry-after
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install PandaAQI/dsh-retry-after 安装本插件(源码仓库:https://github.com/PandaAQI/dsh-retry-after),安装后重启 profile。
插件介绍
当网关返回 429 时,响应头里的 Retry-After 往往已经明确写了还要等多久,但 DeepSeek Harness 原生的 DeepSeek 通道会把这条信息填进 LlmFailure.providerRetryAfterMs,而经 llm-pi-ai 走的 OpenAI 兼容路线却会在 pi-ai 把错误重抛成纯字符串时丢掉状态与头信息。dsh-llm-retry 拿不到时间提示,只能按默认 500ms 起、指数加抖动的本地退避重试,于是网关要你先等 20 秒,你却在半秒内又打过去,软限流很容易被顶成硬撞墙。
dsh-retry-after 在 fetch 边缘、头信息被丢弃之前就读取响应,把 HTTP 状态、Retry-After(或 Retry-After-Ms)以及据此校正的错误码写回失败对象上 dsh-llm-retry 已经在读的 providerRetryAfterMs 等字段。它不重写重试预算、不另起一套重试循环,只是做翻译;实测里网关要求约 2 秒时,等待会贴近约 2030ms,而不是 500ms 与 1000ms 的本地退避。
可选策略包括对超长 Retry-After 的 clamp、honor、ignore,以及针对无头 429 的 floorMsByCode。适合在 OpenCode、OpenRouter、vLLM、LiteLLM 等经 pi-ai 的路由上频繁遇到限流、希望尊重服务商退避建议的团队;deepseek-official 等已原生填充 providerRetryAfterMs 的路由无需安装。若需不同重试策略或换模型容灾,可分别看 dsh-retry-boost 与 dsh-llm-fallbacks。
使用场景
- 经 llm-pi-ai 调用 OpenRouter、vLLM 等时频繁收到 429
- 网关已返回 Retry-After 但实际重试仍按几百毫秒本地退避
- 希望在不改上游 pi-ai 的前提下让重试间隔贴近服务商要求
适合人员
- 使用 OpenCode / OpenRouter 等兼容 API 的 Harness 用户
- 自建或代理网关且会下发 Retry-After 的团队
- 已启用 dsh-llm-retry 并想减少误判限流的用户