@openclaw-china/qqbot 2026.3.11 → 2026.3.12

package/dist/index.js

@@ -3,7 +3,7 @@ import { homedir, tmpdir } from 'os';
 import * as path2 from 'path';
 import { join, dirname } from 'path';
 import * as fs3 from 'fs';
-import { existsSync, readFileSync, rmSync, writeFileSync, mkdirSync } from 'fs';
+import { existsSync, readFileSync, rmSync, writeFileSync, renameSync, copyFileSync, mkdirSync, appendFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import * as fsPromises from 'fs/promises';
 import { createHmac } from 'crypto';
@@ -651,8 +651,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path4, errorMaps, issueData } = params;
-  const fullPath = [...path4, ...issueData.path || []];
+  const { data, path: path5, errorMaps, issueData } = params;
+  const fullPath = [...path5, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -768,11 +768,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path4, key) {
+  constructor(parent, value, path5, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path4;
+    this._path = path5;
     this._key = key;
   }
   get path() {
@@ -4876,7 +4876,7 @@ function extractMediaFromText(text, options = {}) {
   const {
     removeFromText = true,
     checkExists = false,
-    existsSync: existsSync6,
+    existsSync: existsSync7,
     parseMediaLines = false,
     parseMarkdownImages = true,
     parseHtmlImages = true,
@@ -4891,7 +4891,7 @@ function extractMediaFromText(text, options = {}) {
     const key = media.localPath || media.source;
     if (seenSources.has(key)) return false;
     if (checkExists && media.isLocal && media.localPath) {
-      const exists = existsSync6 ? existsSync6(media.localPath) : fs3.existsSync(media.localPath);
+      const exists = existsSync7 ? existsSync7(media.localPath) : fs3.existsSync(media.localPath);
       if (!exists) return false;
     }
     seenSources.add(key);
@@ -7380,8 +7380,8 @@ async function getAccessToken(appId, clientSecret, options) {
   tokenPromiseMap.set(normalizedAppId, promise);
   return promise;
 }
-async function apiGet(accessToken, path4, options) {
-  const url = `${API_BASE}${path4}`;
+async function apiGet(accessToken, path5, options) {
+  const url = `${API_BASE}${path5}`;
   return httpGet(url, {
     ...options,
     headers: {
@@ -7390,8 +7390,8 @@ async function apiGet(accessToken, path4, options) {
     }
   });
 }
-async function apiPost(accessToken, path4, body, options) {
-  const url = `${API_BASE}${path4}`;
+async function apiPost(accessToken, path5, body, options) {
+  const url = `${API_BASE}${path5}`;
   return httpPost(url, body, {
     ...options,
     headers: {
@@ -7490,7 +7490,7 @@ async function sendChannelMessage(params) {
   });
 }
 async function sendC2CInputNotify(params) {
-  await postPassiveMessage({
+  const response = await postPassiveMessage({
     accessToken: params.accessToken,
     path: `/v2/users/${params.openid}/messages`,
     sequenceKey: resolveMsgSeqKey(params.messageId, params.eventId),
@@ -7505,6 +7505,8 @@ async function sendC2CInputNotify(params) {
       ...params.messageId ? { msg_id: params.messageId } : params.eventId ? { event_id: params.eventId } : {}
     })
   });
+  const refIdx = response.ext_info?.ref_idx?.trim();
+  return refIdx ? { refIdx } : {};
 }
 async function uploadC2CMedia(params) {
   const body = {
@@ -7574,6 +7576,233 @@ async function sendGroupMediaMessage(params) {
     })
   });
 }
+var REF_INDEX_FILE = join(homedir(), ".openclaw", "qqbot", "data", "ref-index.jsonl");
+var MAX_CONTENT_LENGTH = 500;
+var MAX_ENTRIES = 5e4;
+var TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+var COMPACT_THRESHOLD_RATIO = 2;
+var cache = null;
+var totalLinesOnDisk = 0;
+function normalizeRefIdx(refIdx) {
+  const next = refIdx.trim();
+  return next ? next : void 0;
+}
+function ensureStorageDir() {
+  mkdirSync(dirname(REF_INDEX_FILE), { recursive: true });
+}
+function truncateContent(content) {
+  return content.trim().slice(0, MAX_CONTENT_LENGTH);
+}
+function sanitizeAttachmentSummary(attachment) {
+  const type = attachment.type;
+  const filename = attachment.filename?.trim();
+  const contentType = attachment.contentType?.trim();
+  const localPath = attachment.localPath?.trim();
+  const url = attachment.url?.trim();
+  const transcript = attachment.transcript?.trim();
+  if (!filename && !contentType && !localPath && !url && !transcript && type === "unknown") {
+    return void 0;
+  }
+  return {
+    type,
+    ...filename ? { filename } : {},
+    ...contentType ? { contentType } : {},
+    ...localPath ? { localPath } : {},
+    ...url ? { url } : {},
+    ...transcript ? { transcript } : {},
+    ...transcript && attachment.transcriptSource ? { transcriptSource: attachment.transcriptSource } : {}
+  };
+}
+function sanitizeEntry(entry) {
+  const senderId = entry.senderId.trim() || "unknown";
+  const senderName = entry.senderName?.trim();
+  const timestamp = Number.isFinite(entry.timestamp) ? Math.trunc(entry.timestamp) : Date.now();
+  const attachments = entry.attachments?.map((attachment) => sanitizeAttachmentSummary(attachment)).filter((attachment) => Boolean(attachment));
+  return {
+    content: truncateContent(entry.content),
+    senderId,
+    ...senderName ? { senderName } : {},
+    timestamp,
+    ...entry.isBot ? { isBot: true } : {},
+    ...attachments && attachments.length > 0 ? { attachments } : {}
+  };
+}
+function shouldCompact() {
+  if (!cache) return false;
+  return totalLinesOnDisk > cache.size * COMPACT_THRESHOLD_RATIO && totalLinesOnDisk > 1e3;
+}
+function compactFile() {
+  if (!cache) return;
+  try {
+    ensureStorageDir();
+    const tempPath = `${REF_INDEX_FILE}.tmp`;
+    const lines = [];
+    for (const [key, entry] of cache.entries()) {
+      lines.push(
+        JSON.stringify({
+          k: key,
+          v: sanitizeEntry(entry),
+          t: entry._createdAt
+        })
+      );
+    }
+    writeFileSync(tempPath, lines.length > 0 ? `${lines.join("\n")}
+` : "", "utf8");
+    renameSync(tempPath, REF_INDEX_FILE);
+    totalLinesOnDisk = cache.size;
+  } catch {
+  }
+}
+function evictIfNeeded() {
+  if (!cache || cache.size < MAX_ENTRIES) return;
+  const now = Date.now();
+  for (const [key, entry] of cache.entries()) {
+    if (now - entry._createdAt > TTL_MS) {
+      cache.delete(key);
+    }
+  }
+  if (cache.size < MAX_ENTRIES) {
+    return;
+  }
+  const sorted = [...cache.entries()].sort((left, right) => left[1]._createdAt - right[1]._createdAt);
+  const removeCount = cache.size - MAX_ENTRIES + 1;
+  for (let index = 0; index < removeCount; index += 1) {
+    const key = sorted[index]?.[0];
+    if (key) {
+      cache.delete(key);
+    }
+  }
+}
+function loadCache() {
+  if (cache) {
+    return cache;
+  }
+  cache = /* @__PURE__ */ new Map();
+  totalLinesOnDisk = 0;
+  try {
+    if (!existsSync(REF_INDEX_FILE)) {
+      return cache;
+    }
+    const now = Date.now();
+    const raw = readFileSync(REF_INDEX_FILE, "utf8");
+    const lines = raw.split(/\r?\n/);
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      totalLinesOnDisk += 1;
+      try {
+        const parsed = JSON.parse(trimmed);
+        const key = typeof parsed.k === "string" ? normalizeRefIdx(parsed.k) : void 0;
+        const createdAt = typeof parsed.t === "number" && Number.isFinite(parsed.t) ? parsed.t : void 0;
+        if (!key || createdAt === void 0 || !parsed.v || typeof parsed.v !== "object") {
+          continue;
+        }
+        if (now - createdAt > TTL_MS) {
+          continue;
+        }
+        const entry = sanitizeEntry(parsed.v);
+        cache.set(key, {
+          ...entry,
+          _createdAt: createdAt
+        });
+      } catch {
+      }
+    }
+    if (shouldCompact()) {
+      compactFile();
+    }
+  } catch {
+    cache = /* @__PURE__ */ new Map();
+    totalLinesOnDisk = 0;
+  }
+  return cache;
+}
+function appendLine(line) {
+  try {
+    ensureStorageDir();
+    appendFileSync(REF_INDEX_FILE, `${JSON.stringify(line)}
+`, "utf8");
+    totalLinesOnDisk += 1;
+  } catch {
+  }
+}
+function restoreEntry(entry) {
+  const sanitized = sanitizeEntry(entry);
+  return {
+    content: sanitized.content,
+    senderId: sanitized.senderId,
+    ...sanitized.senderName ? { senderName: sanitized.senderName } : {},
+    timestamp: sanitized.timestamp,
+    ...sanitized.isBot ? { isBot: true } : {},
+    ...sanitized.attachments ? { attachments: sanitized.attachments } : {}
+  };
+}
+function formatAttachmentSummary(attachment) {
+  const sourceParts = [
+    attachment.localPath?.trim() ? `\u672C\u5730: ${attachment.localPath.trim()}` : void 0,
+    attachment.url?.trim() ? `\u94FE\u63A5: ${attachment.url.trim()}` : void 0
+  ].filter((value) => Boolean(value));
+  const sourceSuffix = sourceParts.length > 0 ? ` (${sourceParts.join(" | ")})` : "";
+  if (attachment.type === "image") {
+    return `[\u56FE\u7247${attachment.filename?.trim() ? `: ${attachment.filename.trim()}` : ""}]${sourceSuffix}`;
+  }
+  if (attachment.type === "voice") {
+    if (attachment.transcript?.trim()) {
+      const sourceLabel = attachment.transcriptSource === "asr" ? "\u5B98\u65B9\u8BC6\u522B" : attachment.transcriptSource === "stt" ? "\u672C\u5730\u8BC6\u522B" : attachment.transcriptSource === "tts" ? "TTS \u539F\u6587" : attachment.transcriptSource === "fallback" ? "\u515C\u5E95\u6587\u672C" : void 0;
+      return `[\u8BED\u97F3\u6D88\u606F: ${attachment.transcript.trim()}${sourceLabel ? ` (${sourceLabel})` : ""}]${sourceSuffix}`;
+    }
+    return `[\u8BED\u97F3\u6D88\u606F]${sourceSuffix}`;
+  }
+  if (attachment.type === "video") {
+    return `[\u89C6\u9891${attachment.filename?.trim() ? `: ${attachment.filename.trim()}` : ""}]${sourceSuffix}`;
+  }
+  if (attachment.type === "file") {
+    return `[\u6587\u4EF6${attachment.filename?.trim() ? `: ${attachment.filename.trim()}` : ""}]${sourceSuffix}`;
+  }
+  return `[\u9644\u4EF6${attachment.filename?.trim() ? `: ${attachment.filename.trim()}` : ""}]${sourceSuffix}`;
+}
+function setRefIndex(refIdx, entry) {
+  const key = normalizeRefIdx(refIdx);
+  if (!key) return;
+  const store = loadCache();
+  evictIfNeeded();
+  const nextEntry = sanitizeEntry(entry);
+  const createdAt = Date.now();
+  store.set(key, {
+    ...nextEntry,
+    _createdAt: createdAt
+  });
+  appendLine({
+    k: key,
+    v: nextEntry,
+    t: createdAt
+  });
+  if (shouldCompact()) {
+    compactFile();
+  }
+}
+function getRefIndex(refIdx) {
+  const key = normalizeRefIdx(refIdx);
+  if (!key) return null;
+  const store = loadCache();
+  const entry = store.get(key);
+  if (!entry) {
+    return null;
+  }
+  if (Date.now() - entry._createdAt > TTL_MS) {
+    store.delete(key);
+    return null;
+  }
+  return restoreEntry(entry);
+}
+function formatRefEntryForAgent(entry) {
+  const content = entry.content.trim();
+  const parts = content ? [content] : [];
+  for (const attachment of entry.attachments ?? []) {
+    parts.push(formatAttachmentSummary(attachment));
+  }
+  return parts.join("\n") || "[\u7A7A\u6D88\u606F]";
+}
 var require2 = createRequire(import.meta.url);
 function resolveQQBotMediaFileType(fileName) {
   const mediaType = detectMediaType(fileName);
@@ -7729,7 +7958,7 @@ async function sendFileQQBot(params) {
     }
   }
   try {
-    return await sendC2CMediaMessage({
+    const result = await sendC2CMediaMessage({
       accessToken,
       openid: target.id,
       fileInfo,
@@ -7737,6 +7966,12 @@ async function sendFileQQBot(params) {
       ...messageId ? { messageId } : {},
       ...eventId ? { eventId } : {}
     });
+    const refIdx = result.ext_info?.ref_idx?.trim();
+    return {
+      id: result.id,
+      timestamp: result.timestamp,
+      ...refIdx ? { refIdx } : {}
+    };
   } catch (err) {
     const message = formatQQBotError(err);
     throw new Error(`QQBot C2C media send failed: ${message}`);
@@ -7853,6 +8088,85 @@ function shouldRetryWithEventId(err) {
 function shouldSendTextAsFollowupForMedia(mediaUrl) {
   return detectMediaType(stripTitleFromUrl(mediaUrl)) === "file";
 }
+function isHttpUrl2(value) {
+  return /^https?:\/\//i.test(value);
+}
+function resolveResponseRefIdx(response) {
+  if (!response || typeof response !== "object") {
+    return void 0;
+  }
+  const direct = response.refIdx;
+  if (typeof direct === "string" && direct.trim()) {
+    return direct.trim();
+  }
+  const extInfo = response.ext_info;
+  if (typeof extInfo?.ref_idx === "string" && extInfo.ref_idx.trim()) {
+    return extInfo.ref_idx.trim();
+  }
+  return void 0;
+}
+function resolveOutboundAttachmentType(mediaUrl) {
+  const detected = detectMediaType(stripTitleFromUrl(mediaUrl));
+  if (detected === "image") return "image";
+  if (detected === "video") return "video";
+  if (detected === "audio") return "voice";
+  if (detected === "file") return "file";
+  return "unknown";
+}
+function resolveOutboundAttachmentFileName(mediaUrl) {
+  const source = stripTitleFromUrl(mediaUrl).trim();
+  if (!source) return void 0;
+  if (isHttpUrl2(source)) {
+    try {
+      const base2 = path2.posix.basename(new URL(source).pathname);
+      return base2 && base2 !== "/" ? base2 : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  const base = path2.basename(source);
+  return base || void 0;
+}
+function buildOutboundAttachmentSummary(params) {
+  const source = stripTitleFromUrl(params.mediaUrl).trim();
+  const type = resolveOutboundAttachmentType(source);
+  const filename = resolveOutboundAttachmentFileName(source);
+  const text = params.text?.trim();
+  return {
+    type,
+    ...filename ? { filename } : {},
+    ...isHttpUrl2(source) ? { url: source } : { localPath: source },
+    ...type === "voice" && text ? {
+      transcript: text,
+      transcriptSource: "tts"
+    } : {}
+  };
+}
+function recordOutboundC2CRefIndex(params) {
+  const refIdx = params.refIdx?.trim();
+  if (!refIdx) return;
+  const text = params.text?.trim() ?? "";
+  const attachments = params.mediaUrl?.trim() ? [buildOutboundAttachmentSummary({ mediaUrl: params.mediaUrl, text })] : void 0;
+  if (!text && !attachments) {
+    return;
+  }
+  try {
+    const accountLabel = params.accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    setRefIndex(refIdx, {
+      content: text,
+      senderId: accountLabel,
+      senderName: accountLabel,
+      timestamp: Date.now(),
+      isBot: true,
+      ...attachments ? { attachments } : {}
+    });
+    console.info(
+      `[qqbot] cached outbound ref_idx=${refIdx} accountId=${accountLabel} textLen=${text.length} media=${params.mediaUrl?.trim() ? "yes" : "no"}`
+    );
+  } catch (err) {
+    console.warn(`[qqbot] failed to cache outbound ref_idx=${refIdx}: ${String(err)}`);
+  }
+}
 function buildPassiveReplyRefs(params) {
   if (params.replyToId) {
     return { messageId: params.replyToId };
@@ -7998,7 +8312,14 @@ var qqbotOutbound = {
           content: text,
           markdown
         });
-        return { channel: "qqbot", messageId: result2.id, timestamp: result2.timestamp };
+        const refIdx2 = resolveResponseRefIdx(result2);
+        recordOutboundC2CRefIndex({ refIdx: refIdx2, accountId, text });
+        return {
+          channel: "qqbot",
+          messageId: result2.id,
+          timestamp: result2.timestamp,
+          ...refIdx2 ? { refIdx: refIdx2 } : {}
+        };
       }
       let result;
       try {
@@ -8065,7 +8386,14 @@ var qqbotOutbound = {
           throw retryErr;
         }
       }
-      return { channel: "qqbot", messageId: result.id, timestamp: result.timestamp };
+      const refIdx = resolveResponseRefIdx(result);
+      recordOutboundC2CRefIndex({ refIdx, accountId, text });
+      return {
+        channel: "qqbot",
+        messageId: result.id,
+        timestamp: result.timestamp,
+        ...refIdx ? { refIdx } : {}
+      };
     } catch (err) {
       const message = summarizeError(err);
       return { channel: "qqbot", error: message };
@@ -8174,7 +8502,21 @@ ${mediaUrl}` : mediaUrl;
           };
         }
       }
-      return { channel: "qqbot", messageId: result.id, timestamp: result.timestamp };
+      const refIdx = target.kind === "c2c" ? resolveResponseRefIdx(result) : void 0;
+      if (target.kind === "c2c") {
+        recordOutboundC2CRefIndex({
+          refIdx,
+          accountId,
+          text: sendTextAsFollowup ? void 0 : trimmedText,
+          mediaUrl
+        });
+      }
+      return {
+        channel: "qqbot",
+        messageId: result.id,
+        timestamp: result.timestamp,
+        ...refIdx ? { refIdx } : {}
+      };
     } catch (err) {
       const message = summarizeError(err);
       return { channel: "qqbot", error: message };
@@ -8193,8 +8535,9 @@ ${mediaUrl}` : mediaUrl;
     }
     try {
       const accessToken = await getAccessToken(credentials.appId, credentials.clientSecret);
+      let typingResult;
       try {
-        await sendC2CInputNotify({
+        typingResult = await sendC2CInputNotify({
           accessToken,
           openid: target.id,
           messageId: replyToId,
@@ -8216,7 +8559,7 @@ ${mediaUrl}` : mediaUrl;
           reason: summarizeError(err)
         });
         try {
-          await sendC2CInputNotify({
+          typingResult = await sendC2CInputNotify({
             accessToken,
             openid: target.id,
             eventId: replyEventId,
@@ -8245,7 +8588,10 @@ ${mediaUrl}` : mediaUrl;
           throw retryErr;
         }
       }
-      return { channel: "qqbot" };
+      return {
+        channel: "qqbot",
+        ...typingResult?.refIdx ? { refIdx: typingResult.refIdx } : {}
+      };
     } catch (err) {
       const message = summarizeError(err);
       return { channel: "qqbot", error: message };
@@ -8394,13 +8740,13 @@ async function replaceAsync(input2, pattern, replacer) {
   return result;
 }
 async function getResolvedImageSize(params) {
-  const { url, cache, resolveImageSize } = params;
-  const existing = cache.get(url);
+  const { url, cache: cache2, resolveImageSize } = params;
+  const existing = cache2.get(url);
   if (existing) {
     return existing;
   }
   const pending = resolveImageSize(url).then((size) => normalizeImageSize(size) ?? DEFAULT_QQBOT_MARKDOWN_IMAGE_SIZE).catch(() => DEFAULT_QQBOT_MARKDOWN_IMAGE_SIZE);
-  cache.set(url, pending);
+  cache2.set(url, pending);
   return pending;
 }
 async function normalizeTextSegment(params) {
@@ -8527,13 +8873,29 @@ async function normalizeQQBotMarkdownImages(params) {
 
 ${appendedImages.join("\n")}`;
 }
-var DEFAULT_KNOWN_TARGETS_PATH = join(homedir(), ".openclaw", "data", "qqbot", "known-targets.json");
+var DEFAULT_KNOWN_TARGETS_PATH = join(homedir(), ".openclaw", "qqbot", "data", "known-targets.json");
+var LEGACY_KNOWN_TARGETS_PATH = join(homedir(), ".openclaw", "data", "qqbot", "known-targets.json");
 function resolveKnownTargetsFilePath(options) {
   return options?.filePath?.trim() || DEFAULT_KNOWN_TARGETS_PATH;
 }
 function ensureKnownTargetsDir(filePath) {
   mkdirSync(dirname(filePath), { recursive: true });
 }
+function migrateLegacyKnownTargets(filePath) {
+  if (filePath !== DEFAULT_KNOWN_TARGETS_PATH) {
+    return;
+  }
+  if (existsSync(filePath) || !existsSync(LEGACY_KNOWN_TARGETS_PATH)) {
+    return;
+  }
+  ensureKnownTargetsDir(filePath);
+  try {
+    renameSync(LEGACY_KNOWN_TARGETS_PATH, filePath);
+  } catch {
+    copyFileSync(LEGACY_KNOWN_TARGETS_PATH, filePath);
+    rmSync(LEGACY_KNOWN_TARGETS_PATH, { force: true });
+  }
+}
 function compareTargetsByLastSeenDesc(a, b) {
   if (b.lastSeenAt !== a.lastSeenAt) {
     return b.lastSeenAt - a.lastSeenAt;
@@ -8569,6 +8931,7 @@ function parseKnownTargets(raw, filePath) {
 }
 function readKnownTargets(options) {
   const filePath = resolveKnownTargetsFilePath(options);
+  migrateLegacyKnownTargets(filePath);
   if (!existsSync(filePath)) {
     return [];
   }
@@ -8580,6 +8943,7 @@ function readKnownTargets(options) {
 }
 function writeKnownTargets(targets, options) {
   const filePath = resolveKnownTargetsFilePath(options);
+  migrateLegacyKnownTargets(filePath);
   if (targets.length === 0) {
     if (existsSync(filePath)) {
       rmSync(filePath, { force: true });
@@ -8713,9 +9077,50 @@ function getQQBotRuntime() {
   return runtime;
 }
 var sessionDispatchQueue = /* @__PURE__ */ new Map();
+function resolveQQBotRouteSessionKey(route) {
+  const effectiveSessionKey = route.effectiveSessionKey?.trim();
+  if (effectiveSessionKey) {
+    return effectiveSessionKey;
+  }
+  return route.sessionKey;
+}
 function buildSessionDispatchQueueKey(route) {
   const accountId = route.accountId?.trim() || DEFAULT_ACCOUNT_ID;
-  return `${accountId}:${route.sessionKey}`;
+  return `${accountId}:${resolveQQBotRouteSessionKey(route)}`;
+}
+function normalizeQQBotSessionKeyPart(value) {
+  const trimmed = value.trim();
+  return trimmed ? trimmed.toLowerCase() : "unknown";
+}
+function buildQQBotDirectSessionKey(params) {
+  const normalizedAccountId = normalizeQQBotSessionKeyPart(params.accountId);
+  const normalizedSenderId = normalizeQQBotSessionKeyPart(params.senderStableId);
+  const trimmedRouteSessionKey = params.routeSessionKey.trim();
+  if (!trimmedRouteSessionKey) {
+    return `agent:main:qqbot:dm:${normalizedAccountId}:${normalizedSenderId}`;
+  }
+  const qqAgentRouteMatch = trimmedRouteSessionKey.match(/^(agent:[^:]+:qqbot:)(?:direct|dm):.+$/i);
+  if (qqAgentRouteMatch?.[1]) {
+    return `${qqAgentRouteMatch[1]}dm:${normalizedAccountId}:${normalizedSenderId}`;
+  }
+  return `${trimmedRouteSessionKey}:dm:${normalizedAccountId}:${normalizedSenderId}`;
+}
+function normalizeQQBotReplyTarget(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  let trimmed = value.trim();
+  if (!trimmed) {
+    return void 0;
+  }
+  if (/^qqbot:/i.test(trimmed)) {
+    trimmed = trimmed.slice("qqbot:".length).trim();
+  }
+  if (/^c2c:/i.test(trimmed)) {
+    const openid = trimmed.slice("c2c:".length).trim();
+    return openid ? `user:${openid}` : void 0;
+  }
+  return /^(user|group|channel):/i.test(trimmed) ? trimmed : void 0;
 }
 async function runSerializedSessionDispatch(queueKey, task) {
   const previous = sessionDispatchQueue.get(queueKey) ?? Promise.resolve();
@@ -8780,6 +9185,33 @@ function parseTextWithAttachments(payload) {
     attachments
   };
 }
+function parseQQBotRefIndices(payload) {
+  const scene = payload.message_scene;
+  if (!scene || typeof scene !== "object") {
+    return {};
+  }
+  const ext = scene.ext;
+  if (!Array.isArray(ext)) {
+    return {};
+  }
+  let refMsgIdx;
+  let msgIdx;
+  for (const value of ext) {
+    const item = toString(value);
+    if (!item) continue;
+    if (item.startsWith("ref_msg_idx=")) {
+      refMsgIdx = toString(item.slice("ref_msg_idx=".length));
+      continue;
+    }
+    if (item.startsWith("msg_idx=")) {
+      msgIdx = toString(item.slice("msg_idx=".length));
+    }
+  }
+  return {
+    ...refMsgIdx ? { refMsgIdx } : {},
+    ...msgIdx ? { msgIdx } : {}
+  };
+}
 function resolveEventId(payload, fallbackEventId) {
   return toString(payload.event_id) ?? toString(payload.eventId) ?? toString(fallbackEventId);
 }
@@ -8789,6 +9221,7 @@ var VOICE_ASR_ERROR_MAX_LENGTH = 500;
 var LONG_TASK_NOTICE_TEXT = "\u4EFB\u52A1\u5904\u7406\u65F6\u95F4\u8F83\u957F\uFF0C\u8BF7\u7A0D\u7B49\uFF0C\u6211\u8FD8\u5728\u7EE7\u7EED\u5904\u7406\u3002";
 var DEFAULT_LONG_TASK_NOTICE_DELAY_MS = 3e4;
 var QQ_GROUP_NO_REPLY_FALLBACK_TEXT = "\u6211\u5728\u3002\u4F60\u53EF\u4EE5\u76F4\u63A5\u8BF4\u5177\u4F53\u4E00\u70B9\u3002";
+var QQ_QUOTE_BODY_UNAVAILABLE_TEXT = "\u539F\u59CB\u5185\u5BB9\u4E0D\u53EF\u7528";
 function startLongTaskNoticeTimer(params) {
   const { delayMs, logger, sendNotice } = params;
   let completed = false;
@@ -8823,7 +9256,7 @@ function startLongTaskNoticeTimer(params) {
     }
   };
 }
-function isHttpUrl2(value) {
+function isHttpUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
 function isImageAttachment(att) {
@@ -8896,7 +9329,7 @@ async function resolveInboundAttachmentsForAgent(params) {
   let asrErrorMessage;
   for (const att of list) {
     const next = { attachment: att };
-    if (isImageAttachment(att) && isHttpUrl2(att.url)) {
+    if (isImageAttachment(att) && isHttpUrl3(att.url)) {
       try {
         const downloaded = await downloadToTempFile(att.url, {
           timeout,
@@ -8925,7 +9358,7 @@ async function resolveInboundAttachmentsForAgent(params) {
         logger.info("voice attachment received but ASR is disabled");
       } else if (!asrCredentials) {
         logger.warn("voice ASR enabled but credentials are missing or invalid");
-      } else if (!isHttpUrl2(att.url)) {
+      } else if (!isHttpUrl3(att.url)) {
         logger.warn("voice ASR skipped: attachment URL is not an HTTP URL");
       } else {
         try {
@@ -8996,6 +9429,74 @@ function buildInboundContentWithAttachments(params) {
   parts.push(block);
   return parts.join("\n\n");
 }
+function resolveRefAttachmentType(attachment) {
+  const contentType = attachment.contentType?.trim().toLowerCase() ?? "";
+  if (contentType.startsWith("image/") || isImageAttachment(attachment)) {
+    return "image";
+  }
+  if (contentType === "voice" || contentType.startsWith("audio/") || isVoiceAttachment(attachment)) {
+    return "voice";
+  }
+  if (contentType.startsWith("video/")) {
+    return "video";
+  }
+  const mediaType = detectMediaType(attachment.filename?.trim() || attachment.url);
+  if (mediaType === "image") return "image";
+  if (mediaType === "audio") return "voice";
+  if (mediaType === "video") return "video";
+  if (mediaType === "file") return "file";
+  return "unknown";
+}
+function buildInboundRefAttachmentSummaries(attachments) {
+  if (attachments.length === 0) {
+    return void 0;
+  }
+  return attachments.map((item) => ({
+    type: resolveRefAttachmentType(item.attachment),
+    ...item.attachment.filename?.trim() ? { filename: item.attachment.filename.trim() } : {},
+    ...item.attachment.contentType?.trim() ? { contentType: item.attachment.contentType.trim() } : {},
+    ...item.localImagePath?.trim() ? { localPath: item.localImagePath.trim() } : {},
+    ...item.attachment.url?.trim() ? { url: item.attachment.url.trim() } : {},
+    ...item.voiceTranscript?.trim() ? {
+      transcript: item.voiceTranscript.trim(),
+      transcriptSource: "asr"
+    } : {}
+  }));
+}
+function buildQuotedAgentBody(params) {
+  const quoteBlock = `[\u5F15\u7528\u6D88\u606F\u5F00\u59CB]
+${params.replyToBody}
+[\u5F15\u7528\u6D88\u606F\u7ED3\u675F]`;
+  return params.baseBody ? `${quoteBlock}
+
+${params.baseBody}` : quoteBlock;
+}
+function resolveAgentBodyBase(ctx) {
+  if (typeof ctx.BodyForAgent === "string" && ctx.BodyForAgent.trim()) {
+    return ctx.BodyForAgent;
+  }
+  if (typeof ctx.RawBody === "string" && ctx.RawBody.trim()) {
+    return ctx.RawBody;
+  }
+  if (typeof ctx.Body === "string" && ctx.Body.trim()) {
+    return ctx.Body;
+  }
+  if (typeof ctx.CommandBody === "string" && ctx.CommandBody.trim()) {
+    return ctx.CommandBody;
+  }
+  return "";
+}
+function uniqueRefIndexKeys(...values) {
+  const keys = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    const next = value?.trim();
+    if (!next || seen.has(next)) continue;
+    seen.add(next);
+    keys.push(next);
+  }
+  return keys;
+}
 function resolveInboundLogContent(params) {
   const text = params.content.trim();
   if (text) return text;
@@ -9017,6 +9518,7 @@ function sanitizeInboundLogText(text) {
 function parseC2CMessage(data, fallbackEventId) {
   const payload = data;
   const { text, attachments } = parseTextWithAttachments(payload);
+  const refIndices = parseQQBotRefIndices(payload);
   const id = toString(payload.id);
   const eventId = resolveEventId(payload, fallbackEventId);
   const timestamp = toNumber2(payload.timestamp) ?? Date.now();
@@ -9033,6 +9535,7 @@ function parseC2CMessage(data, fallbackEventId) {
     messageId: id,
     eventId,
     timestamp,
+    ...refIndices,
     mentionedBot: false
   };
 }
@@ -9146,6 +9649,22 @@ function resolveChatTarget(event) {
     peerKind: "dm"
   };
 }
+function resolveQQBotEffectiveSessionKey(params) {
+  const { inbound, route, accountId } = params;
+  if (inbound.type !== "direct") {
+    return route.sessionKey;
+  }
+  const senderStableId = inbound.c2cOpenid?.trim() || inbound.senderId?.trim();
+  if (!senderStableId) {
+    return route.sessionKey;
+  }
+  const resolvedAccountId = route.accountId?.trim() || accountId.trim() || DEFAULT_ACCOUNT_ID;
+  return buildQQBotDirectSessionKey({
+    routeSessionKey: route.sessionKey,
+    accountId: resolvedAccountId,
+    senderStableId
+  });
+}
 function resolveEnvelopeFrom(event) {
   if (event.type === "group") {
     return `group:${(event.groupOpenid ?? "unknown").toLowerCase()}`;
@@ -9474,7 +9993,7 @@ function normalizeQQBotRenderedMarkdown(text) {
   return changed ? next.trim() : text.trim();
 }
 async function sendQQBotMediaWithFallback(params) {
-  const { qqCfg, to, mediaQueue, replyToId, replyEventId, logger, onDelivered, onError } = params;
+  const { qqCfg, to, mediaQueue, replyToId, replyEventId, accountId, logger, onDelivered, onError } = params;
   const outbound = params.outbound ?? qqbotOutbound;
   for (const mediaUrl of mediaQueue) {
     const result = await outbound.sendMedia({
@@ -9482,7 +10001,8 @@ async function sendQQBotMediaWithFallback(params) {
       to,
       mediaUrl,
       replyToId,
-      replyEventId
+      replyEventId,
+      accountId
     });
     if (result.error) {
       logger.error(`sendMedia failed: ${result.error}`);
@@ -9496,7 +10016,8 @@ async function sendQQBotMediaWithFallback(params) {
         to,
         text: fallback,
         replyToId,
-        replyEventId
+        replyEventId,
+        accountId
       });
       if (fallbackResult.error) {
         logger.error(`sendText fallback failed: ${fallbackResult.error}`);
@@ -9541,17 +10062,23 @@ function buildInboundContext(params) {
 async function dispatchToAgent(params) {
   const { inbound, cfg, qqCfg, accountId, logger, route } = params;
   const runtime2 = getQQBotRuntime();
+  const routeSessionKey = resolveQQBotRouteSessionKey(route);
   const target = resolveChatTarget(inbound);
+  const outboundAccountId = route.accountId ?? accountId;
+  let typingRefIdx;
   if (inbound.c2cOpenid) {
     const typing = await qqbotOutbound.sendTyping({
       cfg: { channels: { qqbot: qqCfg } },
       to: `user:${inbound.c2cOpenid}`,
       replyToId: inbound.messageId,
       replyEventId: inbound.eventId,
-      inputSecond: 60
+      inputSecond: 60,
+      accountId: outboundAccountId
     });
     if (typing.error) {
       logger.warn(`sendTyping failed: ${typing.error}`);
+    } else {
+      typingRefIdx = typing.refIdx;
     }
   }
   const replyApi = runtime2.channel?.reply;
@@ -9582,7 +10109,8 @@ async function dispatchToAgent(params) {
         to: target.to,
         text: LONG_TASK_NOTICE_TEXT,
         replyToId: inbound.messageId,
-        replyEventId: inbound.eventId
+        replyEventId: inbound.eventId,
+        accountId: outboundAccountId
       });
       if (result.error) {
         logger.warn(`send long-task notice failed: ${result.error}`);
@@ -9602,7 +10130,7 @@ async function dispatchToAgent(params) {
       { agentId: route.agentId }
     );
     const envelopeOptions = replyApi.resolveEnvelopeFormatOptions?.(cfg);
-    const previousTimestamp = storePath && sessionApi?.readSessionUpdatedAt ? sessionApi.readSessionUpdatedAt({ storePath, sessionKey: route.sessionKey }) : null;
+    const previousTimestamp = storePath && sessionApi?.readSessionUpdatedAt ? sessionApi.readSessionUpdatedAt({ storePath, sessionKey: routeSessionKey }) : null;
     const resolvedAttachmentResult = await resolveInboundAttachmentsForAgent({
       attachments: inbound.attachments,
       qqCfg,
@@ -9614,7 +10142,8 @@ async function dispatchToAgent(params) {
         to: target.to,
         text: buildVoiceASRFallbackReply(resolvedAttachmentResult.asrErrorMessage),
         replyToId: inbound.messageId,
-        replyEventId: inbound.eventId
+        replyEventId: inbound.eventId,
+        accountId: outboundAccountId
       });
       if (fallback.error) {
         logger.error(`sendText ASR fallback failed: ${fallback.error}`);
@@ -9629,6 +10158,39 @@ async function dispatchToAgent(params) {
     if (localImageCount > 0) {
       logger.info(`prepared ${localImageCount} local image attachment(s) for agent`);
     }
+    let replyToId;
+    let replyToBody;
+    let replyToSender;
+    let replyToIsQuote = false;
+    if (inbound.c2cOpenid && inbound.refMsgIdx) {
+      replyToId = inbound.refMsgIdx;
+      replyToIsQuote = true;
+      const refEntry = getRefIndex(inbound.refMsgIdx);
+      if (refEntry) {
+        replyToBody = formatRefEntryForAgent(refEntry);
+        replyToSender = refEntry.senderName ?? refEntry.senderId;
+        logger.info(`quote context resolved refMsgIdx=${inbound.refMsgIdx}`);
+      } else {
+        replyToBody = QQ_QUOTE_BODY_UNAVAILABLE_TEXT;
+        logger.warn(`quote context missing refMsgIdx=${inbound.refMsgIdx}`);
+      }
+    }
+    const refAttachmentSummaries = buildInboundRefAttachmentSummaries(resolvedAttachments);
+    const currentRefIndexKeys = inbound.c2cOpenid ? uniqueRefIndexKeys(inbound.msgIdx, typingRefIdx) : [];
+    if (currentRefIndexKeys.length > 0) {
+      for (const currentRefIndexKey of currentRefIndexKeys) {
+        setRefIndex(currentRefIndexKey, {
+          content: inbound.content,
+          senderId: inbound.senderId,
+          ...inbound.senderName ? { senderName: inbound.senderName } : {},
+          timestamp: inbound.timestamp,
+          ...refAttachmentSummaries ? { attachments: refAttachmentSummaries } : {}
+        });
+      }
+      logger.info(
+        `cached inbound ref_idx keys=${currentRefIndexKeys.join(",")} msgIdx=${inbound.msgIdx ?? "-"} typingRefIdx=${typingRefIdx ?? "-"}`
+      );
+    }
     const rawBody = buildInboundContentWithAttachments({
       content: inbound.content,
       attachments: resolvedAttachments
@@ -9654,40 +10216,48 @@ async function dispatchToAgent(params) {
     }) : rawBody;
     const inboundCtx = buildInboundContext({
       event: inbound,
-      sessionKey: route.sessionKey,
-      accountId: route.accountId ?? accountId,
+      sessionKey: routeSessionKey,
+      accountId: outboundAccountId,
       body: inboundBody,
       rawBody,
       commandBody: rawBody
     });
     const finalizeInboundContext = replyApi?.finalizeInboundContext;
     const finalCtx = finalizeInboundContext ? finalizeInboundContext(inboundCtx) : inboundCtx;
-    let cronBase = "";
-    if (typeof finalCtx.RawBody === "string" && finalCtx.RawBody) {
-      cronBase = finalCtx.RawBody;
-    } else if (typeof finalCtx.Body === "string" && finalCtx.Body) {
-      cronBase = finalCtx.Body;
-    } else if (typeof finalCtx.CommandBody === "string" && finalCtx.CommandBody) {
-      cronBase = finalCtx.CommandBody;
-    }
-    if (cronBase) {
-      const nextCron = appendCronHiddenPrompt(cronBase);
-      if (nextCron !== cronBase) {
-        finalCtx.BodyForAgent = nextCron;
+    const ctxTo = normalizeQQBotReplyTarget(finalCtx.To);
+    const ctxOriginatingTo = normalizeQQBotReplyTarget(finalCtx.OriginatingTo);
+    const stableTo = ctxOriginatingTo ?? ctxTo ?? target.to;
+    finalCtx.To = stableTo;
+    finalCtx.OriginatingTo = stableTo;
+    if (replyToId) {
+      finalCtx.ReplyToId = replyToId;
+      finalCtx.ReplyToBody = replyToBody;
+      finalCtx.ReplyToSender = replyToSender;
+      finalCtx.ReplyToIsQuote = replyToIsQuote;
+    }
+    const isSlashCommand = typeof finalCtx.CommandBody === "string" ? finalCtx.CommandBody.trim().startsWith("/") : typeof finalCtx.RawBody === "string" ? finalCtx.RawBody.trim().startsWith("/") : false;
+    if (!isSlashCommand) {
+      let agentBody = resolveAgentBodyBase(finalCtx);
+      if (replyToIsQuote && replyToBody && replyToBody !== QQ_QUOTE_BODY_UNAVAILABLE_TEXT) {
+        agentBody = buildQuotedAgentBody({
+          baseBody: agentBody,
+          replyToBody
+        });
       }
+      finalCtx.BodyForAgent = appendCronHiddenPrompt(agentBody);
     }
     if (storePath && sessionApi?.recordInboundSession) {
       try {
-        const mainSessionKeyRaw = route?.mainSessionKey;
-        const mainSessionKey = typeof mainSessionKeyRaw === "string" && mainSessionKeyRaw.trim() ? mainSessionKeyRaw : void 0;
+        const mainSessionKeyRaw = route.mainSessionKey;
+        const mainSessionKey = typeof mainSessionKeyRaw === "string" && mainSessionKeyRaw.trim() ? mainSessionKeyRaw.trim() : void 0;
         const isGroup = inbound.type === "group" || inbound.type === "channel";
         const updateLastRoute = !isGroup ? {
           sessionKey: mainSessionKey ?? route.sessionKey,
           channel: "qqbot",
-          to: finalCtx.OriginatingTo ?? finalCtx.To ?? `user:${inbound.senderId}`,
-          accountId: route.accountId ?? accountId
+          to: stableTo,
+          accountId: outboundAccountId
         } : void 0;
-        const recordSessionKey = typeof finalCtx.SessionKey === "string" && finalCtx.SessionKey.trim() ? finalCtx.SessionKey : route.sessionKey;
+        const recordSessionKey = typeof finalCtx.SessionKey === "string" && finalCtx.SessionKey.trim() ? finalCtx.SessionKey : routeSessionKey;
         await sessionApi.recordInboundSession({
           storePath,
           sessionKey: recordSessionKey,
@@ -9711,7 +10281,7 @@ async function dispatchToAgent(params) {
     const tableMode = textApi?.resolveMarkdownTableMode?.({
       cfg,
       channel: "qqbot",
-      accountId: route.accountId ?? accountId
+      accountId: outboundAccountId
     });
     const resolvedTableMode = tableMode ?? "bullets";
     const chunkText = (text) => {
@@ -9736,27 +10306,16 @@ async function dispatchToAgent(params) {
       bufferedC2CMarkdownMediaSeen.add(next);
       bufferedC2CMarkdownMediaUrls.push(next);
     };
-    const flushBufferedC2CMarkdownReply = async () => {
-      if (!useC2CMarkdownTransport || bufferedC2CMarkdownTexts.length === 0 && bufferedC2CMarkdownMediaUrls.length === 0) {
-        bufferedC2CMarkdownTexts = [];
-        bufferedC2CMarkdownMediaUrls = [];
-        bufferedC2CMarkdownMediaSeen.clear();
-        return;
-      }
-      const combinedText = bufferedC2CMarkdownTexts.join("\n\n").trim();
-      const combinedMediaUrls = [...bufferedC2CMarkdownMediaUrls];
-      bufferedC2CMarkdownTexts = [];
-      bufferedC2CMarkdownMediaUrls = [];
-      bufferedC2CMarkdownMediaSeen.clear();
-      const normalizedCombinedText = normalizeQQBotRenderedMarkdown(combinedText);
-      const { markdownImageUrls, mediaQueue } = splitQQBotMarkdownTransportMediaUrls(combinedMediaUrls);
+    const sendC2CMarkdownTransportPayload = async (params2) => {
+      const normalizedText = normalizeQQBotRenderedMarkdown(params2.text);
+      const { markdownImageUrls, mediaQueue } = splitQQBotMarkdownTransportMediaUrls(params2.mediaUrls);
       const finalMarkdownText = await normalizeQQBotMarkdownImages({
-        text: normalizedCombinedText,
+        text: normalizedText,
         appendImageUrls: markdownImageUrls
       });
       const textReplyRefs = resolveQQBotTextReplyRefs({
         to: target.to,
-        text: finalMarkdownText || normalizedCombinedText,
+        text: finalMarkdownText || normalizedText,
         markdownSupport,
         c2cMarkdownDeliveryMode,
         replyToId: inbound.messageId,
@@ -9765,7 +10324,7 @@ async function dispatchToAgent(params) {
       const textSegments = finalMarkdownText ? [finalMarkdownText] : [];
       const deliveryLabel = textReplyRefs.forceProactive ? "c2c-markdown-proactive" : "c2c-markdown-passive";
       logger.info(
-        `delivery=${deliveryLabel} to=${target.to} segments=${textSegments.length} media=${mediaQueue.length} replyToId=${textReplyRefs.replyToId ? "yes" : "no"} replyEventId=${textReplyRefs.replyEventId ? "yes" : "no"} tableMode=${String(resolvedTableMode)} chunkMode=${String(chunkMode ?? "default")}`
+        `delivery=${deliveryLabel} to=${target.to} segments=${textSegments.length} media=${mediaQueue.length} replyToId=${textReplyRefs.replyToId ? "yes" : "no"} replyEventId=${textReplyRefs.replyEventId ? "yes" : "no"} phase=${params2.phase} tableMode=${String(resolvedTableMode)} chunkMode=${String(chunkMode ?? "default")}`
       );
       await sendQQBotMediaWithFallback({
         qqCfg,
@@ -9773,6 +10332,7 @@ async function dispatchToAgent(params) {
         mediaQueue,
         replyToId: textReplyRefs.replyToId,
         replyEventId: textReplyRefs.replyEventId,
+        accountId: outboundAccountId,
         logger,
         onDelivered: () => {
           markReplyDelivered();
@@ -9790,25 +10350,44 @@ async function dispatchToAgent(params) {
         for (let chunkIndex = 0; chunkIndex < chunks.length; chunkIndex += 1) {
           const chunk = chunks[chunkIndex] ?? "";
           logger.info(
-            `delivery=${deliveryLabel} segment=${segmentIndex + 1}/${textSegments.length} chunk=${chunkIndex + 1}/${chunks.length} preview=${formatQQBotOutboundPreview(chunk)}`
+            `delivery=${deliveryLabel} segment=${segmentIndex + 1}/${textSegments.length} chunk=${chunkIndex + 1}/${chunks.length} phase=${params2.phase} preview=${formatQQBotOutboundPreview(chunk)}`
           );
           const result = await qqbotOutbound.sendText({
             cfg: { channels: { qqbot: qqCfg } },
             to: target.to,
             text: chunk,
             replyToId: textReplyRefs.replyToId,
-            replyEventId: textReplyRefs.replyEventId
+            replyEventId: textReplyRefs.replyEventId,
+            accountId: outboundAccountId
           });
           if (result.error) {
-            logger.error(`send buffered QQ markdown reply failed: ${result.error}`);
+            logger.error(`send QQ markdown reply failed: ${result.error}`);
             markGroupMessageInterfaceBlocked(result.error);
           } else {
-            logger.info(`sent buffered QQ markdown reply (len=${chunk.length})`);
+            logger.info(`sent QQ markdown reply (phase=${params2.phase}, len=${chunk.length})`);
             markReplyDelivered();
           }
         }
       }
     };
+    const flushBufferedC2CMarkdownReply = async () => {
+      if (!useC2CMarkdownTransport || bufferedC2CMarkdownTexts.length === 0 && bufferedC2CMarkdownMediaUrls.length === 0) {
+        bufferedC2CMarkdownTexts = [];
+        bufferedC2CMarkdownMediaUrls = [];
+        bufferedC2CMarkdownMediaSeen.clear();
+        return;
+      }
+      const combinedText = bufferedC2CMarkdownTexts.join("\n\n").trim();
+      const combinedMediaUrls = [...bufferedC2CMarkdownMediaUrls];
+      bufferedC2CMarkdownTexts = [];
+      bufferedC2CMarkdownMediaUrls = [];
+      bufferedC2CMarkdownMediaSeen.clear();
+      await sendC2CMarkdownTransportPayload({
+        text: combinedText,
+        mediaUrls: combinedMediaUrls,
+        phase: "buffered"
+      });
+    };
     const deliver = async (payload, info) => {
       const typed = payload;
       const extractedTextMedia = extractQQBotReplyMedia({
@@ -9840,12 +10419,21 @@ async function dispatchToAgent(params) {
       const suppressText = deliveryDecision.suppressText || suppressEchoText;
       const textToSend = suppressText ? "" : cleanedText;
       if (useC2CMarkdownTransport) {
-        if (textToSend) {
-          bufferedC2CMarkdownTexts = appendQQBotBufferedText(bufferedC2CMarkdownTexts, textToSend);
-        }
-        for (const url of mediaQueue) {
-          bufferC2CMarkdownMedia(url);
+        const shouldBufferFinalOnlyPayload = replyFinalOnly && (!info?.kind || info.kind === "final");
+        if (shouldBufferFinalOnlyPayload) {
+          if (textToSend) {
+            bufferedC2CMarkdownTexts = appendQQBotBufferedText(bufferedC2CMarkdownTexts, textToSend);
+          }
+          for (const url of mediaQueue) {
+            bufferC2CMarkdownMedia(url);
+          }
+          return;
         }
+        await sendC2CMarkdownTransportPayload({
+          text: textToSend,
+          mediaUrls: mediaQueue,
+          phase: "immediate"
+        });
         return;
       }
       if (textToSend) {
@@ -9865,7 +10453,8 @@ async function dispatchToAgent(params) {
             to: target.to,
             text: chunk,
             replyToId: textReplyRefs.replyToId,
-            replyEventId: textReplyRefs.replyEventId
+            replyEventId: textReplyRefs.replyEventId,
+            accountId: outboundAccountId
           });
           if (result.error) {
             logger.error(`sendText failed: ${result.error}`);
@@ -9881,6 +10470,7 @@ async function dispatchToAgent(params) {
         mediaQueue,
         replyToId: inbound.messageId,
         replyEventId: inbound.eventId,
+        accountId: outboundAccountId,
         logger,
         onDelivered: () => {
           markReplyDelivered();
@@ -9952,7 +10542,8 @@ async function dispatchToAgent(params) {
         to: target.to,
         text: noReplyFallback,
         replyToId: inbound.messageId,
-        replyEventId: inbound.eventId
+        replyEventId: inbound.eventId,
+        accountId: outboundAccountId
       });
       if (fallbackResult.error) {
         logger.error(`sendText no-reply fallback failed: ${fallbackResult.error}`);
@@ -10057,9 +10648,19 @@ async function handleQQBotDispatch(params) {
     accountId,
     peer: { kind: target.peerKind, id: target.peerId }
   });
-  const queueKey = buildSessionDispatchQueueKey(route);
+  const effectiveSessionKey = resolveQQBotEffectiveSessionKey({
+    inbound,
+    route,
+    accountId
+  });
+  const resolvedRoute = effectiveSessionKey === route.sessionKey ? route : {
+    ...route,
+    mainSessionKey: route.mainSessionKey?.trim() || route.sessionKey,
+    effectiveSessionKey
+  };
+  const queueKey = buildSessionDispatchQueueKey(resolvedRoute);
   if (sessionDispatchQueue.has(queueKey)) {
-    logger.info(`session busy; queueing inbound dispatch sessionKey=${route.sessionKey}`);
+    logger.info(`session busy; queueing inbound dispatch sessionKey=${resolveQQBotRouteSessionKey(resolvedRoute)}`);
   }
   await runSerializedSessionDispatch(
     queueKey,
@@ -10069,7 +10670,7 @@ async function handleQQBotDispatch(params) {
       qqCfg,
       accountId,
       logger,
-      route
+      route: resolvedRoute
     })
   );
 }
@@ -10381,7 +10982,7 @@ var qqbotPlugin = {
     ...meta
   },
   capabilities: {
-    chatTypes: ["direct", "channel"],
+    chatTypes: ["direct", "group", "channel"],
     media: true,
     reactions: false,
     threads: false,