koishi-plugin-onebot-verifier 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,22 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "onebot-verifier";
+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 interface Config {
+    enable?: boolean;
+    notifyTarget?: string;
+    enableDebug?: boolean;
+    FriendLevel?: number;
+    FriendRequestAutoRegex?: string;
+    MemberRequestAutoRules?: {
+        guildId: string;
+        keyword: string;
+        minLevel: number;
+    }[];
+    GuildAllowUsers?: string[];
+    GuildMinMemberCount?: number;
+    GuildMaxCapacity?: number;
+    manualTimeout?: number;
+    manualTimeoutAction?: 'accept' | 'reject';
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config?: Config): void;

package/lib/index.js

@@ -0,0 +1,312 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Config: () => Config,
+  apply: () => apply,
+  name: () => name,
+  usage: () => usage
+});
+module.exports = __toCommonJS(src_exports);
+var import_koishi = require("koishi");
+var name = "onebot-verifier";
+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: #4a6ee0;">📌 插件说明</h2>
+  <p>📖 <strong>使用文档</strong>：请点击左上角的 <strong>插件主页</strong> 查看插件使用文档</p>
+  <p>🔍 <strong>更多插件</strong>：可访问 <a href="https://github.com/YisRime" style="color:#4a6ee0;text-decoration:none;">苡淞的 GitHub</a> 查看本人的所有插件</p>
+</div>
+<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>
+</div>
+`;
+var Config = import_koishi.Schema.object({
+  enable: import_koishi.Schema.boolean().description("开启请求监听").default(true),
+  notifyTarget: import_koishi.Schema.string().description("通知目标(guild/private:number)").required(),
+  enableDebug: import_koishi.Schema.boolean().description("开启调试日志").default(false),
+  manualTimeout: import_koishi.Schema.number().description("请求超时时长").default(360).min(0),
+  manualTimeoutAction: import_koishi.Schema.union([
+    import_koishi.Schema.const("accept").description("同意"),
+    import_koishi.Schema.const("reject").description("拒绝")
+  ]).description("默认超时操作").default("accept"),
+  FriendLevel: import_koishi.Schema.number().description("最低好友等级").default(-1).min(-1).max(256),
+  GuildMinMemberCount: import_koishi.Schema.number().description("最低群成员数").default(-1).min(-1).max(3e3),
+  GuildMaxCapacity: import_koishi.Schema.number().description("最低受邀容量").default(-1).min(-1).max(3e3),
+  FriendRequestAutoRegex: import_koishi.Schema.string().description("好友验证正则"),
+  MemberRequestAutoRules: import_koishi.Schema.array(import_koishi.Schema.object({
+    guildId: import_koishi.Schema.string().description("群号"),
+    keyword: import_koishi.Schema.string().description("正则"),
+    minLevel: import_koishi.Schema.number().description("等级").default(-1)
+  })).description("加群验证规则").role("table"),
+  GuildAllowUsers: import_koishi.Schema.array(String).description("邀请加群白名单").role("table")
+}).description("请求处理配置");
+function extractAnswers(message) {
+  if (!message) return "";
+  const lines = message.split(/[\r\n]+/);
+  const answers = lines.map((line) => line.trim()).filter((line) => /^(回答)[:：]/i.test(line)).map((line) => line.replace(/^(回答)[:：]\s*/i, ""));
+  if (answers.length > 0) return answers.join("\n");
+  return message;
+}
+__name(extractAnswers, "extractAnswers");
+function apply(ctx, config = {}) {
+  const logger = new import_koishi.Logger("onebot-verifier");
+  const requestNumberMap = /* @__PURE__ */ new Map();
+  let nextRequestNumber = 1;
+  const activeRequests = /* @__PURE__ */ new Map();
+  const processedFlags = /* @__PURE__ */ new Set();
+  const cleanupActiveRequest = /* @__PURE__ */ __name((requestKey) => {
+    const activeRequest = activeRequests.get(requestKey);
+    if (!activeRequest) return;
+    activeRequest.disposer?.();
+    if (activeRequest.timeoutTimer) clearTimeout(activeRequest.timeoutTimer);
+    requestNumberMap.delete(activeRequest.requestNumber);
+    activeRequests.delete(requestKey);
+  }, "cleanupActiveRequest");
+  const processRequestAction = /* @__PURE__ */ __name(async (session, type, approve, reason = "", remark = "") => {
+    try {
+      const eventData = session.event?._data || {};
+      if (!approve && type === "guild" && session.guildId && (session.event?.type === "guild-added" || eventData.notice_type === "group_increase")) {
+        if (reason) {
+          try {
+            await session.bot.sendMessage(session.guildId, `将退出该群 ${reason}`);
+          } catch (e) {
+            logger.warn(`发送退群通知失败: ${e}`);
+          }
+        }
+        try {
+          if (session.onebot) await session.onebot.setGroupLeave(session.guildId, false);
+          return true;
+        } catch (e) {
+          logger.error(`退出群组 ${session.guildId} 失败: ${e}`);
+          return false;
+        }
+      }
+      const flag = eventData.flag;
+      if (!flag || !session.onebot) return false;
+      if (type === "friend") await session.onebot.setFriendAddRequest(flag, approve, remark);
+      else await session.onebot.setGroupAddRequest(flag, eventData.sub_type ?? "add", approve, approve ? "" : reason);
+      return true;
+    } catch (e) {
+      logger.error(`请求处理失败: ${e}`);
+      return false;
+    }
+  }, "processRequestAction");
+  const sendRequestNotification = /* @__PURE__ */ __name(async (session, type, status, details = {}) => {
+    const { notifyTarget = "" } = config;
+    if (!notifyTarget) return;
+    const [targetType, targetId] = notifyTarget.split(":");
+    if (!targetId || targetType !== "guild" && targetType !== "private") return;
+    try {
+      const eventData = session.event?._data || {};
+      const user = session.userId ? await session.bot.getUser?.(session.userId)?.catch(() => null) : null;
+      const userName = user?.name || session.userId || "未知用户";
+      const guild = type !== "friend" && session.guildId ? await session.bot.getGuild?.(session.guildId)?.catch(() => null) : null;
+      const operator = eventData.operator_id && session.userId && eventData.operator_id.toString() !== session.userId ? await session.bot.getUser?.(eventData.operator_id.toString())?.catch(() => null) : null;
+      const msgLines = [];
+      if (user?.avatar) msgLines.push(`<image url="${user.avatar}"/>`);
+      let requestTypeText = type === "friend" ? "好友申请" : type === "member" ? "加群请求" : "群组邀请";
+      msgLines.push(`类型：${requestTypeText}`);
+      if (type !== "guild" || session.userId !== session.selfId) {
+        msgLines.push(`用户：${userName}${session.userId ? `(${session.userId})` : ""}`);
+      }
+      if (operator) msgLines.push(`管理：${operator.name ? `${operator.name}(${eventData.operator_id})` : eventData.operator_id}`);
+      if (guild) msgLines.push(`群组：${guild.name ? `${guild.name}(${session.guildId})` : session.guildId}`);
+      if (eventData.comment) msgLines.push(`验证信息：${eventData.comment}`);
+      const sendFunc = targetType === "private" ? (m) => session.bot.sendPrivateMessage(targetId, m) : (m) => session.bot.sendMessage(targetId, m);
+      await sendFunc(msgLines.join("\n"));
+      if (status === "pending" && details.requestNumber) {
+        await sendFunc(`请回复以下命令处理请求 #${details.requestNumber}：
+通过[y/ya]${details.requestNumber} [备注] | 拒绝[n/na]${details.requestNumber} [理由]`);
+      }
+    } catch (e) {
+      logger.error(`发送通知失败: ${e}`);
+    }
+  }, "sendRequestNotification");
+  const shouldAutoAccept = /* @__PURE__ */ __name(async (session, type) => {
+    const validationMessage = extractAnswers(session.event?._data?.comment);
+    const parseRegex = /* @__PURE__ */ __name((input) => {
+      const slashMatch = input.match(/^\/(.+)\/([a-z]*)$/);
+      if (slashMatch) return new RegExp(slashMatch[1], slashMatch[2]);
+      return new RegExp(input, "i");
+    }, "parseRegex");
+    switch (type) {
+      case "member": {
+        const rule = (config.MemberRequestAutoRules || []).find((r) => r.guildId === session.guildId);
+        if (!rule) return false;
+        if (rule.keyword) {
+          try {
+            if (!parseRegex(rule.keyword).test(validationMessage)) return false;
+          } catch (e) {
+            return false;
+          }
+        }
+        if ((rule.minLevel ?? -1) >= 0 && session.onebot && session.userId) {
+          try {
+            const userInfo = await session.onebot.getStrangerInfo(session.userId, true);
+            if ((userInfo.qqLevel ?? 0) < rule.minLevel) return `QQ 等级低于${rule.minLevel}级`;
+          } catch (e) {
+            return false;
+          }
+        }
+        return true;
+      }
+      case "friend": {
+        if (config.FriendRequestAutoRegex) {
+          try {
+            if (parseRegex(config.FriendRequestAutoRegex).test(validationMessage)) return true;
+          } catch (e) {
+          }
+        }
+        if ((config.FriendLevel ?? -1) >= 0 && session.onebot && session.userId) {
+          try {
+            const userInfo = await session.onebot.getStrangerInfo(session.userId, true);
+            if ((userInfo.qqLevel ?? 0) < config.FriendLevel) return `QQ 等级低于${config.FriendLevel}级`;
+            return true;
+          } catch (e) {
+            return false;
+          }
+        }
+        return false;
+      }
+      case "guild": {
+        if (session.userId && (config.GuildAllowUsers || []).includes(session.userId)) return true;
+        try {
+          if (session.userId) {
+            const user = await ctx.database.getUser(session.platform, session.userId);
+            if (user && user.authority > 1) return true;
+          }
+        } catch {
+        }
+        if ((config.GuildMinMemberCount ?? -1) >= 0 || (config.GuildMaxCapacity ?? -1) >= 0) {
+          if (session.onebot && session.guildId) {
+            try {
+              const info = await session.onebot.getGroupInfo(session.guildId, true);
+              if (config.GuildMinMemberCount >= 0 && info.member_count < config.GuildMinMemberCount) return `群成员不足${config.GuildMinMemberCount}人`;
+              if (config.GuildMaxCapacity >= 0 && info.max_member_count < config.GuildMaxCapacity) return `群容量不足${config.GuildMaxCapacity}`;
+              return true;
+            } catch (e) {
+              return false;
+            }
+          }
+        }
+        return false;
+      }
+    }
+  }, "shouldAutoAccept");
+  const setupManualHandling = /* @__PURE__ */ __name(async (session, type, requestId) => {
+    const requestNumber = nextRequestNumber++;
+    requestNumberMap.set(requestNumber, requestId);
+    const activeRequest = { session, type, requestNumber };
+    activeRequests.set(requestId, activeRequest);
+    await sendRequestNotification(session, type, "pending", { requestNumber });
+    const timeoutMin = config.manualTimeout ?? 60;
+    if (timeoutMin > 0) {
+      activeRequest.timeoutTimer = setTimeout(async () => {
+        if (!activeRequests.has(requestId)) return;
+        cleanupActiveRequest(requestId);
+        const action = config.manualTimeoutAction || "accept";
+        await processRequestAction(session, type, action === "accept", action === "reject" ? "处理超时自动拒绝" : "");
+        const [tType, tId] = (config.notifyTarget || "").split(":");
+        if (tId) {
+          const send = tType === "private" ? (m) => session.bot.sendPrivateMessage(tId, m) : (m) => session.bot.sendMessage(tId, m);
+          await send(`请求 #${requestNumber} 超时，已自动${action === "accept" ? "通过" : "拒绝"}`);
+        }
+      }, timeoutMin * 60 * 1e3);
+    }
+    const [targetType, targetId] = (config.notifyTarget || "").split(":");
+    if (!targetId) return;
+    activeRequest.disposer = ctx.middleware(async (s, next) => {
+      if (typeof s.content !== "string") return next();
+      if (targetType === "private" ? s.userId !== targetId : s.guildId !== targetId) return next();
+      const bulkMatch = s.content.trim().match(/^(ya|na|全部同意|全部拒绝)\s*(.*)$/);
+      if (bulkMatch && activeRequests.size > 0) {
+        const reqs = [...activeRequests.values()];
+        activeRequests.clear();
+        requestNumberMap.clear();
+        const isApprove2 = bulkMatch[1] === "ya" || bulkMatch[1] === "全部同意";
+        const extra2 = bulkMatch[2]?.trim() || "";
+        for (const r of reqs) {
+          r.disposer?.();
+          if (r.timeoutTimer) clearTimeout(r.timeoutTimer);
+          await processRequestAction(r.session, r.type, isApprove2, !isApprove2 ? extra2 : "", isApprove2 && r.type === "friend" ? extra2 : "");
+        }
+        const send2 = targetType === "private" ? (m) => s.bot.sendPrivateMessage(targetId, m) : (m) => s.bot.sendMessage(targetId, m);
+        await send2(`已${isApprove2 ? "通过" : "拒绝"} ${reqs.length} 个请求`);
+        return;
+      }
+      const match = s.content.trim().match(new RegExp(`^(y|n|通过|拒绝)(${requestNumber})\\s*(.*)$`));
+      if (!match) return next();
+      cleanupActiveRequest(requestId);
+      const isApprove = match[1] === "y" || match[1] === "通过";
+      const extra = match[3]?.trim() || "";
+      const success = await processRequestAction(session, type, isApprove, !isApprove ? extra : "", isApprove && type === "friend" ? extra : "");
+      const send = targetType === "private" ? (m) => s.bot.sendPrivateMessage(targetId, m) : (m) => s.bot.sendMessage(targetId, m);
+      if (success) await send(`请求 #${requestNumber} 已${isApprove ? "通过" : "拒绝"}`);
+      else await send(`处理请求 #${requestNumber} 失败`);
+    });
+  }, "setupManualHandling");
+  const processRequest = /* @__PURE__ */ __name(async (session, type) => {
+    const flag = session.event?._data?.flag;
+    if (flag) {
+      if (processedFlags.has(flag)) return;
+      processedFlags.add(flag);
+      setTimeout(() => processedFlags.delete(flag), 6e4);
+    }
+    const requestKey = type === "friend" ? `friend:${session.userId}` : type === "guild" ? `guild:${session.guildId}` : `member:${session.userId}:${session.guildId}`;
+    cleanupActiveRequest(requestKey);
+    try {
+      const autoResult = await shouldAutoAccept(session, type);
+      if (autoResult === true) {
+        await processRequestAction(session, type, true);
+        await sendRequestNotification(session, type, "approved");
+      } else if (typeof autoResult === "string") {
+        await processRequestAction(session, type, false, autoResult);
+        await sendRequestNotification(session, type, "rejected", { reason: autoResult });
+      } else {
+        await setupManualHandling(session, type, requestKey);
+      }
+    } catch (e) {
+      logger.error(`处理流程出错: ${e}`);
+    }
+  }, "processRequest");
+  if (config.enable !== false) {
+    const handle = /* @__PURE__ */ __name((type) => async (session) => {
+      const data = session.event?._data || {};
+      session.userId = data.user_id?.toString();
+      if (type !== "friend") session.guildId = data.group_id?.toString();
+      await processRequest(session, type);
+    }, "handle");
+    ctx.on("friend-request", handle("friend"));
+    ctx.on("guild-request", handle("guild"));
+    ctx.on("guild-member-request", handle("member"));
+    ctx.on("guild-added", handle("guild"));
+  }
+}
+__name(apply, "apply");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Config,
+  apply,
+  name,
+  usage
+});

