@zhin.js/plugin-repeater 1.0.0 → 1.1.0

package/{skills/repeater/SKILL.md → agent/skills/repeater.md}

@@ -1,7 +1,7 @@
 ---
 name: repeater
 description: >-
-  复读机：群内连续多人发送相同消息时 Bot 自动跟读。纯中间件行为，
+  复读机：群内连续多人发送相同消息时 Endpoint 自动跟读。纯中间件行为，
   由阈值和冷却配置控制，无 AI 工具。
 keywords:
   - repeater
@@ -18,7 +18,7 @@ tools: []
 
 # 复读机
 
-中间件自动检测群内连续相同消息，达到阈值后 Bot 跟读一次。无 AI 工具可调用。
+中间件自动检测群内连续相同消息，达到阈值后 Endpoint 跟读一次。无 AI 工具可调用。
 
 ## 行为
 

package/commands/repeater-status.js

@@ -0,0 +1,9 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { getRepeaterEngine, resolveRepeaterConfig, } from "../lib/engine.js";
+export default defineCommand({
+    description: '查看复读机的运行状态',
+    execute({ config }) {
+        return getRepeaterEngine().statusLines(resolveRepeaterConfig(config));
+    },
+});

package/commands/repeater-status.ts

@@ -0,0 +1,13 @@
+import { defineCommand } from 'zhin.js/command';
+import {
+  getRepeaterEngine,
+  resolveRepeaterConfig,
+  type RepeaterConfig,
+} from '../src/engine.js';
+
+export default defineCommand<RepeaterConfig>({
+  description: '查看复读机的运行状态',
+  execute({ config }) {
+    return getRepeaterEngine().statusLines(resolveRepeaterConfig(config));
+  },
+});

package/lib/engine.d.ts

