@core-workspace/infoflow-openclaw-plugin 2026.3.9 → 2026.3.27-beta.0

package/src/handler/message-handler.ts

@@ -1,21 +1,32 @@
+import { mkdirSync, writeFileSync, readFileSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
 import {
   buildPendingHistoryContextFromMap,
   clearHistoryEntriesIfEnabled,
   DEFAULT_GROUP_HISTORY_LIMIT,
-  type HistoryEntry,
   recordPendingHistoryEntryIfEnabled,
-  buildAgentMediaPayload,
-} from "openclaw/plugin-sdk";
+} from "../compat/openclaw-sdk.js";
+import type { HistoryEntry } from "openclaw/plugin-sdk/reply-history";
+import { buildAgentMediaPayload } from "../compat/openclaw-sdk.js";
+import { createInfoflowReplyDispatcher } from "../adapter/outbound/reply-dispatcher.js";
 import { resolveInfoflowAccount } from "../channel/accounts.js";
+import { sendInfoflowMessage, queryASRResult, fetchGroupMemberList } from "../channel/outbound.js";
+import {
+  InfoflowStreamingCardSession,
+  normalizeStreamingFallbackFormat,
+} from "../channel/streaming.js";
 import { getInfoflowBotLog, formatInfoflowError, logVerbose } from "../logging.js";
-import { createInfoflowReplyDispatcher } from "../adapter/outbound/reply-dispatcher.js";
-import { sendInfoflowMessage } from "../channel/outbound.js";
 import { getInfoflowRuntime } from "../runtime.js";
