@zhin.js/plugin-repeater 1.1.24 → 1.1.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -24,6 +24,17 @@ repeater:
 
 配置声明位于 `src/config.ts`，由 `plugin.ts` 暴露给 Runtime 与 Console；默认值、类型、范围和表单说明由同一声明生成。配置不满足范围或含未知字段时，候选代不会激活；有效配置更新只重载插件。
 
+### 按适配器 / 账号 / 群覆盖（ADR 0050 / 0055）
+
+复读机支持全部四个层级（`global` / `adapter` / `endpoint` / `conversation`）：
+
+- 适配器、账号层的覆盖写在 `repeater.overrides`；群（会话）层的覆盖由 Console「功能」区或群内自助命令写入项目数据库，原地生效，不重载插件。
+- 会话层可以改 `threshold` 与 `cooldown`（`conversationFields`），也可以单独关闭某个群的复读。
+- 开启 `features.selfService.enabled` 后，群里的 `admin`（默认含群主 / 管理员）可以用 `功能 设置 repeater threshold 5` 调整本群阈值（`selfServiceFields` 只含 `threshold`），用 `功能 关闭 repeater` 关闭本群复读。
+- 推荐用会话层开关代替自建黑白名单。
+
+Per-group overrides: the repeater supports all four levels. In a group, an `admin` can run `feature set repeater threshold 5` (only `threshold` is self-service) or `feature disable repeater` once `features.selfService.enabled` is on; the Console can also change `cooldown` per group.
+
 ## 工作原理
 
 1. 监听群聊消息，记录每条消息的内容和发送者

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,uBAAuB;;;;EAIlC,CAAC;AAEH,gIAAgI;AAChI,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAIzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,uBAAuB;;;;EAIlC,CAAC;AAEH,gIAAgI;AAChI,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAQzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/lib/config.js

@@ -9,5 +9,9 @@ export const repeaterConfig = Schema.object({
     threshold: Schema.number().min(2).max(10).step(1).default(DEFAULT_REPEATER_CONFIG.threshold).description('触发复读的最少人数').i18n({ "en": { "description": "Minimum distinct users needed to trigger repetition." } }).effect('reload'),
     cooldown: Schema.number().min(5_000).max(300_000).default(DEFAULT_REPEATER_CONFIG.cooldown).description('同一群冷却时间 (ms)').i18n({ "en": { "description": "Cooldown for the same group, in milliseconds." } }).effect('reload'),
     maxLength: Schema.number().min(10).max(1_000).step(1).default(DEFAULT_REPEATER_CONFIG.maxLength).description('消息长度上限').i18n({ "en": { "description": "Maximum message length." } }).effect('reload'),
+}).featureLevels(['global', 'adapter', 'endpoint', 'conversation'], {
+    // ADR 0055: per-group threshold / cooldown in the Console; group admins may tune the threshold in chat.
+    conversationFields: ['threshold', 'cooldown'],
+    selfServiceFields: ['threshold'],
 });
 //# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,GAAG;CACf,CAAC,CAAC;AAEH,gIAAgI;AAChI,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,sDAAsD,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC5N,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,+CAA+C,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvN,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,yBAAyB,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACjM,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,GAAG;CACf,CAAC,CAAC;AAEH,gIAAgI;AAChI,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,sDAAsD,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC5N,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,+CAA+C,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvN,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,yBAAyB,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACjM,CAAC,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE;IAClE,wGAAwG;IACxG,kBAAkB,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;IAC7C,iBAAiB,EAAE,CAAC,WAAW,CAAC;CACjC,CAAC,CAAC"}

package/lib/runtime.d.ts

@@ -1,3 +1,8 @@
-import type { RepeaterEngine } from './engine.js';
+import type { RepeaterConfig, RepeaterEngine } from './engine.js';
 export declare const repeaterEngineToken: import("zhin.js").PluginStore<RepeaterEngine, unknown>;
