dsh-repeat-guard 0.1.4 → 0.2.0

package/README.md

@@ -1,182 +1,100 @@
 # dsh-repeat-guard
 
-拦截思考段的"复读"退化：模型在思考里陷入反复输出"好。""执行。"这类碎片空话时，掐断本次生成，并让本轮继续往下跑，而不是停下来等用户输入。
-
-| 项 | 说明 |
-|---|---|
-| 类型 | dsh bundle，含宿主侧插件与客户端设置页 |
-| 监听 | `llm/stream`、`agent/turn-stopping` |
-| 入口 | `lib/index.js`（`src/index.ts`）、`lib/client.js`（`src/client.tsx`） |
-| 可调项 | 拦截短句表、连续命中阈值、行内重复检测、续跑指令与折叠摘要（设置 → 复读打断） |
-| 分发 | npm 包 `dsh-repeat-guard` |
-
----
-
-## 它解决什么问题
-
-模型退化时，思考段里会出现整行都是空话的情况，如"好。""执行。""OK." "Let me go."。
-
-这类思考本身不含信息，但会一直持续到 token 耗尽，把一次本可以正常完成的任务拖垮。
-
-## 检测范围
-
-**只看思考段（`reasoning-delta`），正文（`text-delta`）不参与判定，原样透传。**
-
-复读退化先出现在思考段，那时正文往往还没开始产出；等正文也碎掉再掐，思考段已经白烧了一遍。
-
-## 判据：查表
-
-判定不做任何"形状归纳"，只查一张表：**思考里有没有独占一行的表项**。
-
-最初试过两条归纳式判据，都被证伪：
-
-1. **数碎片重复了几次**（"好，好，好，好"）。它不看句子结构，只看重复次数，于是"然后，然后，然后，"（逗号被当作片段分隔符）这类正常句子会被判成复读。
-2. **按形状判断空话行**（中文去标点后 ≤2 字、英文 ≤3 词）。形状规则必然外溢："解。""豫。"这种被换行切开的半截词也满足形状，实测在大段正常思考里频繁误杀。
-
-表项是具体的、可增删的、可审计的，不会外溢。规则只有一条：
+> 解决大模型用你的token唱歌的糟糕问题
 
+我们发现部分模型（尤其是`deepseek v4.1 flash`）很容易在长上下文时进入复读状态。
+dsh社区中称呼这种情况为“唱歌”，典型的表现如下所示：
 ```
-整行去掉首尾空白 → 转小写 → 查表
+Let me do it.
+Let me run.
+Let me go.
+Let me do it.
+...
 ```
