@max-null/dsh-allostasis 0.1.1 → 0.2.1

package/README.md

@@ -5,9 +5,11 @@
 This plugin belongs to the **`@max-null/*` family** — a set of plugins that together form the **[SSID (思灵 · Seek Soul in Darkness)](https://github.com/Max-Null/seek-soul-in-darkness)** desktop experience.
 
 Allostasis for the DeepSeek Harness — session self-regulation rather than monitoring.
-Its first capability is **Chinese anchoring**: before each step it reads the most recent
-reasoning block, and when that thinking has drifted into English it appends one near-end
-message to bring it back.
+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**). 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.
 
 ## 它做什么
 
@@ -16,10 +18,31 @@ message to bring it back.
 | 能力 | 状态 | 触发条件 |
 |---|---|---|
 | **中文锚定** | **已实现** | 上一步思考的英文功能词密度越线 |
+| **推理退化提醒** | **已实现** | 上一步思考的重复率越线，且连续 N 步成立 |
+| **空回合提示** | **已实现** | 回合收尾时末条助手消息没有非空文本（只在 `completed` 回合上判） |
 | 上下文占用感知 | 计划中 | 需先定「什么情况下才出现」（持续在场会退化成背景音） |
-| 压缩预约落盘 | 计划中 | 待通路验证：`turn/end` → `whenIdle()` → `compactNow()` |
+| 压缩预约落盘 | 计划中 | 待通路验证：退化样本散布在整段退化区间，「只压一小段」能否打断循环尚无证据（二期方案 §八.1） |
 
-判据来源、实测数据与完整设计见 `docs/设计/2026-09-20-应变-设计方案.md`。
+前两类提醒以 `notice` 形式注入——在**轨迹页**是折叠态就显示一行摘要的注入行，不弹窗、不打断；
+**对话页不显示**（2026-09-29 在 SSiD dev / DSH 0.2.0-rc.1 上实测，口径见二期方案 §九）。
+
+**空回合提示是三者里唯一有界面的一个**，就挂在那一段空白下面（见「截图」段）。它不发消息、不改模型输入——
+浏览器半边从 `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] turn 8 step 11 · drift=chinese funcDensity=0.6% chars=1764
+                 · repetition=normal units=29 ratio=0%
+```
+
+第一行 `info`、每个进程一次，报的是**生效阈值**（`Config` 的解析结果，不是代码里的缺省常量）。第二行 `debug`、**每一步判定一行**：两类判据的三态结论加度量。默认静默，排查时打开即可——不必为了看一眼判定结果去动阈值。其中 `units` 是切分后的单元数，**低于 12 判 `insufficient`**（样本不足不下结论），此时 `ratio` 仍会给出，只是不参与判定。
+
+判据来源、实测数据与完整设计见 `docs/设计/2026-09-20-应变-设计方案.md`、
+`docs/设计/2026-09-28-应变二期-退化检测与自动干预.md`。
 
 ## 为什么需要它
 
@@ -29,6 +52,10 @@ message to bring it back.
 
 ## 判据
 
+两类提醒各有一个纯函数判据，都在 `src/` 下，都附实测依据。
+
+### 语言漂移
+
 **英文功能词密度** =（`the` / `is` / `are` / `and` / `of` / `to` / `that` 这类功能词数）/ 英文词数，**且英文词数 ≥ 50 才判定**。
 
 实测数据（一份 10 turn / 157 step 的真实会话）：中文期中位 **0.012**、英文期中位 **0.273–0.389**，阈值 **0.15** 使两群完全分离。词数门槛不可省——中文期唯一的越线点只有 26 个英文词，小样本会让密度失真。
@@ -37,12 +64,25 @@ message to bring it back.
 
 阈值由 `tools/analyze-thinking-lang.mjs` 在一份真实会话上标定，该工具随包发布。
 