+/** Effective configuration per conversation (ADR 0055): global < adapter < endpoint < conversation. */
+export interface RepeaterConfigResolver {
+    configFor(message: unknown): Readonly<RepeaterConfig>;
+}
+export declare const repeaterConfigToken: import("zhin.js").PluginStore<RepeaterConfigResolver, unknown>;
 //# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,mBAAmB,wDAG/B,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,eAAO,MAAM,mBAAmB,wDAG/B,CAAC;AAEF,uGAAuG;AACvG,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,mBAAmB,gEAG/B,CAAC"}

package/lib/runtime.js

@@ -1,3 +1,4 @@
 import { definePluginStore } from 'zhin.js';
 export const repeaterEngineToken = definePluginStore('zhin.repeater.engine', 'Conversation repeat streak and cooldown state');
+export const repeaterConfigToken = definePluginStore('zhin.repeater.config', 'Layered repeater configuration for one message');
 //# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAClD,sBAAsB,EACtB,+CAA+C,CAChD,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAClD,sBAAsB,EACtB,+CAA+C,CAChD,CAAC;AAOF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAClD,sBAAsB,EACtB,gDAAgD,CACjD,CAAC"}

package/middlewares/repeater/index.js

@@ -1,7 +1,7 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineMiddleware } from 'zhin.js/middleware';
 import {} from "../../lib/engine.js";
