koishi-plugin-group-verification 1.0.22 → 1.0.24

package/lib/index.js

@@ -291,6 +291,10 @@ __name(verifyApplication, "verifyApplication");
 async function handleFailedVerification(ctx, session, config, matchedCount, requiredThreshold) {
   const guildId = (session.guildId || session.channelId || "").toString().trim();
   const userId = session.userId;
+  if (!guildId) {
+    logger.warn("handleFailedVerification invoked without guildId, aborting");
+    return;
+  }
   const username = session.username || "未知用户";
   const message = session.content || "";
   logger.info(`处理失败验证 guild=${guildId} user=${userId} msg="${message}" matched=${matchedCount} threshold=${requiredThreshold}`);
@@ -318,7 +322,20 @@ async function handleFailedVerification(ctx, session, config, matchedCount, requ
   }
   let reminderMsg = config.reminderMessage;
   reminderMsg = reminderMsg.replace(/{user}/g, username).replace(/{id}/g, userId).replace(/{group}/g, guildId).replace(/{gname}/g, groupName).replace(/{question}/g, message).replace(/{answer}/g, matchedCount.toString()).replace(/{threshold}/g, requiredThreshold);
-  await ctx.broadcast([guildId], reminderMsg);
+  const rawChannel = (session.channelId || "").toString().trim();
+  const channel = rawChannel || guildId;
+  const target = rawChannel ? [channel, guildId] : guildId;
+  logger.debug("broadcast target", { channel, guildId, target });
+  if (session.bot && typeof session.bot.broadcast === "function") {
+    try {
+      await session.bot.broadcast([target], reminderMsg);
+    } catch (err) {
+      logger.warn("bot.broadcast failed, fallback to ctx.broadcast", err);
+      await ctx.broadcast([target], reminderMsg);
+    }
+  } else {
+    await ctx.broadcast([target], reminderMsg);
+  }
 }
 __name(handleFailedVerification, "handleFailedVerification");
 function apply(ctx, config) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-group-verification",
   "description": "[WIP] Koishi 群组加群验证插件，支持多关键词匹配审核、多种审核方式和详细统计功能（开发中）",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -146,7 +146,13 @@ group-verify.stats total
 - **手动批准**：管理员手动同意的用户数
 - **拒绝**：被拒绝的申请数
 - **手动入群**：管理员直接邀请入群的用户数
-
+### ⚠️ OneBot/QQ 适配器注意
+默认情况下插件会使用 `ctx.broadcast` 发送提醒消息，
+为了兼容 OneBot、QQ 等需要同时指定频道和群号的协议，
+插件会自动将 `session.channelId` 与 `session.guildId` 一起
+传给 `broadcast`。如果你使用的适配器出现无法发送消息的
+情况，请确保群号与频道 ID 正确无空格，或者手动在配置
+中补充 channelId（目前是自动处理）。
 ## 🛠️ 开发配置
 
 ### 全局配置

package/src/index.ts

@@ -415,6 +415,11 @@ export async function handleFailedVerification(
 ) {
   const guildId = (session.guildId || session.channelId || '').toString().trim();
   const userId = session.userId
+  // 如果没有可用的群号，直接退出（防止错误插入数据库）
+  if (!guildId) {
+    logger.warn('handleFailedVerification invoked without guildId, aborting')
+    return
+  }
   const username = session.username || '未知用户'
   const message = session.content || ''
   logger.info(`处理失败验证 guild=${guildId} user=${userId} msg="${message}" matched=${matchedCount} threshold=${requiredThreshold}`)
@@ -460,7 +465,24 @@ export async function handleFailedVerification(
     .replace(/{threshold}/g, requiredThreshold!)
 
   // 发送提醒消息到群内
-  await ctx.broadcast([guildId], reminderMsg)
+  // OneBot 等适配器需要同时指定 channelId 与 guildId，否则会无法定位到具体频道
+  // ctx.broadcast 接收的元素可以是字符串、[channel, guild] 或者 session
+  const rawChannel = (session.channelId || '').toString().trim()
+  const channel = rawChannel || guildId
+  const target: string | [string, string] = rawChannel ? [channel, guildId] : guildId
+  logger.debug('broadcast target', { channel, guildId, target })
+  // prefer using bot.broadcast since ctx.broadcast may not support tuple
+  if (session.bot && typeof session.bot.broadcast === 'function') {
+    try {
+      await session.bot.broadcast([target], reminderMsg as any)
+    } catch (err) {
+      // fallback to ctx.broadcast if bot.broadcast fails for some reason
+      logger.warn('bot.broadcast failed, fallback to ctx.broadcast', err)
+      await (ctx.broadcast as any)([target], reminderMsg)
+    }
+  } else {
+    await (ctx.broadcast as any)([target], reminderMsg)
+  }
 }
 
 export function apply(ctx: Context, config: Config) {