dsh-fail-guard
在终端中运行以下命令:
dsh plugin install FenrirCait/dsh-fail-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install FenrirCait/dsh-fail-guard 安装本插件(源码:https://github.com/FenrirCait/dsh-fail-guard),安装后重启一次即可生效。
插件介绍
Agent 在同一工具上连续失败时,往往不会真正「读规则」,而是在自己的推理里反复做出「再试一次」的决定——参数微调、同样失败、没有新信息,短句和重复动作会迅速堆高。仅靠提示词里的「失败两次就停」在这种状态下常常无效,因为打断必须来自对话外部。
dsh-fail-guard 会在同一工具(或可配置为全局)连续失败达到阈值后,向会话注入一条结构化的停止说明:尝试过什么、完整错误文本、对原因的首轮猜测、以及需要你做什么。目的是让 Agent 转向汇报与协作,而不是用第四种拼写再跑同一条命令。
失败判定覆盖工具返回 isError 与非零 shell 退出码;任意一次成功会清零计数。适合经常跑长会话、Shell 与工具混用的工作流用户,以及希望 Agent 在「卡死循环」时主动停下来请你介入的场景。
使用场景
- 同一 Shell 命令连续非零退出,Agent 仍在换参数重试
- 长会话里某工具连续 isError,推理出现大量重复短句
- 任务已明显卡住,希望 Agent 停下来向你汇报而非继续试错
适合人员
- 在 Harness 中跑多步 Agent 任务的开发者
- 经常混用 Shell 与 MCP/工具的长会话用户
- 希望失败时有结构化停止说明、便于人工介入的配置者