@zhin.js/adapter-qq 6.0.6 → 6.0.7

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @zhin.js/adapter-qq
 
+## 6.0.7
+
+### Patch Changes
+
+- 7249733: fix(qq): 群消息 @ 判定改为统一按 mentions 检查，不再按 channelKind 直接视为 @
+
+  `GROUP_MESSAGE_CREATE` 与 `GROUP_AT_MESSAGE_CREATE` 在 SDK 中都映射为 `message.group`，前者会下发非 @ 的普通群消息；此前 `channelKind === 'group'` 一律置 `mentioned`，导致所有群消息都触发 AI。现统一按 `mentions` 判定：群场景只认 `is_you === true`（精确标识当前机器人；群里 @ 另一个机器人时 `bot: true` 但无 `is_you`，不误判），`bot === true` 回退仅限频道 `AT_MESSAGE_CREATE`（该事件仅 @ 当前机器人时下发，mentions 无 `is_you`）。非 @ 群消息将回到旁听（Passive Group Context）路径。
+
 ## 6.0.6
 
 ### Patch Changes

package/lib/protocol.d.ts

@@ -66,8 +66,10 @@ export interface QqInboundMessage {
     readonly guildId?: string;
     readonly rawMessage?: string;
     /**
-     * 入站即 @ 机器人（AT_MESSAGE_CREATE 的 mentions[].bot，或群 GROUP_AT_MESSAGE_CREATE
-     * 事件本身仅 @ 时下发）。新 Runtime 纯文本 content 需经 metadata 传递。
+     * 入站是否 @ 当前机器人：统一按 mentions 判定。群场景只认 is_you（@ 另一个
+     * 机器人时 bot:true 但无 is_you，不误判）；bot 回退仅限频道 AT 事件。
+     * 群 GROUP_MESSAGE_CREATE 的非 @ 消息不置位。新 Runtime 纯文本 content 需经
+     * metadata 传递。
      */
     readonly mentioned?: boolean;
 }

package/lib/ws.js

@@ -63,9 +63,12 @@ export function normalizeQqMessage(raw) {
     const content = extractTextContent(msg.message) || msg.raw_message || '';
     const rawRoles = msg.member?.roles ?? msg.sender?.roles;
     const authorRoles = Array.isArray(rawRoles) ? rawRoles.map(String) : undefined;
-    // 群 GROUP_AT_MESSAGE_CREATE 仅 @ 机器人时下发；频道 AT 事件看 mentions[].bot
-    const mentioned = channelKind === 'group'
-        || (Array.isArray(msg.mentions) && msg.mentions.some((m) => m?.bot === true));
+    // 统一按 mentions 判定 @：is_you 精确标识当前机器人（群载荷实测字段）。
+    // 群里 @ 另一个机器人时 mentions 带 bot:true 但无 is_you，不能误判为 @ 当前机器人，
+    // 故群场景只认 is_you；bot 回退仅限频道 AT_MESSAGE_CREATE（该事件仅 @ 当前
+    // 机器人时下发，其 mentions 无 is_you）。
+    const mentioned = Array.isArray(msg.mentions)
+        && msg.mentions.some((m) => m?.is_you === true || (m?.bot === true && channelKind !== 'group'));
     return {
         id: String(msg.message_id),
         content,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-qq",
-  "version": "6.0.6",
+  "version": "6.0.7",
   "description": "Zhin.js QQ Official adapter for Plugin Runtime (WebSocket gateway)",
   "type": "module",
   "main": "./lib/index.js",
@@ -37,9 +37,9 @@
     "qq-official-bot": "^1.2.3",
     "@zhin.js/adapter": "1.1.2",
     "@zhin.js/command": "1.0.4",
+    "@zhin.js/logger": "1.0.75",
     "@zhin.js/core": "1.4.3",
     "@zhin.js/host-http": "1.0.4",
-    "@zhin.js/logger": "1.0.75",
     "@zhin.js/plugin-runtime": "1.1.1"
   },
   "peerDependencies": {
@@ -47,8 +47,8 @@
     "@zhin.js/adapter": "1.1.2",
     "@zhin.js/agent": "1.0.10",
     "@zhin.js/core": "1.4.3",
-    "@zhin.js/plugin-runtime": "1.1.1",
-    "zhin.js": "5.0.3"
+    "zhin.js": "5.0.3",
+    "@zhin.js/plugin-runtime": "1.1.1"
   },
   "peerDependenciesMeta": {
     "zhin.js": {

package/src/protocol.ts

@@ -77,8 +77,10 @@ export interface QqInboundMessage {
   readonly guildId?: string;
   readonly rawMessage?: string;
   /**
-   * 入站即 @ 机器人（AT_MESSAGE_CREATE 的 mentions[].bot，或群 GROUP_AT_MESSAGE_CREATE
-   * 事件本身仅 @ 时下发）。新 Runtime 纯文本 content 需经 metadata 传递。
+   * 入站是否 @ 当前机器人：统一按 mentions 判定。群场景只认 is_you（@ 另一个
+   * 机器人时 bot:true 但无 is_you，不误判）；bot 回退仅限频道 AT 事件。
+   * 群 GROUP_MESSAGE_CREATE 的非 @ 消息不置位。新 Runtime 纯文本 content 需经
+   * metadata 传递。
    */
   readonly mentioned?: boolean;
 }

package/src/ws.ts

@@ -94,8 +94,8 @@ export function normalizeQqMessage(raw: unknown): QqInboundMessage | null {
     sender?: { user_id?: string | number; user_name?: string; roles?: (string | number)[] };
     member?: { roles?: (string | number)[] };
     author?: { member_openid?: string; user_openid?: string; id?: string; username?: string };
-    /** AT_MESSAGE_CREATE 载荷：被 @ 的用户列表，bot=true 即机器人 */
-    mentions?: Array<{ id?: string | number; bot?: boolean }>;
+    /** AT 事件载荷：被 @ 的用户列表；is_you 标识当前机器人，bot 标识机器人账号 */
+    mentions?: Array<{ id?: string | number; bot?: boolean; is_you?: boolean; member_openid?: string; member_role?: string }>;
   };
   if (msg.message_id == null) return null;
 
@@ -132,9 +132,12 @@ export function normalizeQqMessage(raw: unknown): QqInboundMessage | null {
   const content = extractTextContent(msg.message) || msg.raw_message || '';
   const rawRoles = msg.member?.roles ?? msg.sender?.roles;
   const authorRoles = Array.isArray(rawRoles) ? rawRoles.map(String) : undefined;
-  // 群 GROUP_AT_MESSAGE_CREATE 仅 @ 机器人时下发；频道 AT 事件看 mentions[].bot
-  const mentioned = channelKind === 'group'
-    || (Array.isArray(msg.mentions) && msg.mentions.some((m) => m?.bot === true));
+  // 统一按 mentions 判定 @：is_you 精确标识当前机器人（群载荷实测字段）。
+  // 群里 @ 另一个机器人时 mentions 带 bot:true 但无 is_you，不能误判为 @ 当前机器人，
+  // 故群场景只认 is_you；bot 回退仅限频道 AT_MESSAGE_CREATE（该事件仅 @ 当前
+  // 机器人时下发，其 mentions 无 is_you）。
+  const mentioned = Array.isArray(msg.mentions)
+    && msg.mentions.some((m) => m?.is_you === true || (m?.bot === true && channelKind !== 'group'));
 
   return {
     id: String(msg.message_id),