@xgjktech/xg_cwork_im 1.0.7 → 1.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg_cwork_im",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "XG CWork IM channel plugin for OpenClaw",
   "keywords": [
     "bot",

package/src/channel.ts

@@ -13,16 +13,21 @@ import type { OpenClawConfig } from "openclaw/plugin-sdk";
 import { buildChannelConfigSchema } from "openclaw/plugin-sdk";
 import { z } from "zod";
 import { clearTokenCache, getToken } from "./auth.js";
-import { startWebSocket } from "./connection.js";
-import { sendTextMessage } from "./send-service.js";
-import type {
-    GatewayStartContext,
-    PluginRuntime,
-    ResolvedAccount,
-    WsMessage,
-    WsMessageParams,
-    XgImChannelPlugin,
-    XgImConfig,
+import { startWebSocket, type ImStreamClient } from "./connection.js";
+import { normalizeInboundWorkspaceSubdir, saveInboundFilesToWorkspace } from "./inbound-media-local.js";
+import { sendReplyDeliverBlock, sendTextMessage, type ReplyDeliverPayload } from "./send-service.js";
+import {
+    imFormatToMimeType,
+    type BotIdentity,
+    type GatewayStartContext,
+    type MsgFileVO,
+    type PluginRuntime,
+    type ResolvedAccount,
+    type WsMessage,
+    type WsMessageContent,
+    type WsMessageParams,
+    type XgImChannelPlugin,
+    type XgImConfig,
 } from "./types.js";
 
 // ─── 全局 Runtime（在 index.ts 的 register 中注入）────────────────────────────
@@ -47,6 +52,9 @@ const XgImAccountConfigSchema = z.object({
     agentId: z.string().optional().default("main"),
     name: z.string().optional(),
     groupPolicy: z.enum(["open", "mention"]).optional().default("mention"),
+    fileUploadFormField: z.string().min(1).optional(),
+    maxAttachmentBytes: z.number().int().positive().optional(),
+    inboundMediaWorkspaceSubdir: z.string().optional(),
 });
 
 const XgImConfigSchema = z.object({
@@ -63,9 +71,28 @@ const XgImConfigSchema = z.object({
     initialReconnectDelay: z.number().int().positive().optional().default(1_000),
     maxReconnectDelay: z.number().int().positive().optional().default(60_000),
     reconnectJitter: z.number().min(0).max(1).optional().default(0.3),
+    fileUploadFormField: z.string().min(1).optional(),
+    maxAttachmentBytes: z.number().int().positive().optional(),
+    /**
+     * 非空时：将入站附件下载到 `resolveAgentWorkspaceDir(cfg)` 下该相对子目录，
+     * 再向 OpenClaw 传本地 file:// 路径（见 inbound-media-local）。
+     */
+    inboundMediaWorkspaceSubdir: z.string().optional(),
     // 多账户：对象 map（key 为 accountId）
     accounts: z.record(z.string(), XgImAccountConfigSchema).optional(),
 }).superRefine((val, ctx) => {
+    const badSubdir = (s: string | undefined): boolean =>
+        typeof s === "string" && s.trim().length > 0 && normalizeInboundWorkspaceSubdir(s) == null;
+
+    if (badSubdir(val.inboundMediaWorkspaceSubdir)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["inboundMediaWorkspaceSubdir"],
+            message:
+                "inboundMediaWorkspaceSubdir must be a relative path under workspace (no .., no absolute path)",
+        });
+    }
+
     const accounts = val.accounts;
     if (!accounts) return;
     for (const [key, acc] of Object.entries(accounts)) {
@@ -78,6 +105,14 @@ const XgImConfigSchema = z.object({
                 message: "appKey is required for account entries (except accounts.default)",
             });
         }
+        if (badSubdir(acc.inboundMediaWorkspaceSubdir)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["accounts", key, "inboundMediaWorkspaceSubdir"],
+                message:
+                    "inboundMediaWorkspaceSubdir must be a relative path under workspace (no .., no absolute path)",
+            });
+        }
     }
 });
 
