跳到主内容

dsh-auto-continue 使用指南

为 DSH Web UI 自动续跑因网络等原因中断的请求,遇到认证失败等永久性错误会跳过并通知。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-auto-continue

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-client-auto-continue

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 错误分类 — 临时性错误(网络 / 超时 / 5xx / 429 等)自动续跑; 永久性错误跳过并通知, 因为重试也没用。判定为永久性的条件: HTTP 状态码 401/403, 或 code/message 命中认证、凭据/API Key、余额/配额、模型不存在、上下文长度/超限等关键词。关闭分类后则全部自动继续
  • 自适应退避 — 连续失败时等待时间递增(冷却 × 系数: 20s → 40s → 80s…), 有上限, 不再对故障上游狂轰滥炸
  • 幂等护栏 — 续跑前检查上一步工具调用: 结果未确认(回合在工具执行中途夭折, 如 git push 可能已经推上去了)时, 续跑消息会提示模型先确认状态、不要重复执行; 工具已确认成功时说明已完成、请勿重复; 工具失败则不加护栏(重试本来就是目的)。两段护栏文本都可配置(支持 {tool} / {result} 占位符)
  • 暂停 — 设置卡片里的全局 暂停自动继续 开关可立即停掉一切(实时 + 扫描); 会话级暂停(如通过通知按钮)只挂起单个会话, 到期自动恢复。唯一的显式例外是通知里的 立即续跑 按钮——按下它等于用户明确要求发送这一次, 不受暂停限制
  • 通知按钮 — 通知带 立即续跑(无视冷却、连续上限与暂停, 马上发送)和 暂停该会话 1 小时 按钮

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件会自动续跑哪些中断?

仅在请求因网络/超时/5xx/429 等临时性原因失败,或达到输出 token 上限时自动续跑;用户主动停止或认证失败等永久性错误会跳过并通知。

多个浏览器标签页同时打开会重复发送吗?

不会。自 0.8.0 起引擎跑在宿主进程内,全局只有一个实例,多标签不可能重复发送;浏览器全关掉也在值守。

需要重启 dsh web 才能生效吗?

安装后首次启用需重启 dsh web;之后通过设置卡片的所有改动即时保存并生效,浏览器侧无需刷新。

怎样手动关闭自动继续?

在设置 → 插件里打开"自动继续"卡片,把全局"暂停自动继续"开关打开即可,也可以单独把某个会话暂停 1 小时。

卸载后留在 ~/.dsh/settings.yaml 的段落需要手动删吗?

可以不删。卸载插件不会清除已写入的配置段落,留在那里是无害的;若想彻底清理,可手动删除 auto-continue 段落。

循环守卫会把用户手动停止的回合也重启吗?

不会。循环守卫会带内部来源标记发起取消,引擎只对守卫发起的取消触发重启,不会与用户手动停止混淆。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: >= 0.1.0-rc.7
  • Node: >= 18(从源码安装需此版本,常规安装无需)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则