@max-null/dsh-allostasis 0.2.0 → 0.3.0

package/README.md

@@ -7,7 +7,9 @@ This plugin belongs to the **`@max-null/*` family** — a set of plugins that to
 Allostasis for the DeepSeek Harness — session self-regulation rather than monitoring.
 Before each step it reads the most recent reasoning block and appends one near-end message
 when that thinking has drifted into English (**Chinese anchoring**) or collapsed into
-repetition (**degeneration reminder**).
+repetition (**degeneration reminder**). When a turn ends with no visible output at all
+(**silent turn**), it records the verdict in the session log and the browser half shows a
+notice beneath that turn.
 
 ## 它做什么
 
@@ -17,23 +19,27 @@ repetition (**degeneration reminder**).
 |---|---|---|
 | **中文锚定** | **已实现** | 上一步思考的英文功能词密度越线 |
 | **推理退化提醒** | **已实现** | 上一步思考的重复率越线，且连续 N 步成立 |
+| **空回合提示** | **已实现** | 回合收尾时末条助手消息没有非空文本（只在 `completed` 回合上判） |
 | 上下文占用感知 | 计划中 | 需先定「什么情况下才出现」（持续在场会退化成背景音） |
 | 压缩预约落盘 | 计划中 | 待通路验证：退化样本散布在整段退化区间，「只压一小段」能否打断循环尚无证据（二期方案 §八.1） |
 
-两类提醒都以 `notice` 形式注入——在**轨迹页**是折叠态就显示一行摘要的注入行，不弹窗、不打断；
+前两类提醒以 `notice` 形式注入——在**轨迹页**是折叠态就显示一行摘要的注入行，不弹窗、不打断；
 **对话页不显示**（2026-09-29 在 SSiD dev / DSH 0.2.0-rc.1 上实测，口径见二期方案 §九）。
-退化触发时还会 append 一条 `allostasis/degeneration` 事件，记下当时的重复率、阈值与连续步数，
-因此「插件当时判了什么、用的什么阈值」可事后重建。
 
-**它全程静默，所以「确认它在工作」只能靠日志。** 本插件没有任何界面元素，命中时也只在轨迹页留一行；不命中时一个字都不说——「装了没有」「阈值生效没有」「这一步为什么没提醒」三个问题原本都无从回答，只能靠改配置去试。因此它在 `src/index.ts` 的 `apply` 里留两行痕：
+**空回合提示是三者里唯一有界面的一个**，就挂在那一段空白下面（见「截图」段）。它不发消息、不改模型输入——
+浏览器半边从 `turn/start` / `assistant/message` / `turn/end` 自己折叠出判定，投影成 Turn 尾部的一行提示。
+
+**判定结果不写会话日志。** 内核的事件词汇表在构建期生成，下游插件的自定义类型不在其中，而 `Session.append()` 没有 `ignorable` 标记通道；无标记的自定义事件会让**整份**日志在下次加载时被拒读。判定输入本来就可重放，留痕由 `console.debug` 诊断行与界面上那行提示承担。理由与取证见 `docs/设计/2026-09-30-空回合检测与可见化.md` §十一。
+
+**除空回合外全程静默，所以「确认它在工作」只能靠日志。** 前两类命中时只在轨迹页留一行；不命中时一个字都不说——「装了没有」「阈值生效没有」「这一步为什么没提醒」三个问题原本都无从回答，只能靠改配置去试。因此它在 `src/index.ts` 的 `apply` 里留两行痕：
 
 ```
-[dsh-allostasis] loaded · driftThreshold=0.15 repetitionThreshold=0.5 consecutiveSteps=2
+[dsh-allostasis] loaded · driftThreshold=0.15 repetitionThreshold=0.5 loopWindow=2/5
 [dsh-allostasis] turn 8 step 11 · drift=chinese funcDensity=0.6% chars=1764
                  · repetition=normal units=29 ratio=0%
 ```
 
-第一行 `info`、每个进程一次，报的是**生效阈值**（`Config` 的解析结果，不是代码里的缺省常量）。第二行 `debug`、**每一步判定一行**：两类判据的三态结论加度量。默认静默，排查时打开即可——不必为了看一眼判定结果去动阈值。其中 `units` 是切分后的单元数，**低于 12 判 `insufficient`**（样本不足不下结论），此时 `ratio` 仍会给出，只是不参与判定。
+第一行 `info`、每个进程一次，报的是**生效阈值**（`Config` 的解析结果，不是代码里的缺省常量）。第二行 `debug`、**每一步判定一行**：两类判据的三态结论加度量。默认静默，排查时打开即可——不必为了看一眼判定结果去动阈值。其中 `units` 是切分后**计入统计的实义单元数**（滤掉代码围栏与纯符号，见「判据」段），**低于 12 判 `insufficient`**（样本不足不下结论），此时 `ratio` 仍会给出，只是不参与判定。
 
 判据来源、实测数据与完整设计见 `docs/设计/2026-09-20-应变-设计方案.md`、
 `docs/设计/2026-09-28-应变二期-退化检测与自动干预.md`。