@@ -0,0 +1,45 @@
+export interface RepeaterConfig {
+    readonly threshold: number;
+    readonly cooldown: number;
+    readonly maxLength: number;
+}
+export declare const DEFAULT_REPEATER_CONFIG: RepeaterConfig;
+export declare function resolveRepeaterConfig(raw: unknown): RepeaterConfig;
+export interface RepeaterInboundFields {
+    readonly conversation: {
+        readonly kind: 'private' | 'group' | 'channel';
+        readonly id: string;
+    };
+    readonly content: string;
+    readonly sender?: {
+        readonly id: string;
+        readonly name?: string;
+    } | string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Best-effort group detection for Plugin Runtime `Message`.
+ * Channel type comes from `conversation.kind`（metadata.type/channelType 优先，
+ * 兼容早期适配器）；无类型信息时按会话 `kind:id` 作为 group key。
+ */
+export declare function resolveGroupId(message: RepeaterInboundFields): string | null;
+export type RepeaterTickResult = {
+    readonly action: 'next';
+} | {
+    readonly action: 'repeat';
+    readonly content: string;
+};
+export declare class RepeaterEngine {
+    #private;
+    constructor();
+    get totalRepeats(): number;
+    get activeGroups(): number;
+    tick(message: RepeaterInboundFields, config: RepeaterConfig): RepeaterTickResult;
+    statusLines(config: RepeaterConfig): string;
+    pruneStale(now?: number, expiry?: number, cooldown?: number): void;
+    dispose(): void;
+}
+export declare function getRepeaterEngine(): RepeaterEngine;
+/** Test helper — reset the process-wide singleton. */
+export declare function resetRepeaterEngine(): void;
+//# sourceMappingURL=engine.d.ts.map

package/lib/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,uBAAuB,EAAE,cAIpC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAMlE;AAOD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;QAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAY5E;AASD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,qBAAa,cAAc;;;IAezB,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,cAAc,GAAG,kBAAkB;IAuChF,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAW3C,UAAU,CAAC,GAAG,SAAa,EAAE,MAAM,SAAa,EAAE,QAAQ,SAAqB,GAAG,IAAI;IAStF,OAAO,IAAI,IAAI;CAQhB;AAID,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/lib/engine.js

@@ -0,0 +1,135 @@
+export const DEFAULT_REPEATER_CONFIG = Object.freeze({
+    threshold: 3,
+    cooldown: 30_000,
+    maxLength: 200,
+});
+export function resolveRepeaterConfig(raw) {
+    const input = raw && typeof raw === 'object' ? raw : {};
+    const threshold = clampNumber(input.threshold, DEFAULT_REPEATER_CONFIG.threshold, 2, 10);
+    const cooldown = clampNumber(input.cooldown, DEFAULT_REPEATER_CONFIG.cooldown, 5_000, 300_000);
+    const maxLength = clampNumber(input.maxLength, DEFAULT_REPEATER_CONFIG.maxLength, 10, 1_000);
+    return Object.freeze({ threshold, cooldown, maxLength });
+}
+function clampNumber(value, fallback, min, max) {
+    const n = typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+    return Math.min(max, Math.max(min, Math.trunc(n)));
+}
+/**
+ * Best-effort group detection for Plugin Runtime `Message`.
+ * Channel type comes from `conversation.kind`（metadata.type/channelType 优先，
+ * 兼容早期适配器）；无类型信息时按会话 `kind:id` 作为 group key。
+ */
+export function resolveGroupId(message) {
+    const meta = message.metadata ?? {};
+    const type = meta.type ?? meta.channelType
+        ?? (meta.channel && typeof meta.channel === 'object'
+            ? meta.channel.type
+            : undefined)
+        ?? message.conversation.kind;
+    if (type === 'private')
+        return null;
+    if (type === 'group' || type === 'channel') {
+        return message.conversation.id;
+    }
+    return null;
+}
+export class RepeaterEngine {
+    #groupStates = new Map();
+    #cooldownSet = new Map();
+    #totalRepeats = 0;
+    #cleanupTimer;
+    /** 最近一次 tick 的配置冷却，供 pruneStale 用实际配置而非默认值清理。 */
+    #lastCooldown = DEFAULT_REPEATER_CONFIG.cooldown;
+    constructor() {
+        this.#cleanupTimer = setInterval(() => this.pruneStale(), 120_000);
+        if (typeof this.#cleanupTimer === 'object' && 'unref' in this.#cleanupTimer) {
+            this.#cleanupTimer.unref();
+        }
+    }
+    get totalRepeats() {
+        return this.#totalRepeats;
+    }
+    get activeGroups() {
+        return this.#groupStates.size;
+    }
+    tick(message, config) {
+        this.#lastCooldown = config.cooldown;
+        const groupId = resolveGroupId(message);
+        if (!groupId)
+            return { action: 'next' };
+        const content = message.content.trim();
+        if (!content || content.length > config.maxLength)
+            return { action: 'next' };
+        const rawSender = message.sender;
+        const senderId = typeof rawSender === 'object' ? rawSender?.id ?? '' : String(rawSender ?? '');
+        if (!senderId)
+            return { action: 'next' };
+        const state = this.#groupStates.get(groupId);
+        if (state && state.content === content) {
+            if (state.users.has(senderId))
+                return { action: 'next' };
+            state.users.add(senderId);
+            state.lastTime = Date.now();
+            if (state.users.size >= config.threshold && !state.repeated) {
+                const lastCd = this.#cooldownSet.get(groupId);
+                if (lastCd && Date.now() - lastCd < config.cooldown) {
+                    return { action: 'next' };
+                }
+                state.repeated = true;
+                this.#cooldownSet.set(groupId, Date.now());
+                this.#totalRepeats += 1;
+                return { action: 'repeat', content };
+            }
+            return { action: 'next' };
+        }
+        this.#groupStates.set(groupId, {
+            content,
+            users: new Set([senderId]),
+            repeated: false,
+            lastTime: Date.now(),
+        });
+        return { action: 'next' };
+    }
+    statusLines(config) {
+        return [
+            '复读机状态',
+            `监控群数: ${this.activeGroups}`,
+            `触发阈值: ${config.threshold} 人`,
+            `冷却时间: ${config.cooldown / 1000}s`,
+            `消息长度上限: ${config.maxLength}`,
+            `累计复读: ${this.#totalRepeats} 次`,
+        ].join('\n');
+    }
+    pruneStale(now = Date.now(), expiry = 5 * 60_000, cooldown = this.#lastCooldown) {
+        for (const [key, state] of this.#groupStates) {
+            if (now - state.lastTime > expiry)
+                this.#groupStates.delete(key);
+        }
+        for (const [key, time] of this.#cooldownSet) {
+            if (now - time > cooldown * 2)
+                this.#cooldownSet.delete(key);
+        }
+    }
+    dispose() {
+        if (this.#cleanupTimer)
+            clearInterval(this.#cleanupTimer);
+        this.#cleanupTimer = undefined;
+        this.#groupStates.clear();
+        this.#cooldownSet.clear();
+        // 单例 dispose 后不得继续服役：下个 getRepeaterEngine() 必须拿到新实例。
+        if (shared === this)
+            shared = undefined;
+    }
+}
+let shared;
+export function getRepeaterEngine() {
+    if (!shared)
+        shared = new RepeaterEngine();
+    return shared;
+}
+/** Test helper — reset the process-wide singleton. */
+export function resetRepeaterEngine() {
+    shared?.dispose();
+    shared = undefined;
+}
+//# sourceMappingURL=engine.js.map

package/lib/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,2 +1,3 @@
-export {};
+export { DEFAULT_REPEATER_CONFIG, RepeaterEngine, getRepeaterEngine, resetRepeaterEngine, resolveGroupId, resolveRepeaterConfig, } from './engine.js';
+export type { RepeaterConfig, RepeaterInboundFields, RepeaterTickResult } from './engine.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/lib/index.js

@@ -1,115 +1,2 @@
-/**
- * @zhin.js/plugin-repeater
- *
- * 复读机插件 —— 当群内连续多人发送相同消息时自动跟读
- *
- * 规则：
- *   - 同一群聊内，连续 N 人（默认 3）发送完全相同的消息后触发复读
- *   - 同一用户的连续消息不计入（防止单人刷屏触发）
- *   - 每条消息在同一群只复读一次
- *   - 可配置中断策略（不同消息会重置计数）
- *   - 支持冷却时间防止频繁复读
- *
- * 命令：
- *   repeater-status    查看当前复读机状态
- *
- * 配置（zhin.config.yml）：
- * ```yaml
- * plugins:
- *   - "@zhin.js/plugin-repeater"
- * repeater:
- *   threshold: 3
- *   cooldown: 30000
- *   maxLength: 200
- * ```
- */
-import { formatCompact, MessageCommand, Schema, usePlugin } from 'zhin.js';
-const plugin = usePlugin();
-const { logger, addCommand, addMiddleware, onDispose, declareConfig } = plugin;
-const config = declareConfig("repeater", Schema.object({
-    threshold: Schema.number().default(3).min(2).max(10).description("触发复读的最少人数"),
-    cooldown: Schema.number().default(30_000).min(5000).max(300_000).description("同一群冷却时间 (ms)"),
-    maxLength: Schema.number().default(200).min(10).max(1000).description("消息长度上限"),
-}));
-const groupStates = new Map();
-const cooldownSet = new Map();
-function getGroupId(message) {
-    if (message.type !== "group")
-        return null;
-    return String(message.$group?.id || message.$target?.id || "");
-}
-function getSenderId(message) {
-    return String(message.$sender?.id || "");
-}
-let totalRepeats = 0;
-addMiddleware(async function repeaterMiddleware(message, next) {
-    const groupId = getGroupId(message);
-    if (!groupId)
-        return next();
-    const content = (message.$raw || "").trim();
-    if (!content || content.length > config.maxLength)
-        return next();
-    const senderId = getSenderId(message);
-    if (!senderId)
-        return next();
-    const state = groupStates.get(groupId);
-    if (state && state.content === content) {
-        if (state.users.has(senderId))
-            return next();
-        state.users.add(senderId);
-        state.lastTime = Date.now();
-        if (state.users.size >= config.threshold && !state.repeated) {
-            const lastCd = cooldownSet.get(groupId);
-            if (lastCd && Date.now() - lastCd < config.cooldown) {
-                return next();
-            }
-            state.repeated = true;
-            cooldownSet.set(groupId, Date.now());
-            totalRepeats++;
-            await message.$reply(content);
-            return;
-        }
-    }
-    else {
-        groupStates.set(groupId, {
-            content,
-            users: new Set([senderId]),
-            repeated: false,
-            lastTime: Date.now(),
-        });
-    }
-    return next();
-});
-const staleCleanup = setInterval(() => {
-    const now = Date.now();
-    const expiry = 5 * 60_000;
-    for (const [key, state] of groupStates) {
-        if (now - state.lastTime > expiry)
-            groupStates.delete(key);
-    }
-    for (const [key, time] of cooldownSet) {
-        if (now - time > config.cooldown * 2)
-            cooldownSet.delete(key);
-    }
-}, 120_000);
-onDispose(() => {
-    clearInterval(staleCleanup);
-    groupStates.clear();
-    cooldownSet.clear();
-});
-addCommand(new MessageCommand("repeater-status")
-    .desc("复读机状态", "查看复读机的运行状态")
-    .action(async () => {
-    const activeGroups = groupStates.size;
-    const lines = [
-        "复读机状态",
-        `监控群数: ${activeGroups}`,
-        `触发阈值: ${config.threshold} 人`,
-        `冷却时间: ${config.cooldown / 1000}s`,
-        `消息长度上限: ${config.maxLength}`,
-        `累计复读: ${totalRepeats} 次`,
-    ];
-    return lines.join("\n");
-}));
-logger.info(formatCompact({ op: "load", threshold: config.threshold, cooldown_s: config.cooldown / 1000 }));
+export { DEFAULT_REPEATER_CONFIG, RepeaterEngine, getRepeaterEngine, resetRepeaterEngine, resolveGroupId, resolveRepeaterConfig, } from './engine.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/middlewares/repeater.js

@@ -0,0 +1,30 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineMiddleware } from 'zhin.js/middleware';
+import { getRepeaterEngine, resolveRepeaterConfig, } from "../lib/engine.js";
+/**
+ * Runtime `Message` 是 conversation 原生：`conversation.kind/id` 直接喂给引擎
+ * （引擎契约 `RepeaterInboundFields.conversation`，私聊由引擎判 null 跳过）。
+ * Sender 为 MessageSenderRef（`{ id, name?, roles? }`），引擎只读 `id`。
+ * Reply uses `Message.$reply` (available during inbound middleware scope).
+ */
+export default defineMiddleware({
+    target: 'inbound',
+    async handle(context, next) {
+        const config = resolveRepeaterConfig(context.config);
+        const engine = getRepeaterEngine();
+        const result = engine.tick({
+            conversation: {
+                kind: context.input.conversation.kind,
+                id: context.input.conversation.id,
+            },
+            content: context.input.content,
+            sender: context.input.sender,
+            metadata: context.input.metadata,
+        }, config);
+        if (result.action === 'repeat') {
+            await context.input.$reply(result.content);
+            return;
+        }
+        await next();
+    },
+});

