koishi-plugin-onebot-verifier 1.1.6 → 1.1.7

package/lib/index.d.ts

@@ -22,7 +22,6 @@ export interface Config {
     }[];
     specialRules?: {
         guildId: string;
-        enabled: boolean;
         mode: 'vote' | 'captcha';
     }[];
     captchaDiff?: 'simple' | 'medium' | 'hard';

package/lib/index.js

@@ -79,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),
@@ -212,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") {
@@ -305,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") {
@@ -344,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.6",
+  "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` 格式，且机器人必须与该目标存在好友或群成员关系。