dsh-repeat-guard 0.2.1 → 0.2.2

package/src/config.ts

@@ -1,171 +1,171 @@
-/**
- * 插件配置：拦截短句表、连续命中阈值、行内重复检测、续跑注入的正文与摘要，
- * 外加一个运行时计数。
- *
- * dsh 0.1.7 起，配置就是插件自己的 entry Config——标记 `.volatile()` 的字段由宿主
- * 的设置表单读写，写回的是 profile 的 cordis patch。宿主侧不再注册命名空间，
- * 而是持有这些稳定引用，需要时 `.get()` 现取，所以改完立即生效，不用重启。
- *
- * 计数也寄在同一份配置里：宿主侧每次掐断写一次，客户端读同一个值、清零就是把它
- * 写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
- */
-
-import type { Context } from '@deepseek-ai/cordis';
-// 空导入：只为加载它的 declaration merging（往 cordis 的 Context 上补 settings 服务）。
-import type {} from '@deepseek-ai/dsh-settings';
-import z from '@deepseek-ai/schemastery';
-
-/**
- * profile 里本插件的条目 id。设置表单按它定位配置，宿主写回也要用它，
- * 所以必须与 cordis.patch.yml 里的 `id` 逐字一致。
- */
-export const ENTRY_ID = 'dsh-repeat-guard';
-
-/** 默认的拦截短句表，标点照原样写。 */
-export const DEFAULT_FRAGMENTS: readonly string[] = [
-  '好。',
-  '好的。',
-  '好嘞。',
-  '对。',
-  '对的。',
-  '是。',
-  '是的。',
-  '行。',
-  '嗯。',
-  '可以。',
-  '明白。',
-  '收到。',
-  '了解。',
-  '执行。',
-  '继续。',
-  '确认。',
-  '完成。',
-  '搞定。',
-  '写。',
-  '查。',
-  '看。',
-  'ok.',
-  'okay.',
-  'sure.',
-  'alright.',
-  'right.',
-  'yes.',
-  'done.',
-  'got it.',
-  'let me go.',
-  'let me do it.',
-  'check it.',
-];
-
-/** 默认阈值：1 表示发现即拦。 */
-export const DEFAULT_THRESHOLD = 1;
-
-/** 默认关闭行内重复检测：只认独占一行的整句。 */
-export const DEFAULT_INLINE_REPEAT = false;
-
-/** 默认的续跑指令正文，截断后推给模型。 */
-export const DEFAULT_RESUME_TEXT = [
-  '[复读拦截]',
-  '你上一段思考退化成了碎片复读（反复输出"好。"一类的空话），已被系统截断。',
-  '请直接继续执行下一步，不要再输出任何确认语、寒暄或空话。',
-].join('\n');
-
-/** 默认的折叠行摘要；客户端拿它渲染折叠的 context 行，不是用户气泡。 */
-export const DEFAULT_RESUME_SUMMARY = '复读已截断：请继续执行';
-
-/**
- * 插件 Config schema。只有标了 `.volatile()` 的字段会进设置表单并支持编辑，
- * 其余字段仍是普通配置（只由 cordis 配置文件决定）。
- */
-export const Config = z.object({
-  fragments: z.array(z.string()).default([...DEFAULT_FRAGMENTS]).volatile(),
-  threshold: z.number().default(DEFAULT_THRESHOLD).volatile(),
-  inlineRepeat: z.boolean().default(DEFAULT_INLINE_REPEAT).volatile(),
-  resumeText: z.string().default(DEFAULT_RESUME_TEXT).volatile(),
-  resumeSummary: z.string().default(DEFAULT_RESUME_SUMMARY).volatile(),
-  count: z.number().default(0).volatile(),
-});
-
-/** loader 解析后交给插件的配置：volatile 字段是稳定引用，取值要 `.get()`。 */
-export type RepeatGuardConfigSchema = Schemastery.TypeT<typeof Config>;
-
-/** 判定与续跑用得上的一份配置。 */
-export interface RepeatGuardConfig {
-  /** 短句表，已全部小写化。 */
-  readonly fragments: ReadonlySet<string>;
-  /** 连续命中多少次才拦。 */
-  readonly threshold: number;
-  /** 是否把"整行由多个表项拼成"也算命中。 */
-  readonly inlineRepeat: boolean;
-  /** 截断后推给模型的指令正文。 */
-  readonly resumeText: string;
-  /** 注入消息的折叠行摘要。 */
-  readonly resumeSummary: string;
-}
-
-/** 取当前配置。 */
-export type ConfigSource = () => RepeatGuardConfig;
-
-/** 宿主侧要用到的两件事：取配置、记一次拦截。 */
-export interface GuardRuntime {
-  /** 取当前配置。 */
-  readonly read: ConfigSource;
-  /** 记一次拦截，把计数写回配置。 */
-  readonly countHit: () => void;
-}
-
-function compile(value: {
-  fragments: readonly string[];
-  threshold: number;
-  inlineRepeat: boolean;
-  resumeText: string;
-  resumeSummary: string;
-}): RepeatGuardConfig {
-  return {
-    fragments: new Set(value.fragments.map((fragment) => fragment.toLowerCase())),
-    threshold: value.threshold,
-    inlineRepeat: value.inlineRepeat,
-    resumeText: value.resumeText,
-    resumeSummary: value.resumeSummary,
-  };
-}
-
-/**
- * 把 volatile 引用折叠成一份快照，返回宿主侧要用的运行时句柄。
- * @param ctx - 宿主 cordis 上下文。
- * @param config - loader 解析后的本插件配置。
- * @returns 取配置与记数两个入口。
- */
-export function createRuntime(ctx: Context, config: RepeatGuardConfigSchema): GuardRuntime {
-  const read = (): RepeatGuardConfig =>
-    compile({
-      fragments: config.fragments.get(),
-      threshold: config.threshold.get(),
-      inlineRepeat: config.inlineRepeat.get(),
-      resumeText: config.resumeText.get(),
-      resumeSummary: config.resumeSummary.get(),
-    });
-
-  let write: ((count: number) => void) | undefined;
-  ctx.inject(['settings'], (settingsCtx) => {
-    const settings = settingsCtx.settings;
-    // 本插件自带设置页，关掉宿主按 schema 自动生成的页面。
-    settingsCtx.effect(() => settings.configure({ auto: false }, ctx.fiber));
-    write = (count: number): void => {
-      // 现取 revision：表单刚写过的话，旧 revision 会被 SETTINGS_CONFLICT 拒掉。
-      const revision = settings.describe().find((entry) => entry.ns === ENTRY_ID)?.revision;
-      settings.update(ENTRY_ID, { count }, revision).catch((error: unknown) => {
-        console.log(`[repeat-guard] 写设置失败：${String(error)}`);
-      });
-    };
-    // 计数口径是"自本次启动或上次清零以来"。
-    write(0);
-  });
-
-  return {
-    read,
-    countHit: () => {
-      write?.(config.count.get() + 1);
-    },
-  };
-}
+/**
+ * 插件配置：拦截短句表、连续命中阈值、行内重复检测、续跑注入的正文与摘要，
+ * 外加一个运行时计数。
+ *
+ * dsh 0.1.7 起，配置就是插件自己的 entry Config——标记 `.volatile()` 的字段由宿主
+ * 的设置表单读写，写回的是 profile 的 cordis patch。宿主侧不再注册命名空间，
+ * 而是持有这些稳定引用，需要时 `.get()` 现取，所以改完立即生效，不用重启。
+ *
+ * 计数也寄在同一份配置里：宿主侧每次掐断写一次，客户端读同一个值、清零就是把它
+ * 写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
+ */
+
+import type { Context } from '@deepseek-ai/cordis';
+// 空导入：只为加载它的 declaration merging（往 cordis 的 Context 上补 settings 服务）。
+import type {} from '@deepseek-ai/dsh-settings';
+import z from '@deepseek-ai/schemastery';
+
+/**
+ * profile 里本插件的条目 id。设置表单按它定位配置，宿主写回也要用它，
+ * 所以必须与 cordis.patch.yml 里的 `id` 逐字一致。
+ */
+export const ENTRY_ID = 'dsh-repeat-guard';
+
+/** 默认的拦截短句表，标点照原样写。 */
+export const DEFAULT_FRAGMENTS: readonly string[] = [
+  '好。',
+  '好的。',
+  '好嘞。',
+  '对。',
+  '对的。',
+  '是。',
+  '是的。',
+  '行。',
+  '嗯。',
+  '可以。',
+  '明白。',
+  '收到。',
+  '了解。',
+  '执行。',
+  '继续。',
+  '确认。',
+  '完成。',
+  '搞定。',
+  '写。',
+  '查。',
+  '看。',
+  'ok.',
+  'okay.',
+  'sure.',
+  'alright.',
+  'right.',
+  'yes.',
+  'done.',
+  'got it.',
+  'let me go.',
+  'let me do it.',
+  'check it.',
+];
+
+/** 默认阈值：1 表示发现即拦。 */
+export const DEFAULT_THRESHOLD = 1;
+
+/** 默认关闭行内重复检测：只认独占一行的整句。 */
+export const DEFAULT_INLINE_REPEAT = false;
+
+/** 默认的续跑指令正文，截断后推给模型。 */
+export const DEFAULT_RESUME_TEXT = [
+  '[复读拦截]',
+  '你上一段思考退化成了碎片复读（反复输出"好。"一类的空话），已被系统截断。',
+  '请直接继续执行下一步，不要再输出任何确认语、寒暄或空话。',
+].join('\n');
+
+/** 默认的折叠行摘要；客户端拿它渲染折叠的 context 行，不是用户气泡。 */
+export const DEFAULT_RESUME_SUMMARY = '复读已截断：请继续执行';
+
+/**
+ * 插件 Config schema。只有标了 `.volatile()` 的字段会进设置表单并支持编辑，
+ * 其余字段仍是普通配置（只由 cordis 配置文件决定）。
+ */
+export const Config = z.object({
+  fragments: z.array(z.string()).default([...DEFAULT_FRAGMENTS]).volatile(),
+  threshold: z.number().default(DEFAULT_THRESHOLD).volatile(),
+  inlineRepeat: z.boolean().default(DEFAULT_INLINE_REPEAT).volatile(),
+  resumeText: z.string().default(DEFAULT_RESUME_TEXT).volatile(),
+  resumeSummary: z.string().default(DEFAULT_RESUME_SUMMARY).volatile(),
+  count: z.number().default(0).volatile(),
+});
+
+/** loader 解析后交给插件的配置：volatile 字段是稳定引用，取值要 `.get()`。 */
+export type RepeatGuardConfigSchema = Schemastery.TypeT<typeof Config>;
+
+/** 判定与续跑用得上的一份配置。 */
+export interface RepeatGuardConfig {
+  /** 短句表，已全部小写化。 */
+  readonly fragments: ReadonlySet<string>;
+  /** 连续命中多少次才拦。 */
+  readonly threshold: number;
+  /** 是否把"整行由多个表项拼成"也算命中。 */
+  readonly inlineRepeat: boolean;
+  /** 截断后推给模型的指令正文。 */
+  readonly resumeText: string;
+  /** 注入消息的折叠行摘要。 */
+  readonly resumeSummary: string;
+}
+
+/** 取当前配置。 */
+export type ConfigSource = () => RepeatGuardConfig;
+
+/** 宿主侧要用到的两件事：取配置、记一次拦截。 */
+export interface GuardRuntime {
+  /** 取当前配置。 */
+  readonly read: ConfigSource;
+  /** 记一次拦截，把计数写回配置。 */
+  readonly countHit: () => void;
+}
+
+function compile(value: {
+  fragments: readonly string[];
+  threshold: number;
+  inlineRepeat: boolean;
+  resumeText: string;
+  resumeSummary: string;
+}): RepeatGuardConfig {
+  return {
+    fragments: new Set(value.fragments.map((fragment) => fragment.toLowerCase())),
+    threshold: value.threshold,
+    inlineRepeat: value.inlineRepeat,
+    resumeText: value.resumeText,
+    resumeSummary: value.resumeSummary,
+  };
+}
+
+/**
+ * 把 volatile 引用折叠成一份快照，返回宿主侧要用的运行时句柄。
+ * @param ctx - 宿主 cordis 上下文。
+ * @param config - loader 解析后的本插件配置。
+ * @returns 取配置与记数两个入口。
+ */
+export function createRuntime(ctx: Context, config: RepeatGuardConfigSchema): GuardRuntime {
+  const read = (): RepeatGuardConfig =>
+    compile({
+      fragments: config.fragments.get(),
+      threshold: config.threshold.get(),
+      inlineRepeat: config.inlineRepeat.get(),
+      resumeText: config.resumeText.get(),
+      resumeSummary: config.resumeSummary.get(),
+    });
+
+  let write: ((count: number) => void) | undefined;
+  ctx.inject(['settings'], (settingsCtx) => {
+    const settings = settingsCtx.settings;
+    // 本插件自带设置页，关掉宿主按 schema 自动生成的页面。
+    settingsCtx.effect(() => settings.configure({ auto: false }, ctx.fiber));
+    write = (count: number): void => {
+      // 现取 revision：表单刚写过的话，旧 revision 会被 SETTINGS_CONFLICT 拒掉。
+      const revision = settings.describe().find((entry) => entry.ns === ENTRY_ID)?.revision;
+      settings.update(ENTRY_ID, { count }, revision).catch((error: unknown) => {
+        console.log(`[repeat-guard] 写设置失败：${String(error)}`);
+      });
+    };
+    // 计数口径是"自本次启动或上次清零以来"。
+    write(0);
+  });
+
+  return {
+    read,
+    countHit: () => {
+      write?.(config.count.get() + 1);
+    },
+  };
+}

