@leoqlin/openclaw-qqbot 1.6.8-beta.3 → 1.6.9

package/dist/src/api.js

@@ -850,7 +850,6 @@ async function sleep(ms, signal) {
         }
     });
 }
-import { StreamInputState } from "./types.js";
 /**
  * 发送流式消息（C2C 私聊）
  *
@@ -882,9 +881,5 @@ export async function sendC2CStreamMessage(accessToken, openid, req) {
     if (req.stream_msg_id) {
         body.stream_msg_id = req.stream_msg_id;
     }
-    // 仅终结分片触发引用回调，中间分片跳过
-    if (req.input_state === StreamInputState.DONE) {
-        return sendAndNotify(accessToken, "POST", path, body, { text: req.content_raw });
-    }
     return apiRequest(accessToken, "POST", path, body);
 }

package/dist/src/gateway.js

@@ -1,6 +1,7 @@
 import WebSocket from "ws";
 import path from "node:path";
 import fs from "node:fs";
+import { MSG_TYPE_QUOTE } from "./types.js";
 import { getAccessToken, getGatewayUrl, sendC2CMessage, sendChannelMessage, sendGroupMessage, clearTokenCache, initApiConfig, startBackgroundTokenRefresh, stopBackgroundTokenRefresh, sendC2CInputNotify, onMessageSent, PLUGIN_USER_AGENT, acknowledgeInteraction, getApiPluginVersion, setApiLogger } from "./api.js";
 import { loadSession, saveSession, clearSession } from "./session-store.js";
 import { recordKnownUser, flushKnownUsers } from "./known-users.js";
@@ -699,7 +700,8 @@ export async function startGateway(ctx) {
                 let replyToBody;
                 let replyToSender;
                 let replyToIsQuote = false;
-                // 引用消息处理：优先使用本地 refIndex 缓存（同步、已处理），缓存未命中时降级到 messageReference
+                // 引用消息处理：优先使用本地 refIndex 缓存（同步、已处理），缓存未命中时从 msg_elements[0] 获取
+                // refMsgIdx 已由 parseRefIndices 在引用消息类型时合并了 msg_elements[0].msg_idx 的优先级
                 if (event.refMsgIdx) {
                     const refEntry = getRefIndex(event.refMsgIdx);
                     replyToId = event.refMsgIdx;
@@ -710,14 +712,22 @@ export async function startGateway(ctx) {
                         replyToSender = refEntry.senderName ?? refEntry.senderId;
                         log?.info(`[qqbot:${account.accountId}] Quote detected via refMsgIdx cache: refMsgIdx=${event.refMsgIdx}, sender=${replyToSender}, content="${replyToBody.slice(0, 80)}..."`);
                     }
-                    else if (event.messageReference) {
-                        // 缓存未命中，降级到 messageReference：需异步下载附件、语音转录、表情解析
-                        replyToBody = await formatMessageReferenceForAgent(event.messageReference, { appId: account.appId, peerId, cfg, log });
-                        log?.info(`[qqbot:${account.accountId}] Quote detected via message_reference (cache miss): id=${replyToId}, content="${replyToBody.slice(0, 80)}..."`);
+                    else if (event.msgType === MSG_TYPE_QUOTE) {
+                        // 缓存未命中且为引用消息类型，从 msg_elements[0] 获取被引用消息内容
+                        const refElement = event.msgElements?.[0];
+                        if (refElement) {
+                            const refData = { content: refElement.content ?? "", attachments: refElement.attachments };
+                            replyToBody = await formatMessageReferenceForAgent(refData, { appId: account.appId, peerId, cfg, log });
+                            log?.info(`[qqbot:${account.accountId}] Quote detected via msg_elements[0] (cache miss): id=${replyToId}, sender=${replyToSender ?? "unknown"}, content="${(replyToBody ?? "").slice(0, 80)}..."`);
+                        }
+                        else {
+                            // 引用消息但 msg_elements 为空：AI 只能知道"用户引用了一条消息"
+                            log?.info(`[qqbot:${account.accountId}] Quote detected (MSG_TYPE_QUOTE) but no msg_elements: refMsgIdx=${event.refMsgIdx}`);
+                        }
                     }
                     else {
-                        // 缓存未命中且无 messageReference：AI 只能知道"用户引用了一条消息"
-                        log?.info(`[qqbot:${account.accountId}] Quote detected but no cache and no messageReference: refMsgIdx=${event.refMsgIdx}`);
+                        // 缓存未命中且非引用消息类型：AI 只能知道"用户引用了一条消息"
+                        log?.info(`[qqbot:${account.accountId}] Quote detected but no cache and msgType=${event.msgType} (not quote): refMsgIdx=${event.refMsgIdx}`);
                     }
                 }
                 // 2. 缓存当前消息自身的 msgIdx（供将来被引用时查找）
@@ -1711,7 +1721,7 @@ export async function startGateway(ctx) {
                                     accountId: account.accountId,
                                 });
                                 // 解析引用索引
-                                const c2cRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                                const c2cRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                                 // 斜杠指令拦截 → 不匹配则入队
                                 trySlashCommandOrEnqueue({
                                     type: "c2c",
@@ -1722,7 +1732,8 @@ export async function startGateway(ctx) {
                                     attachments: event.attachments,
                                     refMsgIdx: c2cRefs.refMsgIdx,
                                     msgIdx: c2cRefs.msgIdx,
-                                    messageReference: event.message_reference,
+                                    msgElements: event.msg_elements,
+                                    msgType: event.message_type,
                                 });
                             }
                             else if (t === "AT_MESSAGE_CREATE") {
@@ -1734,7 +1745,7 @@ export async function startGateway(ctx) {
                                     nickname: event.author.username,
                                     accountId: account.accountId,
                                 });
-                                const guildRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                                const guildRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                                 trySlashCommandOrEnqueue({
                                     type: "guild",
                                     senderId: event.author.id,
@@ -1747,6 +1758,7 @@ export async function startGateway(ctx) {
                                     attachments: event.attachments,
                                     refMsgIdx: guildRefs.refMsgIdx,
                                     msgIdx: guildRefs.msgIdx,
+                                    msgType: event.message_type,
                                 });
                             }
                             else if (t === "DIRECT_MESSAGE_CREATE") {
@@ -1758,7 +1770,7 @@ export async function startGateway(ctx) {
                                     nickname: event.author.username,
                                     accountId: account.accountId,
                                 });
-                                const dmRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                                const dmRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                                 trySlashCommandOrEnqueue({
                                     type: "dm",
                                     senderId: event.author.id,
@@ -1770,6 +1782,7 @@ export async function startGateway(ctx) {
                                     attachments: event.attachments,
                                     refMsgIdx: dmRefs.refMsgIdx,
                                     msgIdx: dmRefs.msgIdx,
+                                    msgType: event.message_type,
                                 });
                             }
                             else if (t === "GROUP_AT_MESSAGE_CREATE") {
@@ -1782,7 +1795,7 @@ export async function startGateway(ctx) {
                                     groupOpenid: event.group_openid,
                                     accountId: account.accountId,
                                 });
-                                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                                 trySlashCommandOrEnqueue({
                                     type: "group",
                                     senderId: event.author.member_openid,
@@ -1797,7 +1810,8 @@ export async function startGateway(ctx) {
                                     eventType: "GROUP_AT_MESSAGE_CREATE",
                                     mentions: event.mentions,
                                     messageScene: event.message_scene,
-                                    messageReference: event.message_reference,
+                                    msgElements: event.msg_elements,
+                                    msgType: event.message_type,
                                 });
                             }
                             else if (t === "GROUP_MESSAGE_CREATE") {
@@ -1809,7 +1823,7 @@ export async function startGateway(ctx) {
                                     groupOpenid: event.group_openid,
                                     accountId: account.accountId,
                                 });
-                                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                                 trySlashCommandOrEnqueue({
                                     type: "group",
                                     senderId: event.author.member_openid,
@@ -1825,7 +1839,8 @@ export async function startGateway(ctx) {
                                     eventType: "GROUP_MESSAGE_CREATE",
                                     mentions: event.mentions,
                                     messageScene: event.message_scene,
-                                    messageReference: event.message_reference,
+                                    msgElements: event.msg_elements,
+                                    msgType: event.message_type,
                                 });
                             }
                             else if (t === "GROUP_ADD_ROBOT") {

package/dist/src/message-queue.d.ts

@@ -1,5 +1,5 @@
 import type { QueueSnapshot } from "./slash-commands.js";
-import type { MessageReference } from "./types.js";
+import type { MsgElement } from "./types.js";
 /**
  * 消息队列项类型（用于异步处理消息，防止阻塞心跳）
  */