package/middlewares/repeater.ts

@@ -0,0 +1,36 @@
+import { defineMiddleware } from 'zhin.js/middleware';
+import type { Message } from '@zhin.js/core/runtime';
+import {
+  getRepeaterEngine,
+  resolveRepeaterConfig,
+  type RepeaterConfig,
+} from '../src/engine.js';
+
+/**
+ * Runtime `Message` 是 conversation 原生：`conversation.kind/id` 直接喂给引擎
+ * （引擎契约 `RepeaterInboundFields.conversation`，私聊由引擎判 null 跳过）。
+ * Sender 为 MessageSenderRef（`{ id, name?, roles? }`），引擎只读 `id`。
+ * Reply uses `Message.$reply` (available during inbound middleware scope).
+ */
+export default defineMiddleware<Message, RepeaterConfig>({
+  target: 'inbound',
+  async handle(context, next) {
+    const config = resolveRepeaterConfig(context.config);
+    const engine = getRepeaterEngine();
+    const result = engine.tick({
+      conversation: {
+        kind: context.input.conversation.kind,
+        id: context.input.conversation.id,
+      },
+      content: context.input.content,
+      sender: context.input.sender,
+      metadata: context.input.metadata,
+    }, config);
+
+    if (result.action === 'repeat') {
+      await context.input.$reply(result.content);
+      return;
+    }
+    await next();
+  },
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/plugin-repeater",
-  "version": "1.0.0",
-  "description": "Repeater plugin for Zhin.js — auto-repeat messages when group members echo the same content",
+  "version": "1.1.0",
+  "description": "Repeater plugin for Zhin.js — auto-repeat when group members echo the same content (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,11 +14,13 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.js",
+    "schema.json",
+    "commands",
+    "middlewares",
     "src",
     "lib",
-    "client",
-    "dist",
-    "skills",
+    "agent",
     "README.md"
   ],
   "keywords": [
@@ -38,13 +40,13 @@
     "url": "https://github.com/lc-cn"
   },
   "license": "MIT",
-  "dependencies": {},
+  "dependencies": {
+    "@zhin.js/core": "1.1.35"
+  },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "zhin.js": "2.0.0"
-  },
-  "peerDependencies": {
-    "zhin.js": "2.0.0"
+    "vitest": "^4.1.10",
+    "zhin.js": "1.1.0"
   },
   "repository": {
     "type": "git",
@@ -55,8 +57,43 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/middleware",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
+  "peerDependencies": {
+    "@zhin.js/command": "^1.1.0",
+    "@zhin.js/middleware": "^1.1.0",
+    "zhin.js": "^1.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "@zhin.js/middleware": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "build": "tsc --build",
-    "clean": "rimraf lib"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/repeater/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin } from 'zhin.js';
+import { getRepeaterEngine } from "./lib/engine.js";
+export default definePlugin({
+    name: 'repeater',
+    metadata: {
+        displayName: 'Repeater',
+    },
+    setup(context) {
+        const engine = getRepeaterEngine();
+        context.lifecycle.add(() => engine.dispose());
+    },
+});

package/schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "threshold": {
+      "type": "number",
+      "default": 3,
+      "minimum": 2,
+      "maximum": 10,
+      "description": "触发复读的最少人数"
+    },
+    "cooldown": {
+      "type": "number",
+      "default": 30000,
+      "minimum": 5000,
+      "maximum": 300000,
+      "description": "同一群冷却时间 (ms)"
+    },
+    "maxLength": {
+      "type": "number",
+      "default": 200,
+      "minimum": 10,
+      "maximum": 1000,
+      "description": "消息长度上限"
+    }
+  }
+}