package/src/detect.ts

@@ -1,86 +1,86 @@
-/**
- * 复读退化判定：查表。
- *
- * 表里是已知会被模型复读的空话短句，**连标点一起写**，表本身可配置（见 config.ts）。
- * 基本判据是"整行与表项全等"，不拆解行的内部。
- *
- * 行内重复检测（可开关，默认关）打开时，"整行由多个表项首尾相接拼成"也算命中，
- * 用来兜住把短句连成一串写在同一行里的模型（如"好。好。好。"）。
- *
- * 阈值是"连续命中多少次才拦"：默认 1 表示发现即拦。计数单位是表项——整行全等算一次，
- * 开了行内检测后行内每一段各算一次；中间夹一行不命中的就重新计数。
- */
-
-/**
- * 在 line 的 at 处能匹配到的最长表项长度。
- * @param line - 已小写化的行。
- * @param at - 起始下标。
- * @param fragments - 小写化的短句表。
- * @returns 匹配到的长度，0 表示这个位置没有表项。
- */
-function longestFragmentAt(line: string, at: number, fragments: ReadonlySet<string>): number {
-  let size = 0;
-  for (const fragment of fragments) {
-    if (fragment.length > size && line.startsWith(fragment, at)) {
-      size = fragment.length;
-    }
-  }
-  return size;
-}
-
-/**
- * 这一行算几次命中。
- * @param line - 已 trim 并小写化的行。
- * @param fragments - 小写化的短句表。
- * @param inlineRepeat - 是否把"整行由多个表项拼成"也算命中。
- * @returns 0 表示不是命中行，其余为这一行贡献的次数。
- */
-function countHits(line: string, fragments: ReadonlySet<string>, inlineRepeat: boolean): number {
-  if (fragments.has(line)) {
-    return 1;
-  }
-  if (!inlineRepeat) {
-    return 0;
-  }
-  let at = 0;
-  let parts = 0;
-  while (at < line.length) {
-    const size = longestFragmentAt(line, at, fragments);
-    if (size === 0) {
-      return 0;
-    }
-    at += size;
-    parts += 1;
-  }
-  return parts > 1 ? parts : 0;
-}
-
-/**
- * 找出退化的碎片行。
- * @param text - 已生成的思考文本。
- * @param fragments - 小写化的短句表。
- * @param threshold - 连续命中多少次才判定为复读。
- * @param inlineRepeat - 是否启用行内重复检测。
- * @returns 计数成立时返回那一行的原文，否则返回 null。
- */
-export function findDegenerateLine(
-  text: string,
-  fragments: ReadonlySet<string>,
-  threshold: number,
-  inlineRepeat: boolean,
-): string | null {
-  let run = 0;
-  for (const raw of text.split('\n')) {
-    const line = raw.trim();
-    const hits = line === '' ? 0 : countHits(line.toLowerCase(), fragments, inlineRepeat);
-    if (hits === 0) {
-      run = 0;
-      continue;
-    }
-    run += hits;
-    if (run >= threshold) {
-      return line;
-    }
-  }
-  return null;
-}
+/**
+ * 复读退化判定：查表。
+ *
+ * 表里是已知会被模型复读的空话短句，**连标点一起写**，表本身可配置（见 config.ts）。
+ * 基本判据是"整行与表项全等"，不拆解行的内部。
+ *
+ * 行内重复检测（可开关，默认关）打开时，"整行由多个表项首尾相接拼成"也算命中，
+ * 用来兜住把短句连成一串写在同一行里的模型（如"好。好。好。"）。
+ *
+ * 阈值是"连续命中多少次才拦"：默认 1 表示发现即拦。计数单位是表项——整行全等算一次，
+ * 开了行内检测后行内每一段各算一次；中间夹一行不命中的就重新计数。
+ */
+
+/**
+ * 在 line 的 at 处能匹配到的最长表项长度。
+ * @param line - 已小写化的行。
+ * @param at - 起始下标。
+ * @param fragments - 小写化的短句表。
+ * @returns 匹配到的长度，0 表示这个位置没有表项。
+ */
+function longestFragmentAt(line: string, at: number, fragments: ReadonlySet<string>): number {
+  let size = 0;
+  for (const fragment of fragments) {
+    if (fragment.length > size && line.startsWith(fragment, at)) {
+      size = fragment.length;
+    }
+  }
+  return size;
+}
+
+/**
+ * 这一行算几次命中。
+ * @param line - 已 trim 并小写化的行。
+ * @param fragments - 小写化的短句表。
+ * @param inlineRepeat - 是否把"整行由多个表项拼成"也算命中。
+ * @returns 0 表示不是命中行，其余为这一行贡献的次数。
+ */
+function countHits(line: string, fragments: ReadonlySet<string>, inlineRepeat: boolean): number {
+  if (fragments.has(line)) {
+    return 1;
+  }
+  if (!inlineRepeat) {
+    return 0;
+  }
+  let at = 0;
+  let parts = 0;
+  while (at < line.length) {
+    const size = longestFragmentAt(line, at, fragments);
+    if (size === 0) {
+      return 0;
+    }
+    at += size;
+    parts += 1;
+  }
+  return parts > 1 ? parts : 0;
+}
+
+/**
+ * 找出退化的碎片行。
+ * @param text - 已生成的思考文本。
+ * @param fragments - 小写化的短句表。
+ * @param threshold - 连续命中多少次才判定为复读。
+ * @param inlineRepeat - 是否启用行内重复检测。
+ * @returns 计数成立时返回那一行的原文，否则返回 null。
+ */
+export function findDegenerateLine(
+  text: string,
+  fragments: ReadonlySet<string>,
+  threshold: number,
+  inlineRepeat: boolean,
+): string | null {
+  let run = 0;
+  for (const raw of text.split('\n')) {
+    const line = raw.trim();
+    const hits = line === '' ? 0 : countHits(line.toLowerCase(), fragments, inlineRepeat);
+    if (hits === 0) {
+      run = 0;
+      continue;
+    }
+    run += hits;
+    if (run >= threshold) {
+      return line;
+    }
+  }
+  return null;
+}