-
-| 输入 | 结果 |
-|---|---|
-| `好。` `好的。` `执行。` `写。` `明白。` | 拦（表内） |
-| `OK.` `Sure.` `Let me go.` `Got it.` | 拦（表内） |
-| `查一下。` `这需要我。` | 不拦（表外） |
-| `A.` `1.` | 不拦（表外） |
-| `然后，` `注意：` `好的，` | 不拦（表外） |
-| `好？` `好！` `好` `OK` | 不拦（表外） |
-| `我需要检查实现。\n然后重新编译。` | 不拦（各行都在表外） |
-
-表项**连标点一起写**（`'好的。'` 对应思考里的 `好的。`），英文条目一律写小写。分割单位是单个换行，空行会把连续计数打断。
-
-### 行内重复检测（默认关）
-
-上面那条规则只认"独占一行的整句"，所以 `好。好。好。` 这种挤在一行里的重复看不见——对 DeepSeek 够用，但有些模型是单行循环的，所以留了这个开关。
-
-打开之后多一条判据：**整行由一个或多个表项首尾相接拼成**，也算命中（`好。好。好。`、`好。ok.好。`）。它仍然不会误杀——`我觉得可以。好。` 的前面那截不是表项、整行拼不出来，放行；`好的，好的` 也放行（表项是带句号的 `好的。`，这里是逗号）。
-
-计数单位同时从"行"变成"表项"：整行全等算一次，行内每一段各算一次。所以阈值 2 配上它时，`好。好。` 这种一行两段的也会被拦。
-
-**表可以在设置里改**（见下面「可调项」）；`src/config.ts` 的 `DEFAULT_FRAGMENTS` 是出厂默认值。
-
-已知边界：判据只看"有没有这样一行"，不看上下文。所以"用户想让我改代码。\n好的。"这种**前面有实质内容、结尾又跟一句空话**的思考也会被拦。这是"按行判定"的直接结果。
-
-## 连续命中阈值
-
-阈值 `threshold` 是"连着几行命中才拦"：
-
-| 值 | 行为 |
-|---|---|
-| 1（默认） | 任意一行命中即拦 |
-| n | 连着 n 行都是表项（**句子可以各不相同**）才拦；中间夹一行不命中的就重新计数 |
-
-阈值只在**同一次生成内**计数，不跨轮次。
-
-## 命中在思考段末尾时不拦
-
-命中之后，插件再往下探一格：
-
-- 后面还是 `reasoning-delta` → 思考确实在继续复读，**拦**；
-- 后面换成正文、工具调用，或直接收尾（`block-end` / `usage` / `finish` / 流结束）→ 说明命中行本来就是这段思考的最后一句，**不拦**，原样透传。
-
-判据是**思考段是否还在往下写**，不是整个响应是否结束——思考以一句"好。"收尾、接着写正文，属正常收尾。
-
-## 工作原理
-
-1. 包一层 `llm/stream`（模型调用的流式 waterfall），逐 chunk 观察 `reasoning-delta`，累积本次响应已产出的思考文本。
-2. 命中退化时，把触发退化的那个 delta 照常放行，补一个 `block-end` 闭合思考块，再补一个 `finish(stop)`，然后结束流。对 agent-loop 而言这就是一次正常完成：已生成的思考照常落盘，本轮该走什么流程就走什么流程。
-3. 提前结束流时显式向下游传播 `iterator.return()`，否则上游 HTTP 流会继续跑到结束，供应商照常计满 token，且连接悬挂。
-4. 光截断只会让本轮就此结束、停下来等用户输入。所以再挂一个 `agent/turn-stopping` 监听器，在本轮边界提交之前调 `agent.steer(...)` 推一条输入，本轮就会接着再跑一步。
-
-辅助调用（上下文压缩、会话标题等带 `purpose` 的调用）不参与检测。
-
-三种结局各有日志，便于事后核对误杀：
-
+如果在预设或者`AGENTS.md`中约束使用中文思考，则会变成如下的场景：
 ```
-[repeat-guard] 检出思考段复读，已掐断本次生成 | 会话=… | 命中行="好的。"
-[repeat-guard] 命中行位于思考段末尾，未拦截 | 会话=… | 命中行="好的。"
-[repeat-guard] turn-stopping：会话 … 续跑一步
+好。
+做。
+开始。
+做。
+嗯。
+做。
+我必须开始工作了。
+好。
+做。
+...
 ```
+配合`deepseek v4.1 flash`高达 300tok/s 的恐怖输出速率，模型可能会以极为可观的速度消耗token，而不产生任何有效输出。
 
-## 掐断之后怎么让本轮继续
+这通常是比较隐蔽的，尤其是在用户没有注意模型的思考过程的时候。用户实际上只会看到思考过程快速闪过很短的句子，回答好像很正常。
 
-dsh 的 turn 循环（`dsh-agent-loop/lib/index.js:966-973`）：
+在上下文长度达到 300k 以上的时候，该现象会变得十分频繁。
 
-```js
-if (turnEnds && this.inbox.nextStep.length === 0) {
-  await this.dispatch.serial("agent/turn-stopping", { turn, signal });
-}
-if (turnEnds && this.inbox.nextStep.length === 0) break;   // 重读收件箱
+不仅如此，我们也观察到`deepseek v4.1 flash`有着在已经思考到需要工具调用的时候输出一个短句，接下来又进入另一个方向的复杂思考过程的倾向。如下所示：
+```
+我已经收集到了足够的信息，接下来开始操作。先修改xxx文件。
+做。
+但是我还发现仓库里有其它的内容。注意到用户提到xxxxx
+...
 ```
 
-`agent/turn-stopping` 在 `break` 之前被 `await`，之后收件箱会被**重新读一次**。所以只要监听器往 `inbox.nextStep` 里推入东西，本轮就不 break，而是再跑一步。官方对该事件的说明也写明了这个用法，先例见 `dsh-hooks-claude-code/lib/index.js:300`。
-
-注意：
-
-- **做不到"这一步当作没发生"。** 被截断的 assistant 消息在 `step()` 里已经 `session.append` 落盘，dsh 没有回滚一步的机制；`step()` 唯一返回 `null`（循环继续）的出口要求本步真的产生了 tool-call，插件够不着。所以这里的语义是"接着再跑一步"，会话里会留下被截断的思考记录。
-- **续跑没有次数配额。** 有标记就推，同一轮里反复退化就反复续跑。
+显然这不是我们想要的行为。既然模型已经清楚下一步的工作是什么，就应该直接开始工具调用。
 
-## 可调项
+我们还注意到上述问题只出现于思考过程而不出现于回答内容。
+## 此插件的功能
 
-在 **设置 → 复读打断** 里改，保存后宿主侧立即按新配置判定，不用重启。
+此插件致力于解决上述模型复读和无端长思考的问题。它会持续检测模型的输出，如果思考过程出现了一个**白名单**中的短句且单独成段，且模型在输出这个短句后既然有继续思考的意图，我们就会强行中断对话，并发送一句提醒，让模型直接开始下一轮的输出。
 
-| 项 | 含义 |
-|---|---|
-| 累计拦截 | 自本次启动或上次清零以来掐断过多少次（只读，旁边有清零按钮） |
-| 拦截短句 | 判为复读的空话短句表，一行一句，连标点一起写 |
-| 连续命中次数 | 连着几次命中才拦；默认 1 = 发现即拦 |
-| 行内重复检测 | 打开后"好。好。好。"这种挤在一行里的重复也算命中；默认关 |
-| 续跑指令 | 截断后推给模型的指令正文，整段照发 |
-| 折叠行摘要 | 那条注入消息在会话里的折叠行摘要 |
+例如
+```
+[深度思考]
+  直接检查服务器状态和崩溃日志。
 
