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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则