@@ -60,20 +66,25 @@ repetition (**degeneration reminder**).
 
 ### 推理退化
 
-**重复率** = 单条推理按换行与中英句读切分后，**出现 ≥3 次的单元占全部单元的比例**；**单元数 ≥ 12 才判定**，**连续 N 步（默认 2）越线才触发**。
+**重复率** = 单条推理按换行与中英句读切分、滤掉非实义单元后，**出现 ≥3 次的单元占全部单元的比例**；**单元数 ≥ 12 才判定**，**最近 5 步内累计 ≥2 步越线才触发**（窗口跨 turn，不要求连续）。
+
+**非实义单元 = 以代码围栏开头的整段，以及不含「至少一个汉字或两个连续拉丁字母」的单元。** 排除它们是因为纯标记在写代码时天然高频：跨会话实测里三个会话的越线全部来自 ` ``` `、`}`、`*`，排除后归零；而真退化会话的峰值反而更高（`64e08c94` 51%→94%、`a8ac8e89` 53%→90%）——噪声单元出局后真实重复的占比更突出。
 
-实测数据（一份 19 轮 / 416 条助手消息的真实会话）：正常期 **0%–35%**、退化期 **48%–92%**，阈值 **0.5** 落在隔离带中段。连续步数不可省——正常期也有单次抖动（实测峰值 35%）；代价是延迟，按同一份数据回放会晚约 3 步触发。
+实测数据（一份 19 轮 / 416 条助手消息的真实会话）：正常期 **0%–35%**、退化期 **48%–92%**，阈值 **0.5** 落在隔离带中段。触发条件改用窗口累计后，抖动仍由「≥2 步」挡住，而散布型退化不再漏判——跨会话复核（本机 37 个 ≥3MB 会话）见 `docs/设计/2026-10-01-提醒判据修正与实测方案.md`。
 
 **退化与上下文占用脱钩**：同一会话里 26.1% 占用时重复率 84%、67.9% 时 83–92%，压缩到 26.1% 并不降低重复率。所以「调低阈值」治不了它；压缩能否治它取决于力度。完整数据见 `docs/排查/2026-09-28-推理退化与上下文占用脱钩.md`。
 
-退化触发时除提醒消息外还会 append 一条 `allostasis/degeneration` 事件，记下当时的重复率、阈值与连续步数——判定依据因此可事后重建，而不是只能按现在的脚本重算。
+退化触发的留痕是 `console.debug` 诊断行（`repetition=` 那一段给出 `units` 与 `ratio`）加上轨迹页那行提醒。**判定结果不落会话日志**——理由与空回合那条同源，见前文。
 
 ## 截图
 
-本插件是**会话行为调节类**：不新增任何按钮、面板或设置项。它每个 step 前读取最近一条思考，判定为语言漂移或推理退化时向请求末尾追加一条提醒，效果体现在模型行为上。
+空回合提示：浏览器半边从会话事件流自行折叠出「这一轮没有产出内容」，对话页在该回合尾部显示一行说明。它贴着那一段空白，回看历史时也还在原处。
 
-> 按《SSiD 开发手册》§9 截图规范：截图须回答「装完会多出/变成什么」的**入口与面板**。
-> 本插件无界面元素（no UI surface），故**不适用**该项要求，改以上述行为效果说明代替。
+| 空回合提示 |
+|---|
+| ![空回合提示](docs/shots/silent-turn-1.png) |
+
+其余两个能力（中文锚定、推理退化提醒）是**提示注入类**：不新增按钮、面板或设置项，每个 step 前读取最近一条思考，判定越线时向请求末尾追加一条提醒，效果体现在模型行为上——那两项按《SSiD 开发手册》§9 走无 UI 插件豁免，只有空回合提示有界面元素。
 
 ## Compose
 
@@ -88,13 +99,17 @@ Installs as a bundle: `dsh plugin --profile <name> add @max-null/dsh-allostasis`
 
 ## Config
 
-三个判定阈值可在 `config` 段覆盖；省略即用括号内的默认值。
+四个判定阈值加一个空回合档位可在 `config` 段覆盖；省略即用括号内的默认值。
 
 | 字段 | 默认 | 含义 |
 |---|---|---|
 | `driftThreshold` | `0.15` | 英文功能词密度达到此值即判为漂移 |
 | `repetitionThreshold` | `0.5` | 推理重复率阈值，取值 0–1 |
-| `consecutiveSteps` | `2` | 连续多少步越线才触发退化提醒 |
+| `loopWindowSteps` | `5` | 观察窗口的步数；窗口**跨 turn** 累计 |
+| `loopWindowHits` | `2` | 窗口内需要累计的越线步数。取 3 会漏掉「少而猛」型退化；超过 `loopWindowSteps` 会报错中止——那是一个永不成立的触发条件 |
+| `silentTurn` | `observe` | 空回合档位：`off` 宿主不判定也不干预、`observe` 判定并打一行诊断、`steer` 额外补一次生成 |
+
+**档位管不到对话页那行提示**：提示由浏览器半边折叠会话事件流得出，与宿主判据同源但独立于档位——浏览器半边的 `apply` 拿不到插件配置（2026-10-01 实测：在 `cordis.patch.yml` 里配 `silentTurn: off`，宿主读到 `off`，浏览器半边收到空对象）。要完全静默请禁用插件。
 
 ```yaml
 - id: allostasis