@@ -43,8 +43,10 @@ export interface QueuedMessage {
         source?: string;
         ext?: string[];
     };
-    /** 消息引用结构（QQ 推送事件中携带的被引用原始消息） */
-    messageReference?: MessageReference;
+    /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+    msgElements?: MsgElement[];
+    /** 消息类型，参见 MSG_TYPE_* */
+    msgType?: number;
     /** 群消息合并标记：记录合并了多少条原始消息 */
     _mergedCount?: number;
     /** 合并前的原始消息列表（用于 gateway 侧逐条格式化信封） */

package/dist/src/slash-commands.js

@@ -1828,7 +1828,23 @@ registerCommand({
             ].join("\n");
         }
         catch (err) {
-            return `❌ 更新配置失败：${err}`;
+            const fwVer = getFrameworkVersion();
+            return [
+                `❌ 当前版本不支持该指令`,
+                ``,
+                `🦞框架版本：${fwVer}`,
+                `🤖QQBot 插件版本：v${PLUGIN_VERSION}`,
+                ``,
+                `可通过以下命令手动开启流式消息：`,
+                ``,
+                `\`\`\`shell`,
+                `# 1. 开启流式消息`,
+                `openclaw config set channels.qqbot.streaming true`,
+                ``,
+                `# 2. 重启网关使配置生效`,
+                `openclaw gateway restart`,
+                `\`\`\``,
+            ].join("\n");
         }
     },
 });

