dsh-repeat-guard 0.1.5 → 0.2.1

package/README.md

@@ -102,6 +102,14 @@ Let me do it.
 dsh plugin --profile web add dsh-repeat-guard
 ```
 
+> **兼容性**：`0.2.0` 起要求 dsh **0.1.7 及以上**——0.1.7 起宿主会在装载前校验插件的
+> peer 声明，配置表单也换成了 entry Config 模型，旧写法在那上面不再工作。
+> dsh `0.1.0-rc.8` ~ `0.1.6` 请装 `0.1.5`：
+>
+> ```bash
+> dsh plugin --profile web add dsh-repeat-guard@0.1.5
+> ```
+
 ## 许可
 
 MIT，见 `LICENSE`。

package/lib/client.js

@@ -33,7 +33,7 @@ var __dshClientBundle = (() => {
   });
   var import_react = __require("react");
   var import_jsx_runtime = __require("react/jsx-runtime");
-  var SETTINGS_NS = "repeat-guard";
+  var ENTRY_ID = "dsh-repeat-guard";
   var THRESHOLD_MIN = 1;
   var THRESHOLD_MAX = 9;
   var FIELD = `height:36px;box-sizing:border-box;padding:0 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:transparent;color:var(--dsw-alias-label-primary);font-family:inherit;font-size:14px;line-height:22px`;
@@ -363,15 +363,15 @@ var __dshClientBundle = (() => {
       ] })
     ] });
   }
-  var inject = ["slots", "settingsScope"];
+  var inject = ["slots", "configForms"];
   function apply(ctx) {
     injectStyle();
-    const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NS });
+    const form = ctx.configForms.get(ENTRY_ID);
     function Panel() {
-      const [snapshot, setSnapshot] = (0, import_react.useState)(() => scope.getSnapshot());
+      const [snapshot, setSnapshot] = (0, import_react.useState)(() => form.getSnapshot());
       (0, import_react.useEffect)(
-        () => scope.subscribe(() => {
-          setSnapshot(scope.getSnapshot());
+        () => form.subscribe(() => {
+          setSnapshot(form.getSnapshot());
         }),
         []
       );
@@ -385,14 +385,14 @@ var __dshClientBundle = (() => {
           initial: value,
           count: value.count,
           onReset: async () => {
-            await scope.set("count", 0);
+            await form.set("count", 0);
           },
           onSave: async (next) => {
-            await scope.set("fragments", next.fragments);
-            await scope.set("threshold", next.threshold);
-            await scope.set("inlineRepeat", next.inlineRepeat);
-            await scope.set("resumeText", next.resumeText);
-            await scope.set("resumeSummary", next.resumeSummary);
+            await form.set("fragments", next.fragments);
+            await form.set("threshold", next.threshold);
+            await form.set("inlineRepeat", next.inlineRepeat);
+            await form.set("resumeText", next.resumeText);
+            await form.set("resumeSummary", next.resumeSummary);
           }
         }
       );

package/lib/config.d.ts

@@ -2,15 +2,20 @@
  * 插件配置：拦截短句表、连续命中阈值、行内重复检测、续跑注入的正文与摘要，
  * 外加一个运行时计数。
  *
- * 配置放在 dsh 的 settings 服务里（命名空间 repeat-guard）：宿主侧在这边注册
- * schema，客户端设置页写同一个命名空间。判定与续跑时现取，改完立即生效，不用重启。
+ * dsh 0.1.7 起，配置就是插件自己的 entry Config——标记 `.volatile()` 的字段由宿主
+ * 的设置表单读写，写回的是 profile 的 cordis patch。宿主侧不再注册命名空间，
+ * 而是持有这些稳定引用，需要时 `.get()` 现取，所以改完立即生效，不用重启。
  *
- * 计数也寄在同一个命名空间里：宿主侧每次掐断写一次，客户端读同一个值、清零就是
- * 把它写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
+ * 计数也寄在同一份配置里：宿主侧每次掐断写一次，客户端读同一个值、清零就是把它
+ * 写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
  */
 import type { Context } from '@deepseek-ai/cordis';
-/** settings 命名空间。客户端设置页必须写同一个值。 */
-export declare const SETTINGS_NS = "repeat-guard";
+import z from '@deepseek-ai/schemastery';
+/**
+ * profile 里本插件的条目 id。设置表单按它定位配置，宿主写回也要用它，
+ * 所以必须与 cordis.patch.yml 里的 `id` 逐字一致。
+ */
+export declare const ENTRY_ID = "dsh-repeat-guard";
 /** 默认的拦截短句表，标点照原样写。 */
 export declare const DEFAULT_FRAGMENTS: readonly string[];
 /** 默认阈值：1 表示发现即拦。 */
@@ -21,6 +26,27 @@ export declare const DEFAULT_INLINE_REPEAT = false;
 export declare const DEFAULT_RESUME_TEXT: string;
 /** 默认的折叠行摘要；客户端拿它渲染折叠的 context 行，不是用户气泡。 */
 export declare const DEFAULT_RESUME_SUMMARY = "\u590D\u8BFB\u5DF2\u622A\u65AD\uFF1A\u8BF7\u7EE7\u7EED\u6267\u884C";
+/**
+ * 插件 Config schema。只有标了 `.volatile()` 的字段会进设置表单并支持编辑，
+ * 其余字段仍是普通配置（只由 cordis 配置文件决定）。
+ */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    fragments: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    threshold: z<number, number, "volatile-defined">;
+    inlineRepeat: z<boolean, boolean, "volatile-defined">;
+    resumeText: z<string, string, "volatile-defined">;
+    resumeSummary: z<string, string, "volatile-defined">;
+    count: z<number, number, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    fragments: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    threshold: z<number, number, "volatile-defined">;
+    inlineRepeat: z<boolean, boolean, "volatile-defined">;
+    resumeText: z<string, string, "volatile-defined">;
+    resumeSummary: z<string, string, "volatile-defined">;
+    count: z<number, number, "volatile-defined">;
+}>>, "plain">;
+/** loader 解析后交给插件的配置：volatile 字段是稳定引用，取值要 `.get()`。 */
+export type RepeatGuardConfigSchema = Schemastery.TypeT<typeof Config>;
 /** 判定与续跑用得上的一份配置。 */
 export interface RepeatGuardConfig {
     /** 短句表，已全部小写化。 */
@@ -40,12 +66,13 @@ export type ConfigSource = () => RepeatGuardConfig;
 export interface GuardRuntime {
     /** 取当前配置。 */
     readonly read: ConfigSource;
-    /** 记一次拦截，把计数写回 settings。 */
+    /** 记一次拦截，把计数写回配置。 */
     readonly countHit: () => void;
 }
 /**
- * 注册配置命名空间，返回宿主侧要用的运行时句柄。
+ * 把 volatile 引用折叠成一份快照，返回宿主侧要用的运行时句柄。
  * @param ctx - 宿主 cordis 上下文。
+ * @param config - loader 解析后的本插件配置。
  * @returns 取配置与记数两个入口。
  */
-export declare function createRuntime(ctx: Context): GuardRuntime;
+export declare function createRuntime(ctx: Context, config: RepeatGuardConfigSchema): GuardRuntime;

package/lib/config.js

@@ -2,15 +2,19 @@
  * 插件配置：拦截短句表、连续命中阈值、行内重复检测、续跑注入的正文与摘要，
  * 外加一个运行时计数。
  *
- * 配置放在 dsh 的 settings 服务里（命名空间 repeat-guard）：宿主侧在这边注册
- * schema，客户端设置页写同一个命名空间。判定与续跑时现取，改完立即生效，不用重启。
+ * dsh 0.1.7 起，配置就是插件自己的 entry Config——标记 `.volatile()` 的字段由宿主
+ * 的设置表单读写，写回的是 profile 的 cordis patch。宿主侧不再注册命名空间，
+ * 而是持有这些稳定引用，需要时 `.get()` 现取，所以改完立即生效，不用重启。
  *
- * 计数也寄在同一个命名空间里：宿主侧每次掐断写一次，客户端读同一个值、清零就是
- * 把它写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
+ * 计数也寄在同一份配置里：宿主侧每次掐断写一次，客户端读同一个值、清零就是把它
+ * 写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
  */
 import z from '@deepseek-ai/schemastery';
-/** settings 命名空间。客户端设置页必须写同一个值。 */
-export const SETTINGS_NS = 'repeat-guard';
+/**
+ * profile 里本插件的条目 id。设置表单按它定位配置，宿主写回也要用它，
+ * 所以必须与 cordis.patch.yml 里的 `id` 逐字一致。
+ */
+export const ENTRY_ID = 'dsh-repeat-guard';
 /** 默认的拦截短句表，标点照原样写。 */
 export const DEFAULT_FRAGMENTS = [
     '好。',
@@ -58,13 +62,17 @@ export const DEFAULT_RESUME_TEXT = [
 ].join('\n');
 /** 默认的折叠行摘要；客户端拿它渲染折叠的 context 行，不是用户气泡。 */
 export const DEFAULT_RESUME_SUMMARY = '复读已截断：请继续执行';
-const SCHEMA = z.object({
-    fragments: z.array(z.string()).default([...DEFAULT_FRAGMENTS]),
-    threshold: z.number().default(DEFAULT_THRESHOLD),
-    inlineRepeat: z.boolean().default(DEFAULT_INLINE_REPEAT),
-    resumeText: z.string().default(DEFAULT_RESUME_TEXT),
-    resumeSummary: z.string().default(DEFAULT_RESUME_SUMMARY),
-    count: z.number().default(0),
+/**
+ * 插件 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(),
 });
 function compile(value) {
     return {
@@ -76,41 +84,38 @@ function compile(value) {
     };
 }
 /**
- * 注册配置命名空间，返回宿主侧要用的运行时句柄。
+ * 把 volatile 引用折叠成一份快照，返回宿主侧要用的运行时句柄。
  * @param ctx - 宿主 cordis 上下文。
+ * @param config - loader 解析后的本插件配置。
  * @returns 取配置与记数两个入口。
  */
-export function createRuntime(ctx) {
-    let current = compile({
-        fragments: DEFAULT_FRAGMENTS,
-        threshold: DEFAULT_THRESHOLD,
-        inlineRepeat: DEFAULT_INLINE_REPEAT,
-        resumeText: DEFAULT_RESUME_TEXT,
-        resumeSummary: DEFAULT_RESUME_SUMMARY,
+export function createRuntime(ctx, config) {
+    const read = () => compile({
+        fragments: config.fragments.get(),
+        threshold: config.threshold.get(),
+        inlineRepeat: config.inlineRepeat.get(),
+        resumeText: config.resumeText.get(),
+        resumeSummary: config.resumeSummary.get(),
     });
-    let bump;
+    let write;
     ctx.inject(['settings'], (settingsCtx) => {
-        const scope = settingsCtx.settings.register(SETTINGS_NS, SCHEMA);
-        const sync = () => {
-            current = compile(scope.get());
-        };
-        const write = (patch) => {
-            scope.update(patch).catch((error) => {
+        const settings = settingsCtx.settings;
+        // 本插件自带设置页，关掉宿主按 schema 自动生成的页面。
+        settingsCtx.effect(() => settings.configure({ auto: false }, ctx.fiber));
+        write = (count) => {
+            // 现取 revision：表单刚写过的话，旧 revision 会被 SETTINGS_CONFLICT 拒掉。
+            const revision = settings.describe().find((entry) => entry.ns === ENTRY_ID)?.revision;
+            settings.update(ENTRY_ID, { count }, revision).catch((error) => {
                 console.log(`[repeat-guard] 写设置失败：${String(error)}`);
             });
         };
-        sync();
-        scope.watch(sync);
         // 计数口径是"自本次启动或上次清零以来"。
-        write({ count: 0 });
-        bump = () => {
-            write({ count: scope.get().count + 1 });
-        };
+        write(0);
     });
     return {
-        read: () => current,
+        read,
         countHit: () => {
-            bump?.();
+            write?.(config.count.get() + 1);
         },
     };
 }

package/lib/index.d.ts

@@ -1,6 +1,10 @@
 import type { Context } from '@deepseek-ai/cordis';
+import { Config, type RepeatGuardConfigSchema } from './config.js';
+export { Config };
 /**
- * 函数式插件入口。ctx 为 cordis 上下文，注册的监听随插件卸载自动释放。
+ * 函数式插件入口。ctx 为 cordis 上下文，config 是 loader 解析后的配置，
+ * 注册的监听随插件卸载自动释放。
  * @param ctx - 宿主 cordis 上下文。
+ * @param config - 本插件的配置；volatile 字段是稳定引用，取值要 `.get()`。
  */
-export default function repeatGuard(ctx: Context): void;
+export declare function apply(ctx: Context, config: RepeatGuardConfigSchema): void;

package/lib/index.js

@@ -20,18 +20,24 @@
 // `@deepseek-ai/*`——它们声明在 peerDependencies 里，由宿主提供。
 //
 // 本文件只做装配，具体逻辑在各自的模块里。
-import { createRuntime } from './config.js';
+import { Config, createRuntime } from './config.js';
 import { createStreamGuard } from './stream-guard.js';
 import { createTurnStoppingGuard } from './turn-stopping-guard.js';
+// 插件模块的导出形态：loader 的 unwrapExports 优先取 `default`，而 Config 必须挂在
+// 拿到的那一个对象上。所以这里不写 default 导出，而是与官方插件一样导出
+// `Config` + `apply` 两个具名，让 loader 直接拿到带 schema 的插件对象。
+export { Config };
 /**
- * 函数式插件入口。ctx 为 cordis 上下文，注册的监听随插件卸载自动释放。
+ * 函数式插件入口。ctx 为 cordis 上下文，config 是 loader 解析后的配置，
+ * 注册的监听随插件卸载自动释放。
  * @param ctx - 宿主 cordis 上下文。
+ * @param config - 本插件的配置；volatile 字段是稳定引用，取值要 `.get()`。
  */