@@ -121,6 +156,53 @@ function isConfigured(cfg: OpenClawConfig): boolean {
     }
 }
 
+/**
+ * OpenClaw 对入站命令：`CommandAuthorized === undefined` 会按 false 处理，文本 /command 会被静默忽略（仍走普通 AI）。
+ * 见 openclaw LINE #26996 等修复。此处与 channels.xg_cwork_im.allowFrom 对齐；allowFrom 为空表示不限制发送者。
+ */
+function isSenderInXgImAllowFrom(config: XgImConfig, senderId: string | undefined): boolean {
+    const allow = config.allowFrom ?? [];
+    if (allow.length === 0) return true;
+    const id = senderId?.trim();
+    if (!id) return false;
+    return allow.includes(id);
+}
+
+function resolveInboundCommandAuthorized(
+    rt: unknown,
+    cfg: OpenClawConfig,
+    p: { accountId: string; senderId: string | undefined; config: XgImConfig },
+): boolean {
+    const r = rt as {
+        channel?: {
+            commands?: {
+                resolveControlCommandGate?: (args: Record<string, unknown>) =>
+                    | boolean
+                    | { commandAuthorized?: boolean };
+            };
+        };
+    };
+    const fn = r?.channel?.commands?.resolveControlCommandGate;
+    if (typeof fn === "function") {
+        try {
+            const out = fn({
+                cfg,
+                channel: "xg_cwork_im",
+                accountId: p.accountId,
+                senderId: p.senderId ?? "",
+                chatType: "group",
+            });
+            if (typeof out === "boolean") return out;
+            if (out && typeof out === "object" && "commandAuthorized" in out) {
+                return Boolean((out as { commandAuthorized?: boolean }).commandAuthorized);
+            }
+        } catch {
+            /* 回退到 allowFrom */
+        }
+    }
+    return isSenderInXgImAllowFrom(p.config, p.senderId);
+}
+
 // ─── 日志适配器 ───────────────────────────────────────────────────────────────
 // ChannelLogSink 的 info/warn/error 方法接受单个 string
 
@@ -140,6 +222,241 @@ function toLogger(sink: { info?: (msg: string) => void; warn?: (msg: string) =>
     };
 }
 
