Dis2017/dsh-run-guard

README excerpt

🛡️ dsh-run-guard DeepSeek Harness 插件 · Agent 运行节奏守护 — 一体两面,让 LLM 在长任务中既不会「推理死循环停不下来」,也不会「想完就停不干活」。 ✨ 功能特性 能力 方向 说明 guard(刹车) 拦截推理死循环 监听 llm/stream 流,滑动窗口重复率检测 + 硬性上限双保险,死循环在 1 2 秒内被中断 (而非空转数分钟),并给出中文原因提示 continue(油门) 防止提前停摆 turn 正常结束后自动续跑:有未完成 todo 时注入状态续跑;无 todo 但模型「想完就停」(最后只有推理、无正文无工具调用)时注入简洁提示续跑 pause work 暂停 人工控制 模型可随时调用 pause work 工具主动暂停,两路都不会再自动继续 核心设计 :刹车与油门共用一套状态感知,互不干扰——guard 中断的 turn 以 error 结束,continue 天然不会误推;continue 推进的新 turn 若再次死循环,guard 立刻拦截。闭环自洽。 🎯 为什么需要它 DeepSeek V4 Flash 配合 reasoningEffort: max 在长任务中会出现两种典型异常: 1. 想完就停 :模型输出完整思考后直接正常结束 turn,没有正文、没有工具调用,留下未完成的任务——表现为「不干活」。 2. 推理死循环 :模型推理进入重复空转(实测单步可输出 10.9 万块、132 万字符垃圾推理),持续数分钟不停——表现为「停不下来」。 DeepSeek Harness 的 agent loop 本身对这两种异常都没有调控机制。本插件在两端补齐: guard 保证它不会无限干活,continue 保证它不会不干活 。 🧠 工作原理 扩展点 用途 llm/stream (waterfall) guard:包装每次模型调用,拦截 reasoning 死循环 session/event continue:跟踪 turn 生命周期、todo 状态、产出判定 systemPrompt.context continue:预防层——有未完成 todo 时注入状态与引导 tools.register continue:注册 pause work 暂停工具 🚀 快速开始 安装(GitHub 发布版,推荐) dsh plugin add 检测到包内 dsh.bundle 声明后自动挂载:追加进 profile 的 bundles 列表,插件行由 bundle patch 提供。 验证 1. 重启 GUI 2. 打开 设置 → 插件 → Plugin list ,确认 dsh-run-guard 为 Mounted / Enabled 3. 正常使用:死循环会被 1 2 秒内中断并显示原因;「想完就…

Category