dsh-loop-guard

大模型在流式输出里有时会陷入「空转」：reasoning 或正文不断重复同一类短句，正文与工具调用却迟迟不出现。现有机制往往帮不上忙——同名工具重复提醒只看参数、token 上限离得很远、agent-loop 也不做流内重复检测，最后只能靠用户点中断，白白烧时间和 token。

dsh-loop-guard 挂在 llm/stream 这一层，在增量输出上实时刹车。主力是行级塌缩检测：在滑动窗口里统计「有内容」的不同行数，种类过少即判定退化；辅以字符周期重复检测，抓住没有换行的循环；还可选配单次请求的绝对字符上限。命中后可抛出 repetition-loop 错误走既有清理路径，或静默结束流；支持按 provider/model 限定、dryRun 校准与日志落盘。

适合跑长链路 Agent、经第三方网关接 DeepSeek 等模型、或经常在 reasoning-delta 里卡死的运维与插件作者。改动只影响流式水位线，请求间状态独立，禁用即可恢复，并用内置用例与真实会话回放验证低误杀。