package/dist/src/types.d.ts

@@ -1,3 +1,7 @@
+/** 普通文本消息 */
+export declare const MSG_TYPE_TEXT = 0;
+/** 引用（回复）消息 */
+export declare const MSG_TYPE_QUOTE = 103;
 /**
  * QQ Bot 配置类型
  */
@@ -198,8 +202,10 @@ export interface C2CMessageEvent {
         ext?: string[];
     };
     attachments?: MessageAttachment[];
-    /** 消息引用，当用户引用某条消息时存在 */
-    message_reference?: MessageReference;
+    /** 消息类型，参见 MSG_TYPE_* */
+    message_type?: number;
+    /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+    msg_elements?: MsgElement[];
 }
 /**
  * 频道 AT 消息事件
@@ -221,16 +227,18 @@ export interface GuildMessageEvent {
     };
     attachments?: MessageAttachment[];
 }
-/**
- * 消息引用（被回复的原始消息）
- */
-export interface MessageReference {
-    /** 被引用消息的文本内容 */
-    content: string;
-    /** 被引用消息的附件列表 */
-    attachments?: MessageAttachment[];
-    /** 被引用消息的索引标识 */
+/** 消息元素结点，引用消息时 msg_elements[0] 为被引用的原始消息 */
+export interface MsgElement {
+    /** 消息索引标识 */
     msg_idx?: string;
+    /** 消息类型，参见 MSG_TYPE_* 常量 */
+    message_type?: number;
+    /** 文本内容 */
+    content?: string;
+    /** 附件列表 */
+    attachments?: MessageAttachment[];
+    /** 嵌套消息元素（引用消息场景下可能存在） */
+    msg_elements?: MsgElement[];
 }
 /**
  * 群聊 AT 消息事件
@@ -263,8 +271,10 @@ export interface GroupMessageEvent {
         /** 是否 @机器人自身 */
         is_you?: boolean;
     }>;