+// ─── WebSocket 入站：纯函数与 @ 后派发 ───────────────────────────────────────
+
+function collectFileItems(msgContent: WsMessageContent | undefined): MsgFileVO[] {
+    return (msgContent?.files ?? []).filter((f) => f.url?.trim());
+}
+
+function buildInboundDisplayText(msgContent: WsMessageContent | undefined, fileItems: MsgFileVO[]): string {
+    let rawText = msgContent?.text ?? "";
+    if (fileItems.length > 0) {
+        const lines = fileItems.map((f) => {
+            const name = f.name?.trim() || f.fileId || "未命名文件";
+            const mime = imFormatToMimeType(f.format);
+            return mime ? `- \`${name}\` (${mime})` : `- \`${name}\``;
+        });
+        const block = `**附件（${fileItems.length}）**\n${lines.join("\n")}`;
+        rawText = rawText.trim() ? `${rawText.trim()}\n\n${block}` : block;
+
+        const parsedParts = fileItems
+            .map((f) => {
+                const c = f.content?.trim();
+                if (!c) return null;
+                const name = f.name?.trim() || f.fileId || "未命名文件";
+                return `### ${name}\n\n${c}`;
+            })
+            .filter((x): x is string => x != null);
+        if (parsedParts.length > 0) {
+            const parsedBlock = `**附件解析内容**\n\n${parsedParts.join("\n\n")}`;
+            rawText = `${rawText.trim()}\n\n${parsedBlock}`;
+        }
+    }
+    return rawText;
+}
+
+function isActuallyMentioned(
+    msg: WsMessage,
+    params: WsMessageParams,
+    bot: { userId: string; name: string },
+    rawTextForLegacy: string,
+): boolean {
+    const mentions = params.mentions;
+    const isMentioned =
+        Array.isArray(mentions) && (mentions.includes(bot.userId) || mentions.includes("all"));
+    const isLegacyMentioned =
+        msg.cmd === "robotMention" &&
+        (!params.mentions || params.mentions.length === 0) &&
+        new RegExp(`@${bot.name}\\b`).test(rawTextForLegacy);
+    return isMentioned || isLegacyMentioned;
+}
+
+function mediaFieldsFromFileItems(fileItems: MsgFileVO[]): Record<string, unknown> {
+    if (fileItems.length === 0) return {};
+    const mimes = fileItems.map(
+        (f) => imFormatToMimeType(f.format) ?? "application/octet-stream",
+    );
+    // OpenClaw 入站展示与媒体拉取以 MediaPath(s) 为准；[media attached: …] 依赖 Path，仅写 MediaUrl 时该段不出现。
+    // 不要同时写 Path 与 Url（同链接会被拼成两段，出现 `url | url`）。
+    if (fileItems.length === 1) {
+        return {
+            MediaPath: fileItems[0]!.url,
+            MediaType: mimes[0],
+        };
+    }
+    return {
+        MediaPaths: fileItems.map((f) => f.url),
+        MediaTypes: mimes,
+    };
+}
+
+/** ext / 用户 background / 附件元数据（不含下载 URL，避免预签名链过长；URL 已在入站 MediaPath(s)） */
+function buildUntrustedContext(
+    msgExt: WsMessageContent["ext"],
+    senderBackground: string | undefined,
+    fileItems: MsgFileVO[],
+): string[] | undefined {
+    const parts: string[] = [];
+    if (msgExt) parts.push(JSON.stringify(msgExt));
+    if (senderBackground) parts.push(String(senderBackground));
+    if (fileItems.length > 0) {
+        const summary = fileItems.map((f) => ({
+            name: f.name ?? null,
+            format: f.format ?? null,
+            fileId: f.fileId ?? null,
+            size: f.size ?? null,
+            contentChars: f.content?.trim() ? f.content.trim().length : null,
+        }));
+        parts.push(`xg_cwork_im.attachments: ${JSON.stringify(summary)}`);
+    }
+    return parts.length > 0 ? parts : undefined;
+}
+
+function buildTargetReplyMeta(params: WsMessageParams): {
+    targetMsgId: string;
+    targetUserId: string;
+    targetUserName: string;
+    previewText: string;
+} {
+    return {
+        targetMsgId: params.msgId,
+        targetUserId: params.userInfo?.id ?? "",
+        targetUserName: params.userInfo?.name ?? "未知用户",
+        previewText: params.msgContent?.text ?? "",
+    };
+}
+
+/** 流式 START → dispatch → 必发 END；首包超时走 HTTP 覆盖占位 */
+async function dispatchMentionedReply(args: {
+    rt: any;
+    cfg: OpenClawConfig;
+    config: XgImConfig;
+    log: Logger;
+    logPrefix: string;
+    route: { sessionKey: string };
+    inboundCtx: unknown;
+    params: WsMessageParams;
+    currentIdentity: BotIdentity;
+    streamClient: ImStreamClient;
+}): Promise<void> {
+    const { rt, cfg, config, log, logPrefix, route, inboundCtx, params, currentIdentity, streamClient } = args;
+
+    log.info(`${logPrefix} [dispatch] Dispatching to OpenClaw AI, sessionKey=${route.sessionKey}`);
+    let isFirstReply = true;
+    const dispatchStart = Date.now();
+
+    const { msgId: streamMsgId } = await streamClient.start({
+        groupId: params.groupId,
+    });
+    log.info(`${logPrefix} [stream] START acknowledged: msgId=${streamMsgId}`);
+
+    let hasFirstReply = false;
+    const firstReplyTimeoutMs = config.firstReplyTimeoutMs ?? 30 * 60_000;
+    const timeoutLabel = `${logPrefix} [stream] First reply timeout after ${firstReplyTimeoutMs}ms, updating thinking message as error`;
+    const firstReplyTimeout = setTimeout(async () => {
+        if (hasFirstReply) return;
+        log.warn(timeoutLabel);
+        try {
+            const reply = buildTargetReplyMeta(params);
+            const timeoutText = "当前请求处理超时，请稍后重试。";
+            await sendTextMessage(
+                config,
+                currentIdentity.token,
+                params.groupId,
+                timeoutText,
+                [reply.targetUserId] as string[],
+                log,
+                streamMsgId,
+                reply,
+            );
+            log.info(
+                `${logPrefix} [send] Timeout reply sent via HTTP: groupId=${params.groupId} msgId=${streamMsgId} text="${timeoutText}"`,
+            );
+        } catch (err: unknown) {
+            log.error(`${logPrefix} [timeout] Failed to send timeout reply: ${String(err)}`);
+        }
+    }, firstReplyTimeoutMs);
+
+    try {
+        await rt.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+            ctx: inboundCtx,
+            cfg,
+            dispatcherOptions: {
+                responsePrefix: "",
+                deliver: async (payload: ReplyDeliverPayload) => {
+                    try {
+                        const textPart = (payload.markdown || payload.text || "").trim();
+                        const hasMedia =
+                            Boolean(payload.mediaUrl?.trim()) ||
+                            Boolean(payload.mediaUrls?.some((u) => typeof u === "string" && u.trim()));
+                        if (!textPart && !(hasMedia && !payload.isThinking)) return;
+
+                        if (isFirstReply) {
+                            const ttfr = Date.now() - dispatchStart;
+                            log.info(
+                                `${logPrefix} [deliver] First response block received from AI (TTFB: ${ttfr}ms)`,
+                            );
+                            isFirstReply = false;
+                        }
+
+                        const reply = buildTargetReplyMeta(params);
+                        const atIds = [reply.targetUserId] as string[];
+
+                        if (!hasFirstReply) {
+                            hasFirstReply = true;
+                            clearTimeout(firstReplyTimeout);
+                            await sendReplyDeliverBlock(
+                                config,
+                                currentIdentity.token,
+                                params.groupId,
+                                payload,
+                                atIds,
+                                log,
+                                streamMsgId,
+                                reply,
+                            );
+                            const preview =
+                                textPart.length > 80 ? `${textPart.slice(0, 80)}...` : textPart || "[media]";
+                            log.info(
+                                `${logPrefix} [send] First reply sent via HTTP: groupId=${params.groupId} msgId=${streamMsgId} preview="${preview}"`,
+                            );
+                            return;
+                        }
+
+                        await sendReplyDeliverBlock(
+                            config,
+                            currentIdentity.token,
+                            params.groupId,
+                            payload,
+                            atIds,
+                            log,
+                            undefined,
+                            reply,
+                        );
+                        const preview =
+                            textPart.length > 80 ? `${textPart.slice(0, 80)}...` : textPart || "[media]";
+                        log.info(
+                            `${logPrefix} [send] Additional reply sent via HTTP: groupId=${params.groupId} preview="${preview}"`,
+                        );
+                    } catch (err: unknown) {
+                        log.error(`${logPrefix} Reply deliver failed: ${String(err)}`);
+                        throw err;
+                    }
+                },
+            },
+        });
+        log.info(`${logPrefix} [dispatch] Dispatch completed for sessionKey=${route.sessionKey}`);
+    } finally {
+        clearTimeout(firstReplyTimeout);
+        try {
+            await streamClient.end(streamMsgId, "stop");
+            log.info(`${logPrefix} [stream] END sent: msgId=${streamMsgId}`);
+        } catch (endErr: unknown) {
+            log.error(`${logPrefix} [stream] END failed (msgId=${streamMsgId}): ${String(endErr)}`);
+        }
+    }
+}
+
 // ─── Channel Plugin 定义 ─────────────────────────────────────────────────────
 
 export const xgCworkImChannelPlugin: XgImChannelPlugin = {
@@ -159,7 +476,7 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
         chatTypes: ["group"] as Array<"direct" | "group">,
         reactions: false,
         threads: false,
-        media: false,
+        media: true,
         nativeCommands: false,
         blockStreaming: false,
     },
