@openclaw-china/qqbot 2026.3.5 → 2026.3.7

package/dist/index.js

@@ -1,9 +1,9 @@
-import * as fs3 from 'fs';
-import { existsSync } from 'fs';
 import * as os from 'os';
-import { homedir } from 'os';
-import * as path from 'path';
+import { homedir, tmpdir } from 'os';
+import * as path2 from 'path';
 import { join } from 'path';
+import * as fs3 from 'fs';
+import { existsSync } from 'fs';
 import { fileURLToPath } from 'url';
 import * as fsPromises from 'fs/promises';
 import { createHmac } from 'crypto';
@@ -4242,13 +4242,31 @@ var QQBotAccountSchema = external_exports.object({
   historyLimit: external_exports.number().int().min(0).optional().default(10),
   textChunkLimit: external_exports.number().int().positive().optional().default(1500),
   replyFinalOnly: external_exports.boolean().optional().default(false),
+  longTaskNoticeDelayMs: external_exports.number().int().min(0).optional().default(3e4),
   maxFileSizeMB: external_exports.number().positive().optional().default(100),
-  mediaTimeoutMs: external_exports.number().int().positive().optional().default(3e4)
+  mediaTimeoutMs: external_exports.number().int().positive().optional().default(3e4),
+  inboundMedia: external_exports.object({
+    dir: external_exports.string().optional(),
+    keepDays: external_exports.number().optional()
+  }).optional()
 });
 QQBotAccountSchema.extend({
   defaultAccount: external_exports.string().optional(),
   accounts: external_exports.record(QQBotAccountSchema).optional()
 });