package/cordis.patch.yml

@@ -2,7 +2,8 @@
 # `system-prompt` / `agents` / `token-meter` already live in the host (dsh-base);
 # this adds only the allostasis plugin, which registers its own reminders.
 #
-# `config` 可覆盖三个判定阈值：driftThreshold / repetitionThreshold / consecutiveSteps。
+# `config` 可覆盖四个判定阈值：driftThreshold / repetitionThreshold /
+# loopWindowSteps / loopWindowHits，以及空回合档位 silentTurn。
 # 字段都可省略，省略即用插件内的默认值——这里刻意不写具体值，免得默认值有两个来源。
 # 各字段的含义、取值范围与默认值见 README 的「配置」段。
 - insert:

package/dist/client.js

@@ -0,0 +1,238 @@
+window.__ModuleLoader__.load({
+	id: "@max-null/dsh-allostasis",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/tail.ts
+		/**
+		* 统计一条助手消息的块构成。
+		*
+		* `text` 按去掉首尾空白后的长度计入：只含空白的文本块在界面上不产生任何可见内容，
+		* 把它算作「说了话」会让判据漏掉真实的空回合。
+		* @param turn - 该消息所属的 turn。
+		* @param step - 该消息所属的 step。
+		* @param content - 助手消息的内容块，按出现顺序。
+		* @returns 该消息的产出形态。
+		*/
+		function shapeOf(turn, step, content) {
+			let textChars = 0;
+			let reasoningChars = 0;
+			const blocks = {
+				reasoning: 0,
+				text: 0,
+				toolCalls: 0
+			};
+			for (const block of content) if (block.type === "reasoning") {
+				blocks.reasoning += 1;
+				reasoningChars += block.text?.length ?? 0;
+			} else if (block.type === "text") {
+				blocks.text += 1;
+				textChars += block.text?.trim().length ?? 0;
+			} else if (block.type === "tool-call") blocks.toolCalls += 1;
+			return {
+				turn,
+				step,
+				textChars,
+				reasoningChars,
+				blocks
+			};
+		}
+		/**
+		* 对一次测量下判定。
+		*
+		* 只有「有助手消息且它没有非空文本」才算空回合。工具调用**不**改变判定：一个以
+		* `tool-call` 结尾的完成态回合同样是异常（工具执行完还会再走一步，除非回合已经结束）。
+		* @param shape - 末条助手消息的形态；没有助手消息时传 `undefined`。
+		* @returns 三态判定。
+		*/
+		function tailVerdict(shape) {
+			if (shape === void 0) return "unknown";
+			return shape.textChars > 0 ? "spoke" : "silent";
+		}
+		//#endregion
+		//#region src/client/silent-turn.ts
+		/** Turn 数据键；同时用作 Definition 的 `kind`。 */
+		const SILENT_TURN_KEY = "allostasis-silent";
+		/**
+		* 对一个已收尾的 Turn 下判定。
+		* @param turn - 收尾的回合号。
+		* @param reason - `turn/end` 记录的收尾原因。
+		* @param tail - 本 Turn 末条助手消息的形态；没有助手消息时为 null。
+		* @returns 命中时渲染端要读到的事实，否则 null。
+		*/
+		function silentData(turn, reason, tail) {
+			if (reason.kind !== "completed" || tail === null) return null;
+			if (tailVerdict(tail) !== "silent") return null;
+			return {
+				turn,
+				textChars: tail.textChars,
+				reasoningChars: tail.reasoningChars
+			};
+		}
+		/**
+		* 累积空回合判定。
+		*
+		* `match` 只读当前事件：`turn/start` 开一个 Turn，之后两条更新各自折进 State。历史窗口从
+		* 中间加载时 `turn/start` 可能不在窗口里，那种情况下本 Definition 不启动——没有开头就
+		* 无从知道这一轮是怎么开始的。
+		*/
+		const silentTurnDefinition = {
+			kind: SILENT_TURN_KEY,
+			match: (event) => {
+				if (event.type === "turn/start") return {
+					id: String(event.data.turn),
+					role: "start"
+				};
+				if (event.type === "assistant/message") return {
+					id: String(event.data.turn),
+					role: "update"
+				};
+				if (event.type === "turn/end") return {
+					id: String(event.data.turn),
+					role: "update"
+				};
+				return null;
+			},
+			start: (_context, match) => {
+				if (match.event.type !== "turn/start") throw new Error("allostasis-silent start requires turn/start");
+				return {
+					turn: match.event.data.turn,
+					tail: null,
+					found: null
+				};
+			},
+			update: (context, match) => {
+				const { event } = match;
+				if (event.type === "assistant/message") return {
+					...context.state,
+					turn: event.data.turn,
+					tail: shapeOf(event.data.turn, event.data.step, event.data.message.content)
+				};
+				if (event.type === "turn/end") return {
+					...context.state,
+					turn: event.data.turn,
+					found: silentData(event.data.turn, event.data.reason, context.state.tail)
+				};
+				return context.state;
+			},
+			buildLocationData: (context, scope, previous) => {
+				const { state } = context;
+				if (scope !== "turn" || state === void 0 || state.found === null) return null;
+				if (previous?.kind === "turn" && previous.turn === state.turn && previous.key === "allostasis-silent" && previous.value === state.found) return previous;
+				return {
+					kind: "turn",
+					turn: state.turn,
+					key: SILENT_TURN_KEY,
+					value: state.found
+				};
+			}
+		};
+		//#endregion
+		//#region src/client/SilentTurnNotice.tsx
+		/**
+		* 渲染本 Turn 的空回合提示；该 Turn 没有命中判定时什么都不渲染。
+		*
+		* 每个 list 条目都会对每一轮渲染一次，所以判定在这里收窄到自己的那两个键上。
+		* @param props - 回合尾部 owner 货币与本地化座位。
+		* @returns 提示条，或 `null`。
+		*/
+		function SilentTurnNotice({ turn, t }) {
+			const data = turn.data.get(SILENT_TURN_KEY);
+			if (data === void 0) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: wrap,
+				role: "status",
+				"data-allostasis-silent-turn": data.turn,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					style: headline,
+					children: t("silent.headline")
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					style: hint,
+					children: data.reasoningChars > 0 ? t("silent.hintReasoned") : t("silent.hintEmpty")
+				})]
+			});
+		}
+		const wrap = {
+			display: "flex",
+			flexDirection: "column",
+			gap: "2px",
+			margin: "6px 0 2px",
+			padding: "8px 12px",
+			borderLeft: "2px solid var(--dsw-alias-label-caption)",
+			borderRadius: "var(--dsw-radius-md)",
+			background: "var(--dsw-alias-bg-overlay)",
+			color: "var(--dsw-alias-label-secondary)",
+			fontFamily: "var(--dsw-font-family)",
+			fontSize: "12px",
+			lineHeight: "18px"
+		};
+		const headline = {
+			color: "var(--dsw-alias-label-primary)",
+			fontWeight: 600
+		};
+		const hint = { opacity: .85 };
+		//#endregion
+		//#region src/client/locales.ts
+		/**
+		* 浏览器半边的文案字典。
+		*
+		* 产品可见字符串一律走这里，组件不内联文案（DSH 的 `verify-client-ui-i18n` 按来源
+		* 归属校验）。`LocaleNamespaceMap` 里登记的是 `keyof typeof en`，两套字典的键必须一致。
+		*
+		* 措辞对着**用户此刻的困惑**写：他看到的是空白，所以先说明发生了什么，再给一条出路。
+		* 不说「模型坏了」——那是归因，而这里只知道「这一轮没有产出」。
+		* @module @max-null/dsh-allostasis/client/locales
+		*/
+		/** 本插件在浏览器半边占用的 locale 命名空间。 */
+		const NS = "allostasis";
+		/** 中文文案。 */
+		const zh = {
+			/** 一行叙述：这条提醒说的是什么。 */
+			"silent.headline": "这一轮结束时模型没有产出内容",
+			/** 末步只生成了推理时的说明：给出可执行的下一步。 */
+			"silent.hintReasoned": "最后一步只生成了推理就停下了。可以再问一句让它接着说完，或直接看上面的操作记录。",
+			/** 末步什么块都没有时的说明。 */
+			"silent.hintEmpty": "最后一步没有产出任何内容。可以重问一次，或换一种说法。"
+		};
+		/** 英文文案；键与 {@link zh} 一一对应。 */
+		const en = {
+			"silent.headline": "This turn ended with no visible output",
+			"silent.hintReasoned": "The last step stopped after reasoning. Ask again to let it finish the thought, or read the operation log above.",
+			"silent.hintEmpty": "The last step produced nothing at all. Ask again, or rephrase the request."
+		};
+		//#endregion
+		//#region src/client/index.tsx
+		/** 本插件在浏览器半边的包名，用作诊断行的前缀。 */
+		const PLUGIN_ID = "@max-null/dsh-allostasis";
+		/** 需要槽位注册表、文案服务与 Conversation 的事件注册表。 */
+		const inject = [
+			"slots",
+			"locale",
+			"uiConversation"
+		];
+		/**
+		* 登记文案与回合尾部座位。
+		* @param ctx - 浏览器半边上下文。
+		*/
+		function apply(ctx) {
+			console.info(`[${PLUGIN_ID}] client applied`);
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "dsh-allostasis: 文案字典");
+			ctx.effect(() => ctx.uiConversation.events.register(silentTurnDefinition), "dsh-allostasis: 空回合投影");
+			ctx.slots.inject("conversation.chat.turnTail", () => ctx.slots.register({
+				name: "conversation.chat.turnTail",
+				id: SILENT_TURN_KEY,
+				order: 10,
+				locale: NS
+			}, SilentTurnNotice));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/dist/config.d.ts

