@core-workspace/infoflow-openclaw-plugin 2026.3.8 → 2026.3.31

package/src/adapter/inbound/ws-receiver.ts

@@ -12,8 +12,8 @@
  * SDK event system (@core-workspace/infoflow-sdk-nodejs):
  * - Group messages  → "group.*" (covers group.text, group.mixed, group.image, etc.)
  * - Private messages → "private.*" (covers private.text, private.image, etc.)
- * - event.data is normalized by SDK: { chatType, msgType, fromUserId, groupId, body,
- *   content, originalMessage, ... }
+ * - SDK 0.1.1: event.data is normalized with fromUserId, groupId, body, originalMessage, ...
+ * - SDK 0.1.5+: event.data is { chatType, msgType, raw } — raw is the full original payload
  *
  * SDK Bug Workaround:
  * SDK's normalizePrivateMessage() drops PicUrl/MsgId fields from private messages.
@@ -28,7 +28,8 @@ import { WSClient } from "@core-workspace/infoflow-sdk-nodejs";
 import type { OpenClawConfig } from "openclaw/plugin-sdk";
 import { handleGroupChatMessage, handlePrivateChatMessage } from "../../handler/message-handler.js";
 import { isDuplicateMessage } from "./webhook-parser.js";
-import { formatInfoflowError, logVerbose } from "../../logging.js";
+import { formatInfoflowError, logVerbose, getInfoflowWebhookLog } from "../../logging.js";
+import { extractIdFromRawJson } from "../../channel/outbound.js";
 import type { ResolvedInfoflowAccount } from "../../types.js";
 
 // ---------------------------------------------------------------------------
@@ -79,6 +80,22 @@ export class InfoflowWSReceiver {
         return normalized;
       };
     }
+
+    // Patch frameCodec.parsePayload to attach _rawJson to parsed objects.
+    // This preserves large integer precision (e.g. messageid) that JSON.parse loses.
+    const frameCodec = (this.wsClient as any).frameCodec;
+    if (frameCodec && typeof frameCodec.parsePayload === "function") {
+      const originalParse = frameCodec.parsePayload.bind(frameCodec);
+      frameCodec.parsePayload = function (frame: any) {
+        const result = originalParse(frame);
+        if (result && typeof result === "object" && frame.payload) {
+          try {
+            result._rawJson = frame.payload.toString("utf-8");
+          } catch { /* ignore */ }
+        }
+        return result;
+      };
+    }
   }
 
   /** Connect and start receiving messages. */