@@ -260,6 +577,35 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                 messageId: randomUUID(),
             };
         },
+
+        /** 出站带媒体：上传资源后发 FILE，与网关 deliver 逻辑一致（OpenClaw 要求与 sendText 同时实现） */
+        sendMedia: async (ctx) => {
+            const { cfg, to, text, mediaUrl, accountId, log: ctxLog } = ctx as typeof ctx & { log?: Logger };
+            const log = toLogger(ctxLog);
+            const config = getXgImConfig(cfg, accountId);
+            const identity = await getToken(config, log);
+
+            if (!mediaUrl?.trim()) {
+                await sendTextMessage(config, identity.token, to, text || "", [], log);
+                return { channel: "xg_cwork_im", messageId: randomUUID() };
+            }
+
+            await sendReplyDeliverBlock(
+                config,
+                identity.token,
+                to,
+                { text: text || "", mediaUrl: mediaUrl.trim() },
+                [],
+                log,
+                undefined,
+                undefined,
+            );
+
+            return {
+                channel: "xg_cwork_im",
+                messageId: randomUUID(),
+            };
+        },
     },
 
     // ── 网关（WebSocket 长连接）─────────────────────────────────────────────────
@@ -315,22 +661,29 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                     }
 
                     const msgContent = params.msgContent;
