dsh-llm-quota-retry
在终端中运行以下命令:
dsh plugin install windwhiterain/dsh-llm-quota-retry
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中于包含本仓库检出目录的环境下执行 dsh plugin install windwhiterain/dsh-llm-quota-retry,即可从 https://github.com/windwhiterain/dsh-llm-quota-retry 安装并启用该插件。
插件介绍
在 DeepSeek Harness 里,模型请求因账户额度或余额用尽而失败时,宿主默认的恢复策略会在重试预算耗尽后结束当前轮次,对话就此中断。对长期跑任务、多提供商混用的部署来说,这种「一次用完就停」的体验往往比单次 429 更恼人:你明明还有别的路由或只是等额度刷新,步却已经关了。dsh-llm-quota-retry 正是在常规快速重试都放弃之后接管这一步,让额度类失败有机会在同一次开放步内继续走下去。
插件的核心逻辑分两层。若会话配置了路由池(按名称排序、可互换的提供商/模型列表),且池中仍有路线有余量,会按各路剩余额度比例立即切到可用路线重试;若池中都没有余量,则在同一步内按配置间隔(默认约一小时、次数不限)反复重试,直到成功或用户取消。它默认识别 QUOTA,以及文案表明用量已尽的 AUTH、RATE_LIMIT(含部分按 Token Plan 计量的 429),避免只盯 QUOTA 码而漏掉真实场景。会话还可通过 Composer 芯片或 /quota-retry、/quota-pool 单独开关额度重试与指定池;未显式设池时,若当前模型恰好只属于某一个池,也会按该池规则自动 failover。
与 @deepseek-ai/dsh-llm-retry 搭配时,本插件应排在后者之后:先由基础策略消耗有限次快速重试,额度失败再落到本插件的长等待或换路。对 nativeRetryFirstProviders 中列出的提供商,还会在标记「额度用尽」和换路之前,先跑一轮与原生策略一致的短时退避,区分「真没额度」和「几秒就能恢复的限流」,避免误等一小时。除额度耗尽且开关打开的情形外,其它错误(密钥无效、普通限流、超时、上下文溢出等)一律原样交给既有处理,不拖慢失败路径。
适合在多提供商、多模型路由、按余额脚本或提供商自报耗尽来管理额度的团队使用;也适合希望 Agent 在单步内自动换路或耐心等待额度恢复、而不是立刻结束回合的运维与开发者。若你几乎只用单一固定模型、从不配置路由池,价值会小一些,但在混用与池化部署里,它往往是让长任务「熬过额度空窗」的关键一层。
使用场景
- 多提供商混用时某一账户额度用尽,希望自动切到池中仍有余量的模型
- 长任务需要在同一步内按间隔等待额度恢复,而不是立刻结束回合
- 常规 llm-retry 预算耗尽后仍要处理 QUOTA 或文案表明用量已尽的失败
适合人员
- 配置多模型路由池与余额脚本的 Harness 部署维护者
- 需要 Agent 在额度空窗期自动换路或耐心等待的开发者
- 与 dsh-llm-retry 组合使用、管理会话级额度重试开关的团队