koishi-plugin-onebot-verifier 1.1.5 → 1.1.7

package/lib/index.d.ts

@@ -3,23 +3,17 @@ export declare const name = "onebot-verifier";
 export declare const inject: {
     optional: string[];
 };
-export declare const usage = "\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #4a6ee0;\">\uD83D\uDCCC \u63D2\u4EF6\u8BF4\u660E</h2>\n  <p>\uD83D\uDCD6 <strong>\u4F7F\u7528\u6587\u6863</strong>\uFF1A\u8BF7\u70B9\u51FB\u5DE6\u4E0A\u89D2\u7684 <strong>\u63D2\u4EF6\u4E3B\u9875</strong> \u67E5\u770B\u63D2\u4EF6\u4F7F\u7528\u6587\u6863</p>\n  <p>\uD83D\uDD0D <strong>\u66F4\u591A\u63D2\u4EF6</strong>\uFF1A\u53EF\u8BBF\u95EE <a href=\"https://github.com/YisRime\" style=\"color:#4a6ee0;text-decoration:none;\">\u82E1\u6DDE\u7684 GitHub</a> \u67E5\u770B\u672C\u4EBA\u7684\u6240\u6709\u63D2\u4EF6</p>\n</div>\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #e0574a;\">\u2764\uFE0F \u652F\u6301\u4E0E\u53CD\u9988</h2>\n  <p>\uD83C\uDF1F \u559C\u6B22\u8FD9\u4E2A\u63D2\u4EF6\uFF1F\u8BF7\u5728 <a href=\"https://github.com/YisRime\" style=\"color:#e0574a;text-decoration:none;\">GitHub</a> \u4E0A\u7ED9\u6211\u4E00\u4E2A Star\uFF01</p>\n  <p>\uD83D\uDC1B \u9047\u5230\u95EE\u9898\uFF1F\u8BF7\u901A\u8FC7 <strong>Issues</strong> \u63D0\u4EA4\u53CD\u9988\uFF0C\u6216\u52A0\u5165 QQ \u7FA4 <a href=\"https://qm.qq.com/q/PdLMx9Jowq\" style=\"color:#e0574a;text-decoration:none;\"><strong>855571375</strong></a> \u8FDB\u884C\u4EA4\u6D41</p>\n</div>\n";
+export declare const usage = "\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #4a6ee0;\">\uD83D\uDCCC \u63D2\u4EF6\u8BF4\u660E</h2>\n  <p>\uD83D\uDCD6 <strong>\u4F7F\u7528\u6587\u6863</strong>\uFF1A\u8BF7\u70B9\u51FB\u5DE6\u4E0A\u89D2\u7684 <strong>\u63D2\u4EF6\u4E3B\u9875</strong> \u67E5\u770B\u63D2\u4EF6\u4F7F\u7528\u6587\u6863</p>\n  <p>\uD83D\uDD0D <strong>\u66F4\u591A\u63D2\u4EF6</strong>\uFF1A\u53EF\u8BBF\u95EE <a href=\"https://github.com/YisRime\" style=\"color:#4a6ee0;text-decoration:none;\">\u82E1\u6DDE\u7684 GitHub</a> \u67E5\u770B\u672C\u4EBA\u7684\u6240\u6709\u63D2\u4EF6</p>\n</div>\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #e0574a;\">\u2764\uFE0F \u652F\u6301\u4E0E\u53CD\u9988</h2>\n  <p>\uD83C\uDF1F \u559C\u6B22\u8FD9\u4E2A\u63D2\u4EF6\uFF1F\u8BF7\u5728 <a href=\"https://github.com/YisRime\" style=\"color:#e0574a;text-decoration:none;\">GitHub</a> \u4E0A\u7ED9\u6211\u4E00\u4E2A Star\uFF01</p>\n  <p>\uD83D\uDC1B \u9047\u5230\u95EE\u9898\uFF1F\u8BF7\u901A\u8FC7 <strong>Issues</strong> \u63D0\u4EA4\u53CD\u9988\uFF0C\u6216\u52A0\u5165 QQ \u7FA4 <a href=\"https://qm.qm.qq.com/q/PdLMx9Jowq\" style=\"color:#e0574a;text-decoration:none;\"><strong>855571375</strong></a> \u8FDB\u884C\u4EA4\u6D41</p>\n</div>\n";
 export interface Config {
     notifyTarget?: string;
     debugMode?: boolean;
     kickBan?: boolean;
-    friendTimeout: 'manual' | {
-        action: 'accept' | 'reject';
-        timeout: number;
-    };
+    friendTimeout: false | number;
     friendLevel?: number;
     friendRegex?: string;
     minMembers?: number;
     maxCapacity?: number;
-    memberTimeout: 'manual' | {
-        action: 'accept' | 'reject';
-        timeout: number;
-    };
+    memberTimeout: false | number;
     verifyRules?: {
         guildId: string;
         keyword?: string;
@@ -28,7 +22,6 @@ export interface Config {
     }[];
     specialRules?: {
         guildId: string;
-        enabled: boolean;
         mode: 'vote' | 'captcha';
     }[];
     captchaDiff?: 'simple' | 'medium' | 'hard';

package/lib/index.js

@@ -39,7 +39,7 @@ var usage = `
 <div style="border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);">
   <h2 style="margin-top: 0; color: #e0574a;">❤️ 支持与反馈</h2>
   <p>🌟 喜欢这个插件？请在 <a href="https://github.com/YisRime" style="color:#e0574a;text-decoration:none;">GitHub</a> 上给我一个 Star！</p>
-  <p>🐛 遇到问题？请通过 <strong>Issues</strong> 提交反馈，或加入 QQ 群 <a href="https://qm.qq.com/q/PdLMx9Jowq" style="color:#e0574a;text-decoration:none;"><strong>855571375</strong></a> 进行交流</p>
+  <p>🐛 遇到问题？请通过 <strong>Issues</strong> 提交反馈，或加入 QQ 群 <a href="https://qm.qm.qq.com/q/PdLMx9Jowq" style="color:#e0574a;text-decoration:none;"><strong>855571375</strong></a> 进行交流</p>
 </div>
 `;
 var Config = import_koishi.Schema.intersect([
@@ -50,15 +50,9 @@ var Config = import_koishi.Schema.intersect([
   }).description("基础配置"),
   import_koishi.Schema.object({
     friendTimeout: import_koishi.Schema.union([
-      import_koishi.Schema.const("manual").description("手动"),
-      import_koishi.Schema.object({
-        action: import_koishi.Schema.union([
-          import_koishi.Schema.const("accept").description("同意"),
-          import_koishi.Schema.const("reject").description("拒绝")
-        ]).description("操作").required(),
-        timeout: import_koishi.Schema.number().description("时长").default(360).min(1)
-      }).description("自动")
-    ]).description("模式").default("manual"),
+      import_koishi.Schema.const(false).description("手动"),
+      import_koishi.Schema.number().description("正数同意/负数拒绝").default(360)
+    ]).description("超时处理").default(false),
     friendLevel: import_koishi.Schema.number().description("最低好友等级").default(0).min(0).max(256),
     friendRegex: import_koishi.Schema.string().description("好友验证正则"),
     minMembers: import_koishi.Schema.number().description("最低群成员数").default(0).min(0).max(3e3),
@@ -66,15 +60,9 @@ var Config = import_koishi.Schema.intersect([
   }).description("好友邀群配置"),
   import_koishi.Schema.object({
     memberTimeout: import_koishi.Schema.union([
-      import_koishi.Schema.const("manual").description("手动"),
-      import_koishi.Schema.object({
-        action: import_koishi.Schema.union([
-          import_koishi.Schema.const("accept").description("同意"),
-          import_koishi.Schema.const("reject").description("拒绝")
-        ]).description("操作").required(),
-        timeout: import_koishi.Schema.number().description("超时").default(360).min(1)
-      }).description("自动")
-    ]).description("模式").default("manual"),
+      import_koishi.Schema.const(false).description("手动"),
+      import_koishi.Schema.number().description("正数同意/负数拒绝").default(360)
+    ]).description("超时处理").default(false),
     verifyRules: import_koishi.Schema.array(import_koishi.Schema.object({
       guildId: import_koishi.Schema.string().description("群号").required(),
       keyword: import_koishi.Schema.string().description("正则"),
@@ -91,8 +79,7 @@ var Config = import_koishi.Schema.intersect([
       mode: import_koishi.Schema.union([
         import_koishi.Schema.const("vote").description("投票"),
         import_koishi.Schema.const("captcha").description("验证码")
-      ]).description("模式").default("vote"),
-      enabled: import_koishi.Schema.boolean().description("前置规则").default(true)
+      ]).description("模式").default("vote")
     })).description("配置列表").role("table"),
     voteRatio: import_koishi.Schema.string().description("[投票]支持/反对人数").default("3:2"),
     voteInSitu: import_koishi.Schema.boolean().description("[投票]对应群中发起").default(true),
@@ -168,7 +155,7 @@ function apply(ctx, config) {
     }
   }, "sendNotice");
   const setupManual = /* @__PURE__ */ __name(async (session, kind, specialMode, useInSitu) => {
-    const mode = kind === "member" ? config.memberTimeout : config.friendTimeout;
+    const timeoutCfg = kind === "member" ? config.memberTimeout : config.friendTimeout;
     let targetStr = config.notifyTarget || "";
     if (useInSitu && kind === "member" && session.guildId) targetStr = `guild:${session.guildId}`;
     const msgIds = await sendNotice(session, kind, "waiting", targetStr);
@@ -180,23 +167,23 @@ function apply(ctx, config) {
       task.votes = { yes: /* @__PURE__ */ new Set(), no: /* @__PURE__ */ new Set() };
     }
     msgIds.forEach((id) => activeTasks.set(id, task));
-    if (mode !== "manual" && typeof mode === "object") {
-      const { action, timeout } = mode;
+    if (typeof timeoutCfg === "number") {
+      const waitMinutes = Math.abs(timeoutCfg);
+      const isPass = timeoutCfg > 0;
       task.timer = setTimeout(async () => {
         if (!activeTasks.has(msgIds[0])) return;
         msgIds.forEach((id) => activeTasks.delete(id));
-        let finalAction = action;
-        if (specialMode === "vote") finalAction = "reject";
-        const isPass = finalAction === "accept";
-        await executeAction(session, kind, isPass, isPass ? "" : "等待超时，自动拒绝");
+        let finalActionPass = isPass;
+        if (specialMode === "vote") finalActionPass = false;
+        await executeAction(session, kind, finalActionPass, finalActionPass ? "" : "等待超时，自动拒绝");
         const [targetType, targetId] = targetStr.split(":");
         if (targetId && session.bot) {
-          const statusText = `已自动${isPass ? "通过" : "拒绝"}该请求`;
+          const statusText = `已自动${finalActionPass ? "通过" : "拒绝"}该请求`;
           await (targetType === "private" ? session.bot.sendPrivateMessage(targetId, statusText) : session.bot.sendMessage(targetId, statusText)).catch(() => {
           });
         }
-        if (config.debugMode) logger.info(`[操作] 等待超时，默认${isPass ? "通过" : "拒绝"}`);
-      }, timeout * 6e4);
+        if (config.debugMode) logger.info(`[操作] 等待超时，默认${finalActionPass ? "通过" : "拒绝"}`);
+      }, waitMinutes * 6e4);
     }
   }, "setupManual");
   const hookEvent = /* @__PURE__ */ __name((kind) => async (session) => {
@@ -224,7 +211,7 @@ function apply(ctx, config) {
             }
           }
         }
-        const specialRule = config.specialRules?.find((r) => String(r.guildId) === String(session.guildId) && r.enabled);
+        const specialRule = config.specialRules?.find((r) => String(r.guildId) === String(session.guildId));
         if (specialRule) {
           if (specialRule.mode === "vote") return await setupManual(session, kind, "vote", config.voteInSitu);
           if (specialRule.mode === "captcha") {
@@ -317,7 +304,7 @@ function apply(ctx, config) {
   ctx.on("guild-added", hookEvent("guild"));
   ctx.on("guild-member-added", async (session) => {
     if (!config.specialRules || !session.guildId || !session.userId) return;
-    const rule = config.specialRules.find((r) => String(r.guildId) === String(session.guildId) && r.enabled);
+    const rule = config.specialRules.find((r) => String(r.guildId) === String(session.guildId));
     if (rule?.mode === "captcha") {
       let a, b, op = "+", answer;
       if (config.captchaDiff === "simple") {
@@ -356,13 +343,20 @@ function apply(ctx, config) {
   });
   ctx.on("guild-removed", async (session) => {
     if (session.guildId) {
-      if (session.event?._data?.sub_type === "kick_me") {
+      const eventData = session.event?._data || {};
+      if (eventData.sub_type === "kick_me") {
         const inviterId = inviterMap.get(session.guildId);
         if (inviterId) {
           await session.onebot?.deleteFriend(inviterId).catch(() => {
           });
           inviterMap.delete(session.guildId);
-          if (config.debugMode) logger.info(`[操作] 删除好友: ${inviterId}`);
+          if (config.debugMode) logger.info(`[操作] 删除邀请者好友: ${inviterId}`);
+        }
+        const adminId = String(eventData.operator_id || session.event?.operator?.id || "");
+        if (adminId && adminId !== inviterId) {
+          await session.onebot?.deleteFriend(adminId).catch(() => {
+          });
+          if (config.debugMode) logger.info(`[操作] 删除管理员好友: ${adminId}`);
         }
       }
       await session.execute(`analyse.clear -g ${session.guildId}`).catch(() => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-onebot-verifier",
-  "description": "适用于 Onebot 的审核插件，支持自动审核好友/加群/邀请请求",
-  "version": "1.1.5",
+  "description": "适用于 OneBot 的审核插件。不仅支持好友/加群自动审核，还支持入群验证码、投票表决、被踢自动清理等功能。",
+  "version": "1.1.7",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],

package/readme.md

@@ -2,66 +2,63 @@
 
 [![npm](https://img.shields.io/npm/v/koishi-plugin-onebot-verifier?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-onebot-verifier)
 
-**适用于 OneBot 协议的综合审核管理插件**。本插件支持自动处理好友申请、加群申请以及进群邀请，并提供灵活的人工审核通知与指令操作功能。
+适用于 OneBot 的审核插件。不仅支持好友/加群自动审核，还支持**入群验证码**、**投票表决**、**被踢自动清理**等功能。
 
-## ✨ 功能特性
+## ✨ 核心特性
 
-- **多场景覆盖**：支持好友申请、他人加群、邀请机器人进群三种场景。
-- **自动审核机制**：
-  - **等级校验**：根据 QQ 等级进行初步筛选。
-  - **正则匹配**：对验证信息进行关键词正则匹配。
-  - **群规模校验**：针对机器人被邀请进群，可设置最小成员数或最小群容量要求。
-- **三种工作模式**：
-  - `strict`（规则模式）：仅处理配置了规则的请求。
-  - `assist`（辅助模式）：规则不匹配时转为人工审核。
-  - `manual`（手动模式）：全人工介入。
-- **交互式人工审核**：通过引用通知消息并回复 `y/n` 即可快速通过或拒绝申请。
-- **超时自动处理**：防止人工审核积压，支持超时后自动通过或拒绝。
+- 🛡️ **全场景覆盖**：好友申请、用户加群、机器人受邀进群、被踢后续处理。
+- 🧩 **多种验证模式**：
+  - **自动规则**：基于 QQ 等级、正则关键词、群规模（成员数/容量）的秒级自动化处理。
+  - **入群验证码**：新成员进群后触发数学运算挑战，失败自动移出。
+  - **民主投票**：将加群申请转为群内投票，达到指定票数自动通过/拒绝。
+- 交互式人工干预：引用通知消息回复 `y/n` 即可操作，支持超时自动决策。
+- 🧹 **智能清理**：机器人被恶意踢出时，可自动删除邀请者或操作者的好友，并清理数据统计。
+- 📍 **就地审核**：支持在发生申请的群内直接发起审核，无需跳转管理群。
 
-## ⚙️ 配置项说明
+## ⚙️ 配置项深度解析
 
 ### 1. 基础配置
 
-- **通知目标 (`notifyTarget`)**: 审核信息的推送位置。格式为 `private:QQ号` 或 `guild:群号`。
-- **发送全部通知 (`notifyAuto`)**: 开启后，即便被插件自动通过/拒绝的请求也会发送通知。
-- **调试模式 (`debugMode`)**: 开启后将输出更详细的日志。
+- **通知目标 (`notifyTarget`)**: 必填。格式为 `private:QQ号` 或 `guild:群号`。
+- **被踢自动处理 (`kickBan`)**: 开启后，若机器人被移出群组，将自动尝试删除邀请者和操作者的好友。
 
-### 2. 好友与邀群配置
+### 2. 好友与邀群 (机器人被邀)
 
-- **请求超时时长 (`timeout`)**: 人工审核的等待时间（单位：分钟）。
-- **默认超时操作 (`timeoutAction`)**: 超时未处理时执行的操作（同意/拒绝）。
-- **最低好友等级 (`friendLevel`)**: 申请人 QQ 等级需达到的标准（-1 为不限制）。
-- **好友验证正则 (`friendRegex`)**: 匹配好友申请时的验证信息。
-- **最低群成员数 (`minMembers`)**: 机器人被邀请进群时，该群的现有人数要求。
-- **最低受邀容量 (`maxCapacity`)**: 机器人被邀请进群时，该群的群上限人数要求。
+- **超时处理 (`friendTimeout`)**: 数字表示分钟。正数表示超时自动同意，负数表示超时自动拒绝，`false` 表示永久等待。
+- **验证维度**:
+  - `friendLevel`: 申请人最低 QQ 等级。
+  - `friendRegex`: 匹配好友申请说明。
+  - `minMembers` / `maxCapacity`: 校验目标群的活跃程度与规模。
 
-### 3. 加群请求配置 (用户加群)
+### 3. 加群请求 (用户入群)
 
-- **处理模式 (`verifyMode`)**:
-  - `规则`: 仅处理在下方“加群验证配置”中列出的群。
-  - `超时`: 匹配不到规则时，发送人工审核，超时后执行默认操作。
-  - `手动`: 所有申请直接进入人工审核。
-- **加群验证配置 (`verifyRules`)**:
-  - 为特定群设置专属的验证正则、最低等级要求及超时处理动作。
+- **普通验证规则 (`verifyRules`)**: 表格化配置。可针对不同群设置不同的关键词正则和等级要求。
+- **特殊验证模式 (`specialRules`)**:
+  - **投票模式 (vote)**: 引用通知回复 `y/n` 累计票数。
+  - **验证码模式 (captcha)**: 机器人自动先通过申请，用户进群后需在 60s 内回复计算题。
 
-## 🎮 使用方法
+### 4. 进阶安全
 
-### 人工审核交互
+- **投票比例 (`voteRatio`)**: 格式如 `3:2`，表示 3 票赞成则通过，2 票反对则拒绝。
+- **就地投票 (`voteInSitu`)**: 开启后，投票通知将直接发往“该申请所属的群”而非全局通知目标。
+- **验证码难度 (`captchaDiff`)**: 简单（100以内加减）、中等（两位数乘一位数）、困难（两位数乘两位数）。
 
-当有新的申请触发人工审核时，插件会向 `notifyTarget` 发送通知。你只需**引用该通知消息**并回复：
+## 🎮 指令交互指南
 
-- **通过申请**：回复 `y` 或 `通过`。
-  - *提示：若是好友申请，后面可跟备注（如：`y 朋友`）。*
-- **拒绝申请**：回复 `n` 或 `拒绝`。
-  - *提示：后面可以跟拒绝理由（如：`n 等级太低`）。*
+### 人工审核 / 投票
 
-### 自动处理逻辑
+当收到审核通知时，**引用该消息**并回复：
 
-1. **好友申请**：先匹配正则，再校验等级。
-2. **机器人进群**：管理员（权限 > 1）邀请直接通过；普通用户邀请则校验成员数和群容量。
-3. **用户进群**：按照 `verifyRules` 中的设置执行。若不满足条件，则根据 `verifyMode` 决定直接拒绝或转人工。
+- **通过**：回复 `y` 或 `通过`。
+- **拒绝**：回复 `n` 或 `拒绝 [理由]`。
+- **备注**：好友申请通过时，`y 备注名` 可直接修改好友备注。
 
-## 🛠️ 技术细节
+### 自动清理逻辑
 
-- 插件会自动剥离 OneBot 验证信息中的 `回答：` 等前缀，直接提取核心答案进行正则匹配。
-- 对于已经进入群组但被判定不符合条件的邀请，插件会自动发送通知并执行退群操作。
+1. **数据清理**：当机器人退出或被踢出群组时，插件会自动执行 `analyse.clear`清理相关统计。
+2. **反制措施**：若开启 `kickBan`，被踢后会自动切断与相关管理员的好友关系。
+
+## ⚠️ 注意事项
+
+- 使用验证码模式时，请确保机器人拥有**管理员权限**，否则无法在验证失败时踢出成员。
+- `notifyTarget` 必须符合 `platform:id` 格式，且机器人必须与该目标存在好友或群成员关系。