dsh-fail-guard
当代理在同一工具上连续失败 N 次后，停止代理：推送四部分停止指令，让它进行报告而不是继续尝试。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:FenrirCait/dsh-fail-guard#45549f25b44132faef0c1d8b6b5b06332c6b07cbFail Guard 以 dsh-fail-guard 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Stops the agent when it keeps failing on the same tool: after N consecutive failures it pushes a four-part stop instruction (what it tried / the full error text / the first guess at why / what you need to do) so it reports instead of trying a fourth way to spell the same command.
Repeated short lines in reasoning ("Do it. Do it.") are usually not model degradation — they are the residue of consecutive failure: the same thing fails, the parameters change, it fails again, nothing new comes in, so the same "time to act" decision gets re-made over and over.
Prompt-level rules ("stop after two consecutive failures") do not work in that state — the model is not reading the prompt then, it is reading its own thinking. The interruption has to come from outside.
Measured on a 74-turn session: turns 1–67 kept the share of short single-line fragments between 7% and 48%; the moment a task hit a dozen consecutive failed steps it jumped to 81.6%, then 85.9% / 89.1% / 91.4%.
dsh plugin --profile desktop add dsh-fail-guard
Restart once. cordis.patch.yml is applied through the dsh.bundle manifest — no need to edit your profile config.
Edit it in Plugins → dsh-fail-guard → details. Fields are marked .volatile(): saving takes effect immediately, no restart.
| Key | Default | Meaning |
|---|---|---|
threshold | 2 | Consecutive failures before stopping |
sameToolOnly | true | Count per tool; turn off to share one counter across all tools |
stopText | built in | The instruction pushed into the conversation |
stopSummary | built in | The one-line summary shown in the panel |
debug | false | Write events, counts and trips to a log file |
logFile | <plugin dir>/fail-guard.log | Where debug writes |
Or set it directly in cordis.patch.yml:
- id: dsh-fail-guard
config:
threshold: 3
A tool/result counts if either holds: message.isError === true, or meta.opsShell.exitCode exists and is non-zero. Both are needed — a shell command exiting 1 is not marked isError, and some tool-level errors carry no exit code. Counters are per session and per tool, and any success resets them.
MIT