+import { checkDmPolicy, checkGroupPolicy } from "../security/dm-policy.js";
 import {
   checkBotMentioned,
   checkWatchMentioned,
   checkWatchRegex,
   extractMentionIds,
+  getBotRobotidFromBody,
+  checkReplyToBot,
+  hasOtherMentions,
   recordGroupReply,
   isWithinFollowUpWindow,
   resolveGroupConfig,
@@ -23,23 +34,56 @@ import {
   buildWatchRegexPrompt,
   buildFollowUpPrompt,
   buildProactivePrompt,
-  type InfoflowBodyItem,
 } from "../security/group-policy.js";
-import { checkDmPolicy, checkGroupPolicy } from "../security/dm-policy.js";
 import type {
   InfoflowChatType,
+  InfoflowInboundBodyItem,
   InfoflowMessageEvent,
   InfoflowMentionIds,
   InfoflowReplyMode,
+  InfoflowGroupSessionMode,
   InfoflowGroupConfig,
+  InfoflowSender,
   HandleInfoflowMessageParams,
   HandlePrivateChatParams,
   HandleGroupChatParams,
-  ResolvedInfoflowAccount,
 } from "../types.js";
+import { descSender, type InfoflowMessageFormat } from "../types.js";
+import { decodeHdToWav } from "../utils/audio/g722/index.js";
+import { isCacheValid, updateGroupAgentCache } from "../utils/group-agent-cache.js";
 
 // Re-export types for external consumers
-export type { InfoflowChatType, InfoflowMessageEvent } from "../types.js";
+export type { InfoflowChatType, InfoflowMessageEvent, InfoflowSender } from "../types.js";
+
+function buildInfoflowCronTargetPrompt(params: { chatType: InfoflowChatType; to: string }): string {
+  const target = `infoflow:${params.to}`;
+  if (params.chatType === "group") {
+    return [
+      `当前会话来自如流群，当前群发送目标固定为 ${target}。`,
+      "如果你要创建定时消息、cron、system-event，必须优先使用 infoflow_cron 工具。",
+      `infoflow_cron 会自动绑定当前群 ${target}，并在有 FromUserId 时附带创建人信息。`,
+      `只有在你明确无法使用 infoflow_cron 时，才允许显式写 target=${target}。`,
+    ].join("");
+  }
+
+  return [
+    `当前会话来自如流单聊，发送目标为 ${target}。`,
+    "如果你要创建定时消息、cron、system-event，必须优先使用 infoflow_cron 工具。",
+    `infoflow_cron 会直接使用当前会话可信的 FromUserId，并绑定为 ${target}。`,
+  ].join("");
+}
+
+function appendInfoflowSystemPrompt(
+  existing: string | undefined,
+  extra: string | undefined,
+): string | undefined {
+  const next = extra?.trim();
+  if (!next) {
+    return existing;
+  }
+  const prev = existing?.trim();
+  return prev ? `${prev}\n\n---\n\n${next}` : next;
+}
 
 // ---------------------------------------------------------------------------
 // Group reply tracking (in-memory) for follow-up window
@@ -55,52 +99,86 @@ const chatHistories = new Map<string, HistoryEntry[]>();
 export async function handlePrivateChatMessage(params: HandlePrivateChatParams): Promise<void> {
   const { cfg, msgData, accountId, statusSink } = params;
 
-  // Extract sender and content from msgData (flexible field names)
-  const fromuser = String(msgData.FromUserId ?? msgData.fromuserid ?? msgData.from ?? "");
-  const mes = String(msgData.Content ?? msgData.content ?? msgData.text ?? msgData.mes ?? "");
+  logVerbose(`[infoflow:dm] raw private message:\n${JSON.stringify(msgData, null, 2)}`);
 
-  // Extract sender name (FromUserName is more human-readable than FromUserId)
+  // ---------------------------------------------------------------------------
+  // 1. Extract fields from msgData
+  // ---------------------------------------------------------------------------
+  const fromuser = String(msgData.FromUserId ?? msgData.fromuserid ?? msgData.from ?? "");
+  let mes = String(msgData.Content ?? msgData.content ?? msgData.text ?? msgData.mes ?? "");
   const senderName = String(msgData.FromUserName ?? msgData.username ?? fromuser);
+  const rawImid = msgData.FromId ?? msgData.fromid ?? msgData.imid ?? msgData.fromimid;
+  const imid = rawImid != null ? String(rawImid) : undefined;
+  // 构建私聊发送者：目前仅支持普通账户
+  const buildSender = (): InfoflowSender | undefined => {
+    if (!fromuser) return undefined;
+    return {
+      kind: "regular",
+      userid: fromuser,
+      name: senderName || undefined,
+      imid: imid,
+    };
+  };
+
+  const sender = buildSender();
+  if (!sender) {
+    getInfoflowBotLog().warn(`[inbound:dm] dropped: fromuser is empty`);
+    return;
+  }
 
   // Extract message ID for dedup tracking
   const messageId = msgData.MsgId ?? msgData.msgid ?? msgData.messageid;
   const messageIdStr = messageId != null ? String(messageId) : undefined;
 
+  // Extract secondary message ID for private reply (msgid2)
+  const rawMsgid2 = msgData.MsgId2 ?? msgData.msgid2;
+  const msgid2Str = rawMsgid2 != null ? String(rawMsgid2) : undefined;
+
   // Extract timestamp (CreateTime is in seconds, convert to milliseconds)
   const createTime = msgData.CreateTime ?? msgData.createtime;
   const timestamp = createTime != null ? Number(createTime) * 1000 : Date.now();
 
-  // Detect image messages: MsgType=image with PicUrl
   const msgType = String(msgData.MsgType ?? msgData.msgtype ?? "");
   const picUrl = String(msgData.PicUrl ?? msgData.picurl ?? "");
+  const voiceUrl = String(msgData.VoiceUrl ?? msgData.voiceUrl ?? "");
+  const fromPlatform = String(msgData.FromPlatform ?? msgData.fromPlatform ?? "");
+  const agentId = String(msgData.agentId ?? "");
+  const openCode = String(msgData.OpenCode ?? msgData.openCode ?? "");
+
+  // Image handling
   const imageUrls: string[] = [];
   if (msgType === "image" && picUrl.trim()) {
     imageUrls.push(picUrl.trim());
   }
 
-  logVerbose(
-    `[infoflow] private chat: fromuser=${fromuser}, senderName=${senderName}, mes=${mes}, msgType=${msgType}, raw msgData: ${JSON.stringify(msgData)}`,
+  getInfoflowBotLog().info(
+    `[inbound:dm] from=${fromuser}, name=${senderName}, msgType=${msgType}, msgId=${messageIdStr ?? "?"}, text=${mes.slice(0, 80)}${mes.length > 80 ? "..." : ""}, images=${imageUrls.length}${msgType === "voice" ? `, voice=true` : ""}`,
   );
 
-  logVerbose(
-    `[DEBUG private] content字段诊断: Content=${JSON.stringify(msgData.Content)}, content=${JSON.stringify(msgData.content)}, mes=${JSON.stringify(msgData.mes)}, MsgType=${JSON.stringify(msgData.MsgType)}, msgtype=${JSON.stringify(msgData.msgtype)}, PicUrl=${JSON.stringify(msgData.PicUrl)}, picurl=${JSON.stringify(msgData.picurl)}, imageUrls=${JSON.stringify(imageUrls)}`,
-  );
-
-  if (!fromuser || (!mes.trim() && imageUrls.length === 0)) {
+  if (!fromuser || (!mes.trim() && imageUrls.length === 0 && msgType !== "voice")) {
+    getInfoflowBotLog().warn(
+      `[inbound:dm] dropped: fromuser=${fromuser || "(empty)"}, mes_empty=${!mes.trim()}, images=${imageUrls.length}`,
+    );
     return;
   }
 
-  // Check dmPolicy: send a hint when user is not authorized
+  // ---------------------------------------------------------------------------
+  // 3. dmPolicy check (before any network calls)
+  // ---------------------------------------------------------------------------
   const account = resolveInfoflowAccount({ cfg, accountId });
   const dmResult = checkDmPolicy(account, fromuser);
   if (!dmResult.allowed) {
-    logVerbose(`[infoflow] private message rejected: dmPolicy=allowlist, fromuser=${fromuser}`);
+    getInfoflowBotLog().warn(
+      `[inbound:dm] rejected: dmPolicy=${account.config.dmPolicy ?? "allowlist"}, fromuser=${fromuser}`,
+    );
     sendInfoflowMessage({
       cfg,
       to: fromuser,
       contents: [{ type: "text", content: "🚫 抱歉，您暂无使用权限，请联系龙虾主开通～" }],
       accountId: account.accountId,
-    }).catch(() => { /* ignore send errors */ });
+    }).catch(() => {
+      /* ignore send errors */
+    });
     return;
   }
   if ("note" in dmResult && dmResult.note === "pairing") {
@@ -108,7 +186,89 @@ export async function handlePrivateChatMessage(params: HandlePrivateChatParams):
     logVerbose(`[infoflow] private message: dmPolicy=pairing, fromuser=${fromuser}`);
   }
 
-  // For image-only messages (no text), use placeholder
+  // ---------------------------------------------------------------------------
+  // 4. Voice handling: Content empty → .mp3 download or .hd ASR
+  // ---------------------------------------------------------------------------
+  const isVoiceMp3 = msgType === "voice" && voiceUrl.includes(".mp3");
+  let localWavPath: string | undefined;
+  if (msgType === "voice" && !mes.trim() && voiceUrl) {
+    if (isVoiceMp3) {
+      // mp3 语音文件：由 handleInfoflowMessage 下载到本地，路径传给 openclaw
+      mes = "[语音消息]";
+    } else {
+      // .hd 等格式：通过 VoiceUrl MD5 调用 ASR 获取识别文本
+      const md5 = extractMd5FromVoiceUrl(voiceUrl);
+      if (md5) {
+        const asrResult = await queryASRResult({ account, md5 });
+        if (asrResult.ok && asrResult.content) {
+          mes = asrResult.content;
+          getInfoflowBotLog().info(
+            `[inbound:dm] voice ASR success: md5=${md5}, text=${mes.slice(0, 80)}`,
+          );
+        } else {
+          getInfoflowBotLog().info(
+            `[inbound:dm] voice ASR failed: md5=${md5}, error=${asrResult.error ?? "empty"}`,
+          );
+          if (asrResult.error?.includes("plat.clientError, 非法的企业机器人")) {
+            sendInfoflowMessage({
+              cfg,
+              to: fromuser,
+              contents: [
+                {
+                  type: "text",
+                  content:
+                    "当前机器人暂不支持语音转文本，为了更好的体验，可联系管理员在企业管理后台，应用中心-设置-开放API开启[单聊语音消息转文本]权限",
+                },
+              ],
+              accountId: account.accountId,
+            }).catch(() => {});
+          }
+          // ASR 失败回退：下载 .hd → decodeHdToWav → .wav 交给 openclaw 处理
+          try {
+            const voiceTmpDir = join(homedir(), ".openclaw", "tmp", "voice");
+            mkdirSync(voiceTmpDir, { recursive: true });
+            const hdPath = join(voiceTmpDir, `${md5}.hd`);
+            const wavPath = join(voiceTmpDir, `${md5}.wav`);
+            const hdRes = await fetch(voiceUrl);
+            if (!hdRes.ok) throw new Error(`download hd failed: status=${hdRes.status}`);
+            writeFileSync(hdPath, Buffer.from(await hdRes.arrayBuffer()));
+            const decodeResult = decodeHdToWav(hdPath, wavPath);
+            try {
+              unlinkSync(hdPath);
+            } catch {
+              /* ignore */
+            }
+            if (decodeResult) {
+              mes = "[语音消息]";
+              localWavPath = wavPath;
+              getInfoflowBotLog().info(
+                `[inbound:dm] voice hd→wav ok: md5=${md5}, duration=${decodeResult.duration.toFixed(1)}s, path=${wavPath}`,
+              );
+            } else {
+              getInfoflowBotLog().info(`[inbound:dm] voice hd→wav decode failed: md5=${md5}`);
+            }
+          } catch (err) {
+            getInfoflowBotLog().info(
+              `[inbound:dm] voice hd download/decode error: md5=${md5}, ${formatInfoflowError(err)}`,
+            );
+          }
+        }
+      } else {
+        getInfoflowBotLog().info(
+          `[inbound:dm] voice: cannot extract MD5 from VoiceUrl=${voiceUrl.slice(0, 80)}`,
+        );
+      }
+    }
+  }
+
+  // After ASR, if still no content (and not mp3 voice), drop the message
+  if (!mes.trim() && imageUrls.length === 0) {
+    return;
+  }
+
+  // ---------------------------------------------------------------------------
+  // 5. Build effective message and dispatch
+  // ---------------------------------------------------------------------------
   let effectiveMes = mes.trim();
   if (!effectiveMes && imageUrls.length > 0) {
     effectiveMes = "<media:image>";
@@ -118,13 +278,18 @@ export async function handlePrivateChatMessage(params: HandlePrivateChatParams):
   await handleInfoflowMessage({
     cfg,
     event: {
-      fromuser,
+      sender,
       mes: effectiveMes,
       chatType: "direct",
-      senderName,
       messageId: messageIdStr,
+      msgid2: msgid2Str,
       timestamp,
       imageUrls: imageUrls.length > 0 ? imageUrls : undefined,
+      voiceUrl: msgType === "voice" && voiceUrl ? voiceUrl : undefined,
+      localVoicePath: localWavPath,
+      fromPlatform: fromPlatform || undefined,
+      agentId: agentId || undefined,
+      openCode: openCode || undefined,
     },
     accountId,
     statusSink,
@@ -142,12 +307,17 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   const header = (msgData.message as Record<string, unknown>)?.header as
     | Record<string, unknown>
     | undefined;
-  const fromuser = String(header?.fromuserid ?? msgData.fromuserid ?? msgData.from ?? "");
+  const rawFromuser = String(header?.fromuserid ?? msgData.fromuserid ?? msgData.from ?? "");
 
   // Extract sender's imid (数字ID) - the numeric user ID is in msgData.fromid
-  const senderImid = msgData.fromid ?? header?.imid ?? header?.fromimid ?? msgData.imid ?? msgData.fromimid;
+  const senderImid =
+    msgData.fromid ?? header?.imid ?? header?.fromimid ?? msgData.imid ?? msgData.fromimid;
   const senderImidStr = senderImid != null ? String(senderImid) : undefined;
 
+  // 机器人发送者在 ALL_MESSAGE_FORWARD 中通常没有 fromuserid，
+  // 用 senderImidStr（数字 robot ID）作为兜底，加 "bot:" 前缀避免与人类用户 ID 碰撞
+  const senderIsBot = !rawFromuser && !!senderImidStr;
+
   // Extract message ID (priority: header.messageid > header.msgid > MsgId)
   const messageId = header?.messageid ?? header?.msgid ?? msgData.MsgId;
   const messageIdStr = messageId != null ? String(messageId) : undefined;
@@ -161,42 +331,63 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   const timestamp = rawTime != null ? Number(rawTime) : Date.now();
 
   // Debug: 打印完整的原始消息数据
-  logVerbose(`[DEBUG bot.groupchat] 完整 msgData: ${JSON.stringify(msgData, null, 2)}`);
-  logVerbose(`[DEBUG bot.groupchat] 完整 header: ${JSON.stringify(header, null, 2)}`);
-
-  // Debug: 输出所有可能的 ID 字段
-  logVerbose(`[DEBUG bot.groupchat] 查找 imid (期望值: 102752365):`);
-  logVerbose(`  - header.imid: ${header?.imid}`);
-  logVerbose(`  - header.fromimid: ${header?.fromimid}`);
-  logVerbose(`  - header.fromuserid: ${header?.fromuserid}`);
-  logVerbose(`  - msgData.imid: ${msgData.imid}`);
-  logVerbose(`  - msgData.fromimid: ${msgData.fromimid}`);
-  logVerbose(`  - msgData.fromuserid: ${msgData.fromuserid}`);
-  logVerbose(`  - msgData.from: ${msgData.from}`);
-  logVerbose(`  - msgData.userid: ${msgData.userid}`);
-  logVerbose(`  - fromuser: ${fromuser}`);
-  logVerbose(`  - senderImidStr: ${senderImidStr}`);
-
-  if (!fromuser) {
+  logVerbose(`[inbound:group:raw] msgData: ${JSON.stringify(msgData, null, 2)}`);
+
+  // 构建群聊发送者（含 name）：机器人 agentid 暂无处取值（不填），imid 保持不变；普通用户用 rawFromuser 作为 userid
+  const buildSender = (): InfoflowSender | undefined => {
+    const name = String(
+      header?.username ?? header?.nickname ?? msgData.username ?? (rawFromuser || senderImidStr),
+    );
+    if (senderIsBot) {
+      return senderImidStr ? { kind: "robot", imid: senderImidStr, name } : undefined;
+    }
+    return rawFromuser
+      ? { kind: "regular", userid: rawFromuser, imid: senderImidStr, name }
+      : undefined;
+  };
+
+  const sender = buildSender();
+  if (!sender) {
+    getInfoflowBotLog().warn(
+      `[inbound:group] dropped: fromuser and senderImidStr both empty, groupId=${groupid}`,
+    );
     return;
   }
 
   // Extract message content from body array or flat content field
   const message = msgData.message as Record<string, unknown> | undefined;
-  const bodyItems = (message?.body ?? msgData.body ?? []) as InfoflowBodyItem[];
+  const bodyItems = (message?.body ?? msgData.body ?? []) as InfoflowInboundBodyItem[];
 
   // Resolve account to get robotName for mention detection
   const account = resolveInfoflowAccount({ cfg, accountId });
   const robotName = account.config.robotName;
 
   // Check groupPolicy allowlist
-  const wasMentionedEarly = checkBotMentioned(bodyItems, robotName);
+  // wasMentioned 判断优先级：
+  // 1. ws-receiver 已注入 msgData.wasMentioned 时优先使用
+  // 2. webhook 模式下：
+  //    - MESSAGE_RECEIVE: 明确 @机器人 事件
+  //    - ALL_MESSAGE_FORWARD: 全量消息，需要回退到 body AT 检测
+  // 3. 兜底：body 里 AT 元素（robotid 或 robotName）判定
+  const rawEventType = String(msgData.eventtype ?? "");
+  const wasMentionedEarly =
+    msgData.wasMentioned === true
+      ? true
+      : rawEventType === "ALL_MESSAGE_FORWARD"
+        ? checkBotMentioned(bodyItems, account.config)
+        : rawEventType === "MESSAGE_RECEIVE"
+          ? true // 明确的 @机器人 事件
+          : checkBotMentioned(bodyItems, account.config);
   const groupPolicyResult = checkGroupPolicy(account, groupid, wasMentionedEarly);
   if (!groupPolicyResult.allowed) {
     if (groupPolicyResult.reason === "disabled") {
-      logVerbose(`[infoflow] group message rejected: groupPolicy=disabled`);
+      getInfoflowBotLog().warn(
+        `[inbound:group] rejected: groupPolicy=disabled, groupId=${groupid}`,
+      );
     } else {
-      logVerbose(`[infoflow] group message rejected: group=${groupPolicyResult.groupIdStr} not in groupAllowFrom`);
+      getInfoflowBotLog().warn(
+        `[inbound:group] rejected: groupPolicy=allowlist, group=${groupPolicyResult.groupIdStr} not in groupAllowFrom`,
+      );
       // 发送无权限提示，仅当消息是 @机器人 时才回复，避免在无关群里刷屏
       if (groupPolicyResult.wasMentioned && groupPolicyResult.groupIdStr) {
         sendInfoflowMessage({
@@ -204,7 +395,9 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
           to: `group:${groupPolicyResult.groupIdStr}`,
           contents: [{ type: "text", content: "🚫 抱歉，该群暂无使用权限，请联系龙虾主开通～" }],
           accountId: account.accountId,
-        }).catch(() => { /* ignore send errors */ });
+        }).catch(() => {
+          /* ignore send errors */
+        });
       }
     }
     return;
@@ -213,12 +406,67 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   // Check if bot was @mentioned (by robotName)
   const wasMentioned = wasMentionedEarly;
 
+  // --- robotId auto-discovery + self-message ignore ---
+  let effectiveRobotId = account.config.robotId;
+  if (wasMentioned) {
+    const discoveredRobotId = getBotRobotidFromBody(bodyItems, robotName, effectiveRobotId);
+    if (discoveredRobotId && discoveredRobotId !== effectiveRobotId) {
+      effectiveRobotId = discoveredRobotId;
+      // Persist discovered robotId to config (fire-and-forget)
+      try {
+        const runtime = getInfoflowRuntime();
+        const currentCfg = runtime.config.loadConfig();
+        const section = (currentCfg.channels?.["infoflow"] ?? {}) as Record<string, unknown>;
+        const accounts = (section.accounts ?? {}) as Record<string, Record<string, unknown>>;
+        // When `accounts` block exists (multi-account mode), only write to the matching account entry;
+        // when no `accounts` block exists (single-account / legacy mode), write to the channel root.
+        const acctCfg: Record<string, unknown> | undefined =
+          accounts[accountId] ?? (!section.accounts ? section : undefined);
+        if (!acctCfg) {
+          logVerbose(
+            `[infoflow:bot] cannot persist robotId: accountId=${accountId} not found in config accounts`,
+          );
+        } else {
+          acctCfg.robotId = discoveredRobotId;
+          runtime.config.writeConfigFile(currentCfg);
+          logVerbose(
+            `[infoflow:bot] robotId auto-discovered: ${discoveredRobotId} for account=${accountId}`,
+          );
+        }
+      } catch (err) {
+        logVerbose(`[infoflow:bot] failed to persist robotId: ${formatInfoflowError(err)}`);
+      }
+    }
+  }
+  // Ignore own messages: if fromid matches the bot's robotId
+  const fromid = msgData.fromid ?? header?.fromid;
+  if (effectiveRobotId && fromid != null && String(fromid) === effectiveRobotId) {
+    logVerbose(
+      `[infoflow:bot] ignoring own message: fromid=${fromid}, robotId=${effectiveRobotId}`,
+    );
+    return;
+  }
+
   // Extract non-bot mention IDs (userIds + agentIds) for LLM-driven @mentions
-  const mentionIds = extractMentionIds(bodyItems, robotName);
+  const mentionIds = extractMentionIds(bodyItems, robotName, effectiveRobotId);
+
+  // Preload group agent name→agentId cache (skip if cache is still valid)
+  if (groupid !== undefined && !isCacheValid(groupid)) {
+    try {
+      const memberResult = await fetchGroupMemberList({ account, groupId: groupid });
+      if (memberResult.ok && memberResult.agents) {
+        updateGroupAgentCache(groupid, memberResult.agents);
+      }
+    } catch (err) {
+      logVerbose(`[inbound:group] group agent cache preload failed: ${formatInfoflowError(err)}`);
+    }
+  }
 
-  // Build two versions: mes (for CommandBody, no @xxx) and rawMes (for RawBody, with @xxx)
+  // Build three versions: mes (CommandBody, no @xxx), rawMes (RawBody, with @xxx),
+  // agentVisibleText (for LLM, with @name (robotid:N))
   let textContent = "";
   let rawTextContent = "";
+  let agentVisibleText = "";
   const replyContextItems: string[] = [];
   const imageUrls: string[] = [];
   if (Array.isArray(bodyItems)) {
@@ -232,43 +480,57 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
       } else if (item.type === "TEXT") {
         textContent += item.content ?? "";
         rawTextContent += item.content ?? "";
+        agentVisibleText += item.content ?? "";
       } else if (item.type === "LINK") {
         const label = item.label ?? "";
         if (label) {
           textContent += ` ${label} `;
           rawTextContent += ` ${label} `;
+          agentVisibleText += ` ${label} `;
         }
       } else if (item.type === "AT") {
-        // AT elements only go into rawTextContent, not textContent
         const name = item.name ?? "";
         if (name) {
-          rawTextContent += `@${name} `;
+          const atLabel =
+            item.robotid != null
+              ? `@${name}(robotid:${item.robotid}) `
+              : `@${name}(userid:${item.userid}) `;
+          textContent += atLabel;
+          rawTextContent += atLabel;
+          agentVisibleText += atLabel;
         }
       } else if (item.type === "IMAGE") {
         // 提取图片下载地址
-        logVerbose(`[DEBUG bot.groupchat] IMAGE item: ${JSON.stringify(item, null, 2)}`);
         const url = item.downloadurl;
         if (typeof url === "string" && url.trim()) {
-          logVerbose(`[DEBUG bot.groupchat] 提取到图片URL: ${url}`);
           imageUrls.push(url.trim());
-        } else {
-          logVerbose(`[DEBUG bot.groupchat] WARNING: IMAGE item 缺少有效的 downloadurl 字段`);
         }
+      } else if (item.type === "MD") {
+        // Markdown 消息（机器人等场景），提取文本内容
+        textContent += item.content ?? "";
+        rawTextContent += item.content ?? "";
+        agentVisibleText += item.content ?? "";
       }
     }
   }
 
   let mes = textContent.trim() || String(msgData.content ?? msgData.text ?? "");
   const rawMes = rawTextContent.trim() || mes;
+  const bodyForAgent = agentVisibleText.trim() || rawMes || mes;
 
   const replyContext = replyContextItems.length > 0 ? replyContextItems : undefined;
 
+  // Check if this message is a quoted reply to one of the bot's own previously sent messages
+  const isReplyToBot = replyContext ? checkReplyToBot(bodyItems, accountId) : false;
+
   if (!mes && !replyContext && imageUrls.length === 0) {
+    getInfoflowBotLog().warn(
+      `[inbound:group] dropped: empty body, sender=${descSender(sender)}, groupId=${groupid}`,
+    );
     return;
   }
   // 纯图片消息：设置占位符
   if (!mes && imageUrls.length > 0) {
-    logVerbose(`[DEBUG bot.groupchat] 纯图片消息: ${imageUrls.length} 张图片`);
     mes = `<media:image>${imageUrls.length > 1 ? ` (${imageUrls.length} images)` : ""}`;
   }
   // If mes is empty but replyContext exists, use a placeholder so the message is not dropped
@@ -276,19 +538,19 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
     mes = "(引用回复)";
   }
 
-  // Extract sender name from header or fallback to fromuser
-  const senderName = String(header?.username ?? header?.nickname ?? msgData.username ?? fromuser);
+  logVerbose(
+    `[inbound:group] ${descSender(sender)}, group=${groupid}, msgId=${messageIdStr ?? "?"}, mentioned=${wasMentioned}, text=${mes.slice(0, 80)}${mes.length > 80 ? "..." : ""}, images=${imageUrls.length}, reply=${replyContextItems.length > 0}`,
+  );
 
   // Delegate to the common message handler (group chat)
   await handleInfoflowMessage({
     cfg,
     event: {
-      fromuser,
+      sender,
       mes,
       rawMes,
       chatType: "group",
       groupId: groupid,
-      senderName,
       wasMentioned,
       messageId: messageIdStr,
       timestamp,
@@ -297,7 +559,8 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
         mentionIds.userIds.length > 0 || mentionIds.agentIds.length > 0 ? mentionIds : undefined,
       replyContext,
       imageUrls: imageUrls.length > 0 ? imageUrls : undefined,
-      senderImid: senderImidStr,  // 传递发送者的 imid
+      bodyForAgent,
+      isReplyToBot: isReplyToBot || undefined,
     },
     accountId,
     statusSink,
@@ -310,23 +573,43 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
  */
 export async function handleInfoflowMessage(params: HandleInfoflowMessageParams): Promise<void> {
   const { cfg, event, accountId, statusSink } = params;
-  const { fromuser, mes, chatType, groupId, senderName } = event;
+  const { sender, mes, chatType, groupId } = event;
+  const senderDesc = descSender(sender);
+  const senderImid = sender.imid;
+  // 带类型前缀的发送者标识，用于历史记录条目
+  const senderTag = sender.kind === "regular" ? `reg:${sender.userid}` : `bot:${sender.imid}`;
+  const bodyForAgent = event.bodyForAgent ?? mes;
 
   const account = resolveInfoflowAccount({ cfg, accountId });
   const core = getInfoflowRuntime();
 
   const isGroup = chatType === "group";
-  // Convert groupId (number) to string for peerId since routing expects string
-  const peerId = isGroup ? (groupId !== undefined ? String(groupId) : fromuser) : fromuser;
 
-  // Resolve per-group config for replyMode gating
+  // Resolve per-group config for replyMode gating (needed for groupSessionMode)
   const groupCfg = isGroup ? resolveGroupConfig(account, groupId) : undefined;
 
   // "ignore" mode: discard immediately, no save, no think, no reply
   if (isGroup && groupCfg?.replyMode === "ignore") {
+    logVerbose(`[inbound:group] dropped: replyMode=ignore, ${senderDesc}, groupId=${groupId}`);
     return;
   }
 
+  // Determine group session mode for peerId generation (group config overrides account config)
+  const groupSessionMode = isGroup ? groupCfg!.groupSessionMode : "group";
+  // 会话路由 peerId：
+  // 群聊 user 模式：groupId:{groupId};{userid || imid}，按用户分会话
+  // 群聊 group 模式：groupId
+  // 群聊无 groupId（兜底）：userid || imid
+  // 私聊：userid || imid
+  const senderId = sender.kind === "regular" ? sender.userid : (sender.imid ?? "");
+  const peerId = isGroup
+    ? groupId !== undefined
+      ? groupSessionMode === "user"
+        ? `groupId:${groupId};${senderId}`
+        : String(groupId)
+      : senderId
+    : senderId;
+
   // Resolve route based on chat type
   const route = core.channel.routing.resolveAgentRoute({
     cfg,
@@ -347,10 +630,20 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     sessionKey: route.sessionKey,
   });
 
-  // Build conversation label and from address based on chat type
-  const fromLabel = isGroup ? `group:${groupId}` : senderName || fromuser;
-  const fromAddress = isGroup ? `infoflow:group:${groupId}` : `infoflow:${fromuser}`;
-  const toAddress = isGroup ? `infoflow:group:${groupId}` : `infoflow:${fromuser}`;
+  // 构建会话标签：
+  // 私聊 regular：优先 userid，fallback name，兜底"未知"
+  // 私聊 robot：优先 name，fallback imid，兜底"未知"
+  // 群聊 regular：group:{groupId}:{userid || imid}
+  // 群聊 robot：group:{groupId}:{name || imid}
+  const fromLabel = isGroup
+    ? sender.kind === "regular"
+      ? `group:${groupId}:${sender.userid || sender.imid}`
+      : `group:${groupId}:${sender.name || sender.imid}`
+    : sender.kind === "regular"
+      ? sender.userid || sender.name || "未知"
+      : sender.name || sender.imid || "未知";
+  const fromAddress = isGroup ? `infoflow:group:${groupId}` : `infoflow:${senderId}`;
+  const toAddress = isGroup ? `infoflow:group:${groupId}` : `infoflow:${senderId}`;
 
   const body = core.channel.reply.formatAgentEnvelope({
     channel: "Infoflow",
@@ -358,7 +651,7 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     timestamp: Date.now(),
     previousTimestamp,
     envelope: envelopeOptions,
-    body: mes,
+    body: bodyForAgent,
   });
 
   // Inject accumulated group chat history into the body for context
@@ -395,9 +688,8 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   const mediaList: Array<{ path: string; contentType?: string }> = [];
   const failReasons: string[] = [];
 
-  logVerbose(`[DEBUG bot] 图片处理开始: imageUrls数量=${event.imageUrls?.length ?? 0}`);
+  logVerbose(`[inbound] 图片处理: urls=${event.imageUrls?.length ?? 0}`);
   if (event.imageUrls && event.imageUrls.length > 0) {
-    logVerbose(`[DEBUG bot] 待下载图片URLs: ${JSON.stringify(event.imageUrls)}`);
     // Collect unique hostnames from image URLs for SSRF allowlist.
     // Infoflow image servers (e.g. xp2.im.baidu.com, e4hi.im.baidu.com) resolve to
     // internal IPs on Baidu's network, so they need to be explicitly allowed.
@@ -417,38 +709,88 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     const urls = event.imageUrls.slice(0, INFOFLOW_MAX_IMAGES);
     const results = await Promise.allSettled(
       urls.map(async (imageUrl) => {
-        logVerbose(`[DEBUG bot] 开始下载图片: ${imageUrl}`);
         const fetched = await core.channel.media.fetchRemoteMedia({
           url: imageUrl,
           maxBytes: mediaMaxBytes,
           ssrfPolicy,
         });
-        logVerbose(`[DEBUG bot] 图片下载成功: size=${fetched.buffer.length}, contentType=${fetched.contentType}`);
         const saved = await core.channel.media.saveMediaBuffer(
           fetched.buffer,
           fetched.contentType ?? undefined,
           "inbound",
           mediaMaxBytes,
         );
-        logVerbose(`[infoflow] downloaded image from ${imageUrl}, saved to ${saved.path}`);
-        logVerbose(`[DEBUG bot] 图片保存成功: path=${saved.path}`);
+        logVerbose(
+          `[inbound] image downloaded: url=${imageUrl}, size=${fetched.buffer.length}, saved=${saved.path}`,
+        );
         return { path: saved.path, contentType: saved.contentType ?? fetched.contentType };
       }),
     );
     for (const result of results) {
       if (result.status === "fulfilled") {
         mediaList.push(result.value);
-        logVerbose(`[DEBUG bot] 图片处理成功: ${result.value.path}`);
       } else {
         const reason = String(result.reason);
-        logVerbose(`[infoflow] failed to download image: ${reason}`);
-        logVerbose(`[DEBUG bot] 图片下载失败: ${reason}`);
+        logVerbose(`[inbound] image download failed: ${reason}`);
         failReasons.push(reason);
       }
     }
   }
 
-  logVerbose(`[DEBUG bot] 图片处理完成: 成功=${mediaList.length}, 失败=${failReasons.length}`);
+  logVerbose(`[inbound] 图片处理完成: ok=${mediaList.length}, fail=${failReasons.length}`);
+
+  // --- Resolve inbound media (voice mp3) ---
+  if (event.voiceUrl && event.voiceUrl.includes(".mp3")) {
+    try {
+      const voiceHostname = new URL(event.voiceUrl).hostname;
+      const ssrfPolicy = voiceHostname ? { allowedHostnames: [voiceHostname] } : undefined;
+      const fetched = await core.channel.media.fetchRemoteMedia({
+        url: event.voiceUrl,
+        maxBytes: mediaMaxBytes,
+        ssrfPolicy,
+      });
+      const saved = await core.channel.media.saveMediaBuffer(
+        fetched.buffer,
+        fetched.contentType ?? "audio/mpeg",
+        "inbound",
+        mediaMaxBytes,
+      );
+      mediaList.push({ path: saved.path, contentType: saved.contentType ?? "audio/mpeg" });
+      logVerbose(
+        `[inbound] voice mp3 downloaded: url=${event.voiceUrl}, size=${fetched.buffer.length}, saved=${saved.path}`,
+      );
+    } catch (err) {
+      const reason = formatInfoflowError(err);
+      logVerbose(`[inbound] voice mp3 download failed: ${reason}`);
+      failReasons.push(reason);
+    }
+  }
+
+  // --- Resolve inbound media (voice wav from hd→wav conversion) ---
+  if (event.localVoicePath) {
+    try {
+      const wavBuffer = readFileSync(event.localVoicePath);
+      const saved = await core.channel.media.saveMediaBuffer(
+        wavBuffer,
+        "audio/wav",
+        "inbound",
+        mediaMaxBytes,
+      );
+      mediaList.push({ path: saved.path, contentType: saved.contentType ?? "audio/wav" });
+      logVerbose(
+        `[inbound] voice wav loaded: path=${event.localVoicePath}, size=${wavBuffer.length}, saved=${saved.path}`,
+      );
+      try {
+        unlinkSync(event.localVoicePath);
+      } catch {
+        /* ignore */
+      }
+    } catch (err) {
+      const reason = formatInfoflowError(err);
+      logVerbose(`[inbound] voice wav load failed: ${reason}`);
+      failReasons.push(reason);
+    }
+  }
 
   const mediaPayload = buildAgentMediaPayload(mediaList);
 
@@ -489,8 +831,8 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     ChatType: chatType,
     ConversationLabel: fromLabel,
     GroupSubject: isGroup ? `group:${groupId}` : undefined,
-    SenderName: senderName || fromuser,
-    SenderId: fromuser,
+    SenderName: sender.name,
+    SenderId: sender.kind === "regular" ? sender.userid : sender.imid,
     Provider: "infoflow",
     Surface: "infoflow",
     MessageSid: event.messageId ?? `${Date.now()}`,
@@ -521,50 +863,84 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   let triggerReason = "direct-message";
   if (isGroup && groupCfg) {
     const { replyMode } = groupCfg;
-    const groupIdStr = groupId !== undefined ? String(groupId) : undefined;
+    // Generate key for history tracking and follow-up window based on groupSessionMode
+    const historyReplyKey = groupId !== undefined ? String(groupId) : undefined;
 
     // "record" mode: save to session only, no think, no reply
     if (replyMode === "record") {
-      if (groupIdStr) {
+      if (historyReplyKey) {
         logVerbose(
-          `[infoflow:bot] pending: from=${fromuser}, group=${groupId}, reason=record-mode`,
+          `[infoflow:bot] pending: from=${senderDesc}, group=${groupId}, reason=record-mode`,
         );
         recordPendingHistoryEntryIfEnabled({
           historyMap: chatHistories,
-          historyKey: groupIdStr,
-          entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
+          historyKey: historyReplyKey,
+          entry: {
+            sender: senderTag,
+            body: bodyForAgent,
+            timestamp: Date.now(),
+          },
           limit: DEFAULT_GROUP_HISTORY_LIMIT,
         });
       }
       return;
     }
 
-    const canDetectMention = Boolean(account.config.robotName);
+    // eventtype 区分保证了 wasMentioned 的可靠性，不再依赖 robotName 配置
     const wasMentioned = event.wasMentioned === true;
 
+    // 消息里 @了其他机器人（有 robotid 的 AT 元素但不是当前机器人）时，
+    // 不应触发 followUp，避免"@别人说话"被误认为是跟进问题
+    const mentionsOtherBot =
+      !wasMentioned &&
+      (event.bodyItems ?? []).some((item) => item.type === "AT" && item.robotid != null);
+
     if (replyMode === "mention-only") {
-      // Only reply if bot was @mentioned
-      const shouldReply = canDetectMention && wasMentioned;
+      // Only reply if bot was @mentioned.
+      const shouldReply = wasMentioned;
       if (shouldReply) {
         triggerReason = "bot-mentioned";
       } else {
-        // Check follow-up window: if bot recently replied, allow LLM to decide
+        // Check follow-up window: if bot recently replied, allow LLM to decide.
+        // Skip followUp if the message is @mentioning another bot.
         if (
+          !mentionsOtherBot &&
           groupCfg.followUp &&
-          groupIdStr &&
-          isWithinFollowUpWindow(groupIdStr, groupCfg.followUpWindow)
+          historyReplyKey &&
+          isWithinFollowUpWindow(historyReplyKey, groupCfg.followUpWindow)
         ) {
+          // Follow-up window: if message @mentions others, record only without dispatching
+          if (hasOtherMentions(event.mentionIds)) {
+            logVerbose(
+              `[infoflow:bot] followUp record-only: from=${senderDesc}, group=${groupId}, reason=followup-but-other-mentioned`,
+            );
+            recordPendingHistoryEntryIfEnabled({
+              historyMap: chatHistories,
+              historyKey: historyReplyKey,
+              entry: {
+                sender: senderTag,
+                body: bodyForAgent,
+                timestamp: Date.now(),
+              },
+              limit: DEFAULT_GROUP_HISTORY_LIMIT,
+            });
+            return;
+          }
           triggerReason = "followUp";
-          ctxPayload.GroupSystemPrompt = buildFollowUpPrompt();
+          ctxPayload.GroupSystemPrompt = buildFollowUpPrompt(event.isReplyToBot);
         } else {
-          if (groupIdStr) {
+          if (historyReplyKey) {
             logVerbose(
-              `[infoflow:bot] pending: from=${fromuser}, group=${groupId}, reason=mention-only-not-mentioned`,
+              `[infoflow:bot] pending: from=${senderDesc}, group=${groupId}, reason=mention-only-not-mentioned`,
             );
             recordPendingHistoryEntryIfEnabled({
               historyMap: chatHistories,
-              historyKey: groupIdStr,
-              entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
+              historyKey: historyReplyKey,
+              entry: {
+                sender: senderTag,
+                body: bodyForAgent,
+                timestamp: Date.now(),
+              },
               limit: DEFAULT_GROUP_HISTORY_LIMIT,
             });
           }
@@ -572,8 +948,8 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
         }
       }
     } else if (replyMode === "mention-and-watch") {
-      // Reply if bot @mentioned, or if watched person @mentioned, or follow-up
-      const botMentioned = canDetectMention && wasMentioned;
+      // Reply if bot @mentioned, or if watched person @mentioned, or follow-up.
+      const botMentioned = wasMentioned;
       if (botMentioned) {
         triggerReason = "bot-mentioned";
       } else {
@@ -584,31 +960,56 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
             ? checkWatchMentioned(event.bodyItems, watchMentions)
             : undefined;
 
+        const matchedRegexPattern = groupCfg.watchRegex
+          ? checkWatchRegex(mes, groupCfg.watchRegex)
+          : undefined;
+
         if (matchedWatchId) {
           triggerReason = `watchMentions(${matchedWatchId})`;
           // Watch-mention triggered: instruct agent to reply only if confident
           ctxPayload.GroupSystemPrompt = buildWatchMentionPrompt(matchedWatchId);
-        } else if (groupCfg.watchRegex && checkWatchRegex(mes, groupCfg.watchRegex)) {
-          triggerReason = `watchRegex(${groupCfg.watchRegex})`;
+        } else if (matchedRegexPattern) {
+          triggerReason = `watchRegex(${matchedRegexPattern})`;
           // Watch-content triggered: message matched configured regex pattern
-          ctxPayload.GroupSystemPrompt = buildWatchRegexPrompt(groupCfg.watchRegex);
+          ctxPayload.GroupSystemPrompt = buildWatchRegexPrompt(matchedRegexPattern);
         } else if (
+          !mentionsOtherBot &&
           groupCfg.followUp &&
-          groupIdStr &&
-          isWithinFollowUpWindow(groupIdStr, groupCfg.followUpWindow)
+          historyReplyKey &&
+          isWithinFollowUpWindow(historyReplyKey, groupCfg.followUpWindow)
         ) {
+          // Follow-up window: if message @mentions others, record only without dispatching
+          if (hasOtherMentions(event.mentionIds)) {
+            logVerbose(
+              `[infoflow:bot] followUp record-only: from=${senderDesc}, group=${groupId}, reason=followup-but-other-mentioned`,
+            );
+            recordPendingHistoryEntryIfEnabled({
+              historyMap: chatHistories,
+              historyKey: historyReplyKey,
+              entry: {
+                sender: senderTag,
+                body: bodyForAgent,
+                timestamp: Date.now(),
+              },
+              limit: DEFAULT_GROUP_HISTORY_LIMIT,
+            });
+            return;
+          }
           triggerReason = "followUp";
-          // Follow-up window: let LLM decide if this is a follow-up
-          ctxPayload.GroupSystemPrompt = buildFollowUpPrompt();
+          ctxPayload.GroupSystemPrompt = buildFollowUpPrompt(event.isReplyToBot);
         } else {
-          if (groupIdStr) {
+          if (historyReplyKey) {
             logVerbose(
-              `[infoflow:bot] pending: from=${fromuser}, group=${groupId}, reason=mention-and-watch-no-trigger`,
+              `[infoflow:bot] pending: from=${senderDesc}, group=${groupId}, reason=mention-and-watch-no-trigger`,
             );
             recordPendingHistoryEntryIfEnabled({
               historyMap: chatHistories,
-              historyKey: groupIdStr,
-              entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
+              historyKey: historyReplyKey,
+              entry: {
+                sender: senderTag,
+                body: bodyForAgent,
+                timestamp: Date.now(),
+              },
               limit: DEFAULT_GROUP_HISTORY_LIMIT,
             });
           }
@@ -617,7 +1018,7 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
       }
     } else if (replyMode === "proactive") {
       // Always think and potentially reply
-      const botMentioned = canDetectMention && wasMentioned;
+      const botMentioned = wasMentioned;
       if (botMentioned) {
         triggerReason = "bot-mentioned";
       } else {
@@ -646,8 +1047,45 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     }
   }
 
-  // Build unified target: "group:<id>" for group chat, username for private chat
-  const to = isGroup && groupId !== undefined ? `group:${groupId}` : fromuser;
+  // 回复目标：群聊用 group:{groupId}，私聊 regular 用 userid，robot 用 imid
+  const to =
+    isGroup && groupId !== undefined
+      ? `group:${groupId}`
+      : sender.kind === "regular"
+        ? sender.userid
+        : (sender.imid ?? "");
+
+  ctxPayload.GroupSystemPrompt = appendInfoflowSystemPrompt(
+    ctxPayload.GroupSystemPrompt,
+    buildInfoflowCronTargetPrompt({
+      chatType,
+      to,
+    }),
+  );
+
+  const configuredMessageFormat: InfoflowMessageFormat = isGroup
+    ? (account.config.groupMessageFormat ?? "markdown")
+    : (account.config.dmMessageFormat ?? "markdown");
+  let effectiveMessageFormat = configuredMessageFormat;
+  let streamingCard: InfoflowStreamingCardSession | undefined;
+
+  if (configuredMessageFormat === "streaming-card") {
+    streamingCard = new InfoflowStreamingCardSession({
+      cfg,
+      accountId: account.accountId,
+      to,
+      answerFormat: "markdown",
+      fallbackFormat: normalizeStreamingFallbackFormat(configuredMessageFormat),
+    });
+    const started = await streamingCard.start();
+    if (!started) {
+      logVerbose(
+        `[streaming] failed to start streaming card for to=${to}, falling back to standard reply`,
+      );
+      streamingCard = undefined;
+      effectiveMessageFormat = normalizeStreamingFallbackFormat(configuredMessageFormat);
+    }
+  }
 
   // Provide mention context to the LLM so it can decide who to @mention
   if (isGroup && event.mentionIds) {
@@ -663,48 +1101,44 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     }
   }
 
-  logVerbose(
-    `[infoflow:bot] dispatching to LLM: from=${fromuser}, group=${groupId ?? "N/A"}, trigger=${triggerReason}, replyMode=${groupCfg?.replyMode ?? "N/A"}`,
+  getInfoflowBotLog().info(
+    `[dispatch] from=${senderDesc}, to=${to}, chatType=${chatType}, trigger=${triggerReason}, replyMode=${groupCfg?.replyMode ?? "N/A"}, session=${route.sessionKey}`,
   );
 
-  // Debug: Log reply-to context
-  logVerbose(`[DEBUG bot] event.messageId=${event.messageId}, event.senderImid=${event.senderImid}, isGroup=${isGroup}, mes=${mes.slice(0, 50)}`);
-  if (!event.messageId) {
-    logVerbose(`[DEBUG bot] WARNING: event.messageId is undefined/null!`);
-  }
-  if (!event.senderImid) {
-    logVerbose(`[DEBUG bot] WARNING: event.senderImid is undefined/null!`);
-  }
-  if (!isGroup) {
-    logVerbose(`[DEBUG bot] Not a group message, skipping reply-to`);
-  }
+  logVerbose(
+    `[dispatch:detail] trigger=${triggerReason}, messageId=${event.messageId}, senderImid=${senderImid}, images=${mediaList.length}`,
+  );
 
   // Send "processing" hint if LLM takes longer than processingHintDelay seconds
   // (default: 5s). Gives users feedback without spamming fast responses.
-  const processingHintEnabled = account.config.processingHint !== false;
+  const processingHintEnabled =
+    effectiveMessageFormat !== "streaming-card" && account.config.processingHint !== false;
   let cancelProcessingHint: (() => void) | undefined;
   let hintWasSent = false;
   const dispatchStartTime = Date.now();
   if (processingHintEnabled) {
     const delayMs = (account.config.processingHintDelay ?? 5) * 1000;
     const processingReplyTo =
-      isGroup && event.messageId
+      event.messageId
         ? {
             messageid: event.messageId,
             preview: mes ? (mes.length > 100 ? mes.slice(0, 100) + "..." : mes) : "",
-            ...(event.senderImid ? { imid: event.senderImid } : {}),
+            ...(senderImid ? { imid: senderImid } : {}),
             replytype: "2" as const,
+            ...(event.msgid2 ? { msgid2: event.msgid2 } : {}),
           }
         : undefined;
     let cancelled = false;
-    cancelProcessingHint = () => { cancelled = true; };
+    cancelProcessingHint = () => {
+      cancelled = true;
+    };
     setTimeout(() => {
       if (cancelled) return;
       hintWasSent = true;
       sendInfoflowMessage({
         cfg,
         to,
-        contents: [{ type: "text", content: "⏳ 处理中..." }],
+        contents: [{ type: "text", content: "👌收到啦" }],
         accountId: account.accountId,
         replyTo: processingReplyTo,
       }).catch(() => {});
@@ -716,19 +1150,24 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     agentId: route.agentId,
     accountId: account.accountId,
     to,
+    streamingCard,
     statusSink,
-    // @mention the sender back when bot was directly @mentioned in a group
-    atOptions: isGroup && event.wasMentioned ? { atUserIds: [fromuser] } : undefined,
+    // @mention the sender back when bot was directly @mentioned in a group (skip for bot senders)
+    atOptions:
+      isGroup && event.wasMentioned && event.sender.kind === "regular"
+        ? { atUserIds: [event.sender.userid] }
+        : undefined,
     // Pass mention IDs for LLM-driven @mention resolution in outbound text
     mentionIds: isGroup ? event.mentionIds : undefined,
-    // Pass inbound messageId for outbound reply-to (group only)
-    replyToMessageId: isGroup ? event.messageId : undefined,
-    replyToPreview: isGroup ? mes : undefined,
-    replyToImid: isGroup ? event.senderImid : undefined,
-    // Message format: per-chat-type config, falling back to "text"
-    messageFormat: isGroup
-      ? (account.config.groupMessageFormat ?? "text")
-      : (account.config.dmMessageFormat ?? "text"),
+    // Pass inbound messageId for outbound reply-to
+    replyToMessageId: event.messageId,
+    replyToPreview: mes,
+    replyToImid: senderImid,
+    replyToMsgid2: event.msgid2,
+    // Message format: per-chat-type config, falling back to "markdown"
+    messageFormat: effectiveMessageFormat,
+    // Chunk size: per-account config, default 1800
+    textChunkLimit: account.config.textChunkLimit ?? 1800,
   });
 
   // Cancel processing hint the moment the first real message starts being delivered,
@@ -736,38 +1175,89 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   if (cancelProcessingHint) {
     const originalDeliver = dispatcherOptions.deliver;
     let hintCancelledOnDeliver = false;
-    dispatcherOptions.deliver = async (payload: Parameters<typeof originalDeliver>[0]) => {
+    dispatcherOptions.deliver = async (
+      payload: Parameters<typeof originalDeliver>[0],
+      info?: Parameters<typeof originalDeliver>[1],
+    ) => {
       if (!hintCancelledOnDeliver) {
         hintCancelledOnDeliver = true;
         cancelProcessingHint!();
       }
-      return originalDeliver(payload);
+      return originalDeliver(payload, info);
     };
   }
 
-  const dispatchResult = await core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
-    ctx: ctxPayload,
-    cfg,
-    dispatcherOptions,
-    replyOptions,
-  });
+  let hintCancelledOnStream = false;
+  const cancelHintOnStream = () => {
+    if (cancelProcessingHint && !hintCancelledOnStream) {
+      hintCancelledOnStream = true;
+      cancelProcessingHint();
+    }
+  };
+
+  const mergedReplyOptions = {
+    ...replyOptions,
+    onPartialReply: async (payload: { text?: string; mediaUrls?: string[] }) => {
+      cancelHintOnStream();
+      streamingCard?.noteAssistantText(payload.text);
+    },
+    onReasoningStream: async (payload: { text?: string; mediaUrls?: string[] }) => {
+      cancelHintOnStream();
+      streamingCard?.noteReasoning(payload.text);
+    },
+    onToolStart: async (payload: { name?: string; phase?: string }) => {
+      cancelHintOnStream();
+      streamingCard?.noteToolStart(payload);
+    },
+    onToolResult: async (payload: { text?: string; mediaUrls?: string[] }) => {
+      cancelHintOnStream();
+      streamingCard?.noteToolResult(payload.text);
+      if (payload.mediaUrls?.length) {
+        for (const mediaUrl of payload.mediaUrls) {
+          streamingCard?.noteToolResult(`- 附件: ${mediaUrl}`);
+        }
+      }
+    },
+    onAssistantMessageStart: async () => {
+      cancelHintOnStream();
+    },
+  };
+
+  let dispatchResult:
+    | Awaited<ReturnType<typeof core.channel.reply.dispatchReplyWithBufferedBlockDispatcher>>
+    | undefined;
+  try {
+    dispatchResult = await core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+      ctx: ctxPayload,
+      cfg,
+      dispatcherOptions,
+      replyOptions: mergedReplyOptions,
+    });
+  } catch (err) {
+    await streamingCard?.failWithMessage("处理出错，请稍后重试");
+    throw err;
+  }
 
   // Fallback cancel: in case deliver was never called (e.g. empty response)
   cancelProcessingHint?.();
 
   // If hint was shown to the user, send "搞定" so they know the task is done
-  if (hintWasSent) {
-    const elapsedSec = Math.round((Date.now() - dispatchStartTime) / 1000);
-    sendInfoflowMessage({
-      cfg,
-      to,
-      contents: [{ type: "text", content: `任务完成 ✨ (${elapsedSec}s)` }],
-      accountId: account.accountId,
-    }).catch(() => {});
-  }
+  // if (hintWasSent) {
+  //   const elapsedSec = Math.round((Date.now() - dispatchStartTime) / 1000);
+  //   sendInfoflowMessage({
+  //     cfg,
+  //     to,
+  //     contents: [{ type: "text", content: `任务完成 ✨ (${elapsedSec}s)` }],
+  //     accountId: account.accountId,
+  //   }).catch(() => {});
+  // }
 
   const didReply = dispatchResult?.queuedFinal ?? false;
 
+  if (!didReply && streamingCard?.isUsable()) {
+    await streamingCard.complete();
+  }
+
   // Clear accumulated history after dispatch (it's now in the session transcript)
   if (isGroup && historyKey) {
     clearHistoryEntriesIfEnabled({
@@ -779,14 +1269,31 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
 
   // Record bot reply timestamp for follow-up window tracking
   if (didReply && isGroup && groupId !== undefined) {
-    recordGroupReply(String(groupId));
+    const replyKey = String(groupId);
+    recordGroupReply(replyKey);
   }
 
-  logVerbose(
-    `[infoflow] dispatch complete: ${chatType} from ${fromuser}, replied=${didReply}, finalCount=${dispatchResult?.counts.final ?? 0}, hasGroupSystemPrompt=${Boolean(ctxPayload.GroupSystemPrompt)}`,
+  getInfoflowBotLog().info(
+    `[dispatch:done] from=${senderDesc}, to=${to}, replied=${didReply}, blocks=${dispatchResult?.counts.final ?? 0}, elapsed=${Date.now() - dispatchStartTime}ms`,
   );
 }
 
+/**
+ * Extracts the MD5 hash from a VoiceUrl's fileid parameter.
+ * Example: "http://...?fileid=f161a9fd88ca2635ca1334c006c4ffb7.hd" → "F161A9FD88CA2635CA1334C006C4FFB7"
+ */
+export function extractMd5FromVoiceUrl(voiceUrl: string): string | undefined {
+  try {
+    const url = new URL(voiceUrl);
+    const fileid = url.searchParams.get("fileid") ?? "";
+    // Remove file extension (e.g. ".hd") and return uppercase MD5
+    const md5 = fileid.replace(/\.[^.]+$/, "");
+    return md5 && /^[0-9a-f]{32}$/i.test(md5) ? md5.toUpperCase() : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Test-only exports (@internal)
 // ---------------------------------------------------------------------------