package/src/engine.ts

@@ -0,0 +1,169 @@
+export interface RepeaterConfig {
+  readonly threshold: number;
+  readonly cooldown: number;
+  readonly maxLength: number;
+}
+
+export const DEFAULT_REPEATER_CONFIG: RepeaterConfig = Object.freeze({
+  threshold: 3,
+  cooldown: 30_000,
+  maxLength: 200,
+});
+
+export function resolveRepeaterConfig(raw: unknown): RepeaterConfig {
+  const input = raw && typeof raw === 'object' ? raw as Record<string, unknown> : {};
+  const threshold = clampNumber(input.threshold, DEFAULT_REPEATER_CONFIG.threshold, 2, 10);
+  const cooldown = clampNumber(input.cooldown, DEFAULT_REPEATER_CONFIG.cooldown, 5_000, 300_000);
+  const maxLength = clampNumber(input.maxLength, DEFAULT_REPEATER_CONFIG.maxLength, 10, 1_000);
+  return Object.freeze({ threshold, cooldown, maxLength });
+}
+
+function clampNumber(value: unknown, fallback: number, min: number, max: number): number {
+  const n = typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+  return Math.min(max, Math.max(min, Math.trunc(n)));
+}
+
+export interface RepeaterInboundFields {
+  readonly conversation: {
+    readonly kind: 'private' | 'group' | 'channel';
+    readonly id: string;
+  };
+  readonly content: string;
+  readonly sender?: { readonly id: string; readonly name?: string } | string;
+  readonly metadata?: Readonly<Record<string, unknown>>;
+}
+
+/**
+ * Best-effort group detection for Plugin Runtime `Message`.
+ * Channel type comes from `conversation.kind`（metadata.type/channelType 优先，
+ * 兼容早期适配器）；无类型信息时按会话 `kind:id` 作为 group key。
+ */
+export function resolveGroupId(message: RepeaterInboundFields): string | null {
+  const meta = message.metadata ?? {};
+  const type = meta.type ?? meta.channelType
+    ?? (meta.channel && typeof meta.channel === 'object'
+      ? (meta.channel as { type?: unknown }).type
+      : undefined)
+    ?? message.conversation.kind;
+  if (type === 'private') return null;
+  if (type === 'group' || type === 'channel') {
+    return message.conversation.id;
+  }
+  return null;
+}
+
+interface RepeatState {
+  content: string;
+  users: Set<string>;
+  repeated: boolean;
+  lastTime: number;
+}
+
+export type RepeaterTickResult =
+  | { readonly action: 'next' }
+  | { readonly action: 'repeat'; readonly content: string };
+
+export class RepeaterEngine {
+  readonly #groupStates = new Map<string, RepeatState>();
+  readonly #cooldownSet = new Map<string, number>();
+  #totalRepeats = 0;
+  #cleanupTimer?: ReturnType<typeof setInterval>;
+  /** 最近一次 tick 的配置冷却，供 pruneStale 用实际配置而非默认值清理。 */
+  #lastCooldown = DEFAULT_REPEATER_CONFIG.cooldown;
+
+  constructor() {
+    this.#cleanupTimer = setInterval(() => this.pruneStale(), 120_000);
+    if (typeof this.#cleanupTimer === 'object' && 'unref' in this.#cleanupTimer) {
+      this.#cleanupTimer.unref();
+    }
+  }
+
+  get totalRepeats(): number {
+    return this.#totalRepeats;
+  }
+
+  get activeGroups(): number {
+    return this.#groupStates.size;
+  }
+
+  tick(message: RepeaterInboundFields, config: RepeaterConfig): RepeaterTickResult {
+    this.#lastCooldown = config.cooldown;
+    const groupId = resolveGroupId(message);
+    if (!groupId) return { action: 'next' };
+
+    const content = message.content.trim();
+    if (!content || content.length > config.maxLength) return { action: 'next' };
+
+    const rawSender = message.sender;
+    const senderId = typeof rawSender === 'object' ? rawSender?.id ?? '' : String(rawSender ?? '');
+    if (!senderId) return { action: 'next' };
+
+    const state = this.#groupStates.get(groupId);
+    if (state && state.content === content) {
+      if (state.users.has(senderId)) return { action: 'next' };
+      state.users.add(senderId);
+      state.lastTime = Date.now();
+      if (state.users.size >= config.threshold && !state.repeated) {
+        const lastCd = this.#cooldownSet.get(groupId);
+        if (lastCd && Date.now() - lastCd < config.cooldown) {
+          return { action: 'next' };
+        }
+        state.repeated = true;
+        this.#cooldownSet.set(groupId, Date.now());
+        this.#totalRepeats += 1;
+        return { action: 'repeat', content };
+      }
+      return { action: 'next' };
+    }
+
+    this.#groupStates.set(groupId, {
+      content,
+      users: new Set([senderId]),
+      repeated: false,
+      lastTime: Date.now(),
+    });
+    return { action: 'next' };
+  }
+
+  statusLines(config: RepeaterConfig): string {
+    return [
+      '复读机状态',
+      `监控群数: ${this.activeGroups}`,
+      `触发阈值: ${config.threshold} 人`,
+      `冷却时间: ${config.cooldown / 1000}s`,
+      `消息长度上限: ${config.maxLength}`,
+      `累计复读: ${this.#totalRepeats} 次`,
+    ].join('\n');
+  }
+
+  pruneStale(now = Date.now(), expiry = 5 * 60_000, cooldown = this.#lastCooldown): void {
+    for (const [key, state] of this.#groupStates) {
+      if (now - state.lastTime > expiry) this.#groupStates.delete(key);
+    }
+    for (const [key, time] of this.#cooldownSet) {
+      if (now - time > cooldown * 2) this.#cooldownSet.delete(key);
+    }
+  }
+
+  dispose(): void {
+    if (this.#cleanupTimer) clearInterval(this.#cleanupTimer);
+    this.#cleanupTimer = undefined;
+    this.#groupStates.clear();
+    this.#cooldownSet.clear();
+    // 单例 dispose 后不得继续服役：下个 getRepeaterEngine() 必须拿到新实例。
+    if (shared === this) shared = undefined;
+  }
+}
+
+let shared: RepeaterEngine | undefined;
+
+export function getRepeaterEngine(): RepeaterEngine {
+  if (!shared) shared = new RepeaterEngine();
+  return shared;
+}
+
+/** Test helper — reset the process-wide singleton. */
+export function resetRepeaterEngine(): void {
+  shared?.dispose();
+  shared = undefined;
+}

