dsh-auto-continue

DeepSeek Harness（DSH）自动续跑插件 —— 遇到 429 限流、配额耗尽或空响应时，插件等待片刻后自动替你发送 continue，让长任务扛过一次 429 而不是直接中断。它会一直重试到该轮成功，或达到你设定的连续失败上限；任何一轮正常结束都会把计数清零。

English →

📦 安装

环境要求： Node ≥ 20 · DSH ≥ 0.2.0-rc.2

# 1. 把插件装进你的 DSH profile
dsh plugin --profile web add dsh-auto-continue

# 2. 重启 DSH（浏览器端在启动时加载）
# 3. 打开侧边栏  设置 → Auto-Continue  即可配置

就这么多 —— 快捷开关会立刻出现在输入区底部，插件已按默认值开始工作。连续失败上限可设为 1–100（默认 20），如果服务商返回了不常见的错误码，也可以自己加进列表。

# 从本地 checkout 安装（可编辑）
git clone https://github.com/spix18/dsh-auto-continue
dsh plugin --profile web add "file:$PWD/dsh-auto-continue"

# 装到 headless profile
dsh plugin --profile headless add dsh-auto-continue

# 跑验证脚本（56 条断言，覆盖两端，不需要启动 DSH）
node test/run.mjs

如果是从 checkout 安装的，改完代码后重新执行 dsh plugin --profile web add "file:$PWD/dsh-auto-continue"，然后重启 DSH。

✨ 功能特色

| | | |---|---| | 🔄 Turn 级自动续跑 | 在 dsh-llm 自身的 step 级重试耗尽之后介入 —— 已经失败的那一轮的最后一道防线 | | 🚦 认得真正的失败类别 | RATE_LIMIT（429）、QUOTA、ACCOUNT_QUOTA、EMPTY_RESPONSE 为内置，始终启用 | | ➕ 自定义错误码 | 在设置页添加任意错误码；采用递归搜索，藏在错误 cause 里的服务商报文也能命中 | | 🎛 输入区快捷开关 | 输入框底部的一枚胶囊按钮，点一下即可开关，不用离开对话 | | ⚙️ 独立设置页 | 侧边栏「设置 → Auto-Continue」；走 DSH 官方 slot API 渲染，不再抓取 DOM | | 🧮 每会话独立计数 | 某个会话连续失败到上限就自己停下，不影响其它会话；任何一轮成功即清零 | | ✋ 手动发消息即清零 | 你自己发一条消息，所有计数归零（自动 continue 不算干预） | | ⏱️ 随机 1–2 秒退避 | 刻意不随次数增长：用来熬过滑动的限流窗口，而不是越退越远 | | 💾 设置持久化 | 保存在 ~/.dsh/dsh-auto-continue.json |

🚀 工作流程

LLM 返回 429 / 配额耗尽 / 空响应
  ↓
dsh-llm 在当前 step 内自己重试（内置：5 次，500ms → 10s 退避）
  ↓
重试耗尽 → 该轮以  reason.kind === 'error'  或  'max-tokens'  结束
  ↓
★ 本插件介入
  ↓
随机等待 1~2 秒 → 发送 "continue" → 新的一轮启动 ✅
  ↓
……如果又失败，重复上述过程，直到连续失败上限
  ↓
任何一轮正常结束 → 计数归零 🎉
  ↓
达到上限 → 停止，等待你手动介入

内置错误码是精确匹配 LlmFailure.code 的 —— DSH 的官方约定是「按 code 路由，永远不要解析 message」。 你自己添加的错误码则会在整个递归错误里搜索，因此再奇怪的报文也能被捕获。

SERVER、TIMEOUT、TRANSPORT 刻意不做内置：dsh-llm 已经在 step 内重试过它们了， 在这之上再续跑一轮等于重复叠加。

⚙️ 设置页

打开 设置 → Auto-Continue。

| 控件 | 作用 | |---|---| | Enable plugin | 主开关。关闭后隐藏输入区胶囊按钮，并停止一切自动续跑 | | Show the quick switch in the composer | 只隐藏胶囊按钮，自动续跑照常工作 | | Consecutive failure limit | 1–100（默认 20）。任何一轮成功都会把计数清零 | | Additional auto-continue error codes | 逗号或换行分隔；多词的服务商报文会整条保留，不会被拆散 |