-配置存在 dsh 的 settings 服务里（命名空间 `repeat-guard`），落盘在 `~/.dsh/settings.yaml` 的 `repeat-guard:` 节下。
+  关键：先看最新日志和 crash-reports。
 
-**累计计数也寄在这个命名空间里**——宿主侧每掐断一次写一次，客户端读同一个值，清零就是把它写成 0。这样不用另开 host↔client 通道，代价是它跟着配置一起落盘；插件加载时会先把它归零，所以口径是"自本次启动或上次清零以来"。计数只在**真的掐断**时 +1，命中却落在思考段末尾（未拦截）的那种不计。
+  执行。 <--打断
 
-## 续跑时推给模型的输入
+[复读拦截]
+  你上一段思考退化成了碎片复读（反复输出"好。"一类的空话），已被系统截断。
+  请直接继续执行下一步，不要再输出任何确认语、寒暄或空话。
 
-默认正文（可在设置里改）：
+[深度思考]
+  直接调用工具，检查服务器状态和崩溃日志。
 
-```
-[复读拦截]
-你上一段思考退化成了碎片复读（反复输出"好。"一类的空话），已被系统截断。
-请直接继续执行下一步，不要再输出任何确认语、寒暄或空话。
+[tool calls]
+  ssh -o ConnectTimeout=10 -o BatchMode=yes ...
+...
 ```
 
-这条消息带 `source.kind = 'plugin'`，客户端按 `source.summary`（同样可配置）渲染成折叠的 context 行，不是用户气泡。
+## 工作原理
 
-## 构建
+逐 chunk 观察 `reasoning-delta`，检查思考文本。
 
-```bash
-npm install
-npm run build        # tsc 产出 lib/*.js，再用 esbuild 打 lib/client.js
-```
+独立段命中白名单时，向模型传递中断请求，掐断模型输出的片段，并补充结束标志，伪装成正常结束的思考过程。
 
-两步各有各的产物：
+向模型发送一条注入提示词，以恢复`agent-loop`。
 
-- `tsc` 编译 `src/*.ts` → `lib/*.js`，宿主侧入口就是 `lib/index.js`（真正被 dsh import 的部分）。
-- `scripts/build-client.mjs` 用 esbuild 把 `src/client.tsx` 打成**单文件** `lib/client.js`，外面套一层 dsh 客户端模块系统要求的包装：
+用户会通过注入提示词这个步骤看到大模型被中断的过程，因此步骤可能会变得很多。这是不得不付出的代价。
 
-  ```js
-  window.__ModuleLoader__.load({ id: "dsh-repeat-guard", factory: function (require) { … } });
-  ```
+> 虽然我们可以将下一步思考的过程接到上一轮打断的位置以伪装成什么都没发生过的样子，但是一方面这种做法有风险，另一方面不是很有利于缓存命中。更何况，这也能帮助用户判断插件是否在正常工作。
 
-  `id` 必须是包名，`factory` 的返回值就是该包的客户端模块导出。`react` 等平台基座模块由模块系统提供，构建时设为 external，运行时从 `factory` 的 `require` 参数取。
+## 可配置选项
 