-    /** 消息引用，当用户引用某条消息时存在 */
-    message_reference?: MessageReference;
+    /** 消息类型，参见 MSG_TYPE_* */
+    message_type?: number;
+    /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+    msg_elements?: MsgElement[];
 }
 /**
  * 按钮交互事件（INTERACTION_CREATE）

package/dist/src/types.js

@@ -1,3 +1,8 @@
+// ── QQ 消息类型常量（message_type 枚举值） ──
+/** 普通文本消息 */
+export const MSG_TYPE_TEXT = 0;
+/** 引用（回复）消息 */
+export const MSG_TYPE_QUOTE = 103;
 // ---- 流式消息常量 ----
 /** 流式消息输入模式 */
 export const StreamInputMode = {

package/dist/src/utils/text-parsing.d.ts

@@ -13,15 +13,10 @@ export declare function parseFaceTags(text: string): string;
  * 这些标记可能被 AI 错误地学习并输出，需要在发送前移除
  */
 export declare function filterInternalMarkers(text: string): string;
-/**
- * 从 message_scene.ext 和 message_reference 中解析引用索引。
- *
- * @param ext     message_scene.ext 数组，格式示例: ["", "ref_msg_idx=REFIDX_xxx", "msg_idx=REFIDX_yyy"]
- * @param msgRef  message_reference 对象，其 msg_idx 比 ext 中解析的更权威，有值时优先使用
- */
-export declare function parseRefIndices(ext?: string[], msgRef?: {
+/** 从 ext 和 msg_elements 中解析引用索引，仅 MSG_TYPE_QUOTE 时取 msg_elements */
+export declare function parseRefIndices(ext?: string[], messageType?: number, msgElements?: Array<{
     msg_idx?: string;
-}): {
+}>): {
     refMsgIdx?: string;
     msgIdx?: string;
 };

package/dist/src/utils/text-parsing.js

@@ -2,6 +2,7 @@
  * QQ Bot 文本解析工具函数
  */
 import { inferAttachmentType } from "../group-history.js";
+import { MSG_TYPE_QUOTE } from "../types.js";
 /**
  * 解析 QQ 表情标签，将 <faceType=1,faceId="13",ext="base64..."> 格式
  * 替换为 【表情: 中文名】 格式
@@ -35,13 +36,8 @@ export function filterInternalMarkers(text) {
     result = result.replace(/\n{3,}/g, "\n\n").trim();
     return result;
 }
-/**
- * 从 message_scene.ext 和 message_reference 中解析引用索引。
- *
- * @param ext     message_scene.ext 数组，格式示例: ["", "ref_msg_idx=REFIDX_xxx", "msg_idx=REFIDX_yyy"]
- * @param msgRef  message_reference 对象，其 msg_idx 比 ext 中解析的更权威，有值时优先使用
- */
-export function parseRefIndices(ext, msgRef) {
+/** 从 ext 和 msg_elements 中解析引用索引，仅 MSG_TYPE_QUOTE 时取 msg_elements */
+export function parseRefIndices(ext, messageType, msgElements) {
     let refMsgIdx;
     let msgIdx;
     if (ext && ext.length > 0) {
@@ -54,9 +50,12 @@ export function parseRefIndices(ext, msgRef) {
             }
         }
     }
-    // messageReference.msg_idx 更权威，有值时覆盖 ext 解析结果
-    if (msgRef?.msg_idx) {
-        refMsgIdx = msgRef.msg_idx;
+    // 仅当 message_type=MSG_TYPE_QUOTE（引用消息）时，msg_elements[0].msg_idx 更权威，有值时覆盖 ext 解析结果
+    if (messageType === MSG_TYPE_QUOTE) {
+        const refElement = msgElements?.[0];
+        if (refElement?.msg_idx) {
+            refMsgIdx = refElement.msg_idx;
+        }
     }
     return { refMsgIdx, msgIdx };
 }

package/openclaw.plugin.json

@@ -4,7 +4,7 @@
   "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
   "channels": ["qqbot"],
   "extensions": ["./preload.cjs"],
-  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media", "skills/qqbot-upgrade"],
   "capabilities": {
     "proactiveMessaging": true,
     "cronJobs": true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leoqlin/openclaw-qqbot",
-  "version": "1.6.8-beta.3",
+  "version": "1.6.9",
   "publishConfig": {
     "access": "public"
   },

package/scripts/upgrade-via-npm.sh

@@ -80,7 +80,7 @@ trap cleanup_on_exit EXIT
 # 清理上次升级可能遗留的备份目录（如上次脚本被 kill 等极端情况）
 find "${TMPDIR:-/tmp}" -maxdepth 1 -name ".qqbot-upgrade-backup-*" -exec rm -rf {} + 2>/dev/null || true
 
-PKG_NAME="@tencent-connect/openclaw-qqbot"
+PKG_NAME="@leoqlin/openclaw-qqbot"
 PLUGIN_ID="openclaw-qqbot"
 INSTALL_SRC=""
 TARGET_VERSION=""

package/skills/qqbot-upgrade/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: qqbot-upgrade
+description: 通过官方脚本将 openclaw-qqbot 插件升级到最新 npm 版本。当用户要求更新 QQ 机器人插件、升级 qqbot 扩展或同步官方最新版时使用。
+metadata: {"openclaw":{"emoji":"⬆️","requires":{"config":["channels.qqbot"]}}}
+---
+
+# QQBot 插件升级
+
+## 何时使用
+
+用户表达以下意图时，应在**本机终端**执行升级命令（不要只口头说明「去官网升级」）：
+
+- 更新 / 升级 `openclaw-qqbot` 或 QQBot 插件
+- 拉取官方最新 npm 包
+- 执行与「upgrade-via-npm」相关的操作
+
+---
+
+## 标准命令
+
+在 **bash** 环境中执行（需已安装 `curl`，且能访问 GitHub）：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/leol1024/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash
+```
+
+说明：
+
+- `-f`：HTTP 错误时失败；`-sS`：静默但保留错误输出；`-L`：跟随重定向
+- 脚本由 [leol1024/openclaw-qqbot](https://github.com/leol1024/openclaw-qqbot) 仓库 `feat/stream_skill` 分支提供，通过 npm 完成升级流程（具体步骤以脚本为准）
+
+---
+
+## 代理与前置条件
+
+- 若网络无法直连 GitHub，需由用户配置代理或镜像后再执行；代理应作用于当前 shell（如 `HTTPS_PROXY`）
+- 脚本通常会依赖 **Node.js / npm** 环境；若命令失败，根据终端报错检查 PATH、权限与 npm 登录状态
+
+---
+
+## 安全提示
+
+管道执行远程脚本属于**远程代码执行**：仅适用于用户明确请求升级且信任该官方仓库的场景。不要替换为未经验证的 URL。
+
+---
+
+## 执行后
+
+根据脚本退出码与终端输出向用户简要汇报：成功则说明已按官方流程升级；失败则摘录关键错误并提示检查网络、Node/npm 与权限。

package/src/api.ts

@@ -1276,9 +1276,5 @@ export async function sendC2CStreamMessage(
   if (req.stream_msg_id) {
     body.stream_msg_id = req.stream_msg_id;
   }
-  // 仅终结分片触发引用回调，中间分片跳过
-  if (req.input_state === StreamInputState.DONE) {
-    return sendAndNotify(accessToken, "POST", path, body, { text: req.content_raw });
-  }
   return apiRequest<MessageResponse>(accessToken, "POST", path, body);
 }

package/src/gateway.ts

@@ -1,7 +1,8 @@
 import WebSocket from "ws";
 import path from "node:path";
 import fs from "node:fs";
-import type { ResolvedQQBotAccount, WSPayload, C2CMessageEvent, GuildMessageEvent, GroupMessageEvent, InteractionEvent, MessageReference } from "./types.js";
+import type { ResolvedQQBotAccount, WSPayload, C2CMessageEvent, GuildMessageEvent, GroupMessageEvent, InteractionEvent, MsgElement } from "./types.js";
+import { MSG_TYPE_QUOTE } from "./types.js";
 import { getAccessToken, getGatewayUrl, sendC2CMessage, sendChannelMessage, sendGroupMessage, clearTokenCache, initApiConfig, startBackgroundTokenRefresh, stopBackgroundTokenRefresh, sendC2CInputNotify, onMessageSent, PLUGIN_USER_AGENT, sendProactiveGroupMessage, acknowledgeInteraction, getApiPluginVersion, setApiLogger } from "./api.js";
 import { loadSession, saveSession, clearSession } from "./session-store.js";
 import { recordKnownUser, flushKnownUsers } from "./known-users.js";
@@ -726,8 +727,9 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
         eventType?: string;
         mentions?: Array<{ scope?: "all" | "single"; id?: string; user_openid?: string; member_openid?: string; username?: string; bot?: boolean; is_you?: boolean }>;
         messageScene?: { source?: string; ext?: string[] };
-        /** QQ 推送事件中携带的被引用原始消息结构 */
-        messageReference?: MessageReference;
+        msgElements?: MsgElement[];
+        /** 消息类型，参见 MSG_TYPE_* */
+        msgType?: number;
       }) => {
 
         log?.debug?.(`[qqbot:${account.accountId}] Received message: ${JSON.stringify(event)}`);
@@ -856,7 +858,8 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
         let replyToSender: string | undefined;
         let replyToIsQuote = false;
 
-        // 引用消息处理：优先使用本地 refIndex 缓存（同步、已处理），缓存未命中时降级到 messageReference
+        // 引用消息处理：优先使用本地 refIndex 缓存（同步、已处理），缓存未命中时从 msg_elements[0] 获取
+        // refMsgIdx 已由 parseRefIndices 在引用消息类型时合并了 msg_elements[0].msg_idx 的优先级
         if (event.refMsgIdx) {
           const refEntry = getRefIndex(event.refMsgIdx);
           replyToId = event.refMsgIdx;
@@ -867,13 +870,20 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
             replyToBody = formatRefEntryForAgent(refEntry);
             replyToSender = refEntry.senderName ?? refEntry.senderId;
             log?.info(`[qqbot:${account.accountId}] Quote detected via refMsgIdx cache: refMsgIdx=${event.refMsgIdx}, sender=${replyToSender}, content="${replyToBody.slice(0, 80)}..."`);
-          } else if (event.messageReference) {
-            // 缓存未命中，降级到 messageReference：需异步下载附件、语音转录、表情解析
-            replyToBody = await formatMessageReferenceForAgent(event.messageReference, { appId: account.appId, peerId, cfg, log });
-            log?.info(`[qqbot:${account.accountId}] Quote detected via message_reference (cache miss): id=${replyToId}, content="${replyToBody.slice(0, 80)}..."`);
+          } else if (event.msgType === MSG_TYPE_QUOTE) {
+            // 缓存未命中且为引用消息类型，从 msg_elements[0] 获取被引用消息内容
+            const refElement = event.msgElements?.[0];
+            if (refElement) {
+              const refData = { content: refElement.content ?? "", attachments: refElement.attachments };
+              replyToBody = await formatMessageReferenceForAgent(refData, { appId: account.appId, peerId, cfg, log });
+              log?.info(`[qqbot:${account.accountId}] Quote detected via msg_elements[0] (cache miss): id=${replyToId}, sender=${replyToSender ?? "unknown"}, content="${(replyToBody ?? "").slice(0, 80)}..."`);
+            } else {
+              // 引用消息但 msg_elements 为空：AI 只能知道"用户引用了一条消息"
+              log?.info(`[qqbot:${account.accountId}] Quote detected (MSG_TYPE_QUOTE) but no msg_elements: refMsgIdx=${event.refMsgIdx}`);
+            }
           } else {
-            // 缓存未命中且无 messageReference：AI 只能知道"用户引用了一条消息"
-            log?.info(`[qqbot:${account.accountId}] Quote detected but no cache and no messageReference: refMsgIdx=${event.refMsgIdx}`);
+            // 缓存未命中且非引用消息类型：AI 只能知道"用户引用了一条消息"
+            log?.info(`[qqbot:${account.accountId}] Quote detected but no cache and msgType=${event.msgType} (not quote): refMsgIdx=${event.refMsgIdx}`);
           }
         }
 
@@ -1945,7 +1955,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   accountId: account.accountId,
                 });
                 // 解析引用索引
-                const c2cRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                const c2cRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                 // 斜杠指令拦截 → 不匹配则入队
                 trySlashCommandOrEnqueue({
                   type: "c2c",
@@ -1956,7 +1966,8 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   attachments: event.attachments,
                   refMsgIdx: c2cRefs.refMsgIdx,
                   msgIdx: c2cRefs.msgIdx,
-                  messageReference: event.message_reference,
+                  msgElements: event.msg_elements,
+                  msgType: event.message_type,
                 });
               } else if (t === "AT_MESSAGE_CREATE") {
                 const event = d as GuildMessageEvent;
@@ -1967,7 +1978,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   nickname: event.author.username,
                   accountId: account.accountId,
                 });
-                const guildRefs = parseRefIndices((event as any).message_scene?.ext, (event as any).message_reference);
+                const guildRefs = parseRefIndices((event as any).message_scene?.ext, (event as any).message_type, (event as any).msg_elements);
                 trySlashCommandOrEnqueue({
                   type: "guild",
                   senderId: event.author.id,
@@ -1980,6 +1991,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   attachments: event.attachments,
                   refMsgIdx: guildRefs.refMsgIdx,
                   msgIdx: guildRefs.msgIdx,
+                  msgType: (event as any).message_type,
                 });
               } else if (t === "DIRECT_MESSAGE_CREATE") {
                 const event = d as GuildMessageEvent;
@@ -1990,7 +2002,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   nickname: event.author.username,
                   accountId: account.accountId,
                 });
-                const dmRefs = parseRefIndices((event as any).message_scene?.ext, (event as any).message_reference);
+                const dmRefs = parseRefIndices((event as any).message_scene?.ext, (event as any).message_type, (event as any).msg_elements);
                 trySlashCommandOrEnqueue({
                   type: "dm",
                   senderId: event.author.id,
@@ -2002,6 +2014,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   attachments: event.attachments,
                   refMsgIdx: dmRefs.refMsgIdx,
                   msgIdx: dmRefs.msgIdx,
+                  msgType: (event as any).message_type,
                 });
               } else if (t === "GROUP_AT_MESSAGE_CREATE") {
                 const event = d as GroupMessageEvent;
@@ -2013,7 +2026,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   groupOpenid: event.group_openid,
                   accountId: account.accountId,
                 });
-                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                 trySlashCommandOrEnqueue({
                   type: "group",
                   senderId: event.author.member_openid,
@@ -2028,7 +2041,8 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   eventType: "GROUP_AT_MESSAGE_CREATE",
                   mentions: event.mentions,
                   messageScene: event.message_scene,
-                  messageReference: event.message_reference,
+                  msgElements: event.msg_elements,
+                  msgType: event.message_type,
                 });
               } else if (t === "GROUP_MESSAGE_CREATE") {
                 const event = d as GroupMessageEvent;
@@ -2039,7 +2053,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   groupOpenid: event.group_openid,
                   accountId: account.accountId,
                 });
-                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_reference);
+                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
                 trySlashCommandOrEnqueue({
                   type: "group",
                   senderId: event.author.member_openid,
@@ -2055,7 +2069,8 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                   eventType: "GROUP_MESSAGE_CREATE",
                   mentions: event.mentions,
                   messageScene: event.message_scene,
-                  messageReference: event.message_reference,
+                  msgElements: event.msg_elements,
+                  msgType: event.message_type,
                 });
               } else if (t === "GROUP_ADD_ROBOT") {
                 const event = d as { timestamp: string; group_openid: string; op_member_openid: string };

package/src/message-queue.ts

@@ -1,5 +1,5 @@
 import type { QueueSnapshot } from "./slash-commands.js";
-import type { MessageReference } from "./types.js";
+import type { MsgElement } from "./types.js";
 
 // ── 消息队列默认配置 ──
 const DEFAULT_GLOBAL_QUEUE_SIZE = 1000;
@@ -33,8 +33,10 @@ export interface QueuedMessage {
   mentions?: Array<{ scope?: "all" | "single"; id?: string; user_openid?: string; member_openid?: string; username?: string; bot?: boolean; is_you?: boolean }>;
   /** 消息场景（来源、扩展字段） */
   messageScene?: { source?: string; ext?: string[] };
-  /** 消息引用结构（QQ 推送事件中携带的被引用原始消息） */
-  messageReference?: MessageReference;
+  /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+  msgElements?: MsgElement[];
+  /** 消息类型，参见 MSG_TYPE_* */
+  msgType?: number;
   /** 群消息合并标记：记录合并了多少条原始消息 */
   _mergedCount?: number;
   /** 合并前的原始消息列表（用于 gateway 侧逐条格式化信封） */

package/src/slash-commands.ts

@@ -1987,7 +1987,23 @@ registerCommand({
           : `AI 的回复将恢复为完整发送。`,
       ].join("\n");
     } catch (err) {
-      return `❌ 更新配置失败：${err}`;
+      const fwVer = getFrameworkVersion();
+      return [
+        `❌ 当前版本不支持该指令`,
+        ``,
+        `🦞框架版本：${fwVer}`,
+        `🤖QQBot 插件版本：v${PLUGIN_VERSION}`,
+        ``,
+        `可通过以下命令手动开启流式消息：`,
+        ``,
+        `\`\`\`shell`,
+        `# 1. 开启流式消息`,
+        `openclaw config set channels.qqbot.streaming true`,
+        ``,
+        `# 2. 重启网关使配置生效`,
+        `openclaw gateway restart`,
+        `\`\`\``,
+      ].join("\n");
     }
   },
 });