-                    const msgType = msgContent?.type ?? "text";
-                    const msgUrl = msgContent?.url;
+                    let fileItems = collectFileItems(msgContent);
                     const msgExt = msgContent?.ext;
                     const senderId = params.userInfo?.id;
                     const senderName = params.userInfo?.name || senderId || "";
                     const senderBackground = params.userInfo?.background;
 
-                    let rawText = msgContent?.text ?? "";
-                    // 如果是语音消息且没有文本内容，设为占位符
-                    if (msgType === "voice" && !rawText) {
-                        rawText = "[语音消息]";
+                    const inboundSub = config.inboundMediaWorkspaceSubdir?.trim();
+                    if (inboundSub && fileItems.length > 0 && normalizeInboundWorkspaceSubdir(inboundSub)) {
+                        fileItems = await saveInboundFilesToWorkspace({
+                            rt,
+                            cfg: ctx.cfg,
+                            config,
+                            workspaceSubdir: inboundSub,
+                            senderUserId: senderId,
+                            fileItems,
+                            log,
+                        });
                     }
-                    const text = rawText;
 
-                    if (!text && !msgUrl) {
-                        log.debug?.(`${logPrefix} Empty message (no text and no url), skipping`);
+                    const text = buildInboundDisplayText(msgContent, fileItems);
+
+                    if (!text.trim() && fileItems.length === 0) {
+                        log.debug?.(`${logPrefix} Empty message (no text and no files), skipping`);
                         return;
                     }
 
@@ -338,21 +691,8 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         `${logPrefix} Message from ${senderName}(${senderId ?? "unknown"}) in group=${params.groupId}: ${text}`,
                     );
 
-                    // 1. 获取当前机器人身份
                     const currentIdentity = await getToken(config, log);
-                    // 2. 判定是否真正 @ 了当前机器人
-                    const mentions = params.mentions;
-                    const isMentioned = Array.isArray(mentions) &&
-                        (mentions.includes(currentIdentity.userId) || mentions.includes("all"));
-
-                    // (补充逻辑) 如果是 robotMention 指令，但没有 mentions 列表，则降级为老逻辑：文本正则匹配
-                    const isLegacyMentioned = msg.cmd === "robotMention" &&
-                        (!params.mentions || params.mentions.length === 0) &&
-                        new RegExp(`@${currentIdentity.name}\\b`).test(rawText);
-
-                    const actuallyMentioned = isMentioned || isLegacyMentioned;
-
-                    // 3. 构建 OpenClaw 视角的“单条纯净消息”
+                    const actuallyMentioned = isActuallyMentioned(msg, params, currentIdentity, text);
 
                     // 通过 PluginRuntime 路由消息到 OpenClaw
                     const route = rt.channel.routing.resolveAgentRoute({
@@ -387,10 +727,17 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         envelope: envelopeOptions,
                     });
 
+                    const commandAuthorized = resolveInboundCommandAuthorized(rt, ctx.cfg, {
+                        accountId: account.accountId,
+                        senderId,
+                        config,
+                    });
+
                     const inboundCtx = rt.channel.reply.finalizeInboundContext({
                         Body: body,
                         RawBody: text,
                         CommandBody: text,
+                        CommandAuthorized: commandAuthorized,
                         From: params.groupId,
                         To: params.groupId,
                         SessionKey: route.sessionKey,
@@ -407,16 +754,8 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         OriginatingChannel: "xg_cwork_im",
                         OriginatingTo: params.groupId,
                         GroupChannel: route.sessionKey,
-                        // 透传媒体信息
-                        MediaUrl: msgUrl,
-                        MediaType: msgType === "voice" ? "voice" : undefined,
-                        // 透传扩展字段给 AI (作为 UntrustedContext)
-                        UntrustedContext: (() => {
-                            const parts: string[] = [];
-                            if (msgExt) parts.push(JSON.stringify(msgExt));
-                            if (senderBackground) parts.push(String(senderBackground));
-                            return parts.length > 0 ? parts : undefined;
-                        })(),
+                        ...mediaFieldsFromFileItems(fileItems),
+                        UntrustedContext: buildUntrustedContext(msgExt, senderBackground, fileItems),
                         // 同时保留原始 ext 供可能的后续逻辑使用
                         XgImExt: msgExt,
                     });
@@ -449,140 +788,19 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         },
                     });
 
