限流自动续跑 haochi72/dsh-auto-continue-429

dsh-auto-continue-429

DeepSeek Harness（DSH）插件：遇到 429 限流 / 配额耗尽自动 continue 恢复对话，20 次连续失败才停，成功一次即清零。

✨ 功能特色

| 能力 | 说明 |
| 🔄 自动 Continue | dsh-llm-retry 的 step 级重试耗尽后，自动发送 continue 开启新 turn |
| 🚦 识别 429 与配额耗尽 | 监听 RATE_LIMIT（429）与 QUOTA（insufficient_quota 等）两类错误码 |
| 🎛 对话框底部开关 | 输入区底部「开/关」滑动开关，点击即切换，无需去设置页 |
| ⚙ 设置页主开关 | 「启用插件」主开关：停用后插件整体失效，对话框不再显示开关按钮（两开关互不联动） |
| 🧮 连续失败计数 | 每会话独立计数：连续失败 20 次只停止该会话，任何一次 turn 正常结束即清零，互不影响 |
| ✋ 手动干预即清零 | 你主动发送任意消息后，所有会话积攒的失败计数全部归零（自动 continue 不算干预） |
| ⏱️ 随机 1~2 秒退避 | 每次 429 后随机等待 1~2 秒发送 continue（不随重试次数增长） |
| 🤫 无计数显示 | 开关条不显示当前失败次数；达到上限该会话自动停止，再发一条消息即清零 |
| 💾 设置持久化 | 开关状态/隐藏状态保存在 ~/.dsh/auto-continue-429.json |

UI 交互示例： ┌─────────────────────────────────────────┐ │ │ │ 对话内容 │ │ │
│ [🟢429] [开] ← 对话框底部开关条 │
│ （设置页停用插件后，此开关条自动隐藏） │ └─────────────────────────────────────────┘

📦 安装

方式 1：已发布到 npm（发布后）

cd ~/.dsh/profiles/web
pnpm add dsh-auto-continue-429

方式 2：从 GitHub 安装

dsh plugin --profile web add github:haochi72/dsh-auto-continue-429

方式 3：本地开发链接

cd ~/.dsh/profiles/web
pnpm link /path/to/dsh-auto-continue-429

然后在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组末尾加上：

"dsh-auto-continue-429"

重启 DSH Desktop 生效。

🚀 使用

1. 确认加载成功

重启 DSH 后在对话框输入区底部，应该出现一个胶囊形的 「429」开关条（绿色=已开启）。

2. 控制开关

| 操作 | 效果 |
| 点击对话框底部的开关条 | 切换快捷开关（quickOn），绿色=开，灰色=关 |
| 设置页 → 429 自动 Continue 卡片 →「启用插件」 | 切换主开关（enabled），与对话框快捷开关互不联动 |
| 在设置页停用插件 | 对话框底部的开关条自动隐藏；重新启用后恢复显示 |
| 设置页 →「连续失败上限」 | 自定义失败多少轮后停止自动 continue（1-100） |

3. 遇到 429 / 配额耗尽时的行为

LLM 返回 429 或配额耗尽(insufficient_quota) ↓ dsh-llm-retry 在当前 step 内重试 2 次（内置） ↓ 重试耗尽 → turn 以 error(RATE_LIMIT / QUOTA) 结束 ↓ ★ 本插件介入 ↓ 等 1~2 秒（随机）→ 发送 "continue" → 新 turn 启动 ✅ ↓ （如果又 429） ↓ 等 1~2 秒（随机）→ 发送 "continue" → …（重复到第 20 次） ↓ 如果某次 turn 正常结束（reason.kind ≠ error）→ 计数归零 🎉 ↓ 连续 20 次全失败 → 停止，等待手动介入

⚙️ 配置（可选）

插件提供以下 Schema 配置项（在 cordis.patch.yml 或 profile 配置中声明）：

- id: auto-continue-429
name: dsh-auto-continue-429
config:
maxRetries: 20 # 连续失败最大次数（默认20） continueMessage: "continue" # 发送的 continue 消息文本

🧩 架构

本插件是 DSH 标准的双端插件（Cordis 驱动）：

dsh-auto-continue-429/
├── package.json # dsh.bundle.patch 声明 + dsh.client 声明 ├── cordis.patch.yml # bundle 层补丁：插入插件行 ├── lib/ │ ├── index.js # 宿主端：错误拦截 + 退避 + continue + HTTP 路由 │ └── client.js # 客户端：对话框底部开关条 + 设置页卡片 ├── LICENSE # MIT └── README.md

宿主端接入点

| 接入点 | 说明 |
| ctx.inject(["webServer"]) | 注册 5 个 HTTP 路由供客户端轮询与控制 |
| ctx.on("session/event", …) | 监听 turn/end，检测 RATE_LIMIT / QUOTA 错误码后调度 continue（全局监听，覆盖所有会话） |
| ctx.agents.get(sessionId).followup(…) | 发送 continue 用户消息 |

客户端接入点

纯 DOM 注入（不依赖 React），通过 HTTP fetch 与宿主端通信：

- 启动时在对话框输入区底部创建「开/关」开关条
- 每 2 秒 GET /api/auto-continue-429/state 同步状态
- POST /toggle-quick 切换对话框快捷开关、POST /toggle 切换设置页主开关、POST /set-max-retries 保存失败上限
- MutationObserver 监听设置页 DOM 自动注入设置卡片；输入区被 SPA 重渲染时自动重新挂载开关条

🔒 权限

- 不访问文件系统：仅 ~/.dsh/auto-continue-429.json 保存开关状态（<1KB）
- 不读取 API Key：完全复用 DSH 内置的 agent/followup 通道
- 不外发任何网络请求：所有 HTTP 路由走 DSH 内置 webServer（localhost 回环）

🐛 调试

宿主端日志（DSH stdout）：

[auto-continue-429] 会话 sess_xxx 连续失败第 3/20 次，2000ms 后自动 continue [auto-continue-429] 已发送 continue 到会话 sess_xxx [auto-continue-429] 已达连续失败上限 20 次，停止自动 continue 设置文件路径：

~/.dsh/auto-continue-429.json
→ {"enabled": true, "quickOn": true, "buttonHidden": false, "maxRetries": 20}

📜 开源协议

MIT © 2026