-export default function repeatGuard(ctx) {
+export function apply(ctx, config) {
     // 直接写 stdout：dsh 把插件的 stdout 收进 journal，便于确认插件确实被加载。
     console.log('[repeat-guard] 已加载，复读拦截生效');
     const state = { pending: new Set() };
-    const runtime = createRuntime(ctx);
+    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));
 }

package/lib/resume.d.ts

@@ -15,8 +15,17 @@
  * 推什么内容由配置决定（见 config.ts 的 resumeText / resumeSummary）。
  */
 import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { ContextFormed } from '@deepseek-ai/dsh-llm';
 import type { RepeatGuardConfig } from './config.js';
 import type { GuardState } from './types.js';
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        /** 本插件推给模型的续跑提示。 */
+        'plugin:repeat-guard': {
+            kind: 'plugin:repeat-guard';
+        } & ContextFormed;
+    }
+}
 /**
  * 本轮即将关闭时，若上一步刚被掐断过，就推一条输入让本轮继续。
  * @param state - 跨监听保留的拦截状态。

package/lib/resume.js

@@ -33,8 +33,7 @@ export function reviveTurn(state, agent, config) {
         // `form: 'notice'` 要求同时给出 `summary`（dsh-llm 的 ContextFormed），
         // 客户端据此把它渲染成折叠的 context 行，而不是用户气泡。
         source: {
-            kind: 'plugin',
-            plugin: 'repeat-guard',
+            kind: 'plugin:repeat-guard',
             form: 'notice',
             summary: config.resumeSummary,
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-repeat-guard",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "流式输出退化拦截：检测碎片复读，掐断本次生成并提醒模型直接执行工具调用",
   "type": "module",
   "main": "lib/index.js",
@@ -39,23 +39,23 @@
   "license": "MIT",
   "author": "yuqing",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.8 <0.1.1-0 || >=0.1.1-0 <0.1.2-0 || >=0.1.2-0 <0.1.3-0 || >=0.1.3-0 <0.1.4-0 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-0 <0.1.6-0 || >=0.1.6-0 <0.1.7-0",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.0-rc.8 <0.1.1-0 || >=0.1.1-0 <0.1.2-0 || >=0.1.2-0 <0.1.3-0 || >=0.1.3-0 <0.1.4-0 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-0 <0.1.6-0 || >=0.1.6-0 <0.1.7-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.8 <0.1.1-0 || >=0.1.1-0 <0.1.2-0 || >=0.1.2-0 <0.1.3-0 || >=0.1.3-0 <0.1.4-0 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-0 <0.1.6-0 || >=0.1.6-0 <0.1.7-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.8 <0.1.1-0 || >=0.1.1-0 <0.1.2-0 || >=0.1.2-0 <0.1.3-0 || >=0.1.3-0 <0.1.4-0 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-0 <0.1.6-0 || >=0.1.6-0 <0.1.7-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.8 <0.1.1-0 || >=0.1.1-0 <0.1.2-0 || >=0.1.2-0 <0.1.3-0 || >=0.1.3-0 <0.1.4-0 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-0 <0.1.6-0 || >=0.1.6-0 <0.1.7-0",
-    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-agent": ">=0.1.7-0 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-0 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-0 <0.1.8-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-0 <0.1.8-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-0 <0.1.8-0",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "react": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22.0.0",
     "@types/react": "^19.3.0",
     "esbuild": "^0.28.2",

package/src/client.tsx

@@ -11,13 +11,13 @@
 
 import type { Context } from '@deepseek-ai/cordis';
 // 空导入：只为加载这两处的 declaration merging（往 cordis 的 Context 上补
-// slots 与 settingsScope 两个客户端服务）。
+// slots 与 configForms 两个客户端服务）。
 import type {} from '@deepseek-ai/dsh-client-ui-renderer/client';
 import type {} from '@deepseek-ai/dsh-client-ui-settings/client';
 import { useEffect, useState, type KeyboardEvent, type ReactElement } from 'react';
 
-/** settings 命名空间，必须与宿主侧 config.ts 的 SETTINGS_NS 逐字一致。 */
-const SETTINGS_NS = 'repeat-guard';
+/** profile 条目 id，必须与宿主侧 config.ts 的 ENTRY_ID 逐字一致。 */
+const ENTRY_ID = 'dsh-repeat-guard';
 
 /** 阈值步进器的取值边界。 */
 const THRESHOLD_MIN = 1;
