前言¶

在 DeepSeek Harness（DSH）里跑智能体时，模型偶尔会进入「塌缩」：输出从正常推理退化成短句刷屏，例如「好。写。发。」循环，或固定动作词绕圈。若只是中途停掉，半截内容仍可能以 assistant/message 进入可见历史，下一轮会继续照着垃圾写。

dsh-collapse-guard（npm 包名 doudou-collapse-guard，仓库 otonemame/dsh-collapse-guard）挂在 llm/stream 瀑布上监听 chunk，发现重复塌缩后断流，并以 finish(error) 结束本步，使本步只写 assistant/attempt，不产生带 surface 的 assistant/message。下文介绍其定位、断流方式、安装与配置。

这是什么¶

维护者 otonemame，分类为模型推理，许可证 MIT（package.json 版本 0.1.0）。

一句话：在 LLM 流式输出中扫描近期行与滚动原文，命中塌缩规则时中止流，并以 provider 失败（failure.code = STREAM_COLLAPSE）收场，让垃圾不进入模型可见历史。

兼容性要求：dsh >= 0.2.1，node >= 20。README 说明对 dsh 0.3 的破坏性变更未在声明中锁定，升级到 0.3 后建议先查看 fires.jsonl 是否正常记录。

为什么要用 finish(error)¶

不是所有断法效果相同：

本插件采用第三种；STREAM_COLLAPSE 刻意不在 dsh-llm-retry 默认重试集里（默认仅 EMPTY_RESPONSE / RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT），因为塌缩与当前请求属性相关，重试等于整段 prompt 再跑一遍。

核心功能¶

监听与硬上限¶

• 挂在 llm/stream 上包住上游 chunk 流，扫最近一百多行（默认主窗 128 行），发现退化成重复碎念则断流并补 terminal finish(error)。
• README 称一次可截断二十余万字符级别的垃圾吞吐（hardChars 默认 200000）。
• 围栏（``）内内容不参与判定；超过skipLineChars`（默认 2000）的长行跳过且不清窗。

六种塌缩形态（规则码）¶

段落复读另用 4096 字符滚动原文，找连着重复三遍的周期串（段长 8–400 字），每增 48 字符扫一次；不换行的重复也走此路径。

形态随上下文变化：塌缩往往在复制上下文里高频出现的句式，规则表是「目前见过的六种」，新形状需增补规则。插件管得住一直吐到爆，管不住本不该塌的生成——README 建议从参数侧降低 reasoning_effort 等。

命中后的界面表现¶

界面大致提示：

模型推理通道进入重复塌缩（尾窗只剩 3 种短句，「发。」出现了 42 次，已读到 4403 字符），守卫掐断了本次流。

本轮结束，不会自动重试；再发一句即可继续。

安装与启用¶

官方安装命令（来自 README）：

plugin_manager install_bundle target="github:otonemame/dsh-collapse-guard"

也可在 cordis.patch.yml 里手动插入类似 dsh-mcp-client 的条目，name 写 doudou-collapse-guard。

本地开发时包挂在 @local/doudou-collapse-guard，装时认 npm 包名，搜仓库认 dsh-collapse-guard。

注意：插件在当前 dsh 进程权限下运行；安装前请自行查看 GitHub 源码 与 MIT 许可证。DSH 社区插件目录（SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系。

关闭方式¶

任选其一，下一请求即生效（空文件方式无需重启 DSH）：

1. 创建空文件：~/.dsh/doudou-collapse-guard/off
2. 环境变量：DOUDOU_COLLAPSE_GUARD_OFF=1
3. 在 DSH 设置中关闭该插件

典型配置¶

配置优先级：默认值 → cordis.patch.yml 的 config → 环境变量 DOUDOU_COLLAPSE_GUARD_CONFIG（JSON）。

常用键（节选，默认见 README）：

例：只监控推理通道：

DOUDOU_COLLAPSE_GUARD_CONFIG={"watch":["reasoning-delta"]}

交接记录¶

每次触发写一行 JSONL：$DSH_HOME/doudou-collapse-guard/fires.jsonl（未设 DSH_HOME 则为 ~/.dsh），超过 512 KB 自动轮转为 .1。行内包含时间、规则码、通道、阈值快照、sessionId、model 等，便于事后回校判据。

已知边界¶

• 段落复读日志里长行可能显示为 <长行> 占位符。
• 只读流，不改判据外内容，不碰历史与会话文件。

结尾¶

dsh-collapse-guard 面向 DSH 下长流式推理的塌缩止血：用六种（加硬上限）规则识别重复短句与段落复读，以 STREAM_COLLAPSE 失败结束本步，避免半截垃圾进入可见历史。适合已遇到刷屏塌缩、且希望与 dsh-llm-retry 默认策略区分的开发者。

• 目录页：https://www.skillhub.cn/plugins/otonemame/dsh-collapse-guard
• 仓库：https://github.com/otonemame/dsh-collapse-guard