@chbo297/infoflow 2026.3.16 → 2026.3.18

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 2026.3.17
+
+### 修复与优化
+
+#### follow-up（跟进回复）策略
+
+- **他人被 @ 时仅记录不派发**：在 follow-up 时间窗口内，若新消息 @ 了其他人或机器人（而非本 bot），则仅写入会话历史、不派发 LLM，避免误判为对机器人的追问。
+- **LLM 可见 body 含 robotid**：群消息中 @ 提及会以「@名称 (robotid:N)」形式呈现给模型，便于区分不同机器人并做出更准确的回复判断。
+
+---
+
 ## 2026.3.15
 
 ### 新功能

package/README.md

@@ -8,6 +8,8 @@
 
 百度如流 (Infoflow) 企业消息平台 — OpenClaw 频道插件。
 
+📦 **[npm](https://www.npmjs.com/package/@chbo297/infoflow)**
+
 ## 特性
 
 - **私聊 & 群聊**消息接收与回复
@@ -279,6 +281,8 @@ MIT
 
 Baidu Infoflow (如流) enterprise messaging platform — OpenClaw channel plugin.
 
+📦 **[npm](https://www.npmjs.com/package/@chbo297/infoflow)**
+
 ## Features
 
 - **Direct & group** message receiving and replying

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chbo297/infoflow",
-  "version": "2026.3.16",
+  "version": "2026.3.18",
   "description": "OpenClaw Infoflow (如流) channel plugin for Baidu enterprise messaging",
   "type": "module",
   "main": "index.ts",

package/src/bot.ts

@@ -194,6 +194,38 @@ function hasOtherMentions(mentionIds?: InfoflowMentionIds): boolean {
   return mentionIds.userIds.length > 0 || mentionIds.agentIds.length > 0;
 }
 
+/**
+ * When in follow-up window and message has other @mentions (not this bot): record only and
+ * return "record_only" (no LLM dispatch). Otherwise return "dispatch".
+ */
+function resolveFollowUpOtherMentioned(params: {
+  mentionIds: InfoflowMentionIds | undefined;
+  groupId: number | undefined;
+  bodyForAgent: string;
+  senderName: string;
+  fromuser: string;
+}): "record_only" | "dispatch" {
+  const { mentionIds, groupId, bodyForAgent, senderName, fromuser } = params;
+  if (!hasOtherMentions(mentionIds)) return "dispatch";
+  const groupIdStr = groupId != null ? String(groupId) : undefined;
+  if (groupIdStr) {
+    recordPendingHistoryEntryIfEnabled({
+      historyMap: chatHistories,
+      historyKey: groupIdStr,
+      entry: {
+        sender: senderName || fromuser,
+        body: bodyForAgent,
+        timestamp: Date.now(),
+      },
+      limit: DEFAULT_GROUP_HISTORY_LIMIT,
+    });
+  }
+  logVerbose(
+    `[infoflow:bot] skip dispatch: from=${fromuser}, group=${groupId}, reason=followUp-other-mentioned (record only, no LLM)`,
+  );
+  return "record_only";
+}
+
 // ---------------------------------------------------------------------------
 // Reply-to-bot detection (引用回复机器人消息)
 // ---------------------------------------------------------------------------
@@ -347,18 +379,6 @@ function buildFollowUpPrompt(isReplyToBot: boolean): string {
   return lines.join("\n");
 }
 
-/**
- * Build a GroupSystemPrompt for follow-up messages that @mention another person or bot.
- * Uses the conservative ReplyJudgmentRules since the message is likely directed at someone else.
- */
-function buildFollowUpOtherMentionedPrompt(): string {
-  return [
-    "You recently replied in this group. A new message has arrived, but it @mentions another person or bot — it is likely directed at them, not at you.",
-    "",
-    buildReplyJudgmentRules(),
-  ].join("\n");
-}
-
 /**
  * Build a GroupSystemPrompt for proactive mode.
  * Instructs the agent to think about the message and reply when helpful.
@@ -585,9 +605,11 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   // Extract non-bot mention IDs (userIds + agentIds) for LLM-driven @mentions
   const mentionIds = extractMentionIds(bodyItems, robotName);
 
-  // Build two versions: mes (for CommandBody, no @xxx) and rawMes (for RawBody, with @xxx)
+  // Build three versions: mes (for CommandBody, no @xxx), rawMes (for RawBody, with @xxx),
+  // and bodyForAgent (for LLM: @name with robotid when present so model sees "@地图不打烊 (robotid:N)")
   let textContent = "";
   let rawTextContent = "";
+  let agentVisibleText = "";
   const replyContextItems: string[] = [];
   const imageUrls: string[] = [];
   if (Array.isArray(bodyItems)) {
@@ -601,17 +623,21 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
       } else if (item.type === "TEXT" || item.type === "MD") {
         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
+        // AT elements only go into rawTextContent and agentVisibleText, not textContent
         const name = item.name ?? "";
         if (name) {
           rawTextContent += `@${name} `;
+          agentVisibleText +=
+            item.robotid != null ? `@${name} (robotid:${item.robotid}) ` : `@${name} `;
         }
       } else if (item.type === "IMAGE") {
         // 提取图片下载地址
@@ -623,6 +649,7 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
         // Fallback: for any other item types with string content, treat content as text.
         textContent += item.content;
         rawTextContent += item.content;
+        agentVisibleText += item.content;
       }
     }
   }
@@ -643,6 +670,8 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   if (!mes && replyContext) {
     mes = "(引用回复)";
   }
+  // Body for LLM: include @mentions with robotid so model sees e.g. "@地图不打烊 (robotid:N)"
+  const bodyForAgent = agentVisibleText.trim() || rawMes || mes;
 
   // Extract sender name from header or fallback to fromuser
   const senderName = String(header?.username ?? header?.nickname ?? msgData.username ?? fromuser);
@@ -657,6 +686,7 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
       fromuser,
       mes,
       rawMes,
+      bodyForAgent,
       chatType: "group",
       groupId: groupid,
       senderName,
@@ -682,6 +712,8 @@ 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;
+  // Single source for "body shown to LLM": already computed in group handler (line ~666)
+  const bodyForAgent = event.bodyForAgent ?? mes;
 
   const account = resolveInfoflowAccount({ cfg, accountId });
   const core = getInfoflowRuntime();
@@ -729,7 +761,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
@@ -844,6 +876,7 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     Body: combinedBody,
     RawBody: event.rawMes ?? mes,
     CommandBody: mes,
+    BodyForAgent: bodyForAgent,
     From: fromAddress,
     To: toAddress,
     SessionKey: route.sessionKey,
@@ -866,6 +899,14 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     ...mediaPayload,
   });
 
+  // Ensure BodyForAgent stays set for group messages (with @ and robotid) so the LLM sees full context
+  if (isGroup && bodyForAgent !== mes) {
+    (ctxPayload as Record<string, unknown>).BodyForAgent = bodyForAgent;
+    logVerbose(
+      `[infoflow] group: BodyForAgent set for LLM (${bodyForAgent.length} chars, includes @/robotid)`,
+    );
+  }
+
   // Record session using recordInboundSession for proper session tracking
   await core.channel.session.recordInboundSession({
     storePath,
@@ -894,7 +935,11 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
         recordPendingHistoryEntryIfEnabled({
           historyMap: chatHistories,
           historyKey: groupIdStr,
-          entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
+          entry: {
+            sender: senderName || fromuser,
+            body: bodyForAgent,
+            timestamp: Date.now(),
+          },
           limit: DEFAULT_GROUP_HISTORY_LIMIT,
         });
       }
@@ -917,8 +962,17 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
           isWithinFollowUpWindow(groupIdStr, groupCfg.followUpWindow)
         ) {
           if (hasOtherMentions(event.mentionIds)) {
-            triggerReason = "followUp-other-mentioned";
-            ctxPayload.GroupSystemPrompt = buildFollowUpOtherMentionedPrompt();
+            if (
+              resolveFollowUpOtherMentioned({
+                mentionIds: event.mentionIds,
+                groupId,
+                bodyForAgent,
+                senderName: senderName || fromuser,
+                fromuser,
+              }) === "record_only"
+            ) {
+              return;
+            }
           } else {
             triggerReason = "followUp";
             ctxPayload.GroupSystemPrompt = buildFollowUpPrompt(event.isReplyToBot === true);
@@ -931,7 +985,11 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
             recordPendingHistoryEntryIfEnabled({
               historyMap: chatHistories,
               historyKey: groupIdStr,
-              entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
+              entry: {
+                sender: senderName || fromuser,
+                body: bodyForAgent,
+                timestamp: Date.now(),
+              },
               limit: DEFAULT_GROUP_HISTORY_LIMIT,
             });
           }
@@ -969,8 +1027,17 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
           isWithinFollowUpWindow(groupIdStr, groupCfg.followUpWindow)
         ) {
           if (hasOtherMentions(event.mentionIds)) {
-            triggerReason = "followUp-other-mentioned";
-            ctxPayload.GroupSystemPrompt = buildFollowUpOtherMentionedPrompt();
+            if (
+              resolveFollowUpOtherMentioned({
+                mentionIds: event.mentionIds,
+                groupId,
+                bodyForAgent,
+                senderName: senderName || fromuser,
+                fromuser,
+              }) === "record_only"
+            ) {
+              return;
+            }
           } else {
             triggerReason = "followUp";
             ctxPayload.GroupSystemPrompt = buildFollowUpPrompt(event.isReplyToBot === true);
@@ -983,7 +1050,11 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
             recordPendingHistoryEntryIfEnabled({
               historyMap: chatHistories,
               historyKey: groupIdStr,
-              entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
+              entry: {
+                sender: senderName || fromuser,
+                body: bodyForAgent,
+                timestamp: Date.now(),
+              },
               limit: DEFAULT_GROUP_HISTORY_LIMIT,
             });
           }
@@ -1038,8 +1109,22 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     }
   }
 
+  const mentionIdsLog =
+    isGroup && event.mentionIds
+      ? `, mentionIds={userIds:[${event.mentionIds.userIds.join(",")}], agentIds:[${event.mentionIds.agentIds.join(",")}]}`
+      : "";
+  const bodyPreview =
+    (ctxPayload as Record<string, unknown>).Body != null
+      ? String((ctxPayload as Record<string, unknown>).Body)
+      : "";
+  const bodyLog = `bodyLen=${bodyPreview.length} bodyPreview=${bodyPreview.length > 5000 ? bodyPreview.slice(0, 5000) + "..." : bodyPreview}`;
+  const sysPrompt =
+    (ctxPayload as Record<string, unknown>).GroupSystemPrompt != null
+      ? String((ctxPayload as Record<string, unknown>).GroupSystemPrompt)
+      : "";
+  const sysPromptLog = `groupSystemPromptLen=${sysPrompt.length} groupSystemPromptPreview=${sysPrompt.length > 5000 ? sysPrompt.slice(0, 5000) + "..." : sysPrompt}`;
   logVerbose(
-    `[infoflow:bot] dispatching to LLM: from=${fromuser}, group=${groupId ?? "N/A"}, trigger=${triggerReason}, replyMode=${groupCfg?.replyMode ?? "N/A"}`,
+    `[infoflow:bot] dispatching to LLM: from=${fromuser}, group=${groupId ?? "N/A"}, trigger=${triggerReason}, replyMode=${groupCfg?.replyMode ?? "N/A"}${mentionIdsLog} | ${bodyLog} | ${sysPromptLog}`,
   );
 
   const { dispatcherOptions, replyOptions } = createInfoflowReplyDispatcher({
@@ -1054,7 +1139,7 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     mentionIds: isGroup ? event.mentionIds : undefined,
     // Pass inbound messageId for outbound reply-to (group only)
     replyToMessageId: isGroup ? event.messageId : undefined,
-    replyToPreview: isGroup ? mes : undefined,
+    replyToPreview: isGroup ? bodyForAgent : undefined,
     mediaLocalRoots: getAgentScopedMediaLocalRoots(cfg, route.agentId),
   });
 

package/src/infoflow-req-parse.ts

@@ -9,6 +9,55 @@ import { handlePrivateChatMessage, handleGroupChatMessage } from "./bot.js";
 import type { ResolvedInfoflowAccount } from "./channel.js";
 import { getInfoflowParseLog, formatInfoflowError, logVerbose } from "./logging.js";
 
+// ---------------------------------------------------------------------------
+// Large-integer precision protection
+// ---------------------------------------------------------------------------
+
+// Infoflow message IDs (e.g. 1859713223686736431) exceed Number.MAX_SAFE_INTEGER (2^53-1).
+// JSON.parse silently truncates these to imprecise values.
+// We extract precise strings from raw JSON text via regex and patch the parsed object.
+const ID_KEYS = ["messageid", "msgid", "MsgId", "msgkey"] as const;
+
+/**
+ * Patches large integer ID fields in `obj` with precise string values
+ * extracted from `rawText` via regex, bypassing JSON.parse precision loss.
+ * Only patches values with 16+ digits (smaller integers are safe).
+ */
+function patchPreciseIds(rawText: string, obj: Record<string, unknown>): void {
+  for (const key of ID_KEYS) {
+    const re = new RegExp(`"${key}"\\s*:\\s*(\\d{16,})`, "g");
+    const preciseValues: string[] = [];
+    let m;
+    while ((m = re.exec(rawText)) !== null) {
+      preciseValues.push(m[1]);
+    }
+    if (preciseValues.length > 0) {
+      patchField(obj, key, preciseValues, 0);
+    }
+  }
+}
+
+/** Recursively walks `obj` and replaces numeric fields named `key` with precise strings (in order). */
+function patchField(obj: unknown, key: string, values: string[], idx: number): number {
+  if (obj == null || typeof obj !== "object") return idx;
+  if (Array.isArray(obj)) {
+    for (const item of obj) {
+      idx = patchField(item, key, values, idx);
+    }
+    return idx;
+  }
+  const rec = obj as Record<string, unknown>;
+  if (key in rec && typeof rec[key] === "number" && idx < values.length) {
+    rec[key] = values[idx++];
+  }
+  for (const v of Object.values(rec)) {
+    if (v != null && typeof v === "object") {
+      idx = patchField(v, key, values, idx);
+    }
+  }
+  return idx;
+}
+
 const DEDUP_TTL_MS = 5 * 60 * 1000; // 5 minutes
 const DEDUP_MAX_SIZE = 1000;
 
@@ -309,10 +358,13 @@ function tryDecryptAndDispatch(params: DecryptDispatchParams): ParseResult {
       continue; // Try next account
     }
 
+    logVerbose(`[infoflow] ${chatType}: decryptedContent=(${decryptedContent})`);
+
     // Parse as JSON first, then try fallback parser (XML for private)
     let msgData: Record<string, unknown> | null = null;
     try {
       msgData = JSON.parse(decryptedContent) as Record<string, unknown>;
+      patchPreciseIds(decryptedContent, msgData);
     } catch {
       if (fallbackParser) {
         msgData = fallbackParser(decryptedContent);
@@ -357,6 +409,7 @@ function handlePrivateMessage(messageJsonStr: string, targets: WebhookTarget[]):
   let messageJson: Record<string, unknown>;
   try {
     messageJson = JSON.parse(messageJsonStr) as Record<string, unknown>;
+    patchPreciseIds(messageJsonStr, messageJson);
   } catch {
     getInfoflowParseLog().error(`[infoflow] private: invalid messageJson`);
     return { handled: true, statusCode: 400, body: "invalid messageJson" };
@@ -430,3 +483,6 @@ export const _parseXmlMessage = parseXmlMessage;
 export function _resetMessageCache(): void {
   messageCache.clear();
 }
+
+/** @internal */
+export const _patchPreciseIds = patchPreciseIds;

package/src/types.ts

@@ -191,6 +191,8 @@ export type InfoflowMessageEvent = {
   timestamp?: number;
   /** Raw message text preserving @mentions (for RawBody) */
   rawMes?: string;
+  /** Message text for the LLM including @mentions and robotid (BodyForAgent) */
+  bodyForAgent?: string;
   /** Raw body items from group message (for watch-mention detection) */
   bodyItems?: InfoflowInboundBodyItem[];
   /** Non-bot mention IDs extracted from AT items in group messages (excluding bot itself) */