dsh-reasoning-loop-guard

在 DeepSeek Harness 里跑带思维链的模型时，一种很折磨人的故障是推理复读：工程判断其实已经做完，模型却卡在准备落笔的阶段，在 reasoning 里反复催促自己，既不产出 text，也不发起 tool-call。用户只能盯着进度空等几分钟、烧掉几十万字符，最后手动点停止，而宿主当时往往没有任何机制能提前发现。

dsh-reasoning-loop-guard 挂在 llm/stream 瀑布钩子上，只测量流式推理文本 reasoning-delta，在滚动窗口上按节奏评估五条判据：周期重复、等距块重复、散文行重复、k-gram 与末尾装饰字符兜底。任一判据命中即停止向上游拉取，并以可见错误结束本步，而不是让整条 assistant 消息以空 stopReason 和巨型 reasoning 块静默收场。README 记录的 11 次真实退化样本均在万字符量级内被拦住；在更大规模的本机推理流语料上，触发次数极少且对应真循环。

插件提供可覆盖的阈值与开关、触发日志与只读维护工具 reasoning_loop_log，还可选配 Web 角落提示、历史思维链剥离、按档位回写 reasoningEffort 与有限次自动恢复。failureCode 默认带命名空间，刻意避开通用可重试码，避免与其它插件的循环恢复逻辑串台。

适合日常在 DSH 桌面版或网页版做长会话、多步 Agent 推理的用户：一旦你也遇到过模型明明在想却永远不写结果的卡顿，这个护栏能把损失从几分钟缩到一次明确的报错，并留下可复盘的触发记录。