@@ -1,10 +1,10 @@
 /**
  * 插件的可配置面。
  *
- * 只暴露**判定阈值**这一类值：它们是「宁可晚一点也别误报」这条取舍的刻度，随任务类型
- * 与模型行为漂移，属于部署间会变的选择（DSH 插件规范 "No hardcoded tunables in
- * plugins"）。判据里的小样本门槛（`MIN_WORDS` / `MIN_UNITS` / `REPEAT_MIN_COUNT`）
- * 不在此列——它们不是偏好，改了就是把密度与比例算飞，属于判据几何的一部分。
+ * 只暴露**判定阈值与档位**这一类值：它们是「宁可晚一点也别误报」这条取舍的刻度，随任务
+ * 类型与模型行为漂移，属于部署间会变的选择（DSH 插件规范 "No hardcoded tunables in
+ * plugins"）。判据里的小样本门槛（`MIN_WORDS` / `MIN_UNITS` / `REPEAT_MIN_COUNT`）与
+ * 实义单元规则不在此列——它们不是偏好，改了就是把密度与比例算飞，属于判据几何的一部分。
  *
  * **schema 只管形式，缺省与范围在 `resolveConfig`**：两处各管一半是有意的。schema 用
  * `.default()` 会让输出类型变成 `number | Volatile<number>`（默认值允许是动态函数），
@@ -15,6 +15,7 @@
  * @module @max-null/dsh-allostasis/config
  */
 import Schema from '@deepseek-ai/schemastery';