package/src/index.ts

@@ -1,136 +1,9 @@
-/**
- * @zhin.js/plugin-repeater
- *
- * 复读机插件 —— 当群内连续多人发送相同消息时自动跟读
- *
- * 规则：
- *   - 同一群聊内，连续 N 人（默认 3）发送完全相同的消息后触发复读
- *   - 同一用户的连续消息不计入（防止单人刷屏触发）
- *   - 每条消息在同一群只复读一次
- *   - 可配置中断策略（不同消息会重置计数）
- *   - 支持冷却时间防止频繁复读
- *
- * 命令：
- *   repeater-status    查看当前复读机状态
- *
- * 配置（zhin.config.yml）：
- * ```yaml
- * plugins:
- *   - "@zhin.js/plugin-repeater"
- * repeater:
- *   threshold: 3
- *   cooldown: 30000
- *   maxLength: 200
- * ```
- */
-import { formatCompact, MessageCommand, Schema, usePlugin } from 'zhin.js';
-
-const plugin = usePlugin();
-const { logger, addCommand, addMiddleware, onDispose, declareConfig } = plugin;
-
-const config = declareConfig("repeater", Schema.object({
-  threshold: Schema.number().default(3).min(2).max(10).description("触发复读的最少人数"),
-  cooldown: Schema.number().default(30_000).min(5000).max(300_000).description("同一群冷却时间 (ms)"),
-  maxLength: Schema.number().default(200).min(10).max(1000).description("消息长度上限"),
-}));
-
-interface RepeatState {
-  content: string;
-  users: Set<string>;
-  repeated: boolean;
-  lastTime: number;
-}
-
-const groupStates = new Map<string, RepeatState>();
-
-const cooldownSet = new Map<string, number>();
-
-function getGroupId(message: any): string | null {
-  if (message.type !== "group") return null;
-  return String(message.$group?.id || message.$target?.id || "");
-}
-
-function getSenderId(message: any): string {
-  return String(message.$sender?.id || "");
-}
-
-let totalRepeats = 0;
-
-addMiddleware(async function repeaterMiddleware(message: any, next: () => Promise<void>) {
-  const groupId = getGroupId(message);
-  if (!groupId) return next();
-
-  const content = (message.$raw || "").trim();
-  if (!content || content.length > config.maxLength) return next();
-
-  const senderId = getSenderId(message);
-  if (!senderId) return next();
-
-  const state = groupStates.get(groupId);
-
-  if (state && state.content === content) {
-    if (state.users.has(senderId)) return next();
-
-    state.users.add(senderId);
-    state.lastTime = Date.now();
-
-    if (state.users.size >= config.threshold && !state.repeated) {
-      const lastCd = cooldownSet.get(groupId);
-      if (lastCd && Date.now() - lastCd < config.cooldown) {
-        return next();
-      }
-
-      state.repeated = true;
-      cooldownSet.set(groupId, Date.now());
-      totalRepeats++;
-
-      await message.$reply(content);
-      return;
-    }
-  } else {
-    groupStates.set(groupId, {
-      content,
-      users: new Set([senderId]),
-      repeated: false,
-      lastTime: Date.now(),
-    });
-  }
-
-  return next();
-});
-
-const staleCleanup = setInterval(() => {
-  const now = Date.now();
-  const expiry = 5 * 60_000;
-  for (const [key, state] of groupStates) {
-    if (now - state.lastTime > expiry) groupStates.delete(key);
-  }
-  for (const [key, time] of cooldownSet) {
-    if (now - time > config.cooldown * 2) cooldownSet.delete(key);
-  }
-}, 120_000);
-
-onDispose(() => {
-  clearInterval(staleCleanup);
-  groupStates.clear();
-  cooldownSet.clear();
-});
-
-addCommand(
-  new MessageCommand("repeater-status")
-    .desc("复读机状态", "查看复读机的运行状态")
-    .action(async () => {
-      const activeGroups = groupStates.size;
-      const lines = [
-        "复读机状态",
-        `监控群数: ${activeGroups}`,
-        `触发阈值: ${config.threshold} 人`,
-        `冷却时间: ${config.cooldown / 1000}s`,
-        `消息长度上限: ${config.maxLength}`,
-        `累计复读: ${totalRepeats} 次`,
-      ];
-      return lines.join("\n");
-    }),
-);
-
-logger.info(formatCompact( { op: "load", threshold: config.threshold, cooldown_s: config.cooldown / 1000 }));
+export {
+  DEFAULT_REPEATER_CONFIG,
+  RepeaterEngine,
+  getRepeaterEngine,
+  resetRepeaterEngine,
+  resolveGroupId,
+  resolveRepeaterConfig,
+} from './engine.js';
+export type { RepeaterConfig, RepeaterInboundFields, RepeaterTickResult } from './engine.js';