dsh-failbook：DeepSeek Harness 的失败账本插件，自动聚类并拦截重试

它是做什么的？

dsh-failbook 是 DeepSeek Harness（DSH）的失败账本插件，自动记录每次工具调用失败并按失败原因聚类，跨会话持久化，在同类错误反复出现时拦截 Agent 的重试。它解决 Agent 反复重试同一错误、浪费 token 和时间的痛点，让 Agent 越用越少犯错。核心能力包括失败签名聚类、失败感知重试拦截、Web UI 面板和静音排除，零配置开箱即用，由 G1en-114 维护，采用 MIT 协议。

核心功能

• 自动记录失败：挂钩 tools/post-execute，捕获结构化错误、非零退出码、沙箱拒绝和常见错误文本。
• 签名聚类：同一失败原因（如 bash:command-not-found）自动归为一桶，不因参数不同而散落。
• 跨会话持久化：通过官方 ctx.storageDomain 存储，重启不丢；无该服务时自动降级为内存账本。
• 失败感知重试拦截：同一签名近窗口内失败 ≥N 次（默认 2 次）时注入建议性提醒，附失败原因和改法建议。
• Web UI 面板：设置页展示 Top 失败签名表、次数/近窗口/最近时间，支持静音、单删/清空。
• 静音与排除：误报桶一键静音，excludeTools/patterns 精细控制。

怎么使用这个插件？

在 DSH 中启用后，插件自动挂钩工具执行，无需额外操作。当同一失败签名在近窗口内重复出现达到阈值时，插件会向模型注入提醒，建议停止重试并给出改法。可在设置面板查看失败账本，调整 retryGuardThreshold、reminderCooldownSec、reminderLocale 等配置项，或通过静音和排除规则减少误报。