@@ -106,7 +123,10 @@ export class InfoflowWSReceiver {
     this.wsClient.on("private.*", handlePrivateEvent);
 
     // Connect (two-phase: endpoint allocation → WS handshake)
+    const wsGateway = this.options.account.config.wsGateway ?? "infoflow-open-gateway.weiyun.baidu.com";
+    getInfoflowWebhookLog().info(`[ws:connect] connecting to ${wsGateway}`);
     await this.wsClient.connect();
+    getInfoflowWebhookLog().info(`[ws:connect] connected to ${wsGateway}`);
 
     // Listen for abortSignal to gracefully disconnect
     this.options.abortSignal.addEventListener(
@@ -122,6 +142,7 @@ export class InfoflowWSReceiver {
   stop(): void {
     if (this.stopped) return;
     this.stopped = true;
+    getInfoflowWebhookLog().info(`[ws:disconnect] stopping ws receiver`);
     try {
       this.wsClient.disconnect();
     } catch {
@@ -131,8 +152,10 @@ export class InfoflowWSReceiver {
 
   /**
    * Handle a group message event from the new SDK.
-   * SDK normalizes to: { chatType, msgType, fromUserId, groupId, body, content,
-   *                       originalMessage, createTime, ... }
+   *
+   * SDK 0.1.1: normalizes to { chatType, msgType, fromUserId, groupId, body, originalMessage, ... }
+   * SDK 0.1.5: normalizes to { chatType, msgType, raw } — raw is the original payload
+   *
    * We reconstruct the raw msgData shape expected by handleGroupChatMessage.
    */
   private async handleGroupEvent(data: any): Promise<void> {
@@ -140,37 +163,54 @@ export class InfoflowWSReceiver {
 
     this.options.statusSink?.({ lastInboundAt: Date.now() });
 
+    // SDK 0.1.5 puts everything in data.raw; 0.1.1 inlines fields directly.
+    const payload = data.raw ?? data;
+
     // Reconstruct raw msgData compatible with handleGroupChatMessage expectations:
     // { message: { header: { fromuserid, servertime, messageid, ... }, body }, groupid, ... }
-    const originalMessage = data.originalMessage ?? {};
-    const header = originalMessage.header ?? {};
+    const originalMessage = payload.originalMessage ?? payload;
+    const message = payload.message ?? originalMessage.message ?? {};
+    const header = message.header ?? originalMessage.header ?? {};
+
+    // Extract messageid with full precision from raw JSON string (avoids JS Number precision loss
+    // for large int64 IDs like 1859821262633816373 which JSON.parse rounds to ...300).
+    const rawJson: string | undefined = payload._rawJson;
+    const preciseMessageId =
+      (rawJson && extractIdFromRawJson(rawJson, "messageid")) ??
+      (header.messageid != null ? String(header.messageid) : undefined);
+    const preciseClientMsgId =
+      (rawJson && extractIdFromRawJson(rawJson, "clientmsgid")) ??
+      (header.clientmsgid != null ? String(header.clientmsgid) : undefined);
+
     const msgData: Record<string, unknown> = {
       eventtype: "MESSAGE_RECEIVE",
-      groupid: data.groupId ?? data.groupid,
+      groupid: payload.groupid ?? payload.groupId ?? data.groupId,
+      fromid: payload.fromid,
       message: {
         header: {
-          fromuserid: data.fromUserId ?? header.fromuserid ?? "",
-          toid: data.groupId ?? data.groupid,
+          fromuserid: header.fromuserid ?? payload.fromUserId ?? data.fromUserId ?? "",
+          toid: payload.groupid ?? payload.groupId ?? data.groupId,
           totype: "GROUP",
-          msgtype: data.msgType ?? header.msgtype ?? "text",
-          messageid: header.messageid ?? header.clientmsgid,
-          clientmsgid: header.clientmsgid,
+          msgtype: header.msgtype ?? data.msgType ?? "text",
+          messageid: preciseMessageId,
+          clientmsgid: preciseClientMsgId,
           servertime: header.servertime,
           clienttime: header.clienttime,
           at: header.at ?? { atrobotids: [] },
         },
-        body: data.body ?? (data.content ? [{ type: "TEXT", content: data.content }] : []),
+        body: message.body ?? payload.body ?? data.body ??
+          (data.content ? [{ type: "TEXT", content: data.content }] : []),
       },
     };
 
-    // Dedup check using clientmsgid or messageid as key
-    const dedupKey = header.clientmsgid ?? header.messageid;
+    // Dedup check using clientmsgid or messageid as key (use precise string IDs)
+    const dedupKey = preciseClientMsgId ?? preciseMessageId;
     if (dedupKey && isDuplicateMessage({ CreateTime: String(dedupKey) })) {
       logVerbose("[infoflow:ws] duplicate group message, skipping");
       return;
     }
 
-    logVerbose(`[infoflow:ws] group message: from=${data.fromUserId}, msgType=${data.msgType}, groupId=${data.groupId}`);
+    logVerbose(`[infoflow:ws] group message: from=${header.fromuserid}, msgType=${header.msgtype}, groupId=${payload.groupid ?? payload.groupId}`);
 
     await handleGroupChatMessage({
       cfg: this.options.config,
@@ -182,7 +222,10 @@ export class InfoflowWSReceiver {
 
   /**
    * Handle a private message event from the new SDK.
-   * SDK normalizes to: { chatType, msgType, fromUserId, content, createTime, ... }
+   *
+   * SDK 0.1.1: normalizes to { chatType, msgType, fromUserId, content, createTime, originalMessage, ... }
+   * SDK 0.1.5: normalizes to { chatType, msgType, raw } — raw is the original payload
+   *
    * We reconstruct the raw msgData shape expected by handlePrivateChatMessage.
    */
   private async handlePrivateEvent(data: any): Promise<void> {
@@ -190,20 +233,21 @@ export class InfoflowWSReceiver {
 
     this.options.statusSink?.({ lastInboundAt: Date.now() });
 
-    logVerbose(`[DEBUG ws.private] SDK event data 完整结构: ${JSON.stringify(data, null, 2)}`);
+    // SDK 0.1.5 puts everything in data.raw; 0.1.1 inlines fields directly.
+    const payload = data.raw ?? data;
 
     // Reconstruct raw msgData compatible with handlePrivateChatMessage expectations:
     // { FromUserId, Content, MsgType, CreateTime, PicUrl, MsgId, ... }
-    const originalMessage = data.originalMessage ?? {};
+    const originalMessage = payload.originalMessage ?? payload;
     const msgData: Record<string, unknown> = {
-      FromUserId: data.fromUserId ?? data.FromUserId ?? originalMessage.FromUserId ?? "",
-      FromUserName: data.fromUserName ?? data.FromUserName ?? originalMessage.FromUserName,
-      Content: data.content ?? data.Content ?? originalMessage.Content ?? "",
-      MsgType: data.msgType ?? data.MsgType ?? originalMessage.MsgType ?? "text",
-      CreateTime: data.createTime ?? data.CreateTime ?? originalMessage.CreateTime ?? String(Date.now()),
+      FromUserId: payload.FromUserId ?? payload.fromUserId ?? data.fromUserId ?? originalMessage.FromUserId ?? "",
+      FromUserName: payload.FromUserName ?? payload.fromUserName ?? data.fromUserName ?? originalMessage.FromUserName,
+      Content: payload.Content ?? payload.content ?? data.content ?? originalMessage.Content ?? "",
+      MsgType: payload.MsgType ?? payload.msgType ?? data.msgType ?? originalMessage.MsgType ?? "text",
+      CreateTime: payload.CreateTime ?? payload.createTime ?? data.createTime ?? originalMessage.CreateTime ?? String(Date.now()),
       // 图片消息字段
-      PicUrl: data.picUrl ?? data.PicUrl ?? originalMessage.PicUrl ?? "",
-      MsgId: data.msgId ?? data.MsgId ?? originalMessage.MsgId,
+      PicUrl: payload.PicUrl ?? payload.picUrl ?? data.picUrl ?? originalMessage.PicUrl ?? "",
+      MsgId: payload.MsgId ?? payload.msgId ?? data.msgId ?? originalMessage.MsgId,
     };
 
     // Dedup check
@@ -222,5 +266,3 @@ export class InfoflowWSReceiver {
     });
   }
 }
-
-

package/src/adapter/outbound/reply-dispatcher.ts

@@ -45,6 +45,11 @@ export type CreateInfoflowReplyDispatcherParams = {
    * Default: "text"
    */
   messageFormat?: "text" | "markdown";
+  /**
+   * Maximum character limit per outbound message chunk.
+   * Default: 1800
+   */
+  textChunkLimit?: number;
 };
 
 /**
@@ -64,6 +69,7 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
     replyToPreview,
     replyToImid,
     messageFormat = "text",
+    textChunkLimit = 1800,
   } = params;
   const core = getInfoflowRuntime();
 
@@ -93,8 +99,6 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
 
   // Build replyTo context (only used for the first outbound message)
   // Note: replyTo is suppressed when messageFormat is "markdown" (not supported by API)
-  logVerbose(`[DEBUG reply-dispatcher] isGroup=${isGroup}, replyToMessageId=${replyToMessageId}, replyToImid=${replyToImid}, replyToPreview=${replyToPreview?.slice(0, 50)}`);
-
   const replyTo: InfoflowOutboundReply | undefined =
     isGroup && effectiveReplyToMessageId
       ? {
@@ -106,17 +110,8 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
       : undefined;
   let replyApplied = false;
 
-  // Debug: Log constructed replyTo
-  logVerbose(`[DEBUG reply-dispatcher] replyTo constructed: ${JSON.stringify(replyTo)}`);
-  if (replyTo) {
-    logVerbose(`[DEBUG reply-dispatcher] Creating reply context with messageid=${replyTo.messageid}`);
-  } else {
-    logVerbose(`[DEBUG reply-dispatcher] replyTo is undefined - not creating reply context`);
-  }
-
   const deliver = async (payload: ReplyPayload) => {
     const text = payload.text ?? "";
-    logVerbose(`[infoflow] deliver called: to=${to}, text=${text}`);
 
     // Normalize media URL list (same pattern as Feishu reply-dispatcher)
     const mediaList =
@@ -126,7 +121,6 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
           ? [payload.mediaUrl]
           : [];
 
-    logVerbose(`[infoflow] deliver called: to=${to}, text=${text}, mediaList=${JSON.stringify(mediaList)}`);
     if (!text.trim() && mediaList.length === 0) {
       return;
     }
@@ -169,8 +163,8 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
       // AT nodes will be added to contents for notification, but text stays clean
       let messageText = text;
 
-      // Chunk text to 4000 chars max (Infoflow limit)
-      const chunks = core.channel.text.chunkText(messageText, 4000);
+      // Chunk text using markdown-aware chunker with configured limit
+      const chunks = core.channel.text.chunkMarkdownText(messageText, textChunkLimit);
       // Only include @mentions in the first chunk (avoid duplicate @s)
       let isFirstChunk = true;
 
@@ -196,10 +190,6 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
         // Only include replyTo on the first outbound message
         const chunkReplyTo = !replyApplied ? replyTo : undefined;
 
-        // Debug: Log when sending with replyTo
-        logVerbose(`[DEBUG deliver] chunkReplyTo: ${JSON.stringify(chunkReplyTo)}`);
-        logVerbose(`[DEBUG deliver] replyApplied=${replyApplied}, replyTo exists=${!!replyTo}`);
-
         const result = await sendInfoflowMessage({
           cfg,
           to,
@@ -210,10 +200,13 @@ export function createInfoflowReplyDispatcher(params: CreateInfoflowReplyDispatc
         if (chunkReplyTo) replyApplied = true;
 
         if (result.ok) {
+          getInfoflowSendLog().info(
+            `[outbound] to=${to}, len=${chunk.length}, msgId=${result.messageId ?? "N/A"}, replyTo=${chunkReplyTo?.messageid ?? "none"}`,
+          );
           statusSink?.({ lastOutboundAt: Date.now() });
         } else if (result.error) {
           getInfoflowSendLog().error(
-            `[infoflow] reply failed to=${to}, accountId=${accountId}: ${result.error}`,
+            `[outbound:error] to=${to}, accountId=${accountId}: ${result.error}`,
           );
         }
       }

package/src/channel/accounts.ts

@@ -77,10 +77,16 @@ function mergeInfoflowAccountConfig(
   appAgentId?: number;
   dmMessageFormat?: "text" | "markdown";
   groupMessageFormat?: "text" | "markdown";
-  dmPolicy?: string;
+  replyMode?: import("../types.js").InfoflowReplyMode;
+  groupSessionMode?: import("../types.js").InfoflowGroupSessionMode;
+  followUp?: boolean;
+  followUpWindow?: number;
+  groups?: Record<string, import("../types.js").InfoflowGroupConfig>;
+  dmPolicy?: import("../types.js").InfoflowDmPolicy;
   allowFrom?: string[];
-  groupPolicy?: string;
+  groupPolicy?: import("../types.js").InfoflowGroupPolicy;
   groupAllowFrom?: string[];
+  textChunkLimit?: number;
 } {
   const raw = getChannelSection(cfg) ?? {};
   const { accounts: _ignored, defaultAccount: _ignored2, ...base } = raw;
@@ -102,9 +108,14 @@ function mergeInfoflowAccountConfig(
     appAgentId?: number;
     dmMessageFormat?: "text" | "markdown";
     groupMessageFormat?: "text" | "markdown";
-    dmPolicy?: string;
+    replyMode?: import("../types.js").InfoflowReplyMode;
+    groupSessionMode?: import("../types.js").InfoflowGroupSessionMode;
+    followUp?: boolean;
+    followUpWindow?: number;
+    groups?: Record<string, import("../types.js").InfoflowGroupConfig>;
+    dmPolicy?: import("../types.js").InfoflowDmPolicy;
     allowFrom?: string[];
-    groupPolicy?: string;
+    groupPolicy?: import("../types.js").InfoflowGroupPolicy;
     groupAllowFrom?: string[];
   };
 }
@@ -125,13 +136,16 @@ export function resolveInfoflowAccount(params: {
   const merged = mergeInfoflowAccountConfig(params.cfg, accountId);
   const accountEnabled = merged.enabled !== false;
   const enabled = baseEnabled && accountEnabled;
-  const apiHost = merged.apiHost ?? "";
+  const apiHost = merged.apiHost ?? "http://apiin.im.baidu.com";
   const checkToken = merged.checkToken ?? "";
   const encodingAESKey = merged.encodingAESKey ?? "";
   const appKey = merged.appKey ?? "";
   const appSecret = merged.appSecret ?? "";
+  const effectiveConnectionMode = merged.connectionMode ?? "websocket";
   const configured =
-    Boolean(checkToken) && Boolean(encodingAESKey) && Boolean(appKey) && Boolean(appSecret);
+    effectiveConnectionMode === "websocket"
+      ? Boolean(appKey) && Boolean(appSecret)
+      : Boolean(checkToken) && Boolean(encodingAESKey) && Boolean(appKey) && Boolean(appSecret);
 
   return {
     accountId,
@@ -155,10 +169,16 @@ export function resolveInfoflowAccount(params: {
       appAgentId: merged.appAgentId,
       dmMessageFormat: merged.dmMessageFormat,
       groupMessageFormat: merged.groupMessageFormat,
+      replyMode: merged.replyMode,
+      groupSessionMode: merged.groupSessionMode,
+      followUp: merged.followUp,
+      followUpWindow: merged.followUpWindow,
+      groups: merged.groups,
       dmPolicy: merged.dmPolicy,
       allowFrom: merged.allowFrom,
       groupPolicy: merged.groupPolicy,
       groupAllowFrom: merged.groupAllowFrom,
+      textChunkLimit: merged.textChunkLimit,
     },
   };
 }

package/src/channel/channel.ts

@@ -205,10 +205,11 @@ export const infoflowPlugin: ChannelPlugin<ResolvedInfoflowAccount> = {
     },
   },
   outbound: {
-    deliveryMode: "direct",
+    deliveryMode: "gateway",
     chunkerMode: "markdown",
-    textChunkLimit: 4000,
-    chunker: (text, limit) => getInfoflowRuntime().channel.text.chunkText(text, limit),
+    textChunkLimit: 1800,
+    resolveTextChunkLimit: (account) => account.config.textChunkLimit,
+    chunker: (text, limit) => getInfoflowRuntime().channel.text.chunkMarkdownText(text, limit),
     sendText: async ({ cfg, to, text, accountId }) => {
       logVerbose(`[infoflow:sendText] to=${to}, accountId=${accountId}`);
       // Use "markdown" type even though param is named `text`: LLM outputs are often markdown,
@@ -322,7 +323,7 @@ export const infoflowPlugin: ChannelPlugin<ResolvedInfoflowAccount> = {
   gateway: {
     startAccount: async (ctx) => {
       const account = ctx.account;
-      const connectionMode = account.config.connectionMode ?? "webhook";
+      const connectionMode = account.config.connectionMode ?? "websocket";
       ctx.log?.info(`[${account.accountId}] starting Infoflow ${connectionMode}`);
       ctx.setStatus({
         accountId: account.accountId,

package/src/channel/media.ts

@@ -298,6 +298,14 @@ export async function sendInfoflowPrivateImage(params: {
     const data = JSON.parse(responseText) as Record<string, unknown>;
     logVerbose(`[infoflow:sendPrivateImage] response: status=${res.status}, data=${responseText}`);
 
+    // Check outer code first (same format as text message API)
+    const code = typeof data.code === "string" ? data.code : "";
+    if (code && code !== "ok") {
+      const errMsg = String(data.message ?? data.errmsg ?? `code=${code}`);
+      getInfoflowSendLog().error(`[infoflow:sendPrivateImage] failed: ${errMsg}`);
+      return { ok: false, error: errMsg };
+    }
+    // Also check inner errcode
     if (data.errcode && data.errcode !== 0) {
       const errMsg = String(data.errmsg ?? `errcode ${data.errcode}`);
       getInfoflowSendLog().error(`[infoflow:sendPrivateImage] failed: ${errMsg}`);

package/src/channel/outbound.ts

@@ -283,8 +283,9 @@ export async function sendInfoflowPrivateMessage(params: {
 
     const bodyStr = JSON.stringify(payload);
 
-    // Log request URL and body when verbose logging is enabled
-    logVerbose(`[infoflow:sendPrivate] POST body: ${bodyStr}`);
+    // Log request
+    getInfoflowSendLog().info(`[outbound:dm] to=${toUser}, msgtype=${payload.msgtype}, bodyLen=${bodyStr.length}`);
+    logVerbose(`[outbound:dm] POST body: ${bodyStr}`);
 
     const res = await fetch(`${ensureHttps(apiHost)}${INFOFLOW_PRIVATE_SEND_PATH}`, {
       method: "POST",
@@ -295,7 +296,8 @@ export async function sendInfoflowPrivateMessage(params: {
 
     const responseText = await res.text();
     const data = JSON.parse(responseText) as Record<string, unknown>;
-    logVerbose(`[infoflow:sendPrivate] response: status=${res.status}, data=${responseText}`);
+    getInfoflowSendLog().info(`[outbound:dm] response: status=${res.status}, code=${data.code ?? "?"}, msgkey=${(data.data as any)?.msgkey ?? "?"}`);
+    logVerbose(`[outbound:dm] response body: ${responseText}`);
 
     // Check outer code first
     const code = typeof data.code === "string" ? data.code : "";
@@ -465,10 +467,10 @@ export async function sendInfoflowGroupMessage(params: {
           ...(replyTo
             ? {
                 reply: {
-                  messageid: String(replyTo.messageid),  // messageid应该是字符串
+                  messageid: String(replyTo.messageid),
                   preview: replyTo.preview ?? "",
-                  ...(replyTo.imid ? { imid: replyTo.imid } : {}),  // 如果有 imid 则添加
-                  replyType: replyTo.replytype ?? "1",   // 注意是replyType,不是replytype
+                  ...(replyTo.imid ? { imid: replyTo.imid } : {}),
+                  replytype: replyTo.replytype ?? "1",
                 },
               }
             : {}),
@@ -478,6 +480,9 @@ export async function sendInfoflowGroupMessage(params: {
       // Build request body
       const bodyStr = JSON.stringify(payload);
 
+      getInfoflowSendLog().info(`[outbound:group] groupId=${groupId}, msgtype=${msgtype}, bodyLen=${bodyStr.length}, hasReply=${!!replyTo}`);
+      logVerbose(`[outbound:group] POST body: ${bodyStr}`);
+
       const res = await fetch(`${ensureHttps(apiHost)}${INFOFLOW_GROUP_SEND_PATH}`, {
         method: "POST",
         headers,
@@ -487,7 +492,8 @@ export async function sendInfoflowGroupMessage(params: {
 
       const responseText = await res.text();
       const data = JSON.parse(responseText) as Record<string, unknown>;
-      logVerbose(`[infoflow:sendGroup] response: status=${res.status}, data=${responseText}`);
+      getInfoflowSendLog().info(`[outbound:group] response: status=${res.status}, code=${data.code ?? "?"}, messageid=${extractIdFromRawJson(responseText, "messageid") ?? "?"}`);
+      logVerbose(`[outbound:group] response body: ${responseText}`);
 
       const code = typeof data.code === "string" ? data.code : "";
       if (code !== "ok") {
@@ -861,6 +867,8 @@ export async function sendInfoflowMessage(params: {
   // Parse target: remove "infoflow:" prefix if present
   const target = to.replace(/^infoflow:/i, "");
 
+  getInfoflowSendLog().info(`[outbound] sendMessage: to=${target}, items=${resolvedContents.length}, types=[${resolvedContents.map(c => c.type).join(",")}]`);
+
   // Check if target is a group (format: group:123)
   const groupMatch = target.match(/^group:(\d+)/i);
   if (groupMatch) {

package/src/commands/changelog.ts

@@ -0,0 +1,53 @@
+/**
+ * /infoflow-changelog command
+ *
+ * 读取 CHANGELOG.md，展示最近几次更新内容。
+ *
+ * 用法：
+ *   /infoflow-changelog        — 最近 5 次更新
+ *   /infoflow-changelog all    — 全部更新记录
+ */
+
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CHANGELOG_PATH = resolve(__dirname, "../../CHANGELOG.md");
+const DEFAULT_SHOW = 5;
+
+export async function runChangelogCommand(ctx: {
+  args?: string;
+}): Promise<{ text: string }> {
+  const showAll = ctx.args?.trim().toLowerCase() === "all";
+
+  if (!existsSync(CHANGELOG_PATH)) {
+    return { text: "**更新日志**\n\n暂无更新记录。" };
+  }
+
+  let content: string;
+  try {
+    content = readFileSync(CHANGELOG_PATH, "utf-8");
+  } catch (err: unknown) {
+    return {
+      text: `**更新日志**\n\n读取更新日志失败：${err instanceof Error ? err.message : String(err)}`,
+    };
+  }
+
+  // 按 "## " 版本标题分割，跳过第一个（文件标题行）
+  const sections = content.split(/^## /m).filter(Boolean);
+
+  if (sections.length === 0) {
+    return { text: "**Infoflow 更新日志**\n\n暂无更新记录。" };
+  }
+
+  const toShow = showAll ? sections : sections.slice(0, DEFAULT_SHOW);
+  const body = toShow.map((s) => `## ${s.trimEnd()}`).join("\n\n");
+
+  const hint =
+    !showAll && sections.length > DEFAULT_SHOW
+      ? `\n\n> 仅显示最近 ${toShow.length} 次更新，发送 \`/infoflow-changelog all\` 查看全部 ${sections.length} 次更新记录。`
+      : "";
+
+  return { text: `**Infoflow 更新日志**\n\n${body}${hint}` };
+}