dsh-fail-guard
Verifieddsh-fail-guard · v0.2.1 · MIT · Web UI
Stop the agent when it keeps failing: after N consecutive failures on the same tool, push a four-part stop instruction so it reports instead of trying again.
Install
dsh plugin add dsh-fail-guard Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
dsh-fail-guard
English | 中文
同一工具连续失败 N 次之后叫停,推一条四段式停手指令(试过什么 / 完整错误原文 / 初判原因 / 需要用户做什么),让它来报告,而不是再试第四种命令写法。
为什么需要外部打断
思考里的复读(「做。做。做。」)一般不是模型退化,是连续试错留下的:同一件事失败、换参数、再失败,没有新信息,同一个「该动手了」被反复重下。
提示词层的规则(「连续失败两次就停手」)在这种状态下无效——那时候模型读的不是提示词,是它自己的 thinking。 所以打断必须来自外部。
实测依据:一份 74 轮的会话里,前 67 轮短句行占比在 7–48% 波动,从连续十几步失败那一刻断崖跳到 81.6%,之后 85.9% / 89.1% / 91.4%。
安装
dsh plugin --profile desktop add dsh-fail-guard
重启一次。cordis.patch.yml 通过 dsh.bundle manifest 自动应用,不用手写 profile 配置。
配置
在 插件 → dsh-fail-guard → 详情 里改。字段标了 .volatile(),保存即生效,不用重启。
| 键 | 默认 | 含义 |
|---|---|---|
threshold |
2 |
连续失败几次后叫停 |
sameToolOnly |
true |
按工具分别计数;关掉则所有工具共用一个计数 |
stopText |
内置 | 推给模型的那条指令 |
stopSummary |
内置 | 界面上显示的一行摘要 |
debug |
false |
把事件、计数、叫停写进日志文件 |
logFile |
<插件目录>/fail-guard.log |
日志路径 |
也可以直接写 cordis.patch.yml:
- id: dsh-fail-guard
config:
threshold: 3
判定
一条 tool/result 满足任一条件就算失败:message.isError === true,或 meta.opsShell.exitCode 存在且非零。两条都要看——退出码为 1 的 shell 命令不会被标 isError,而有些工具级错误不带退出码。计数按「会话 + 工具」分组,任何一次成功都清零。
边界
- 不中止刚失败的那次调用(已经发生了)
- 不判断「算不算真失败」,任何非零退出都算
- 不重置对话,停手指令只是多一条用户消息
- 不是限流器:叫停后继续失败会重新计数,再达阈值会再叫停一次
许可证
MIT