+import { type SilentTurnMode } from './tail.ts';
 /**
  * 插件配置，与同名 schemastery schema 一起由 Loader 校验。
  *
@@ -25,8 +26,30 @@ export interface Config {
     driftThreshold?: number;
     /** 重复率阈值，0–1（默认 0.5）。取 1 等于事实上关闭退化提醒。 */
     repetitionThreshold?: number;
-    /** 连续多少步越线才触发退化提醒（默认 2）。取 1 会跟着正常期的单次抖动误报。 */
-    consecutiveSteps?: number;
+    /** 观察窗口的大小，以步为单位（默认 5）。窗口内累计越线达标即触发。 */
+    loopWindowSteps?: number;
+    /**
+     * 窗口内需要累计的越线步数（默认 2）。
+     *
+     * 取 3 会漏掉「少而猛」型退化——单条推理重复率很高但只发生两次的那种（实测样本
+     * `8fa3b15e`，峰值 76%、只有 2 次语义越线）。取 1 会跟着正常期的单次抖动误报。
+     */
+    loopWindowHits?: number;
+    /**
+     * 空回合兜底的档位（默认 `observe`）。
+     *
+     * `off` 宿主不判定也不干预；`observe` 判定并打一行诊断；`steer` 在判定之外追加一次
+     * 补生成请求。补生成受两条边界约束：同一回合至多一次（`throttle.ts`），取消的回合与
+     * 子代理会话不触发（见 `index.ts` 的 `installSilentTurn`）。
+     *
+     * **档位管不到对话页那行提示**：提示由浏览器半边折叠会话事件流得出，与宿主判据同源
+     * 但独立于档位——浏览器半边的 `apply` 拿不到插件配置（2026-10-01 实测）。要完全静默
+     * 就禁用插件。
+     *
+     * **默认取 `observe` 而不是 `steer`**：补生成能不能改变采样轨迹尚未验证
+     * （设计文档 §六.1），先让它只观测、由使用者显式打开。
+     */
+    silentTurn?: SilentTurnMode;
 }
 /** {@link Config} 经校验后的形态：字段齐全，可直接参与判定。 */
 export interface ResolvedConfig {
@@ -34,8 +57,12 @@ export interface ResolvedConfig {
     readonly driftThreshold: number;
     /** 见 {@link Config.repetitionThreshold}。 */
     readonly repetitionThreshold: number;
-    /** 见 {@link Config.consecutiveSteps}。 */
-    readonly consecutiveSteps: number;
+    /** 见 {@link Config.loopWindowSteps}。 */
+    readonly loopWindowSteps: number;
+    /** 见 {@link Config.loopWindowHits}。 */
+    readonly loopWindowHits: number;
+    /** 见 {@link Config.silentTurn}。 */
+    readonly silentTurn: SilentTurnMode;
 }
 /** Loader 用于校验 `cordis.patch.yml` 里 `config` 段的 schema。 */
 export declare const Config: Schema<Config>;
@@ -44,6 +71,9 @@ export declare const Config: Schema<Config>;
  *
  * 范围约束不交给 schema 的 `.min()/.max()`：那样报错只会说「number」，而说出该字段的
  * 合理区间与收到的实际值，正是 fail-loud 的全部价值。
+ *
+ * `loopWindowHits` 超过 `loopWindowSteps` 时报错而不是静默夹取：那是一个**永不成立**的
+ * 触发条件（窗口装不下所需命中数），静默接受等于关掉退化提醒而不说。
  * @param config - Loader 传入的配置；未配置时传 `undefined` 或 `{}`。
  * @returns 字段齐全且已校验的配置。
  */

package/dist/config.js

@@ -1,10 +1,10 @@
 /**
  * 插件的可配置面。
  *
- * 只暴露**判定阈值**这一类值：它们是「宁可晚一点也别误报」这条取舍的刻度，随任务类型
- * 与模型行为漂移，属于部署间会变的选择（DSH 插件规范 "No hardcoded tunables in
- * plugins"）。判据里的小样本门槛（`MIN_WORDS` / `MIN_UNITS` / `REPEAT_MIN_COUNT`）
- * 不在此列——它们不是偏好，改了就是把密度与比例算飞，属于判据几何的一部分。
+ * 只暴露**判定阈值与档位**这一类值：它们是「宁可晚一点也别误报」这条取舍的刻度，随任务
+ * 类型与模型行为漂移，属于部署间会变的选择（DSH 插件规范 "No hardcoded tunables in
+ * plugins"）。判据里的小样本门槛（`MIN_WORDS` / `MIN_UNITS` / `REPEAT_MIN_COUNT`）与
+ * 实义单元规则不在此列——它们不是偏好，改了就是把密度与比例算飞，属于判据几何的一部分。
  *
  * **schema 只管形式，缺省与范围在 `resolveConfig`**：两处各管一半是有意的。schema 用
  * `.default()` 会让输出类型变成 `number | Volatile<number>`（默认值允许是动态函数），
@@ -16,12 +16,15 @@
  */
 import Schema from '@deepseek-ai/schemastery';
 import { DRIFT_THRESHOLD } from "./drift.js";
-import { CONSECUTIVE_STEPS, REPETITION_THRESHOLD } from "./repetition.js";
+import { LOOP_WINDOW_HITS, LOOP_WINDOW_STEPS, REPETITION_THRESHOLD } from "./repetition.js";
+import { SILENT_TURN_MODE, SILENT_TURN_MODES } from "./tail.js";
 /** Loader 用于校验 `cordis.patch.yml` 里 `config` 段的 schema。 */
 export const Config = Schema.object({
     driftThreshold: Schema.number(),
     repetitionThreshold: Schema.number(),
-    consecutiveSteps: Schema.number(),
+    loopWindowSteps: Schema.number(),
+    loopWindowHits: Schema.number(),
+    silentTurn: Schema.union(SILENT_TURN_MODES),
 });
 /**
  * 校验一个 0–1 的阈值字段。
@@ -35,20 +38,51 @@ function ratio(field, value) {
     }
     return value;
 }
+/**
+ * 校验一个正整数步数字段。
+ * @param field - 字段名，用于报错文案。
+ * @param value - 字段值。
+ * @returns 校验通过的原值。
+ */
+function steps(field, value) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error(`dsh-allostasis: \`${field}\` must be an integer >= 1, got ${value}`);
+    }
+    return value;
+}
+/**
+ * 校验一个枚举字段。
+ * @param field - 字段名，用于报错文案。
+ * @param value - 字段值。
+ * @param allowed - 允许的取值。
+ * @returns 校验通过的原值。
+ */
+function oneOf(field, value, allowed) {
+    if (!allowed.includes(value)) {
+        throw new Error(`dsh-allostasis: \`${field}\` must be one of ${allowed.join(' | ')}, got ${String(value)}`);
+    }
+    return value;
+}
 /**
  * 校验配置并补齐缺省值。
  *
  * 范围约束不交给 schema 的 `.min()/.max()`：那样报错只会说「number」，而说出该字段的
  * 合理区间与收到的实际值，正是 fail-loud 的全部价值。
+ *
+ * `loopWindowHits` 超过 `loopWindowSteps` 时报错而不是静默夹取：那是一个**永不成立**的
+ * 触发条件（窗口装不下所需命中数），静默接受等于关掉退化提醒而不说。
  * @param config - Loader 传入的配置；未配置时传 `undefined` 或 `{}`。
  * @returns 字段齐全且已校验的配置。
  */
 export function resolveConfig(config = {}) {
     const driftThreshold = ratio('driftThreshold', config.driftThreshold ?? DRIFT_THRESHOLD);
     const repetitionThreshold = ratio('repetitionThreshold', config.repetitionThreshold ?? REPETITION_THRESHOLD);
-    const consecutiveSteps = config.consecutiveSteps ?? CONSECUTIVE_STEPS;
-    if (!Number.isInteger(consecutiveSteps) || consecutiveSteps < 1) {
-        throw new Error(`dsh-allostasis: \`consecutiveSteps\` must be an integer >= 1, got ${consecutiveSteps}`);
+    const loopWindowSteps = steps('loopWindowSteps', config.loopWindowSteps ?? LOOP_WINDOW_STEPS);
+    const loopWindowHits = steps('loopWindowHits', config.loopWindowHits ?? LOOP_WINDOW_HITS);
+    if (loopWindowHits > loopWindowSteps) {
+        throw new Error(`dsh-allostasis: \`loopWindowHits\` (${loopWindowHits}) cannot exceed`
+            + ` \`loopWindowSteps\` (${loopWindowSteps}) — that trigger can never fire`);
     }
-    return { driftThreshold, repetitionThreshold, consecutiveSteps };
+    const silentTurn = oneOf('silentTurn', config.silentTurn ?? SILENT_TURN_MODE, SILENT_TURN_MODES);
+    return { driftThreshold, repetitionThreshold, loopWindowSteps, loopWindowHits, silentTurn };
 }

package/dist/index.d.ts

@@ -1,11 +1,29 @@
 /**
  * 应变（allostasis）：会话状态的自我调节。
  *
- * 两期能力都落在同一个 `agent/pre-step` 上，因为它们读的是同一份输入——最近一条思考：
- *
- * · **一期 · 中文锚定**：判定为语言漂移（英文功能词密度越线）就追加一条中文锚定消息。
- * · **二期 · 退化提醒**：判定为推理退化（重复率越线且连续若干步成立）就追加减速提醒，
- *   并向会话日志 append 一条 `allostasis/degeneration` 记录当时的判定依据。
+ * 三个能力落在两个挂载点上：
+ *
+ * · **一期 · 中文锚定**（`agent/pre-step`）：判定为语言漂移（英文功能词密度越线）就追加
+ *   一条中文锚定消息。
+ * · **二期 · 退化提醒**（`agent/pre-step`）：判定为推理退化（窗口内累计若干步重复率越线）
+ *   就追加减速提醒。
+ * · **空回合检测**（`agent/turn-stopping`）：回合收尾时末条助手消息没有非空文本即判定成立，
+ *   `steer` 档位下追加一次补生成。
+ *
+ * **判定结果不写会话日志**。会话日志的事件词汇表 `KNOWN_SESSION_EVENT_TYPES` 由内核在构建期
+ * 生成，下游插件的事件类型不在其中；`Session.append()` 的封装
+ * （`packages/core/session/src/index.ts:744-750`）没有 `ignorable` 通道，而
+ * `SessionEvent.ignorable` 的契约要求这类「丢失不影响重建」的记录必须自带该标记
+ * （`packages/core/session/src/types.ts:501-511`）。缺标记的自定义类型会让**整份**日志在下次
+ * 加载时被拒读（`packages/session/session-persistence/src/storage-contract.ts:75-80`）——
+ * 2026-10-01 实测：dev 与装版各有会话因此打不开。判定输入本来就可重放（推理原文在
+ * `reasoning-chunks.texts`、回合边界在 `turn/start` / `turn/end`），留痕因此改由本模块的
+ * `console.debug` 诊断行与浏览器半边的提示承担；浏览器半边自行从事件流折叠判定，
+ * 见 `client/silent-turn.ts`。
+ *
+ * 前两个共用 `agent/pre-step`，因为它们读同一份输入——最近一条思考。空回合读的是另一种
+ * 输入（这一轮最终产出了什么），而且**它之后没有下一步**，`pre-step` 不会被再次调用，
+ * 判定只能落在回合收尾。
  *
  * **平时不出现、异常时才出现**——按需出现是它作为信号的前提。但异常持续时也不每个 step
  * 都提醒：同一 turn 至多一次，见 `throttle.ts`。两类提醒各有独立的一份节流状态：判据无关，
@@ -13,17 +31,19 @@
  *
  * 为什么不挂到 system prompt 前缀上：那是 `dsh-chinese-thinking` 的位置，它作为基线
  * 永远在场。而基线在长会话里会失效（固定前缀离输出最远，语言模式受近因支配）。本插件
- * 补的是「**你正在漂移 / 正在打转**」这个纠偏信号，因此必须落在近因位置。
+ * 补的是「**你正在漂移 / 正在打转 / 这一轮什么也没说**」这类纠偏信号，因此必须落在近因
+ * 或收尾位置。
  *
  * 为什么用 `agent/pre-step` 而不是 `systemPrompt.context()`：前者直接给出 `turn` /
  * `step`，且追加的是一条独立消息，落点比快照里的一个段更靠后。用法先例见官方
  * `packages/context/time-context/src/index.ts:180-220`。
  *
- * 阈值全部走 `config.ts` 的配置面。**压缩动作按设计方案 §九 暂缓**：数据指向退化样本
- * 散布在整段退化区间，而 `compactRegion` 只压指定区间，能否打断循环尚未验证。
+ * 阈值与档位全部走 `config.ts` 的配置面。**压缩动作按设计方案 §九 暂缓**：数据指向退化
+ * 样本散布在整段退化区间，而 `compactRegion` 只压指定区间，能否打断循环尚未验证。
  *
  * 设计出处：`docs/设计/2026-09-20-应变-设计方案.md`、
- * `docs/设计/2026-09-28-应变二期-退化检测与自动干预.md`
+ * `docs/设计/2026-09-28-应变二期-退化检测与自动干预.md`、
+ * `docs/设计/2026-09-30-空回合检测与可见化.md`
  * @module @max-null/dsh-allostasis
  */
 import type { Context } from '@deepseek-ai/cordis';
@@ -31,7 +51,7 @@ import { anchorText } from './anchor.ts';
 import { Config } from './config.ts';
 import { name } from './name.ts';
 export { anchorText, Config, name };
-/** 需要 `agents` 服务来接收 `agent/pre-step` 事件。 */
+/** 需要 `agents` 服务来接收 `agent/pre-step` 与 `agent/turn-stopping` 事件。 */
 export declare const inject: string[];
 /**
  * 注册 pre-step 监听器；监听器随 `ctx` 生命周期销毁。