-`lib/` **不进版本库**：`npm publish` 前由 `prepack` 钩子现构建，随包发布（`files` 字段已含 `lib`）。这样"改了 `src/` 忘了 build"不会让旧产物静默跟着提交——代价是构建失败时发不出去，这是有意的。
+在 **设置 → 复读打断** 里查看，保存后生效，无需重启。
 
-## 发布
+| 项 | 含义 |
+|---|---|
+| 累计拦截 | 掐断次数（有清零按钮） |
+| 拦截短句 | 触发打断的白名单，需要加上标点 |
+| 连续命中次数\* | 连续命中的阈值，如果为2就需要连续出现两个短句才触发 |
+| 行内重复检测\* | 打开后"好。好。好。"这种挤在一行里的重复也算命中。 |
+| 续跑指令 | 截断后推给模型的提示词 |
+| 折叠行摘要 | 注入段用户可见的简要信息 |
 
-```bash
-npm login   --registry=https://registry.npmjs.org
-npm publish --registry=https://registry.npmjs.org
-```
+> \* 连续的意思是中间没有长段。如果配置成2就只会拦截循环，默认配置连一个短句后的分支思考过程也会拦下。
 
-**两条命令都别省 `--registry`。** npm 的凭据是**按源绑定**的：`npm login` 登的是哪个源，`~/.npmrc` 里就只在那个源下记一条 `//registry.npmjs.org/:_authToken`。所以 `npm config get registry` 一旦被切到 npmmirror 这类只读镜像（它本身也发不上去），不带参数的 `npm publish` 会直接报 `need auth`。
+> \*deepseek不存在行内重复问题，这个选项是为 qwen 35B 这样的模型准备的。
 
-发布前不必手动构建，`prepack` 会跑一次 `npm run build`；tsc 或 esbuild 报错则发布中止。
 
 ## 安装到 dsh
 