-                    // 【只有真 @ 我的消息才做】呼叫 AI 激活推理
                     if (actuallyMentioned) {
-                        log.info(`${logPrefix} [dispatch] Dispatching to OpenClaw AI, sessionKey=${route.sessionKey}`);
-                        let isFirstReply = true;
-                        const dispatchStart = Date.now();
-
-                        // 1. 先向 IM 声明“开始流式消息”，拿到 msgId
-                        const { msgId } = await wsHandle.streamClient.start({
-                            groupId: params.groupId,
-                        });
-                        log.info(`${logPrefix} [stream] START acknowledged: msgId=${msgId}`);
-
-                        // 1.1 为“思考中”占位增加首回复超时保护（默认 30分钟，可通过 firstReplyTimeoutMs 配置）
-                        let hasFirstReply = false;
-                        let firstReplyTimedOut = false;
-                        const firstReplyTimeoutMs = config.firstReplyTimeoutMs ?? 30 * 60_000;
-                        const timeoutLabel = `${logPrefix} [stream] First reply timeout after ${firstReplyTimeoutMs}ms, updating thinking message as error`;
-                        const firstReplyTimeout = setTimeout(async () => {
-                            if (hasFirstReply) {
-                                return;
-                            }
-                            firstReplyTimedOut = true;
-                            log.warn(timeoutLabel);
-                            try {
-                                const senderId = params.userInfo?.id;
-                                const senderName = params.userInfo?.name ?? "未知用户";
-                                const text = params.msgContent?.text ?? "";
-                                const reply = {
-                                    targetMsgId: params.msgId,
-                                    targetUserId: senderId ?? "",
-                                    targetUserName: senderName,
-                                    previewText: text,
-                                };
-                                const timeoutText = "当前请求处理超时，请稍后重试。";
-                                await sendTextMessage(
-                                    config,
-                                    currentIdentity.token,
-                                    params.groupId,
-                                    timeoutText,
-                                    [senderId ?? ""] as string[],
-                                    log,
-                                    msgId,
-                                    reply,
-                                );
-                                log.info(
-                                    `${logPrefix} [send] Timeout reply sent via HTTP: groupId=${params.groupId} msgId=${msgId} text="${timeoutText}"`,
-                                );
-                            } catch (err: unknown) {
-                                log.error(`${logPrefix} [timeout] Failed to send timeout reply: ${String(err)}`);
-                            }
-                        }, firstReplyTimeoutMs);
-
-                        // 2. 分发消息给 AI，deliver 回调负责发送首条和后续回复
-                        let fullText = "";
-
-                        await rt.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
-                            ctx: inboundCtx,
+                        await dispatchMentionedReply({
+                            rt,
                             cfg: ctx.cfg,
-                            dispatcherOptions: {
-                                responsePrefix: "",
-                                deliver: async (payload: { markdown?: string; text?: string; isThinking?: boolean }) => {
-                                    try {
-                                        const textToSend = payload.markdown || payload.text;
-                                        if (!textToSend) return;
-
-                                        if (isFirstReply) {
-                                            const ttfr = Date.now() - dispatchStart;
-                                            log.info(`${logPrefix} [deliver] First response block received from AI (TTFB: ${ttfr}ms)`);
-                                            isFirstReply = false;
-                                        }
-
-                                        fullText += textToSend;
-
-                                        const senderId = params.userInfo?.id;
-                                        const senderName = params.userInfo?.name ?? "未知用户";
-                                        const text = params.msgContent?.text ?? "";
-                                        const reply = {
-                                            targetMsgId: params.msgId,
-                                            targetUserId: senderId ?? "",
-                                            targetUserName: senderName,
-                                            previewText: text,
-                                        };
-
-                                        // 第一次有效回复：覆盖“思考中”占位消息（带 msgId）
-                                        if (!hasFirstReply) {
-                                            hasFirstReply = true;
-                                            clearTimeout(firstReplyTimeout);
-                                            await sendTextMessage(
-                                                config,
-                                                currentIdentity.token,
-                                                params.groupId,
-                                                textToSend,
-                                                [senderId ?? ""] as string[],
-                                                log,
-                                                msgId,
-                                                reply,
-                                            );
-                                            const preview = textToSend.length > 80 ? `${textToSend.slice(0, 80)}...` : textToSend;
-                                            log.info(
-                                                `${logPrefix} [send] First reply sent via HTTP: groupId=${params.groupId} msgId=${msgId} text="${preview}"`,
-                                            );
-                                            return;
-                                        }
-
-                                        // 后续回复：作为独立消息发送（不再复用 msgId）
-                                        await sendTextMessage(
-                                            config,
-                                            currentIdentity.token,
-                                            params.groupId,
-                                            textToSend,
-                                            [senderId ?? ""] as string[],
-                                            log,
-                                            undefined,
-                                            reply,
-                                        );
-                                        const preview = textToSend.length > 80 ? `${textToSend.slice(0, 80)}...` : textToSend;
-                                        log.info(
-                                            `${logPrefix} [send] Additional reply sent via HTTP: groupId=${params.groupId} text="${preview}"`,
-                                        );
-                                    } catch (err: unknown) {
-                                        log.error(`${logPrefix} Reply deliver failed: ${String(err)}`);
-                                        throw err;
-                                    }
-                                },
-                            },
+                            config,
+                            log,
+                            logPrefix,
+                            route,
+                            inboundCtx,
+                            params,
+                            currentIdentity,
+                            streamClient: wsHandle.streamClient,
                         });
-
-                        // 3. AI 推理完成，发送 END，结束本次流式占位语义
-                        // 一旦发送 END，就不再补发「请求超时」消息，因此这里无条件清理定时器。
-                        clearTimeout(firstReplyTimeout);
-                        await wsHandle.streamClient.end(msgId, "stop");
-                        log.info(`${logPrefix} [stream] END sent: msgId=${msgId}`);
-
-                        log.info(`${logPrefix} [dispatch] Dispatch completed for sessionKey=${route.sessionKey}`);
                     } else {
                         // 没 @ 我，仅作为旁观者缓存记忆，不打扰群里聊天
                         log.debug?.(`${logPrefix} Not mentioned in group, quietly memorized the message context.`);