-import { repeaterEngineToken } from "../../lib/runtime.js";
+import { repeaterConfigToken, repeaterEngineToken } from "../../lib/runtime.js";
 /**
  * Runtime `Message` 是 conversation 原生：`conversation.kind/id` 直接喂给引擎
  * （引擎契约 `RepeaterInboundFields.conversation`，私聊由引擎判 null 跳过）。
@@ -11,7 +11,9 @@ import { repeaterEngineToken } from "../../lib/runtime.js";
 export default defineMiddleware({
     target: 'inbound',
     async handle(context, next) {
-        const config = context.config;
+        // Per-conversation effective configuration (ADR 0055); falls back to the global view.
+        const resolver = context.has(repeaterConfigToken) ? context.use(repeaterConfigToken) : undefined;
+        const config = { ...context.config, ...(resolver?.configFor(context.input) ?? {}) };
         const engine = context.use(repeaterEngineToken);
         const result = engine.tick({
             conversation: context.input.conversation,

package/middlewares/repeater/index.ts

@@ -3,7 +3,7 @@ import type { Message } from '@zhin.js/core/runtime';
 import {
   type RepeaterConfig,
 } from '../../src/engine.js';
-import { repeaterEngineToken } from '../../src/runtime.js';
+import { repeaterConfigToken, repeaterEngineToken } from '../../src/runtime.js';
 
 /**
  * Runtime `Message` 是 conversation 原生：`conversation.kind/id` 直接喂给引擎
@@ -14,7 +14,9 @@ import { repeaterEngineToken } from '../../src/runtime.js';
 export default defineMiddleware<Message, RepeaterConfig>({
   target: 'inbound',
   async handle(context, next) {
-    const config = context.config;
+    // Per-conversation effective configuration (ADR 0055); falls back to the global view.
+    const resolver = context.has(repeaterConfigToken) ? context.use(repeaterConfigToken) : undefined;
+    const config = { ...context.config, ...(resolver?.configFor(context.input) ?? {}) } as RepeaterConfig;
     const engine = context.use(repeaterEngineToken);
     const result = engine.tick({
       conversation: context.input.conversation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-repeater",
-  "version": "1.1.24",
+  "version": "1.1.26",
   "description": "Repeater plugin for Zhin.js — auto-repeat when group members echo the same content (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,7 +18,6 @@
     "middlewares",
     "src",
     "lib",
-    "skills",
     "README.md",
     "schema.json"
   ],
@@ -40,13 +39,12 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/core": "1.1.59",
-    "@zhin.js/skill": "1.1.16"
+    "@zhin.js/core": "1.2.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "1.1.24"
+    "zhin.js": "1.1.26"
   },
   "repository": {
     "type": "git",
@@ -74,18 +72,14 @@
       {
         "package": "@zhin.js/middleware",
         "api": "^1.0.0"
-      },
-      {
-        "package": "@zhin.js/skill",
-        "api": "^1.0.0"
       }
     ],
     "plugins": []
   },
   "peerDependencies": {
-    "@zhin.js/command": "^1.1.17",
-    "@zhin.js/middleware": "^1.1.16",
-    "zhin.js": "^1.1.24"
+    "@zhin.js/command": "^1.2.0",
+    "@zhin.js/middleware": "^1.1.17",
+    "zhin.js": "^1.1.26"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -98,6 +92,6 @@
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/repeater/tests"
+    "test": "vitest run --root ../../.. plugins/utils/repeater/tests"
   }
 }

package/plugin.js

@@ -1,7 +1,7 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { definePlugin } from 'zhin.js';
 import { RepeaterEngine } from "./lib/engine.js";
-import { repeaterEngineToken } from "./lib/runtime.js";
+import { repeaterConfigToken, repeaterEngineToken } from "./lib/runtime.js";
 export default definePlugin({
     name: 'repeater',
     metadata: {
@@ -9,5 +9,9 @@ export default definePlugin({
     },
     setup(context) {
         repeaterEngineToken.provide(context, () => new RepeaterEngine());
+        // `threshold` etc. may be overridden per adapter / endpoint / conversation (in place, no reload).
+        repeaterConfigToken.provide(context, {
+            configFor: message => context.configFor(message),
+        });
     },
 });

package/schema.json

@@ -49,5 +49,20 @@
         "effect": "reload"
       }
     }
+  },
+  "x-zhin-config": {
+    "levels": [
+      "global",
+      "adapter",
+      "endpoint",
+      "conversation"
+    ],
+    "conversationFields": [
+      "threshold",
+      "cooldown"
+    ],
+    "selfServiceFields": [
+      "threshold"
+    ]
   }
 }

package/src/config.ts

@@ -11,6 +11,10 @@ export const repeaterConfig = Schema.object({
   threshold: Schema.number().min(2).max(10).step(1).default(DEFAULT_REPEATER_CONFIG.threshold).description('触发复读的最少人数').i18n({"en": {"description": "Minimum distinct users needed to trigger repetition."}}).effect('reload'),
   cooldown: Schema.number().min(5_000).max(300_000).default(DEFAULT_REPEATER_CONFIG.cooldown).description('同一群冷却时间 (ms)').i18n({"en": {"description": "Cooldown for the same group, in milliseconds."}}).effect('reload'),
   maxLength: Schema.number().min(10).max(1_000).step(1).default(DEFAULT_REPEATER_CONFIG.maxLength).description('消息长度上限').i18n({"en": {"description": "Maximum message length."}}).effect('reload'),
+}).featureLevels(['global', 'adapter', 'endpoint', 'conversation'], {
+  // ADR 0055: per-group threshold / cooldown in the Console; group admins may tune the threshold in chat.
+  conversationFields: ['threshold', 'cooldown'],
+  selfServiceFields: ['threshold'],
 });
 
 export type RepeaterConfig = Schema.Output<typeof repeaterConfig>;

package/src/runtime.ts

@@ -1,7 +1,17 @@
 import { definePluginStore } from 'zhin.js';
-import type { RepeaterEngine } from './engine.js';
+import type { RepeaterConfig, RepeaterEngine } from './engine.js';
 
 export const repeaterEngineToken = definePluginStore<RepeaterEngine>(
   'zhin.repeater.engine',
   'Conversation repeat streak and cooldown state',
 );
+
+/** Effective configuration per conversation (ADR 0055): global < adapter < endpoint < conversation. */
+export interface RepeaterConfigResolver {
+  configFor(message: unknown): Readonly<RepeaterConfig>;
+}
+
+export const repeaterConfigToken = definePluginStore<RepeaterConfigResolver>(
+  'zhin.repeater.config',
+  'Layered repeater configuration for one message',
+);