@@ -408,7 +408,7 @@ function Form({ initial, count, onReset, onSave }: FormProps): ReactElement {
 }
 
 /** 注册设置页需要的服务；这两个是 cordis 服务名，不是包名。 */
-export const inject = ['slots', 'settingsScope'];
+export const inject = ['slots', 'configForms'];
 
 /**
  * 客户端插件入口。
@@ -416,14 +416,15 @@ export const inject = ['slots', 'settingsScope'];
  */
 export function apply(ctx: Context): void {
   injectStyle();
-  const scope = ctx.settingsScope.bind<RepeatGuardSettings>({ namespace: SETTINGS_NS });
+  // 0.1.7 起表单按 profile 条目 id 定位；快照与写入接口同形。
+  const form = ctx.configForms.get<RepeatGuardSettings>(ENTRY_ID);
 
   function Panel(): ReactElement {
-    const [snapshot, setSnapshot] = useState(() => scope.getSnapshot());
+    const [snapshot, setSnapshot] = useState(() => form.getSnapshot());
     useEffect(
       () =>
-        scope.subscribe(() => {
-          setSnapshot(scope.getSnapshot());
+        form.subscribe(() => {
+          setSnapshot(form.getSnapshot());
         }),
       [],
     );
@@ -436,14 +437,14 @@ export function apply(ctx: Context): void {
         initial={value}
         count={value.count}
         onReset={async () => {
-          await scope.set('count', 0);
+          await form.set('count', 0);
         }}
         onSave={async (next) => {
-          await scope.set('fragments', next.fragments);
-          await scope.set('threshold', next.threshold);
-          await scope.set('inlineRepeat', next.inlineRepeat);
-          await scope.set('resumeText', next.resumeText);
-          await scope.set('resumeSummary', next.resumeSummary);
+          await form.set('fragments', next.fragments);
+          await form.set('threshold', next.threshold);
+          await form.set('inlineRepeat', next.inlineRepeat);
+          await form.set('resumeText', next.resumeText);
+          await form.set('resumeSummary', next.resumeSummary);
         }}
       />
     );

package/src/config.ts

@@ -2,11 +2,12 @@
  * 插件配置：拦截短句表、连续命中阈值、行内重复检测、续跑注入的正文与摘要，
  * 外加一个运行时计数。
  *
- * 配置放在 dsh 的 settings 服务里（命名空间 repeat-guard）：宿主侧在这边注册
- * schema，客户端设置页写同一个命名空间。判定与续跑时现取，改完立即生效，不用重启。
+ * dsh 0.1.7 起，配置就是插件自己的 entry Config——标记 `.volatile()` 的字段由宿主
+ * 的设置表单读写，写回的是 profile 的 cordis patch。宿主侧不再注册命名空间，
+ * 而是持有这些稳定引用，需要时 `.get()` 现取，所以改完立即生效，不用重启。
  *
- * 计数也寄在同一个命名空间里：宿主侧每次掐断写一次，客户端读同一个值、清零就是
- * 把它写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
+ * 计数也寄在同一份配置里：宿主侧每次掐断写一次，客户端读同一个值、清零就是把它
+ * 写成 0。插件加载时先把它归零，所以口径是"自本次启动或上次清零以来"。
  */
 
 import type { Context } from '@deepseek-ai/cordis';
@@ -14,8 +15,11 @@ import type { Context } from '@deepseek-ai/cordis';
 import type {} from '@deepseek-ai/dsh-settings';
 import z from '@deepseek-ai/schemastery';
 
-/** settings 命名空间。客户端设置页必须写同一个值。 */
-export const SETTINGS_NS = 'repeat-guard';
+/**
+ * profile 里本插件的条目 id。设置表单按它定位配置，宿主写回也要用它，
+ * 所以必须与 cordis.patch.yml 里的 `id` 逐字一致。
+ */
+export const ENTRY_ID = 'dsh-repeat-guard';
 
 /** 默认的拦截短句表，标点照原样写。 */
 export const DEFAULT_FRAGMENTS: readonly string[] = [
@@ -69,15 +73,22 @@ export const DEFAULT_RESUME_TEXT = [
 /** 默认的折叠行摘要；客户端拿它渲染折叠的 context 行，不是用户气泡。 */
 export const DEFAULT_RESUME_SUMMARY = '复读已截断：请继续执行';
 
-const SCHEMA = z.object({
-  fragments: z.array(z.string()).default([...DEFAULT_FRAGMENTS]),
-  threshold: z.number().default(DEFAULT_THRESHOLD),
-  inlineRepeat: z.boolean().default(DEFAULT_INLINE_REPEAT),
-  resumeText: z.string().default(DEFAULT_RESUME_TEXT),
-  resumeSummary: z.string().default(DEFAULT_RESUME_SUMMARY),
-  count: z.number().default(0),
+/**
+ * 插件 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 {
   /** 短句表，已全部小写化。 */
@@ -99,7 +110,7 @@ export type ConfigSource = () => RepeatGuardConfig;
 export interface GuardRuntime {
   /** 取当前配置。 */
   readonly read: ConfigSource;
-  /** 记一次拦截，把计数写回 settings。 */
+  /** 记一次拦截，把计数写回配置。 */
   readonly countHit: () => void;
 }
 
@@ -120,43 +131,41 @@ function compile(value: {
 }
 
 /**
- * 注册配置命名空间，返回宿主侧要用的运行时句柄。
+ * 把 volatile 引用折叠成一份快照，返回宿主侧要用的运行时句柄。
  * @param ctx - 宿主 cordis 上下文。
+ * @param config - loader 解析后的本插件配置。
  * @returns 取配置与记数两个入口。
  */
-export function createRuntime(ctx: Context): GuardRuntime {
-  let current = compile({
-    fragments: DEFAULT_FRAGMENTS,
-    threshold: DEFAULT_THRESHOLD,
-    inlineRepeat: DEFAULT_INLINE_REPEAT,
-    resumeText: DEFAULT_RESUME_TEXT,
-    resumeSummary: DEFAULT_RESUME_SUMMARY,
-  });
-  let bump: (() => void) | undefined;
+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 scope = settingsCtx.settings.register(SETTINGS_NS, SCHEMA);
-    const sync = (): void => {
-      current = compile(scope.get());
-    };
-    const write = (patch: object): void => {
-      scope.update(patch).catch((error: unknown) => {
+    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)}`);
       });
     };
-    sync();
-    scope.watch(sync);
     // 计数口径是"自本次启动或上次清零以来"。
-    write({ count: 0 });
-    bump = (): void => {
-      write({ count: scope.get().count + 1 });
-    };
+    write(0);
   });
 
   return {
-    read: () => current,
+    read,
     countHit: () => {
-      bump?.();
+      write?.(config.count.get() + 1);
     },
   };
 }

package/src/index.ts

@@ -22,20 +22,27 @@
 // 本文件只做装配，具体逻辑在各自的模块里。
 
 import type { Context } from '@deepseek-ai/cordis';
-import { createRuntime } from './config.js';
+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 上下文，注册的监听随插件卸载自动释放。
+ * 函数式插件入口。ctx 为 cordis 上下文，config 是 loader 解析后的配置，
+ * 注册的监听随插件卸载自动释放。
  * @param ctx - 宿主 cordis 上下文。
+ * @param config - 本插件的配置；volatile 字段是稳定引用，取值要 `.get()`。
  */
-export default function repeatGuard(ctx: Context): void {
+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);
+  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));
 }

package/src/resume.ts

@@ -17,9 +17,23 @@
 
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import type { ContextFormed } from '@deepseek-ai/dsh-llm';
 import type { RepeatGuardConfig } from './config.js';
 import type { GuardState } from './types.js';
 
+// dsh 0.1.7 起 `MessageSourceMap` 没有通用的 `plugin` kind：每个生产者在自己的模块里
+// 声明自己的 kind（merge-extensible），`form` 另由 ContextFormed 提供。
+// 用 `plugin:<名>` 而不是裸名：会话格式 v3→v4 的迁移器对历史消息生成的正是这个前缀
+// （dsh-session-format-v3-to-v4 的 producerKind），裸名会让同一生产者出现两种 kind。
+declare module '@deepseek-ai/dsh-llm' {
+  interface MessageSourceMap {
+    /** 本插件推给模型的续跑提示。 */
+    'plugin:repeat-guard': {
+      kind: 'plugin:repeat-guard';
+    } & ContextFormed;
+  }
+}
+
 /**
  * 本轮即将关闭时，若上一步刚被掐断过，就推一条输入让本轮继续。
  * @param state - 跨监听保留的拦截状态。
@@ -39,8 +53,7 @@ export function reviveTurn(state: GuardState, agent: Agent, config: RepeatGuardC
       // `form: 'notice'` 要求同时给出 `summary`（dsh-llm 的 ContextFormed），
       // 客户端据此把它渲染成折叠的 context 行，而不是用户气泡。
       source: {
-        kind: 'plugin',
-        plugin: 'repeat-guard',
+        kind: 'plugin:repeat-guard',
         form: 'notice',
         summary: config.resumeSummary,
       },