+### 推理退化
+
+**重复率** = 单条推理按换行与中英句读切分后，**出现 ≥3 次的单元占全部单元的比例**；**单元数 ≥ 12 才判定**，**连续 N 步（默认 2）越线才触发**。
+
+实测数据（一份 19 轮 / 416 条助手消息的真实会话）：正常期 **0%–35%**、退化期 **48%–92%**，阈值 **0.5** 落在隔离带中段。连续步数不可省——正常期也有单次抖动（实测峰值 35%）；代价是延迟，按同一份数据回放会晚约 3 步触发。
+
+**退化与上下文占用脱钩**：同一会话里 26.1% 占用时重复率 84%、67.9% 时 83–92%，压缩到 26.1% 并不降低重复率。所以「调低阈值」治不了它；压缩能否治它取决于力度。完整数据见 `docs/排查/2026-09-28-推理退化与上下文占用脱钩.md`。
+
+退化触发的留痕是 `console.debug` 诊断行（`repetition=` 那一段给出 `units` 与 `ratio`）加上轨迹页那行提醒。**判定结果不落会话日志**——理由与空回合那条同源，见前文。
+
 ## 截图
 
-本插件是**会话行为调节类**：不新增任何按钮、面板或设置项。它在会话过程中读取思考的语言，漂移时向请求末尾追加一条提醒，效果体现在模型行为上。
+空回合提示：浏览器半边从会话事件流自行折叠出「这一轮没有产出内容」，对话页在该回合尾部显示一行说明。它贴着那一段空白，回看历史时也还在原处。
 
-> 按《SSiD 开发手册》§9 截图规范：截图须回答「装完会多出/变成什么」的**入口与面板**。
-> 本插件无界面元素（no UI surface），故**不适用**该项要求，改以上述行为效果说明代替。
+| 空回合提示 |
+|---|
+| ![空回合提示](docs/shots/silent-turn-1.png) |
+
+其余两个能力（中文锚定、推理退化提醒）是**提示注入类**：不新增按钮、面板或设置项，每个 step 前读取最近一条思考，判定越线时向请求末尾追加一条提醒，效果体现在模型行为上——那两项按《SSiD 开发手册》§9 走无 UI 插件豁免，只有空回合提示有界面元素。
 
 ## Compose
 
@@ -57,7 +97,27 @@ Installs as a bundle: `dsh plugin --profile <name> add @max-null/dsh-allostasis`
 
 ## Config
 
-第一期没有配置项；阈值与门槛是经过标定的常量，写在 `src/drift.ts` 里并附实测依据。
+三个判定阈值加一个空回合档位可在 `config` 段覆盖；省略即用括号内的默认值。
+
+| 字段 | 默认 | 含义 |
+|---|---|---|
+| `driftThreshold` | `0.15` | 英文功能词密度达到此值即判为漂移 |
+| `repetitionThreshold` | `0.5` | 推理重复率阈值，取值 0–1 |
+| `consecutiveSteps` | `2` | 连续多少步越线才触发退化提醒 |
+| `silentTurn` | `observe` | 空回合档位：`off` 宿主不判定也不干预、`observe` 判定并打一行诊断、`steer` 额外补一次生成 |
+
+**档位管不到对话页那行提示**：提示由浏览器半边折叠会话事件流得出，与宿主判据同源但独立于档位——浏览器半边的 `apply` 拿不到插件配置（2026-10-01 实测：在 `cordis.patch.yml` 里配 `silentTurn: off`，宿主读到 `off`，浏览器半边收到空对象）。要完全静默请禁用插件。
+
+```yaml
+- id: allostasis
+  name: '@max-null/dsh-allostasis'
+  config:
+    repetitionThreshold: 0.6
+```
+
+判据里的**小样本门槛**（`MIN_WORDS` / `MIN_UNITS` / `REPEAT_MIN_COUNT`）不是配置项——它们不是偏好，改了就是把密度与比例算飞。值域外的取值会让插件**报错中止**而不是静默回退：静默回退会让「我明明改了配置」与「插件按默认值跑」同时成立而无从察觉。
+
+这几个阈值都是**起点值而非标定结果**——单会话样本给出的隔离带中段，标定留给数据积累（设计方案 §5.1 的三条路：显性配置项、数据积累、LLM 自调）。
 
 ## Develop
 