package/lib/request.d.ts

@@ -0,0 +1,84 @@
+import { Context, Logger, Session } from 'koishi';
+import { Config } from './index';
+/**
+ * 请求类型
+ * - friend: 好友请求
+ * - guild: 群组请求
+ * - member: 群成员请求
+ */
+export type RequestType = 'friend' | 'guild' | 'member';
+/**
+ * OneBot 用户信息接口
+ */
+export interface OneBotUserInfo {
+    /** 用户 ID */
+    user_id: number;
+    /** QQ等级 */
+    qqLevel?: number;
+}
+/**
+ * OneBot 群组信息接口
+ */
+export interface OneBotGroupInfo {
+    /** 群组 ID */
+    group_id: number;
+    /** 群组名称 */
+    group_name: string;
+    /** 成员数量 */
+    member_count: number;
+    /** 群组最大成员数 */
+    max_member_count: number;
+}
+/**
+ * OneBot 请求处理类
+ * 处理好友请求、群组请求和群成员请求
+ */
+export declare class OnebotRequest {
+    private ctx;
+    private logger;
+    private config;
+    private requestNumberMap;
+    private nextRequestNumber;
+    private activeRequests;
+    private processedFlags;
+    /**
+     * 创建 OneBot 请求处理实例
+     * @param ctx - Koishi 上下文
+     * @param logger - 日志记录器
+     * @param config - 配置项
+     */
+    constructor(ctx: Context, logger: Logger, config?: Config);
+    /**
+     * 清理并取消一个活动中的请求
+     */
+    private cleanupActiveRequest;
+    /**
+     * 从验证消息中提取用户的回答
+     * 如果消息包含 "回答:" 格式，则只返回回答部分
+     */
+    private extractAnswers;
+    /**
+     * 发送请求通知
+     */
+    private sendRequestNotification;
+    /**
+     * 处理收到的请求
+     */
+    processRequest(session: Session, type: RequestType): Promise<void>;
+    /**
+     * 判断是否应自动接受请求
+     */
+    private shouldAutoAccept;
+    /**
+     * 处理请求操作（接受或拒绝）
+     */
+    private processRequestAction;
+    /**
+     * 设置手动处理流程：通知、响应监听和超时回退
+     */
+    private setupManualHandling;
+    /**
+     * 注册请求类事件监听器
+     */
+    registerEventListeners(): void;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "koishi-plugin-onebot-verifier",
+  "description": "适用于 Onebot 的审核插件，支持自动审核好友/加群/邀请请求",
+  "version": "0.0.1",
+  "contributors": [
+    "Yis_Rime <yis_rime@outlook.com>"
+  ],
+  "homepage": "https://github.com/Koishi-Plugin/onebot-verifier",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Koishi-Plugin/onebot-verifier.git"
+  },
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "license": "AGPL-3.0-only",
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin",
+    "onebot",
+    "verifier",
+    "group",
+    "user"
+  ],
+  "devDependencies": {
+    "koishi-plugin-adapter-onebot": "^6.1.3"
+  },
+  "peerDependencies": {
+    "koishi": "^4.18.3"
+  }
+}

package/readme.md

@@ -0,0 +1,5 @@
+# koishi-plugin-onebot-verifier
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-onebot-verifier?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-onebot-verifier)
+
+适用于 Onebot 的审核插件，支持自动审核好友/加群/邀请请求