package/src/index.ts

@@ -1,48 +1,48 @@
-// dsh-repeat-guard — host 侧插件入口：拦截"复读"型退化输出。
-//
-// 做法：包一层 `llm/stream`（模型调用的流式 waterfall），逐 chunk 观察思考段
-// （reasoning-delta）。命中退化时，把触发退化的那个 delta 照常放行，补一个 block-end
-// 闭合思考块，再补一个 finish(stop)，然后直接结束流。对 agent-loop 而言这就是一次正常
-// 完成：已生成的思考照常落盘，本轮该走什么流程就走什么流程。
-//
-// 只检测思考段：正文 text-delta 不参与判定。复读退化先出现在思考段，那时正文往往还没
-// 开始产出；等正文也碎掉再掐，思考段已经白烧了一遍。
-//
-// 判定做什么：思考段里出现独占一行的表项（如"好。""执行。""Let me go."）就掐断，
-// 短句表与阈值都可配置，见 config.ts。不做形状归纳——归纳出的规则总会外溢误伤，表项则是
-// 具体、可增删、可审计的。
-//
-// 掐断之后要让本轮继续，而不是停下来等用户输入：挂在 `agent/turn-stopping` 上，在本轮
-// 边界提交之前调 `agent.steer(...)` 推一条输入，机器就会再跑一步。详见 resume.ts。
-//
-// 依赖：dsh 把 bundle 的 dependencies / peerDependencies 从安装目录软链进 profile
-// （dsh-app-boot 的 healProfileModuleFallback），所以本插件可以正常 import
-// `@deepseek-ai/*`——它们声明在 peerDependencies 里，由宿主提供。
-//
-// 本文件只做装配，具体逻辑在各自的模块里。
-
-import type { Context } from '@deepseek-ai/cordis';
-import { Config, createRuntime, type RepeatGuardConfigSchema } from './config.js';
-import { createStreamGuard } from './stream-guard.js';
-import { createTurnStoppingGuard } from './turn-stopping-guard.js';
-import type { GuardState } from './types.js';
-
-// 插件模块的导出形态：loader 的 unwrapExports 优先取 `default`，而 Config 必须挂在
-// 拿到的那一个对象上。所以这里不写 default 导出，而是与官方插件一样导出
-// `Config` + `apply` 两个具名，让 loader 直接拿到带 schema 的插件对象。
-export { Config };
-
-/**
- * 函数式插件入口。ctx 为 cordis 上下文，config 是 loader 解析后的配置，
- * 注册的监听随插件卸载自动释放。
- * @param ctx - 宿主 cordis 上下文。
- * @param config - 本插件的配置；volatile 字段是稳定引用，取值要 `.get()`。
- */
-export function apply(ctx: Context, config: RepeatGuardConfigSchema): void {
-  // 直接写 stdout：dsh 把插件的 stdout 收进 journal，便于确认插件确实被加载。
-  console.log('[repeat-guard] 已加载，复读拦截生效');
-  const state: GuardState = { pending: new Set() };
-  const runtime = createRuntime(ctx, config);
-  ctx.on('llm/stream', createStreamGuard(state, runtime.read, runtime.countHit), { global: true });
-  ctx.on('agent/turn-stopping', createTurnStoppingGuard(state, runtime.read));
-}
+// dsh-repeat-guard — host 侧插件入口：拦截"复读"型退化输出。
+//
+// 做法：包一层 `llm/stream`（模型调用的流式 waterfall），逐 chunk 观察思考段
+// （reasoning-delta）。命中退化时，把触发退化的那个 delta 照常放行，补一个 block-end
+// 闭合思考块，再补一个 finish(stop)，然后直接结束流。对 agent-loop 而言这就是一次正常
+// 完成：已生成的思考照常落盘，本轮该走什么流程就走什么流程。
+//
+// 只检测思考段：正文 text-delta 不参与判定。复读退化先出现在思考段，那时正文往往还没
+// 开始产出；等正文也碎掉再掐，思考段已经白烧了一遍。
+//
+// 判定做什么：思考段里出现独占一行的表项（如"好。""执行。""Let me go."）就掐断，
+// 短句表与阈值都可配置，见 config.ts。不做形状归纳——归纳出的规则总会外溢误伤，表项则是
+// 具体、可增删、可审计的。
+//
+// 掐断之后要让本轮继续，而不是停下来等用户输入：挂在 `agent/turn-stopping` 上，在本轮
+// 边界提交之前调 `agent.steer(...)` 推一条输入，机器就会再跑一步。详见 resume.ts。
+//
+// 依赖：dsh 把 bundle 的 dependencies / peerDependencies 从安装目录软链进 profile
+// （dsh-app-boot 的 healProfileModuleFallback），所以本插件可以正常 import
+// `@deepseek-ai/*`——它们声明在 peerDependencies 里，由宿主提供。
+//
+// 本文件只做装配，具体逻辑在各自的模块里。
+
+import type { Context } from '@deepseek-ai/cordis';
+import { Config, createRuntime, type RepeatGuardConfigSchema } from './config.js';
+import { createStreamGuard } from './stream-guard.js';
+import { createTurnStoppingGuard } from './turn-stopping-guard.js';
+import type { GuardState } from './types.js';
+
+// 插件模块的导出形态：loader 的 unwrapExports 优先取 `default`，而 Config 必须挂在
+// 拿到的那一个对象上。所以这里不写 default 导出，而是与官方插件一样导出
+// `Config` + `apply` 两个具名，让 loader 直接拿到带 schema 的插件对象。
+export { Config };
+
+/**
+ * 函数式插件入口。ctx 为 cordis 上下文，config 是 loader 解析后的配置，
+ * 注册的监听随插件卸载自动释放。
+ * @param ctx - 宿主 cordis 上下文。
+ * @param config - 本插件的配置；volatile 字段是稳定引用，取值要 `.get()`。
+ */
+export function apply(ctx: Context, config: RepeatGuardConfigSchema): void {
+  // 直接写 stdout：dsh 把插件的 stdout 收进 journal，便于确认插件确实被加载。
+  console.log('[repeat-guard] 已加载，复读拦截生效');
+  const state: GuardState = { pending: new Set() };
+  const runtime = createRuntime(ctx, config);
+  ctx.on('llm/stream', createStreamGuard(state, runtime.read, runtime.countHit), { global: true });
+  ctx.on('agent/turn-stopping', createTurnStoppingGuard(state, runtime.read));
+}