@@ -184,70 +102,13 @@ npm publish --registry=https://registry.npmjs.org
 dsh plugin --profile web add dsh-repeat-guard
 ```
 
-本插件是一个 **dsh bundle**——包根带 `cordis.patch.yml`，由 `package.json` 的 `dsh.bundle.patch` 声明。装进 profile 时它会自动进入 `dsh.profile.bundles` 分层栈，**不需要改 profile 自己的 `cordis.patch.yml`**。客户端半靠 `package.json` 的 `dsh.client` 声明被自动发现，同样不用改 profile。
-
-装完**必须重启 dsh 进程**。`patchReload: live` 只重载已有的层，不会加载新增的层——实测编辑后运行中的进程既不加载也不报错。
-
-机制（dsh 源码）：`dsh plugin` 是 pnpm 转发器（`dsh/lib/plugin-*.js`），在 profile 目录跑 `pnpm add` 后按**安装后的真实包名**调和 `dsh.profile.bundles`，判定条件就是 `dsh.bundle.patch` 是否为 undefined（没有就印一句 "declares no dsh.bundle — installed as a plain dependency, not a profile layer"）。加载时 `dsh-app-boot` 的 `loadProfileDirectory` 对该字段做 `join(packageDir, declared)` 并当 overlay patch 读；声明缺失直接抛错。
-
-**只走 npm 分发。** git 安装（`add github:...`）会让 pnpm 拦下依赖的构建脚本，装出来的包没有 `lib/index.js`，除非安装者手工去 profile 的 `pnpm-workspace.yaml` 加 `allowBuilds` 白名单——那等于把本机的构建配置摊派给每个使用者。本地目录安装同理，只适合开发调试，不作为分发方式。
-
-验证是否加载：
-
-```bash
-journalctl --user -u dsh-web --no-pager | grep -a repeat-guard
-# [repeat-guard] 已加载，复读拦截生效
-```
-
-⚠️ 插件加载失败会让 **dsh 启动直接失败**，而 dsh-web 是本机 GUI 的唯一通道。改完先离线验证再重启：用假上下文 import 产物调一次入口，或喂一段真实 chunk 序列。
-
-## 依赖
-
-dsh 会把 bundle 声明的 `dependencies` 与 `peerDependencies` 从安装目录软链进 profile（`dsh-app-boot` 的 `healProfileModuleFallback`，依赖名取自 `profileDependencyNames(manifest)`，注释原文是 "dependency names that may be imported by a loader-visible plugin"）。软链落在 `~/.dsh/profiles/node_modules/`，Node 按常规向上查找即可解析到。
-
-dsh 的 profile 同时带一份 `.npmrc`，写着 `auto-install-peers=false`（注释：core packages come from the CLI dependency tree; a profile must never resolve its own copy）——所以声明 `peerDependencies` 不会让 profile 自己再装一份宿主包。
-
-所以：
-
-- **宿主提供的包写 `peerDependencies`**：`@deepseek-ai/cordis`、`dsh-llm`、`dsh-agent`、`dsh-settings`、`schemastery`、`dsh-client-ui-renderer`、`dsh-client-ui-settings`，以及客户端侧由平台基座提供的 `react`。它们不在 profile 里重复安装，用 dsh 自带的那份。
-- **类型一律从官方引**，不在本地重抄。`Context`、`StreamChunk`、`GenerateOptions`、`Agent`、`SettingsScope` 都是 dsh 导出的；本地抄一份只会在 dsh 升级后于运行时暴露字段对不上，官方声明则会在 `tsc` 阶段直接报错。
-- `src/types.ts` 只放本插件自有的类型（当前是 `GuardState`）。
-- 部分 dsh 包的类型只通过 module augmentation 生效（如 `Context.settings`、`Context.slots`、`Context.settingsScope`），要显式 `import type {} from '…'` 触发加载，否则 `tsc` 会报"属性不存在"。
-- dsh 的 loader 是原生 ESM import，**没有转译层**，运行时读到的永远是编译产物——改完 `src/` 必须重新构建。`lib/` 只随 npm 包发布，不进版本库。
-
-## 代码约定
-
-| 项 | 约定 |
-|---|---|
-| 缩进 / 引号 / 分号 | 2 空格、单引号、语句末分号 |
-| 行宽 | 目标 100 字符，上限 120（中英混排按字符数计） |
-| 控制语句 | **一律带花括号**，单行 `if`、`continue`、`break` 也不例外，不写 `if (x) return;` |
-| 文件 | 一个文件只干一件事：类型声明 / 配置 / 判定 / 续跑 / 单个监听器 / 装配，各占一个文件 |
-| 函数 | 不超过 50 行；超了就先看能不能按职责拆开 |
-| 注释 | 一律中文；导出函数与判定函数配 `@param` / `@returns`，文件内小工具函数用单行注释即可 |
-
-排版细节已固化在 `.editorconfig`。花括号、文件职责、函数行数这三条没有配置项可表达，只能靠人工遵守。
-
-## 目录结构
-
-```
-.
-├── src/
-│   ├── index.ts                 宿主侧入口：装配状态，注册两个监听器（只做装配）
-│   ├── types.ts                 本插件自有的类型（dsh 的接口一律从 @deepseek-ai/* 引）
-│   ├── config.ts                配置：settings 命名空间、默认值、schema、取当前值
-│   ├── detect.ts                复读判定：查表 + 连续计数，不碰会话状态
-│   ├── resume.ts                续跑：注入文案、消息构造、推送
-│   ├── stream-guard.ts          llm/stream 监听器：思考段检测与掐断
-│   ├── turn-stopping-guard.ts   agent/turn-stopping 监听器：让本轮继续
-│   └── client.tsx               客户端设置页：注册 settings.section
-├── scripts/
-│   └── build-client.mjs         esbuild 打包客户端半 → lib/client.js
-├── lib/                         构建产物（已 gitignore），dsh 加载 lib/index.js 与 lib/client.js
-├── cordis.patch.yml             bundle 层声明：把本插件挂进 profile 树
-├── package.json
-└── tsconfig.json
-```
+> **兼容性**：`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
+> ```
 
 ## 许可
 

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 {
+        /** 本插件推给模型的续跑提示。 */
+        'repeat-guard': {
+            kind: '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: 'repeat-guard',
             form: 'notice',
             summary: config.resumeSummary,
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-repeat-guard",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "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.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-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,21 @@
 
 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 提供。
+declare module '@deepseek-ai/dsh-llm' {
+  interface MessageSourceMap {
+    /** 本插件推给模型的续跑提示。 */
+    'repeat-guard': {
+      kind: 'repeat-guard';
+    } & ContextFormed;
+  }
+}
+
 /**
  * 本轮即将关闭时，若上一步刚被掐断过，就推一条输入让本轮继续。
  * @param state - 跨监听保留的拦截状态。
@@ -39,8 +51,7 @@ export function reviveTurn(state: GuardState, agent: Agent, config: RepeatGuardC
       // `form: 'notice'` 要求同时给出 `summary`（dsh-llm 的 ContextFormed），
       // 客户端据此把它渲染成折叠的 context 行，而不是用户气泡。
       source: {
-        kind: 'plugin',
-        plugin: 'repeat-guard',
+        kind: 'repeat-guard',
         form: 'notice',
         summary: config.resumeSummary,
       },