+var DEFAULT_INBOUND_MEDIA_DIR = join(homedir(), ".openclaw", "media", "qqbot", "inbound");
+var DEFAULT_INBOUND_MEDIA_KEEP_DAYS = 7;
+var DEFAULT_INBOUND_MEDIA_TEMP_DIR = join(tmpdir(), "qqbot-media");
+function resolveInboundMediaDir(config) {
+  return String(config?.inboundMedia?.dir ?? "").trim() || DEFAULT_INBOUND_MEDIA_DIR;
+}
+function resolveInboundMediaKeepDays(config) {
+  const value = config?.inboundMedia?.keepDays;
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : DEFAULT_INBOUND_MEDIA_KEEP_DAYS;
+}
+function resolveInboundMediaTempDir() {
+  return DEFAULT_INBOUND_MEDIA_TEMP_DIR;
+}
 var DEFAULT_ACCOUNT_ID = "default";
 function listConfiguredAccountIds(cfg) {
   const accounts = cfg.channels?.qqbot?.accounts;
@@ -4639,10 +4657,10 @@ function normalizeLocalPath(raw) {
   } catch {
   }
   if (p.startsWith("~/") || p === "~") {
-    p = path.join(os.homedir(), p.slice(1));
+    p = path2.join(os.homedir(), p.slice(1));
   } else if (p.startsWith("~")) ;
-  if (!path.isAbsolute(p)) {
-    p = path.resolve(process.cwd(), p);
+  if (!path2.isAbsolute(p)) {
+    p = path2.resolve(process.cwd(), p);
   }
   return p;
 }
@@ -4652,7 +4670,7 @@ function stripTitleFromUrl(value) {
   return match ? match[1] : trimmed;
 }
 function getExtension(filePath) {
-  const ext = path.extname(filePath).toLowerCase();
+  const ext = path2.extname(filePath).toLowerCase();
   return ext.startsWith(".") ? ext.slice(1) : ext;
 }
 function isImagePath(filePath) {
@@ -4678,11 +4696,11 @@ function createExtractedMedia(source, sourceKind, options) {
   let fileName;
   if (isLocal) {
     localPath = normalizeLocalPath(cleanSource);
-    fileName = path.basename(localPath);
+    fileName = path2.basename(localPath);
   } else if (isHttp) {
     try {
       const url = new URL(cleanSource);
-      fileName = path.basename(url.pathname) || void 0;
+      fileName = path2.basename(url.pathname) || void 0;
     } catch {
     }
   }
@@ -4840,7 +4858,7 @@ function extractMediaFromText(text, options = {}) {
       if (media.type !== "image" && isNonImageFilePath(media.localPath || rawPath)) {
         if (addMedia(media)) {
           if (removeFromText && match.index !== void 0) {
-            const fileName = media.fileName || path.basename(rawPath);
+            const fileName = media.fileName || path2.basename(rawPath);
             replacements.push({
               start: match.index,
               end: match.index + fullMatch.length,
@@ -4885,7 +4903,7 @@ function extractMediaFromText(text, options = {}) {
       if (media.type !== "image") {
         if (addMedia(media)) {
           if (removeFromText && match.index !== void 0) {
-            const fileName = media.fileName || path.basename(rawPath);
+            const fileName = media.fileName || path2.basename(rawPath);
             replacements.push({
               start: match.index,
               end: match.index + fullMatch.length,
@@ -4934,13 +4952,27 @@ function sanitizeFileName(name) {
 function resolveFileNameFromUrl(url) {
   try {
     const parsed = new URL(url);
-    const base = path.basename(parsed.pathname);
+    const base = path2.basename(parsed.pathname);
     if (!base || base === "/") return void 0;
     return base;
   } catch {
     return void 0;
   }
 }
+function normalizeForCompare(value) {
+  return path2.resolve(value).replace(/\\/g, "/").toLowerCase();
+}
+function isPathUnderDir(filePath, dirPath) {
+  const f = normalizeForCompare(filePath);
+  const d2 = normalizeForCompare(dirPath).replace(/\/+$/, "");
+  return f === d2 || f.startsWith(`${d2}/`);
+}
+function formatDateDir(date = /* @__PURE__ */ new Date()) {
+  const yyyy = date.getFullYear();
+  const mm = String(date.getMonth() + 1).padStart(2, "0");
+  const dd = String(date.getDate()).padStart(2, "0");
+  return `${yyyy}-${mm}-${dd}`;
+}
 var EXT_TO_MIME = {
   // 图片
   jpg: "image/jpeg",
@@ -5035,15 +5067,15 @@ function validatePathSecurity(filePath, options = {}) {
     );
   }
   if (preventTraversal) {
-    const normalized = path.normalize(filePath);
+    const normalized = path2.normalize(filePath);
     if (normalized.includes("..")) {
       throw new PathSecurityError(filePath, "Path traversal detected");
     }
   }
   if (allowedPrefixes && allowedPrefixes.length > 0) {
-    const normalizedPath = path.normalize(filePath);
+    const normalizedPath = path2.normalize(filePath);
     const isAllowed = allowedPrefixes.some(
-      (prefix) => normalizedPath.startsWith(path.normalize(prefix))
+      (prefix) => normalizedPath.startsWith(path2.normalize(prefix))
     );
     if (!isAllowed) {
       throw new PathSecurityError(
@@ -5086,7 +5118,7 @@ async function fetchMediaFromUrl(url, options = {}) {
     let fileName = "file";
     try {
       const urlPath = new URL(url).pathname;
-      fileName = path.basename(urlPath) || "file";
+      fileName = path2.basename(urlPath) || "file";
     } catch {
     }
     const mimeType = response.headers.get("content-type")?.split(";")[0].trim() || getMimeType(fileName);
@@ -5159,7 +5191,7 @@ async function downloadToTempFile(url, options = {}) {
     const ext = resolveExtension(contentType, sourceName);
     const random = Math.random().toString(36).slice(2, 8);
     const fileName = `${safePrefix}-${Date.now()}-${random}${ext}`;
-    const fullPath = path.join(tempDir, fileName);
+    const fullPath = path2.join(tempDir, fileName);
     await fsPromises.mkdir(tempDir, { recursive: true });
     const buffer = Buffer.concat(chunks.map((chunk) => Buffer.from(chunk)));
     await fsPromises.writeFile(fullPath, buffer);
@@ -5191,7 +5223,7 @@ async function readMediaFromLocal(filePath, options = {}) {
     throw new FileSizeLimitError(stats.size, maxSize);
   }
   const buffer = await fsPromises.readFile(localPath);
-  const fileName = path.basename(localPath);
+  const fileName = path2.basename(localPath);
   const mimeType = getMimeType(localPath);
   return {
     buffer,
@@ -5206,6 +5238,63 @@ async function readMedia(source, options = {}) {
   }
   return readMediaFromLocal(source, options);
 }
+async function finalizeInboundMediaFile(options) {
+  const current = String(options.filePath ?? "").trim();
+  if (!current) return current;
+  if (!isPathUnderDir(current, options.tempDir)) {
+    return current;
+  }
+  const datedDir = path2.join(options.inboundDir, formatDateDir());
+  const target = path2.join(datedDir, path2.basename(current));
+  try {
+    await fsPromises.mkdir(datedDir, { recursive: true });
+    await fsPromises.rename(current, target);
+    return target;
+  } catch {
+    return current;
+  }
+}
+async function pruneInboundMediaDir(options) {
+  const keepDays = Number(options.keepDays);
+  if (!Number.isFinite(keepDays) || keepDays < 0) return;
+  const now = options.nowMs ?? Date.now();
+  const cutoff = now - keepDays * 24 * 60 * 60 * 1e3;
+  let entries = [];
+  try {
+    entries = await fsPromises.readdir(options.inboundDir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(entry)) continue;
+    const dirPath = path2.join(options.inboundDir, entry);
+    let dirStats;
+    try {
+      dirStats = await fsPromises.stat(dirPath);
+    } catch {
+      continue;
+    }
+    if (!dirStats.isDirectory()) continue;
+    const dirTime = dirStats.mtimeMs || dirStats.ctimeMs || 0;
+    if (dirTime >= cutoff) continue;
+    let files = [];
+    try {
+      files = await fsPromises.readdir(dirPath);
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      const fp = path2.join(dirPath, file);
+      try {
+        const fst = await fsPromises.stat(fp);
+        if (fst.isFile() && (fst.mtimeMs || fst.ctimeMs || 0) < cutoff) {
+          await fsPromises.unlink(fp);
+        }
+      } catch {
+      }
+    }
+  }
+}
 async function cleanupFileSafe(filePath, onError) {
   if (!filePath) return;
   try {
@@ -6990,6 +7079,12 @@ function requireTrimmedString(value, field) {
   }
   return normalized;
 }
+function sanitizeUploadFileName(fileName) {
+  const trimmed = fileName.trim();
+  if (!trimmed) return "file";
+  const normalized = trimmed.replace(/[<>:"/\\|?*\x00-\x1F]/g, "_");
+  return normalized || "file";
+}
 function nextMsgSeq(sequenceKey) {
   if (!sequenceKey) return MSG_SEQ_BASE + 1;
   const current = msgSeqMap.get(sequenceKey) ?? 0;
@@ -7106,8 +7201,7 @@ async function sendGroupMessage(params) {
     eventId: params.eventId,
     markdown: params.markdown
   });
-  const groupOpenidLower = params.groupOpenid.toLowerCase();
-  return apiPost(params.accessToken, `/v2/groups/${groupOpenidLower}/messages`, body, {
+  return apiPost(params.accessToken, `/v2/groups/${params.groupOpenid}/messages`, body, {
     timeout: 15e3
   });
 }
@@ -7116,8 +7210,7 @@ async function sendChannelMessage(params) {
   if (params.messageId) {
     body.msg_id = params.messageId;
   }
-  const channelIdLower = params.channelId.toLowerCase();
-  return apiPost(params.accessToken, `/channels/${channelIdLower}/messages`, body, {
+  return apiPost(params.accessToken, `/channels/${params.channelId}/messages`, body, {
     timeout: 15e3
   });
 }
@@ -7140,7 +7233,8 @@ async function sendC2CInputNotify(params) {
 }
 async function uploadC2CMedia(params) {
   const body = {
-    file_type: params.fileType
+    file_type: params.fileType,
+    srv_send_msg: params.srvSendMsg ?? false
   };
   if (params.url) {
     body.url = params.url;
@@ -7149,13 +7243,17 @@ async function uploadC2CMedia(params) {
   } else {
     throw new Error("uploadC2CMedia requires url or fileData");
   }
+  if (params.fileType === 4 /* FILE */ && params.fileName?.trim()) {
+    body.file_name = sanitizeUploadFileName(params.fileName);
+  }
   return apiPost(params.accessToken, `/v2/users/${params.openid}/files`, body, {
     timeout: 3e4
   });
 }
 async function uploadGroupMedia(params) {
   const body = {
-    file_type: params.fileType
+    file_type: params.fileType,
+    srv_send_msg: params.srvSendMsg ?? false
   };
   if (params.url) {
     body.url = params.url;
@@ -7164,6 +7262,9 @@ async function uploadGroupMedia(params) {
   } else {
     throw new Error("uploadGroupMedia requires url or fileData");
   }
+  if (params.fileType === 4 /* FILE */ && params.fileName?.trim()) {
+    body.file_name = sanitizeUploadFileName(params.fileName);
+  }
   return apiPost(params.accessToken, `/v2/groups/${params.groupOpenid}/files`, body, {
     timeout: 3e4
   });
@@ -7198,7 +7299,6 @@ async function sendGroupMediaMessage(params) {
     { timeout: 15e3 }
   );
 }
-var QQBOT_UNSUPPORTED_FILE_TYPE_MESSAGE = "QQ official C2C/group media API does not support generic files (file_type=4, e.g. PDF). Images and other supported media types are unaffected.";
 var require2 = createRequire(import.meta.url);
 function resolveQQBotMediaFileType(fileName) {
   const mediaType = detectMediaType(fileName);
@@ -7214,7 +7314,7 @@ function resolveQQBotMediaFileType(fileName) {
   }
 }
 async function uploadQQBotFile(params) {
-  const { accessToken, target, fileType, url, fileData } = params;
+  const { accessToken, target, fileType, url, fileData, fileName } = params;
   if (!url && !fileData) {
     throw new Error("QQBot file upload requires url or fileData");
   }
@@ -7222,11 +7322,15 @@ async function uploadQQBotFile(params) {
     accessToken,
     groupOpenid: target.id,
     fileType,
+    srvSendMsg: false,
+    ...fileName ? { fileName } : {},
     ...url ? { url } : { fileData }
   }) : await uploadC2CMedia({
     accessToken,
     openid: target.id,
     fileType,
+    srvSendMsg: false,
+    ...fileName ? { fileName } : {},
     ...url ? { url } : { fileData }
   });
   if (!upload.file_info) {
@@ -7234,14 +7338,29 @@ async function uploadQQBotFile(params) {
   }
   return upload.file_info;
 }
+function deriveUploadFileName(source) {
+  const trimmed = source.trim();
+  if (!trimmed) return void 0;
+  if (isHttpUrl(trimmed)) {
+    try {
+      const pathname = new URL(trimmed).pathname;
+      const base2 = path2.posix.basename(pathname);
+      return base2 && base2 !== "/" ? base2 : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  const base = path2.basename(trimmed);
+  return base || void 0;
+}
 async function convertAudioToSilk(audioPath) {
   const ffmpegPath = require2("ffmpeg-static");
   if (!ffmpegPath) {
     throw new Error("ffmpeg-static not found");
   }
   const silkWasm = require2("silk-wasm");
-  const tmpDir = fs3.mkdtempSync(path.join(os.tmpdir(), "qqbot-silk-"));
-  const pcmPath = path.join(tmpDir, "audio.pcm");
+  const tmpDir = fs3.mkdtempSync(path2.join(os.tmpdir(), "qqbot-silk-"));
+  const pcmPath = path2.join(tmpDir, "audio.pcm");
   try {
     execFileSync(
       ffmpegPath,
@@ -7259,31 +7378,33 @@ async function convertAudioToSilk(audioPath) {
   }
 }
 async function sendFileQQBot(params) {
-  const { cfg, target, mediaUrl, messageId, eventId } = params;
-  if (!cfg.appId || !cfg.clientSecret) {
+  const { cfg, target, mediaUrl, text, messageId, eventId } = params;
+  const credentials = resolveQQBotCredentials(cfg);
+  if (!credentials) {
     throw new Error("QQBot not configured (missing appId/clientSecret)");
   }
   const src = stripTitleFromUrl(mediaUrl);
   const fileType = resolveQQBotMediaFileType(src);
-  if (fileType === 4 /* FILE */) {
-    throw new Error(QQBOT_UNSUPPORTED_FILE_TYPE_MESSAGE);
-  }
   const sourceIsHttp = isHttpUrl(src);
   const maxFileSizeMB = cfg.maxFileSizeMB ?? 100;
   const mediaTimeoutMs = cfg.mediaTimeoutMs ?? 3e4;
   const maxSizeBytes = Math.floor(maxFileSizeMB * 1024 * 1024);
-  const accessToken = await getAccessToken(cfg.appId, cfg.clientSecret);
+  const messageText = text?.trim() ? text.trim() : void 0;
+  const accessToken = await getAccessToken(credentials.appId, credentials.clientSecret);
   let fileInfo;
   try {
     if (sourceIsHttp) {
+      const fileName = fileType === 4 /* FILE */ ? deriveUploadFileName(src) : void 0;
       fileInfo = await uploadQQBotFile({
         accessToken,
         target,
         fileType,
-        url: src
+        url: src,
+        ...fileName ? { fileName } : {}
       });
     } else {
       let buffer;
+      let fileName = fileType === 4 /* FILE */ ? deriveUploadFileName(src) : void 0;
       if (fileType === 3 /* VOICE */) {
         try {
           const silkData = await convertAudioToSilk(src);
@@ -7301,12 +7422,16 @@ async function sendFileQQBot(params) {
           maxSize: maxSizeBytes
         });
         buffer = local.buffer;
+        if (fileType === 4 /* FILE */) {
+          fileName = local.fileName || fileName;
+        }
       }
       fileInfo = await uploadQQBotFile({
         accessToken,
         target,
         fileType,
-        fileData: buffer.toString("base64")
+        fileData: buffer.toString("base64"),
+        ...fileName ? { fileName } : {}
       });
     }
   } catch (err) {
@@ -7319,6 +7444,7 @@ async function sendFileQQBot(params) {
         accessToken,
         groupOpenid: target.id,
         fileInfo,
+        ...messageText ? { content: messageText } : {},
         ...messageId ? { messageId } : {},
         ...eventId ? { eventId } : {}
       });
@@ -7332,6 +7458,7 @@ async function sendFileQQBot(params) {
       accessToken,
       openid: target.id,
       fileInfo,
+      ...messageText ? { content: messageText } : {},
       ...messageId ? { messageId } : {},
       ...eventId ? { eventId } : {}
     });
@@ -7406,7 +7533,7 @@ function shortId(value) {
 function summarizeError(err) {
   if (err instanceof HttpError) {
     const body = err.body?.trim();
-    return body ? `status=${err.status}, body=${body}` : `status=${err.status}, message=${err.message}`;
+    return body ? `${err.message} - ${body}` : err.message;
   }
   return err instanceof Error ? err.message : String(err);
 }
@@ -7440,6 +7567,9 @@ function shouldRetryWithEventId(err) {
   }
   return text.includes("expire") || text.includes("invalid") || text.includes("not found") || text.includes("\u8D85\u8FC7") || text.includes("\u8D85\u65F6") || text.includes("\u8FC7\u671F") || text.includes("\u5931\u6548") || text.includes("\u65E0\u6548");
 }
+function shouldSendTextAsFollowupForMedia(mediaUrl) {
+  return detectMediaType(stripTitleFromUrl(mediaUrl)) === "file";
+}
 var qqbotOutbound = {
   deliveryMode: "direct",
   textChunkLimit: 1500,
@@ -7447,12 +7577,14 @@ var qqbotOutbound = {
   sendText: async (params) => {
     const { cfg, to, text, replyToId, replyEventId, accountId } = params;
     const qqCfg = mergeQQBotAccountConfig(cfg, accountId ?? DEFAULT_ACCOUNT_ID);
-    if (!qqCfg.appId || !qqCfg.clientSecret) {
+    const credentials = resolveQQBotCredentials(qqCfg);
+    if (!credentials) {
       return { channel: "qqbot", error: "QQBot not configured (missing appId/clientSecret)" };
     }
     const target = parseTarget(to);
-    const accessToken = await getAccessToken(qqCfg.appId, qqCfg.clientSecret);
+    const accessToken = await getAccessToken(credentials.appId, credentials.clientSecret);
     const markdown = qqCfg.markdownSupport ?? true;
+    const groupMarkdown = false;
     try {
       if (target.kind === "group") {
         let result2;
@@ -7462,7 +7594,7 @@ var qqbotOutbound = {
             groupOpenid: target.id,
             content: text,
             messageId: replyToId,
-            markdown
+            markdown: groupMarkdown
           });
         } catch (err) {
           if (!replyToId || !replyEventId || !shouldRetryWithEventId(err)) {
@@ -7484,7 +7616,7 @@ var qqbotOutbound = {
               groupOpenid: target.id,
               content: text,
               eventId: replyEventId,
-              markdown
+              markdown: groupMarkdown
             });
             logEventIdFallback({
               phase: "success",
@@ -7576,7 +7708,7 @@ var qqbotOutbound = {
       }
       return { channel: "qqbot", messageId: result.id, timestamp: result.timestamp };
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
+      const message = summarizeError(err);
       return { channel: "qqbot", error: message };
     }
   },
@@ -7590,12 +7722,14 @@ var qqbotOutbound = {
       return qqbotOutbound.sendText({ cfg, to, text: fallbackText, replyToId, replyEventId, accountId });
     }
     const qqCfg = mergeQQBotAccountConfig(cfg, accountId ?? DEFAULT_ACCOUNT_ID);
-    if (!qqCfg.appId || !qqCfg.clientSecret) {
+    if (!resolveQQBotCredentials(qqCfg)) {
       return { channel: "qqbot", error: "QQBot not configured (missing appId/clientSecret)" };
     }
     const target = parseTarget(to);
+    const trimmedText = text?.trim() ? text.trim() : void 0;
+    const sendTextAsFollowup = trimmedText ? shouldSendTextAsFollowupForMedia(mediaUrl) : false;
     if (target.kind === "channel") {
-      const fallbackText = text?.trim() ? `${text}
+      const fallbackText = trimmedText ? `${trimmedText}
 ${mediaUrl}` : mediaUrl;
       return qqbotOutbound.sendText({ cfg, to, text: fallbackText, replyToId, replyEventId, accountId });
     }
@@ -7606,6 +7740,7 @@ ${mediaUrl}` : mediaUrl;
           cfg: qqCfg,
           target: { kind: target.kind, id: target.id },
           mediaUrl,
+          text: sendTextAsFollowup ? void 0 : trimmedText,
           messageId: replyToId
         });
       } catch (err) {
@@ -7627,6 +7762,7 @@ ${mediaUrl}` : mediaUrl;
             cfg: qqCfg,
             target: { kind: target.kind, id: target.id },
             mediaUrl,
+            text: sendTextAsFollowup ? void 0 : trimmedText,
             eventId: replyEventId
           });
           logEventIdFallback({
@@ -7652,16 +7788,33 @@ ${mediaUrl}` : mediaUrl;
           throw retryErr;
         }
       }
+      if (sendTextAsFollowup && trimmedText) {
+        const textResult = await qqbotOutbound.sendText({
+          cfg,
+          to,
+          text: trimmedText,
+          replyToId,
+          replyEventId,
+          accountId
+        });
+        if (textResult.error) {
+          return {
+            channel: "qqbot",
+            error: `QQBot follow-up text send failed after media delivery: ${textResult.error}`
+          };
+        }
+      }
       return { channel: "qqbot", messageId: result.id, timestamp: result.timestamp };
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
+      const message = summarizeError(err);
       return { channel: "qqbot", error: message };
     }
   },
   sendTyping: async (params) => {
     const { cfg, to, replyToId, replyEventId, inputSecond, accountId } = params;
     const qqCfg = mergeQQBotAccountConfig(cfg, accountId ?? DEFAULT_ACCOUNT_ID);
-    if (!qqCfg.appId || !qqCfg.clientSecret) {
+    const credentials = resolveQQBotCredentials(qqCfg);
+    if (!credentials) {
       return { channel: "qqbot", error: "QQBot not configured (missing appId/clientSecret)" };
     }
     const target = parseTarget(to);
@@ -7669,7 +7822,7 @@ ${mediaUrl}` : mediaUrl;
       return { channel: "qqbot" };
     }
     try {
-      const accessToken = await getAccessToken(qqCfg.appId, qqCfg.clientSecret);
+      const accessToken = await getAccessToken(credentials.appId, credentials.clientSecret);
       try {
         await sendC2CInputNotify({
           accessToken,
@@ -7724,7 +7877,7 @@ ${mediaUrl}` : mediaUrl;
       }
       return { channel: "qqbot" };
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
+      const message = summarizeError(err);
       return { channel: "qqbot", error: message };
     }
   }
@@ -7800,6 +7953,43 @@ function resolveEventId(payload, fallbackEventId) {
 var VOICE_ASR_FALLBACK_TEXT = "\u5F53\u524D\u8BED\u97F3\u529F\u80FD\u672A\u542F\u52A8\u6216\u8BC6\u522B\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
 var VOICE_EXTENSIONS = [".silk", ".amr", ".mp3", ".wav", ".ogg", ".m4a", ".aac", ".speex"];
 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";
+function startLongTaskNoticeTimer(params) {
+  const { delayMs, logger, sendNotice } = params;
+  let completed = false;
+  let timer = null;
+  const clear = () => {
+    if (!timer) return;
+    clearTimeout(timer);
+    timer = null;
+  };
+  if (delayMs > 0) {
+    timer = setTimeout(() => {
+      if (completed) return;
+      completed = true;
+      timer = null;
+      void sendNotice().catch((err) => {
+        logger.warn(`send long-task notice failed: ${String(err)}`);
+      });
+    }, delayMs);
+    timer.unref?.();
+  } else {
+    completed = true;
+  }
+  return {
+    markReplyDelivered: () => {
+      if (completed) return;
+      completed = true;
+      clear();
+    },
+    dispose: () => {
+      completed = true;
+      clear();
+    }
+  };
+}
 function isHttpUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
@@ -7865,6 +8055,8 @@ async function resolveInboundAttachmentsForAgent(params) {
   const maxFileSizeMB = qqCfg.maxFileSizeMB ?? 100;
   const maxSize = Math.floor(maxFileSizeMB * 1024 * 1024);
   const asrCredentials = resolveQQBotASRCredentials(qqCfg);
+  const inboundMediaDir = resolveInboundMediaDir(qqCfg);
+  const inboundMediaTempDir = resolveInboundMediaTempDir();
   const resolved = [];
   let hasVoiceAttachment = false;
   let hasVoiceTranscript = false;
@@ -7877,11 +8069,19 @@ async function resolveInboundAttachmentsForAgent(params) {
           timeout,
           maxSize,
           sourceFileName: att.filename,
-          tempPrefix: "qqbot-inbound"
+          tempPrefix: "qqbot-inbound",
+          tempDir: inboundMediaTempDir
+        });
+        const finalPath = await finalizeInboundMediaFile({
+          filePath: downloaded.path,
+          tempDir: inboundMediaTempDir,
+          inboundDir: inboundMediaDir
         });
-        next.localImagePath = downloaded.path;
-        logger.info(`inbound image cached: ${downloaded.path}`);
-        scheduleTempCleanup(downloaded.path);
+        next.localImagePath = finalPath;
+        logger.info(`inbound image cached: ${finalPath}`);
+        if (finalPath === downloaded.path) {
+          scheduleTempCleanup(downloaded.path);
+        }
       } catch (err) {
         logger.warn(`failed to download inbound attachment: ${String(err)}`);
       }
@@ -8090,18 +8290,20 @@ function resolveInbound(eventType, data, fallbackEventId) {
 }
 function resolveChatTarget(event) {
   if (event.type === "group") {
-    const group = (event.groupOpenid ?? "").toLowerCase();
+    const group = event.groupOpenid ?? "";
+    const normalizedGroup = group.toLowerCase();
     return {
       to: `group:${group}`,
-      peerId: `group:${group}`,
+      peerId: `group:${normalizedGroup}`,
       peerKind: "group"
     };
   }
   if (event.type === "channel") {
-    const channel = (event.channelId ?? "").toLowerCase();
+    const channel = event.channelId ?? "";
+    const normalizedChannel = channel.toLowerCase();
     return {
       to: `channel:${channel}`,
-      peerId: `channel:${channel}`,
+      peerId: `channel:${normalizedChannel}`,
       peerKind: "group"
     };
   }
@@ -8138,7 +8340,7 @@ function extractLocalMediaFromText(params) {
     parseBarePaths: true,
     parseMarkdownLinks: true
   });
-  const mediaUrls = result.all.filter((m) => m.isLocal && m.localPath).map((m) => m.localPath);
+  const mediaUrls = result.all.filter((m) => m.isLocal && typeof m.localPath === "string").filter((m) => m.type !== "file").map((m) => m.localPath);
   return { text: result.text, mediaUrls };
 }
 function extractMediaLinesFromText(params) {
@@ -8162,24 +8364,16 @@ function extractMediaLinesFromText(params) {
   const mediaUrls = result.all.map((m) => m.isLocal ? m.localPath ?? m.source : m.source).filter((m) => typeof m === "string" && m.trim().length > 0);
   return { text: result.text, mediaUrls };
 }
-function isOfficialQQFileSendLimit(errorMessage) {
-  const text = (errorMessage ?? "").toLowerCase();
-  if (!text) return false;
-  return text.includes("file_type=4") || text.includes("generic files") || text.includes("not support generic files") || text.includes("\u6682\u4E0D\u652F\u6301\u901A\u7528\u6587\u4EF6");
-}
-function buildMediaFallbackText(mediaUrl, errorMessage) {
-  if (isOfficialQQFileSendLimit(errorMessage)) {
-    return [
-      "\u8BF4\u660E\uFF1A\u6839\u636E QQ \u5B98\u65B9\u63A5\u53E3\u89C4\u8303\uFF0C\u5F53\u524D C2C/\u7FA4\u804A\u6682\u4E0D\u652F\u6301\u76F4\u63A5\u53D1\u9001 PDF/\u6587\u6863\u7B49\u901A\u7528\u6587\u4EF6\uFF08file_type=4\uFF09\u3002",
-      "\u8FD9\u5C5E\u4E8E\u5E73\u53F0\u9650\u5236\uFF0C\u4E0D\u662F\u63D2\u4EF6\u7F3A\u9677\uFF1B\u56FE\u7247\u7B49\u5A92\u4F53\u4ECD\u53EF\u6B63\u5E38\u53D1\u9001\u3002",
-      `\u5DF2\u4E3A\u4F60\u9644\u4E0A\u6587\u4EF6\u94FE\u63A5\uFF1A${mediaUrl}`
-    ].join("\n");
+function buildMediaFallbackText(mediaUrl) {
+  if (!/^https?:\/\//i.test(mediaUrl)) {
+    return void 0;
   }
   return `\u{1F4CE} ${mediaUrl}`;
 }
 var THINK_BLOCK_RE = /<think\b[^>]*>[\s\S]*?<\/think>/gi;
 var FINAL_BLOCK_RE = /<final\b[^>]*>([\s\S]*?)<\/final>/gi;
 var RAW_THINK_OR_FINAL_TAG_RE = /<\/?(?:think|final)\b[^>]*>/gi;
+var FILE_PLACEHOLDER_RE = /\[文件:\s*[^\]\n]+\]/g;
 var DIRECTIVE_TAG_RE = /\[\[\s*(?:reply_to_current|reply_to\s*:[^\]]+|audio_as_voice|tts(?::text)?|\/tts(?::text)?)\s*\]\]/gi;
 var VOICE_EMOTION_TAG_RE = /\[(?:happy|excited|calm|sad|angry|frustrated|softly|whispers|loudly|cheerfully|deadpan|sarcastically|laughs|sighs|chuckles|gasps|pause|slowly|rushed|hesitates|playfully|warmly|gently)\]/gi;
 var TTS_LIKE_RAW_TEXT_RE = /\[\[\s*(?:tts(?::text)?|\/tts(?::text)?|audio_as_voice|reply_to_current|reply_to\s*:)/i;
@@ -8197,6 +8391,7 @@ function sanitizeQQBotOutboundText(rawText) {
   }
   next = next.replace(THINK_BLOCK_RE, "");
   next = next.replace(RAW_THINK_OR_FINAL_TAG_RE, "");
+  next = next.replace(FILE_PLACEHOLDER_RE, " ");
   next = next.replace(DIRECTIVE_TAG_RE, " ");
   next = next.replace(VOICE_EMOTION_TAG_RE, " ");
   next = next.replace(/[ \t]+\n/g, "\n");
@@ -8214,6 +8409,20 @@ function shouldSuppressQQBotTextWhenMediaPresent(rawText, sanitizedText) {
   if (!sanitizedText) return true;
   return !/[A-Za-z0-9\u4e00-\u9fff]/.test(sanitizedText);
 }
+function resolveQQBotNoReplyFallback(params) {
+  const { inbound, replyDelivered } = params;
+  if (replyDelivered) return void 0;
+  if (!inbound.mentionedBot) return void 0;
+  if (inbound.type !== "group" && inbound.type !== "channel") return void 0;
+  const hasVisibleInput = inbound.content.trim().length > 0 || (inbound.attachments?.length ?? 0) > 0;
+  if (!hasVisibleInput) return void 0;
+  return QQ_GROUP_NO_REPLY_FALLBACK_TEXT;
+}
+function isQQBotGroupMessageInterfaceBlocked(errorMessage) {
+  const text = (errorMessage ?? "").toLowerCase();
+  if (!text) return false;
+  return text.includes("304103") || text.includes("\u7FA4\u5185\u6D88\u606F\u63A5\u53E3\u88AB\u4E34\u65F6\u5C01\u7981") || text.includes("\u673A\u5668\u4EBA\u5B58\u5728\u5B89\u5168\u98CE\u9669");
+}
 function evaluateReplyFinalOnlyDelivery(params) {
   const { replyFinalOnly, kind, hasMedia } = params;
   if (!replyFinalOnly || !kind || kind === "final") {
@@ -8225,7 +8434,7 @@ function evaluateReplyFinalOnlyDelivery(params) {
   return { skipDelivery: true, suppressText: false };
 }
 async function sendQQBotMediaWithFallback(params) {
-  const { qqCfg, to, mediaQueue, replyToId, replyEventId, logger } = params;
+  const { qqCfg, to, mediaQueue, replyToId, replyEventId, logger, onDelivered, onError } = params;
   const outbound = params.outbound ?? qqbotOutbound;
   for (const mediaUrl of mediaQueue) {
     const result = await outbound.sendMedia({
@@ -8237,7 +8446,11 @@ async function sendQQBotMediaWithFallback(params) {
     });
     if (result.error) {
       logger.error(`sendMedia failed: ${result.error}`);
-      const fallback = buildMediaFallbackText(mediaUrl, result.error);
+      onError?.(result.error);
+      const fallback = buildMediaFallbackText(mediaUrl);
+      if (!fallback) {
+        continue;
+      }
       const fallbackResult = await outbound.sendText({
         cfg: { channels: { qqbot: qqCfg } },
         to,
@@ -8247,7 +8460,12 @@ async function sendQQBotMediaWithFallback(params) {
       });
       if (fallbackResult.error) {
         logger.error(`sendText fallback failed: ${fallbackResult.error}`);
+        onError?.(fallbackResult.error);
+      } else {
+        onDelivered?.();
       }
+    } else {
+      onDelivered?.();
     }
   }
 }
@@ -8312,237 +8530,319 @@ async function dispatchToAgent(params) {
     logger.warn("reply API not available");
     return;
   }
-  const sessionApi = runtime2.channel?.session;
-  const storePath = sessionApi?.resolveStorePath?.(
-    cfg?.session?.store,
-    { agentId: route.agentId }
-  );
-  const envelopeOptions = replyApi.resolveEnvelopeFormatOptions?.(cfg);
-  const previousTimestamp = storePath && sessionApi?.readSessionUpdatedAt ? sessionApi.readSessionUpdatedAt({ storePath, sessionKey: route.sessionKey }) : null;
-  const resolvedAttachmentResult = await resolveInboundAttachmentsForAgent({
-    attachments: inbound.attachments,
-    qqCfg,
-    logger
-  });
-  if (qqCfg.asr?.enabled && resolvedAttachmentResult.hasVoiceAttachment && !resolvedAttachmentResult.hasVoiceTranscript) {
-    const fallback = await qqbotOutbound.sendText({
-      cfg: { channels: { qqbot: qqCfg } },
-      to: target.to,
-      text: buildVoiceASRFallbackReply(resolvedAttachmentResult.asrErrorMessage),
-      replyToId: inbound.messageId,
-      replyEventId: inbound.eventId
-    });
-    if (fallback.error) {
-      logger.error(`sendText ASR fallback failed: ${fallback.error}`);
+  let replyDelivered = false;
+  let groupMessageInterfaceBlocked = false;
+  const markReplyDelivered = () => {
+    replyDelivered = true;
+    longTaskNotice.markReplyDelivered();
+  };
+  const markGroupMessageInterfaceBlocked = (error) => {
+    if (!isQQBotGroupMessageInterfaceBlocked(error)) return;
+    if (!groupMessageInterfaceBlocked) {
+      logger.warn("QQ group message interface is temporarily blocked by platform; suppressing extra sends");
     }
-    return;
-  }
-  const resolvedAttachments = resolvedAttachmentResult.attachments;
-  const localImageCount = resolvedAttachments.filter((item) => Boolean(item.localImagePath)).length;
-  if (localImageCount > 0) {
-    logger.info(`prepared ${localImageCount} local image attachment(s) for agent`);
-  }
-  const rawBody = buildInboundContentWithAttachments({
-    content: inbound.content,
-    attachments: resolvedAttachments
-  });
-  const envelopeFrom = resolveEnvelopeFrom(inbound);
-  const inboundBody = replyApi.formatInboundEnvelope ? replyApi.formatInboundEnvelope({
-    channel: "QQ",
-    from: envelopeFrom,
-    body: rawBody,
-    timestamp: inbound.timestamp,
-    previousTimestamp: previousTimestamp ?? void 0,
-    chatType: inbound.type === "direct" ? "direct" : "group",
-    senderLabel: inbound.senderName ?? inbound.senderId,
-    sender: { id: inbound.senderId, name: inbound.senderName ?? void 0 },
-    envelope: envelopeOptions
-  }) : replyApi.formatAgentEnvelope ? replyApi.formatAgentEnvelope({
-    channel: "QQ",
-    from: envelopeFrom,
-    timestamp: inbound.timestamp,
-    previousTimestamp: previousTimestamp ?? void 0,
-    envelope: envelopeOptions,
-    body: rawBody
-  }) : rawBody;
-  const inboundCtx = buildInboundContext({
-    event: inbound,
-    sessionKey: route.sessionKey,
-    accountId: route.accountId ?? accountId,
-    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;
-    }
-  }
-  if (storePath && sessionApi?.recordInboundSession) {
-    try {
-      const mainSessionKeyRaw = route?.mainSessionKey;
-      const mainSessionKey = typeof mainSessionKeyRaw === "string" && mainSessionKeyRaw.trim() ? mainSessionKeyRaw : 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
-      } : void 0;
-      const recordSessionKey = typeof finalCtx.SessionKey === "string" && finalCtx.SessionKey.trim() ? finalCtx.SessionKey : route.sessionKey;
-      await sessionApi.recordInboundSession({
-        storePath,
-        sessionKey: recordSessionKey,
-        ctx: finalCtx,
-        updateLastRoute,
-        onRecordError: (err) => {
-          logger.warn(`failed to record inbound session: ${String(err)}`);
-        }
+    groupMessageInterfaceBlocked = true;
+  };
+  const longTaskNotice = startLongTaskNoticeTimer({
+    delayMs: qqCfg.longTaskNoticeDelayMs ?? DEFAULT_LONG_TASK_NOTICE_DELAY_MS,
+    logger,
+    sendNotice: async () => {
+      if (groupMessageInterfaceBlocked) return;
+      const result = await qqbotOutbound.sendText({
+        cfg: { channels: { qqbot: qqCfg } },
+        to: target.to,
+        text: LONG_TASK_NOTICE_TEXT,
+        replyToId: inbound.messageId,
+        replyEventId: inbound.eventId
       });
-    } catch (err) {
-      logger.warn(`failed to record inbound session: ${String(err)}`);
+      if (result.error) {
+        logger.warn(`send long-task notice failed: ${result.error}`);
+        markGroupMessageInterfaceBlocked(result.error);
+      } else {
+        replyDelivered = true;
+      }
     }
-  }
-  const textApi = runtime2.channel?.text;
-  const limit = textApi?.resolveTextChunkLimit?.({
-    cfg,
-    channel: "qqbot",
-    defaultLimit: qqCfg.textChunkLimit ?? 1500
-  }) ?? (qqCfg.textChunkLimit ?? 1500);
-  const chunkMode = textApi?.resolveChunkMode?.(cfg, "qqbot");
-  const tableMode = textApi?.resolveMarkdownTableMode?.({
-    cfg,
-    channel: "qqbot",
-    accountId: route.accountId ?? accountId
   });
-  const resolvedTableMode = tableMode ?? "bullets";
-  const chunkText = (text) => {
-    if (textApi?.chunkMarkdownText && limit > 0) {
-      return textApi.chunkMarkdownText(text, limit);
+  const inboundMediaDir = resolveInboundMediaDir(qqCfg);
+  const inboundMediaKeepDays = resolveInboundMediaKeepDays(qqCfg);
+  try {
+    const sessionApi = runtime2.channel?.session;
+    const sessionConfig = cfg?.session;
+    const storePath = sessionApi?.resolveStorePath?.(
+      sessionConfig?.store,
+      { agentId: route.agentId }
+    );
+    const envelopeOptions = replyApi.resolveEnvelopeFormatOptions?.(cfg);
+    const previousTimestamp = storePath && sessionApi?.readSessionUpdatedAt ? sessionApi.readSessionUpdatedAt({ storePath, sessionKey: route.sessionKey }) : null;
+    const resolvedAttachmentResult = await resolveInboundAttachmentsForAgent({
+      attachments: inbound.attachments,
+      qqCfg,
+      logger
+    });
+    if (qqCfg.asr?.enabled && resolvedAttachmentResult.hasVoiceAttachment && !resolvedAttachmentResult.hasVoiceTranscript) {
+      const fallback = await qqbotOutbound.sendText({
+        cfg: { channels: { qqbot: qqCfg } },
+        to: target.to,
+        text: buildVoiceASRFallbackReply(resolvedAttachmentResult.asrErrorMessage),
+        replyToId: inbound.messageId,
+        replyEventId: inbound.eventId
+      });
+      if (fallback.error) {
+        logger.error(`sendText ASR fallback failed: ${fallback.error}`);
+        markGroupMessageInterfaceBlocked(fallback.error);
+      } else {
+        replyDelivered = true;
+      }
+      return;
     }
-    if (textApi?.chunkTextWithMode && limit > 0) {
-      return textApi.chunkTextWithMode(text, limit, chunkMode);
+    const resolvedAttachments = resolvedAttachmentResult.attachments;
+    const localImageCount = resolvedAttachments.filter((item) => Boolean(item.localImagePath)).length;
+    if (localImageCount > 0) {
+      logger.info(`prepared ${localImageCount} local image attachment(s) for agent`);
     }
-    return [text];
-  };
-  const replyFinalOnly = qqCfg.replyFinalOnly ?? false;
-  const deliver = async (payload, info) => {
-    const typed = payload;
-    const mediaLineResult = extractMediaLinesFromText({
-      text: typed?.text ?? "",
-      logger
+    const rawBody = buildInboundContentWithAttachments({
+      content: inbound.content,
+      attachments: resolvedAttachments
     });
-    const localMediaResult = extractLocalMediaFromText({
-      text: mediaLineResult.text,
-      logger
+    const envelopeFrom = resolveEnvelopeFrom(inbound);
+    const inboundBody = replyApi.formatInboundEnvelope ? replyApi.formatInboundEnvelope({
+      channel: "QQ",
+      from: envelopeFrom,
+      body: rawBody,
+      timestamp: inbound.timestamp,
+      previousTimestamp: previousTimestamp ?? void 0,
+      chatType: inbound.type === "direct" ? "direct" : "group",
+      senderLabel: inbound.senderName ?? inbound.senderId,
+      sender: { id: inbound.senderId, name: inbound.senderName ?? void 0 },
+      envelope: envelopeOptions
+    }) : replyApi.formatAgentEnvelope ? replyApi.formatAgentEnvelope({
+      channel: "QQ",
+      from: envelopeFrom,
+      timestamp: inbound.timestamp,
+      previousTimestamp: previousTimestamp ?? void 0,
+      envelope: envelopeOptions,
+      body: rawBody
+    }) : rawBody;
+    const inboundCtx = buildInboundContext({
+      event: inbound,
+      sessionKey: route.sessionKey,
+      accountId: route.accountId ?? accountId,
+      body: inboundBody,
+      rawBody,
+      commandBody: rawBody
     });
-    const cleanedText = sanitizeQQBotOutboundText(localMediaResult.text);
-    const payloadMediaUrls = Array.isArray(typed?.mediaUrls) ? typed?.mediaUrls : typed?.mediaUrl ? [typed.mediaUrl] : [];
-    const mediaQueue = [];
-    const seenMedia = /* @__PURE__ */ new Set();
-    const addMedia = (value) => {
-      const next = value?.trim();
-      if (!next) return;
-      if (seenMedia.has(next)) return;
-      seenMedia.add(next);
-      mediaQueue.push(next);
-    };
-    for (const url of payloadMediaUrls) addMedia(url);
-    for (const url of mediaLineResult.mediaUrls) addMedia(url);
-    for (const url of localMediaResult.mediaUrls) addMedia(url);
-    const deliveryDecision = evaluateReplyFinalOnlyDelivery({
-      replyFinalOnly,
-      kind: info?.kind,
-      hasMedia: mediaQueue.length > 0});
-    if (deliveryDecision.skipDelivery) return;
-    const suppressEchoText = mediaQueue.length > 0 && shouldSuppressQQBotTextWhenMediaPresent(localMediaResult.text, cleanedText);
-    const suppressText = deliveryDecision.suppressText || suppressEchoText;
-    const textToSend = suppressText ? "" : cleanedText;
-    if (textToSend) {
-      const converted = textApi?.convertMarkdownTables ? textApi.convertMarkdownTables(textToSend, resolvedTableMode) : textToSend;
-      const chunks = chunkText(converted);
-      for (const chunk of chunks) {
-        const result = await qqbotOutbound.sendText({
-          cfg: { channels: { qqbot: qqCfg } },
-          to: target.to,
-          text: chunk,
-          replyToId: inbound.messageId,
-          replyEventId: inbound.eventId
+    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;
+      }
+    }
+    if (storePath && sessionApi?.recordInboundSession) {
+      try {
+        const mainSessionKeyRaw = route?.mainSessionKey;
+        const mainSessionKey = typeof mainSessionKeyRaw === "string" && mainSessionKeyRaw.trim() ? mainSessionKeyRaw : 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
+        } : void 0;
+        const recordSessionKey = typeof finalCtx.SessionKey === "string" && finalCtx.SessionKey.trim() ? finalCtx.SessionKey : route.sessionKey;
+        await sessionApi.recordInboundSession({
+          storePath,
+          sessionKey: recordSessionKey,
+          ctx: finalCtx,
+          updateLastRoute,
+          onRecordError: (err) => {
+            logger.warn(`failed to record inbound session: ${String(err)}`);
+          }
         });
-        if (result.error) {
-          logger.error(`sendText failed: ${result.error}`);
-        }
+      } catch (err) {
+        logger.warn(`failed to record inbound session: ${String(err)}`);
       }
     }
-    await sendQQBotMediaWithFallback({
-      qqCfg,
-      to: target.to,
-      mediaQueue,
-      replyToId: inbound.messageId,
-      replyEventId: inbound.eventId,
-      logger
-    });
-  };
-  const humanDelay = replyApi.resolveHumanDelayConfig?.(cfg, route.agentId);
-  const dispatchBuffered = replyApi.dispatchReplyWithBufferedBlockDispatcher;
-  if (dispatchBuffered) {
-    await dispatchBuffered({
-      ctx: finalCtx,
+    const textApi = runtime2.channel?.text;
+    const limit = textApi?.resolveTextChunkLimit?.({
+      cfg,
+      channel: "qqbot",
+      defaultLimit: qqCfg.textChunkLimit ?? 1500
+    }) ?? (qqCfg.textChunkLimit ?? 1500);
+    const chunkMode = textApi?.resolveChunkMode?.(cfg, "qqbot");
+    const tableMode = textApi?.resolveMarkdownTableMode?.({
       cfg,
-      dispatcherOptions: {
+      channel: "qqbot",
+      accountId: route.accountId ?? accountId
+    });
+    const resolvedTableMode = tableMode ?? "bullets";
+    const chunkText = (text) => {
+      if (textApi?.chunkMarkdownText && limit > 0) {
+        return textApi.chunkMarkdownText(text, limit);
+      }
+      if (textApi?.chunkTextWithMode && limit > 0) {
+        return textApi.chunkTextWithMode(text, limit, chunkMode);
+      }
+      return [text];
+    };
+    const replyFinalOnly = qqCfg.replyFinalOnly ?? false;
+    const deliver = async (payload, info) => {
+      const typed = payload;
+      const mediaLineResult = extractMediaLinesFromText({
+        text: typed?.text ?? "",
+        logger
+      });
+      const localMediaResult = extractLocalMediaFromText({
+        text: mediaLineResult.text,
+        logger
+      });
+      const cleanedText = sanitizeQQBotOutboundText(localMediaResult.text);
+      const payloadMediaUrls = Array.isArray(typed?.mediaUrls) ? typed?.mediaUrls : typed?.mediaUrl ? [typed.mediaUrl] : [];
+      const mediaQueue = [];
+      const seenMedia = /* @__PURE__ */ new Set();
+      const addMedia = (value) => {
+        const next = value?.trim();
+        if (!next) return;
+        if (seenMedia.has(next)) return;
+        seenMedia.add(next);
+        mediaQueue.push(next);
+      };
+      for (const url of payloadMediaUrls) addMedia(url);
+      for (const url of mediaLineResult.mediaUrls) addMedia(url);
+      for (const url of localMediaResult.mediaUrls) addMedia(url);
+      const deliveryDecision = evaluateReplyFinalOnlyDelivery({
+        replyFinalOnly,
+        kind: info?.kind,
+        hasMedia: mediaQueue.length > 0,
+        sanitizedText: cleanedText
+      });
+      if (deliveryDecision.skipDelivery) return;
+      const suppressEchoText = mediaQueue.length > 0 && shouldSuppressQQBotTextWhenMediaPresent(localMediaResult.text, cleanedText);
+      const suppressText = deliveryDecision.suppressText || suppressEchoText;
+      const textToSend = suppressText ? "" : cleanedText;
+      if (textToSend) {
+        const converted = textApi?.convertMarkdownTables ? textApi.convertMarkdownTables(textToSend, resolvedTableMode) : textToSend;
+        const chunks = chunkText(converted);
+        for (const chunk of chunks) {
+          const result = await qqbotOutbound.sendText({
+            cfg: { channels: { qqbot: qqCfg } },
+            to: target.to,
+            text: chunk,
+            replyToId: inbound.messageId,
+            replyEventId: inbound.eventId
+          });
+          if (result.error) {
+            logger.error(`sendText failed: ${result.error}`);
+            markGroupMessageInterfaceBlocked(result.error);
+          } else {
+            markReplyDelivered();
+          }
+        }
+      }
+      await sendQQBotMediaWithFallback({
+        qqCfg,
+        to: target.to,
+        mediaQueue,
+        replyToId: inbound.messageId,
+        replyEventId: inbound.eventId,
+        logger,
+        onDelivered: () => {
+          markReplyDelivered();
+        },
+        onError: (error) => {
+          markGroupMessageInterfaceBlocked(error);
+        }
+      });
+    };
+    const humanDelay = replyApi.resolveHumanDelayConfig?.(cfg, route.agentId);
+    const dispatchBuffered = replyApi.dispatchReplyWithBufferedBlockDispatcher;
+    if (dispatchBuffered) {
+      await dispatchBuffered({
+        ctx: finalCtx,
+        cfg,
+        dispatcherOptions: {
+          deliver,
+          humanDelay,
+          onError: (err, info) => {
+            logger.error(`${info.kind} reply failed: ${String(err)}`);
+          },
+          onSkip: (_payload, info) => {
+            if (info.reason !== "silent") {
+              logger.info(`reply skipped: ${info.reason}`);
+            }
+          }
+        }
+      });
+    } else {
+      const dispatcherResult = replyApi.createReplyDispatcherWithTyping ? replyApi.createReplyDispatcherWithTyping({
         deliver,
         humanDelay,
         onError: (err, info) => {
           logger.error(`${info.kind} reply failed: ${String(err)}`);
-        },
-        onSkip: (_payload, info) => {
-          if (info.reason !== "silent") {
-            logger.info(`reply skipped: ${info.reason}`);
-          }
         }
+      }) : {
+        dispatcher: replyApi.createReplyDispatcher?.({
+          deliver,
+          humanDelay,
+          onError: (err, info) => {
+            logger.error(`${info.kind} reply failed: ${String(err)}`);
+          }
+        }),
+        replyOptions: {},
+        markDispatchIdle: () => void 0
+      };
+      if (!dispatcherResult.dispatcher || !replyApi.dispatchReplyFromConfig) {
+        logger.warn("dispatcher not available, skipping reply");
+        return;
       }
-    });
-    return;
-  }
-  const dispatcherResult = replyApi.createReplyDispatcherWithTyping ? replyApi.createReplyDispatcherWithTyping({
-    deliver,
-    humanDelay,
-    onError: (err, info) => {
-      logger.error(`${info.kind} reply failed: ${String(err)}`);
+      await replyApi.dispatchReplyFromConfig({
+        ctx: finalCtx,
+        cfg,
+        dispatcher: dispatcherResult.dispatcher,
+        replyOptions: dispatcherResult.replyOptions
+      });
+      dispatcherResult.markDispatchIdle?.();
     }
-  }) : {
-    dispatcher: replyApi.createReplyDispatcher?.({
-      deliver,
-      humanDelay,
-      onError: (err, info) => {
-        logger.error(`${info.kind} reply failed: ${String(err)}`);
+    const noReplyFallback = resolveQQBotNoReplyFallback({
+      inbound,
+      replyDelivered
+    });
+    if (noReplyFallback && !groupMessageInterfaceBlocked) {
+      logger.info("no visible reply generated for group mention; sending fallback text");
+      const fallbackResult = await qqbotOutbound.sendText({
+        cfg: { channels: { qqbot: qqCfg } },
+        to: target.to,
+        text: noReplyFallback,
+        replyToId: inbound.messageId,
+        replyEventId: inbound.eventId
+      });
+      if (fallbackResult.error) {
+        logger.error(`sendText no-reply fallback failed: ${fallbackResult.error}`);
+        markGroupMessageInterfaceBlocked(fallbackResult.error);
+      } else {
+        markReplyDelivered();
       }
-    }),
-    replyOptions: {},
-    markDispatchIdle: () => void 0
-  };
-  if (!dispatcherResult.dispatcher || !replyApi.dispatchReplyFromConfig) {
-    logger.warn("dispatcher not available, skipping reply");
-    return;
+    }
+  } finally {
+    longTaskNotice.dispose();
+    try {
+      await pruneInboundMediaDir({
+        inboundDir: inboundMediaDir,
+        keepDays: inboundMediaKeepDays
+      });
+    } catch (err) {
+      logger.warn(`failed to prune qqbot inbound media dir: ${String(err)}`);
+    }
   }
-  await replyApi.dispatchReplyFromConfig({
-    ctx: finalCtx,
-    cfg,
-    dispatcher: dispatcherResult.dispatcher,
-    replyOptions: dispatcherResult.replyOptions
-  });
-  dispatcherResult.markDispatchIdle?.();
 }
 function shouldHandleMessage(event, qqCfg, logger) {
   if (event.type === "direct") {
@@ -8676,7 +8976,7 @@ function cleanupSocket(conn) {
   }
 }
 async function monitorQQBotProvider(opts = {}) {
-  const { config, runtime: runtime2, abortSignal, accountId = DEFAULT_ACCOUNT_ID } = opts;
+  const { config, runtime: runtime2, abortSignal, accountId = DEFAULT_ACCOUNT_ID, setStatus } = opts;
   const logger = createLogger("qqbot", {
     log: runtime2?.log,
     error: runtime2?.error
@@ -8783,6 +9083,7 @@ async function monitorQQBotProvider(opts = {}) {
           return;
         }
         case 11:
+          setStatus?.({ lastEventAt: Date.now() });
           return;
         case 7:
           cleanupSocket(conn);
@@ -9008,8 +9309,17 @@ var qqbotPlugin = {
         historyLimit: { type: "integer", minimum: 0 },
         textChunkLimit: { type: "integer", minimum: 1 },
         replyFinalOnly: { type: "boolean" },
+        longTaskNoticeDelayMs: { type: "integer", minimum: 0 },
         maxFileSizeMB: { type: "number" },
         mediaTimeoutMs: { type: "number" },
+        inboundMedia: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            dir: { type: "string" },
+            keepDays: { type: "number", minimum: 0 }
+          }
+        },
         accounts: {
           type: "object",
           additionalProperties: {
@@ -9039,8 +9349,17 @@ var qqbotPlugin = {
               historyLimit: { type: "integer", minimum: 0 },
               textChunkLimit: { type: "integer", minimum: 1 },
               replyFinalOnly: { type: "boolean" },
+              longTaskNoticeDelayMs: { type: "integer", minimum: 0 },
               maxFileSizeMB: { type: "number" },
-              mediaTimeoutMs: { type: "number" }
+              mediaTimeoutMs: { type: "number" },
+              inboundMedia: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                  dir: { type: "string" },
+                  keepDays: { type: "number", minimum: 0 }
+                }
+              }
             }
           }
         }
@@ -9182,7 +9501,8 @@ var qqbotPlugin = {
           error: ctx.log?.error ?? console.error
         },
         abortSignal: ctx.abortSignal,
-        accountId: ctx.accountId
+        accountId: ctx.accountId,
+        setStatus: ctx.setStatus
       });
     },
     stopAccount: async (ctx) => {
@@ -9225,8 +9545,17 @@ var plugin = {
       historyLimit: { type: "integer", minimum: 0 },
       textChunkLimit: { type: "integer", minimum: 1 },
       replyFinalOnly: { type: "boolean" },
+      longTaskNoticeDelayMs: { type: "integer", minimum: 0 },
       maxFileSizeMB: { type: "number" },
       mediaTimeoutMs: { type: "number" },
+      inboundMedia: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          dir: { type: "string" },
+          keepDays: { type: "number", minimum: 0 }
+        }
+      },
       accounts: {
         type: "object",
         additionalProperties: {
@@ -9256,8 +9585,17 @@ var plugin = {
             historyLimit: { type: "integer", minimum: 0 },
             textChunkLimit: { type: "integer", minimum: 1 },
             replyFinalOnly: { type: "boolean" },
+            longTaskNoticeDelayMs: { type: "integer", minimum: 0 },
             maxFileSizeMB: { type: "number" },
-            mediaTimeoutMs: { type: "number" }
+            mediaTimeoutMs: { type: "number" },
+            inboundMedia: {
+              type: "object",
+              additionalProperties: false,
+              properties: {
+                dir: { type: "string" },
+                keepDays: { type: "number", minimum: 0 }
+              }
+            }
           }
         }
       }