package/cordis.patch.yml

@@ -1,6 +1,10 @@
 # dsh-allostasis bundle patch: one insert over the profile root.
 # `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。
+# 字段都可省略，省略即用插件内的默认值——这里刻意不写具体值，免得默认值有两个来源。
+# 各字段的含义、取值范围与默认值见 README 的「配置」段。
 - insert:
     - id: allostasis
       name: '@max-null/dsh-allostasis'

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

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

package/dist/config.js

@@ -0,0 +1,70 @@
+/**
+ * 插件的可配置面。
+ *
+ * 只暴露**判定阈值与档位**这一类值：它们是「宁可晚一点也别误报」这条取舍的刻度，随任务
+ * 类型与模型行为漂移，属于部署间会变的选择（DSH 插件规范 "No hardcoded tunables in
+ * plugins"）。判据里的小样本门槛（`MIN_WORDS` / `MIN_UNITS` / `REPEAT_MIN_COUNT`）
+ * 不在此列——它们不是偏好，改了就是把密度与比例算飞，属于判据几何的一部分。
+ *
+ * **schema 只管形式，缺省与范围在 `resolveConfig`**：两处各管一半是有意的。schema 用
+ * `.default()` 会让输出类型变成 `number | Volatile<number>`（默认值允许是动态函数），
+ * 与接口对不上，内核自己也要在那里补 `as Schema<T>` 断言；而缺省值有两个来源之后，
+ * 「我明明改了配置」与「插件按默认值跑」就能同时成立而无从察觉。缺省值就是判据模块里的
+ * 常量本身，因此不配置时行为与配置前逐字一致。
+ *
+ * @module @max-null/dsh-allostasis/config
+ */
+import Schema from '@deepseek-ai/schemastery';
+import { DRIFT_THRESHOLD } from "./drift.js";
+import { CONSECUTIVE_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(),
+    silentTurn: Schema.union(SILENT_TURN_MODES),
+});
+/**
+ * 校验一个 0–1 的阈值字段。
+ * @param field - 字段名，用于报错文案。
+ * @param value - 字段值。
+ * @returns 校验通过的原值。
+ */
+function ratio(field, value) {
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new Error(`dsh-allostasis: \`${field}\` must be a number between 0 and 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 的全部价值。
+ * @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 silentTurn = oneOf('silentTurn', config.silentTurn ?? SILENT_TURN_MODE, SILENT_TURN_MODES);
+    return { driftThreshold, repetitionThreshold, consecutiveSteps, silentTurn };
+}

package/dist/drift.d.ts

@@ -38,5 +38,10 @@ export interface DriftMetrics {
 export type DriftVerdict = 'drift' | 'chinese' | 'insufficient';
 /** 统计一条思考文本的各量。空文本返回全零。 */
 export declare function measureThinking(text: string): DriftMetrics;
-/** 对一次测量下判定。 */
-export declare function verdict(metrics: DriftMetrics): DriftVerdict;
+/**
+ * 对一次测量下判定。
+ * @param metrics - 量化结果。
+ * @param threshold - 功能词密度阈值；缺省用 {@link DRIFT_THRESHOLD}。
+ * @returns 三态判定。
+ */
+export declare function verdict(metrics: DriftMetrics, threshold?: number): DriftVerdict;

package/dist/drift.js

@@ -40,9 +40,14 @@ export function measureThinking(text) {
         funcDensity: words.length === 0 ? 0 : funcWords / words.length,
     };
 }
-/** 对一次测量下判定。 */
-export function verdict(metrics) {
+/**
+ * 对一次测量下判定。
+ * @param metrics - 量化结果。
+ * @param threshold - 功能词密度阈值；缺省用 {@link DRIFT_THRESHOLD}。
+ * @returns 三态判定。
+ */
+export function verdict(metrics, threshold = DRIFT_THRESHOLD) {
     if (metrics.words < MIN_WORDS)
         return 'insufficient';
-    return metrics.funcDensity >= DRIFT_THRESHOLD ? 'drift' : 'chinese';
+    return metrics.funcDensity >= threshold ? 'drift' : 'chinese';
 }

package/dist/index.d.ts

@@ -1,33 +1,63 @@
 /**
  * 应变（allostasis）：会话状态的自我调节。
  *
- * 第一期只实现一个能力——**中文锚定**：每个 step 之前读最近一条思考，若判定为语言
- * 漂移（英文功能词密度越线），就在请求末尾追加一条中文锚定消息。**平时不出现、漂移
- * 时才出现**——按需出现是它作为信号的前提。但漂移持续时也不每个 step 都提醒：同一
- * turn 至多一次，见 `throttle.ts`。
+ * 三个能力落在两个挂载点上：
+ *
+ * · **一期 · 中文锚定**（`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`。两类提醒各有独立的一份节流状态：判据无关，
+ * 共用状态会让先说的那类把另一类挡在门外。
  *
  * 为什么不挂到 system prompt 前缀上：那是 `dsh-chinese-thinking` 的位置，它作为基线
  * 永远在场。而基线在长会话里会失效（固定前缀离输出最远，语言模式受近因支配）。本插件
- * 补的是「**你正在漂移**」这个纠偏信号，因此必须落在近因位置。
+ * 补的是「**你正在漂移 / 正在打转 / 这一轮什么也没说**」这类纠偏信号，因此必须落在近因
+ * 或收尾位置。
  *
  * 为什么用 `agent/pre-step` 而不是 `systemPrompt.context()`：前者直接给出 `turn` /
  * `step`，且追加的是一条独立消息，落点比快照里的一个段更靠后。用法先例见官方
  * `packages/context/time-context/src/index.ts:180-220`。
  *
- * 设计出处：`docs/设计/2026-09-20-应变-设计方案.md`
+ * 阈值与档位全部走 `config.ts` 的配置面。**压缩动作按设计方案 §九 暂缓**：数据指向退化
+ * 样本散布在整段退化区间，而 `compactRegion` 只压指定区间，能否打断循环尚未验证。
+ *
+ * 设计出处：`docs/设计/2026-09-20-应变-设计方案.md`、
+ * `docs/设计/2026-09-28-应变二期-退化检测与自动干预.md`、
+ * `docs/设计/2026-09-30-空回合检测与可见化.md`
  * @module @max-null/dsh-allostasis
  */
 import type { Context } from '@deepseek-ai/cordis';
 import { anchorText } from './anchor.ts';
-/** Cordis 插件名，同时用作注入消息的 `source.plugin` 与 section 名。 */
-export declare const name = "dsh-allostasis";
-/** 需要 `agents` 服务来接收 `agent/pre-step` 事件。 */
+import { Config } from './config.ts';
+import { name } from './name.ts';
+export { anchorText, Config, name };
+/** 需要 `agents` 服务来接收 `agent/pre-step` 与 `agent/turn-stopping` 事件。 */
 export declare const inject: string[];
-export { anchorText };
 /**
  * 注册 pre-step 监听器；监听器随 `ctx` 生命周期销毁。
  *
  * 用 `{ prepend: true }` 以取得 `next()` 的决策后再追加，与官方 `time-context` 一致。
  * @param ctx - 插件上下文。
+ * @param config - `cordis.patch.yml` 里的配置段；省略时全部取判据模块的缺省值。
  */
-export declare function apply(ctx: Context): void;
+export declare function apply(ctx: Context, config?: Config): void;