@zhin.js/plugin-repeater 0.0.0

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

@@ -0,0 +1,40 @@
+# @zhin.js/plugin-repeater
+
+复读机插件 —— 当群内连续多人发送相同消息时，Bot 自动跟读。
+
+## 安装
+
+```bash
+npm install @zhin.js/plugin-repeater
+```
+
+## 配置
+
+在 `zhin.config.yml` 中添加：
+
+```yaml
+plugins:
+ - "@zhin.js/plugin-repeater" 
+repeater:
+  threshold: 3       # 触发复读的最少人数（默认 3）
+  cooldown: 30000    # 同一群冷却时间，毫秒（默认 30s）
+  maxLength: 200    # 消息长度上限，超过不触发（默认 200）
+```
+
+## 工作原理
+
+1. 监听群聊消息，记录每条消息的内容和发送者
+2. 当 **不同** 用户连续发送完全相同的消息达到阈值时，Bot 自动回复该消息
+3. 同一用户连续发送不计入（防止刷屏触发）
+4. 每条消息在同一群只复读一次
+5. 冷却期内不重复触发
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `repeater-status` | 查看复读机运行状态 |
+
+## 许可
+
+MIT

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/lib/index.js

@@ -0,0 +1,123 @@
+/**
+ * @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 { usePlugin, MessageCommand } from "zhin.js";
+const plugin = usePlugin();
+const { logger, root, addCommand, addMiddleware, onDispose, declareSkill } = plugin;
+const configService = root.inject("config");
+const appConfig = configService?.get("zhin.config.yml") || {};
+const config = {
+    threshold: 3,
+    cooldown: 30_000,
+    maxLength: 200,
+    ...appConfig.repeater,
+};
+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");
+}));
+declareSkill({
+    description: "复读机：当群内连续多人发送相同消息时，Bot 自动跟读。支持阈值和冷却配置。",
+    keywords: ["repeater", "复读", "复读机", "跟读", "echo", "parrot"],
+    tags: ["repeater", "fun", "group"],
+});
+logger.info(`插件已加载 (阈值=${config.threshold}人, 冷却=${config.cooldown / 1000}s)`);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@zhin.js/plugin-repeater",
+  "version": "0.0.0",
+  "description": "Repeater plugin for Zhin.js — auto-repeat messages when group members echo the same content",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "keywords": [
+    "zhin",
+    "bot",
+    "plugin",
+    "repeater",
+    "echo",
+    "parrot",
+    "chatbot",
+    "im"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "zhin.js": "1.0.42"
+  },
+  "peerDependencies": {
+    "zhin.js": ">=1.0.42"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/utils/repeater"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  }
+}