package/src/types.ts

@@ -1,3 +1,9 @@
+// ── QQ 消息类型常量（message_type 枚举值） ──
+/** 普通文本消息 */
+export const MSG_TYPE_TEXT = 0;
+/** 引用（回复）消息 */
+export const MSG_TYPE_QUOTE = 103;
+
 /**
  * QQ Bot 配置类型
  */
@@ -207,8 +213,10 @@ export interface C2CMessageEvent {
     ext?: string[];
   };
   attachments?: MessageAttachment[];
-  /** 消息引用，当用户引用某条消息时存在 */
-  message_reference?: MessageReference;
+  /** 消息类型，参见 MSG_TYPE_* */
+  message_type?: number;
+  /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+  msg_elements?: MsgElement[];
 }
 
 /**
@@ -232,16 +240,18 @@ export interface GuildMessageEvent {
   attachments?: MessageAttachment[];
 }
 
-/**
- * 消息引用（被回复的原始消息）
- */
-export interface MessageReference {
-  /** 被引用消息的文本内容 */
-  content: string;
-  /** 被引用消息的附件列表 */
-  attachments?: MessageAttachment[];
-  /** 被引用消息的索引标识 */
+/** 消息元素结点，引用消息时 msg_elements[0] 为被引用的原始消息 */
+export interface MsgElement {
+  /** 消息索引标识 */
   msg_idx?: string;
+  /** 消息类型，参见 MSG_TYPE_* 常量 */
+  message_type?: number;
+  /** 文本内容 */
+  content?: string;
+  /** 附件列表 */
+  attachments?: MessageAttachment[];
+  /** 嵌套消息元素（引用消息场景下可能存在） */
+  msg_elements?: MsgElement[];
 }
 
 /**
@@ -275,8 +285,10 @@ export interface GroupMessageEvent {
     /** 是否 @机器人自身 */
     is_you?: boolean;
   }>;