🧩 配置（可选）

在 cordis.patch.yml 或 profile 配置中声明覆盖项：

- id: auto-continue
  name: dsh-auto-continue
  config:
    maxRetries: 20                 # 连续失败多少次后放弃
    continueMessage: "continue"    # 续跑时发送的文本
    errorCodes: ["invalid_request_error"]

🏗 架构

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

dsh-auto-continue/
├── package.json          # dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml      # bundle 层补丁：插入插件行
├── lib/
│   ├── index.js          # 宿主端：错误拦截、退避、continue、HTTP 路由
│   └── client.js         # 浏览器端：输入区开关 + 设置分区（React，走 slots）
├── test/run.mjs          # 验证脚本（56 条断言，覆盖两端）
├── LICENSE               # MIT
└── README.md

宿主端（lib/index.js）

| 接入点 | 用途 | |---|---| | ctx.inject(["webServer"]) | 在 /api/dsh-auto-continue/* 下注册 6 个 HTTP 路由供浏览器端使用 | | ctx.on("session/event", …) | 监听 turn/end，发现可重试原因后调度 continue | | ctx.agents.get(id).followup(…) | 发送 continue 用户消息 |

浏览器端（lib/client.js）—— 通过 DSH 官方 slot API（@deepseek-ai/dsh-client-ui-slots） 注册 React 组件，不再抓取 CSS-module 哈希：

• conversation.input.left → 输入工具行左侧的快捷开关胶囊
• settings.section → 「设置 → Auto-Continue」页面
• 每 2 秒轮询 GET /api/dsh-auto-continue/state，标签页隐藏时自动暂停
• 每处注册都包了保护，单点失败不会让整个 slot 变空
• 两处都是 kind: 'list' 槽位，插件不可能挤掉核心插件自己的条目 —— 见 槽位安全

🧩 槽位安全

DSH 的 slot 分类型。list 槽位以 id 为键，任意数量的插件都能投稿；single 槽位只能有一个条目 —— 而拥有它的核心插件会在自己 apply 的末尾占用这个条目。第二个注册会抛 single slot "<name>" already has a registration。

这个异常抛在拥有者自己的 apply 里。所以冲突不只是新来的那个失败：它会杀掉核心插件的 fiber，以及所有等待该插件所提供服务的插件。

v0.4.2 占用了 conversation.composer.bar（kind: 'single'，由 @deepseek-ai/dsh-client-ui-conversation 占用）。web boot 时该插件失败，uiConversation 服务始终不出现，7 个依赖它的插件一起挂掉：

web boot: 8 entries did not activate
@deepseek-ai/dsh-client-ui-conversation: failed
@deepseek-ai/dsh-client-ui-chat: pending (waiting for service: uiConversation)
… 另有 6 个

v0.4.3 把开关移到了 list 槽位，崩溃就此修复 —— 但选的是 conversation.input.dock，官方注释为「输入卡片上方的整行条目」。24px 的胶囊放进一个为整行条目准备的容器里，会被 align-items: stretch 拉满整行 —— 当时看到的就是这个样子。

v0.4.4 把它移到 conversation.input.left —— 「输入工具行左侧的紧凑控件」，这才是这个控件本来的形状。测试套件现在会记录本插件触碰的每个槽位官方注释所述的形状，冲突和形状错配都不会再回来。

🔒 权限

• 除设置外不碰文件系统 —— 只写 ~/.dsh/dsh-auto-continue.json（< 1 KB）
• 不读取你的 API Key —— 完全复用 DSH 自己的 agent / followup 通道
• 不外发任何网络请求 —— 所有 HTTP 路由走 DSH 内置 webServer（仅本机回环）

从旧的 dsh-auto-continue-429 升级？插件会读取一次 ~/.dsh/auto-continue-429.json， 把你原有的失败上限与错误码列表迁移到新文件，不会丢配置。

🐛 调试

宿主端日志（DSH stdout）：

[Auto-Continue] Session sess_xxx failure 3/20, sending continue in 1862ms
[Auto-Continue] Sent continue to session sess_xxx
[Auto-Continue] Consecutive failure limit of 20 reached, stopping automatic continue

设置文件：

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

☕ 支持

如果这个插件对你有帮助，欢迎在 ko-fi.com/spix18 请我喝杯咖啡。

📜 开源协议

MIT © 2026