-  /** 消息引用，当用户引用某条消息时存在 */
-  message_reference?: MessageReference;
+  /** 消息类型，参见 MSG_TYPE_* */
+  message_type?: number;
+  /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+  msg_elements?: MsgElement[];
 }
 
 /**

package/src/utils/text-parsing.ts

@@ -4,6 +4,7 @@
 
 import type { RefAttachmentSummary } from "../ref-index-store.js";
 import { inferAttachmentType } from "../group-history.js";
+import { MSG_TYPE_QUOTE } from "../types.js";
 
 /**
  * 解析 QQ 表情标签，将 <faceType=1,faceId="13",ext="base64..."> 格式
@@ -40,15 +41,11 @@ export function filterInternalMarkers(text: string): string {
   return result;
 }
 
-/**
- * 从 message_scene.ext 和 message_reference 中解析引用索引。
- *
- * @param ext     message_scene.ext 数组，格式示例: ["", "ref_msg_idx=REFIDX_xxx", "msg_idx=REFIDX_yyy"]
- * @param msgRef  message_reference 对象，其 msg_idx 比 ext 中解析的更权威，有值时优先使用
- */
+/** 从 ext 和 msg_elements 中解析引用索引，仅 MSG_TYPE_QUOTE 时取 msg_elements */
 export function parseRefIndices(
   ext?: string[],
-  msgRef?: { msg_idx?: string },
+  messageType?: number,
+  msgElements?: Array<{ msg_idx?: string }>,
 ): { refMsgIdx?: string; msgIdx?: string } {
   let refMsgIdx: string | undefined;
   let msgIdx: string | undefined;
@@ -61,9 +58,12 @@ export function parseRefIndices(
       }
     }
   }
-  // messageReference.msg_idx 更权威，有值时覆盖 ext 解析结果
-  if (msgRef?.msg_idx) {
-    refMsgIdx = msgRef.msg_idx;
+  // 仅当 message_type=MSG_TYPE_QUOTE（引用消息）时，msg_elements[0].msg_idx 更权威，有值时覆盖 ext 解析结果
+  if (messageType === MSG_TYPE_QUOTE) {
+    const refElement = msgElements?.[0];
+    if (refElement?.msg_idx) {
+      refMsgIdx = refElement.msg_idx;
+    }
   }
   return { refMsgIdx, msgIdx };
 }