@downcity/agent 1.1.10 → 1.1.12

package/bin/service/builtins/chat/channels/feishu/FeishuMessageHandler.js

@@ -0,0 +1,247 @@
+/**
+ * Feishu 入站消息处理器。
+ *
+ * 关键点（中文）
+ * - 负责单条飞书消息的去重、解析、授权、附件保存与执行入队。
+ * - 不持有 `FeishuBot` 实例；所有副作用通过显式依赖注入。
+ * - 解析失败/执行失败通过渠道门面提供的发送函数回写错误消息。
+ */
+import path from "path";
+import { buildReplyContextExtra, buildReplyContextInstruction, } from "../../../../../service/builtins/chat/runtime/ReplyContextFormatter.js";
+import { augmentChatInboundInput, buildChatInboundText, } from "../../../../../service/builtins/chat/runtime/InboundAugment.js";
+import { renderChatMessageFileTag } from "../../../../../service/builtins/chat/runtime/ChatMessageMarkup.js";
+import { parseFeishuInboundMessage } from "./InboundAttachment.js";
+import { extractFeishuSenderIdentity, isFeishuGroupChat, stripFeishuAtMentions, } from "./FeishuInbound.js";
+/**
+ * 处理 Feishu 入站消息。
+ */
+export async function handleFeishuMessage(options, data) {
+    try {
+        if (!data?.message)
+            return;
+        const { message: { chat_id, content, message_type, chat_type, message_id, parent_id, }, } = data;
+        const threadId = options.buildChatKey(chat_id);
+        const senderIdentity = extractFeishuSenderIdentity(data);
+        const actorId = senderIdentity.senderId;
+        const normalizedMessageId = String(message_id || "").trim();
+        if (!normalizedMessageId)
+            return;
+        if (!actorId) {
+            options.logger.warn("飞书消息缺少发送者 userId/open_id，已忽略", {
+                chatId: chat_id,
+                chatType: chat_type,
+                messageId: normalizedMessageId,
+            });
+            return;
+        }
+        if (options.processedMessages.has(normalizedMessageId)) {
+            options.logger.debug(`Message already processed, skipping: ${normalizedMessageId}`);
+            return;
+        }
+        const persisted = await options.loadDedupeSet(threadId);
+        if (persisted.has(normalizedMessageId)) {
+            options.logger.debug(`Message already processed (persisted), skipping: ${normalizedMessageId}`);
+            return;
+        }
+        if (options.processingMessages.has(normalizedMessageId)) {
+            options.logger.debug(`Message is already being processed, skipping duplicate delivery: ${normalizedMessageId}`);
+            return;
+        }
+        options.processingMessages.add(normalizedMessageId);
+        let handled = false;
+        try {
+            let parsedInput;
+            try {
+                parsedInput = await parseIncomingMessage({
+                    options,
+                    chatId: chat_id,
+                    chatType: chat_type,
+                    messageId: message_id,
+                    messageType: message_type,
+                    content,
+                    parentMessageId: parent_id,
+                });
+            }
+            catch (error) {
+                await options.sendErrorMessage({
+                    chatId: chat_id,
+                    chatType: chat_type,
+                    messageId: message_id,
+                    errorText: `Failed to parse message: ${String(error)}`,
+                });
+                handled = true;
+                return;
+            }
+            if (parsedInput.alreadyHandled) {
+                handled = true;
+                return;
+            }
+            const handledByAuth = await handleAuthorizedMessage({
+                options,
+                data,
+                threadId,
+                senderIdentity,
+                actorId,
+                chatId: chat_id,
+                chatType: chat_type,
+                messageId: message_id,
+                ...parsedInput,
+            });
+            handled = handledByAuth;
+        }
+        finally {
+            options.processingMessages.delete(normalizedMessageId);
+            if (handled) {
+                options.processedMessages.add(normalizedMessageId);
+                persisted.add(normalizedMessageId);
+                await options.persistDedupeSet(threadId, persisted);
+            }
+        }
+    }
+    catch (error) {
+        options.logger.error("Failed to process Feishu message", {
+            error: String(error),
+        });
+    }
+}
+/**
+ * 解析入站消息文本、附件和 reply 上下文。
+ */
+async function parseIncomingMessage(params) {
+    const parsed = parseFeishuInboundMessage({
+        messageType: params.messageType,
+        content: params.content,
+    });
+    if (parsed.unsupportedType) {
+        await params.options.sendErrorMessage({
+            chatId: params.chatId,
+            chatType: params.chatType,
+            messageId: params.messageId,
+            errorText: `Unsupported Feishu message type: ${parsed.unsupportedType}`,
+        });
+        return {
+            userMessage: "",
+            incomingAttachments: [],
+            alreadyHandled: true,
+        };
+    }
+    return {
+        userMessage: parsed.text,
+        incomingAttachments: await params.options.downloadIncomingAttachments({
+            messageId: params.messageId,
+            attachments: parsed.attachments,
+        }),
+        replyContext: await params.options.resolveReplyContext({
+            parentMessageId: params.parentMessageId,
+        }),
+    };
+}
+/**
+ * 授权后处理消息内容。
+ */
+async function handleAuthorizedMessage(params) {
+    const { options, threadId, senderIdentity, actorId, chatId, chatType, messageId, incomingAttachments, replyContext, } = params;
+    let userMessage = params.userMessage;
+    options.logger.info(`Received Feishu message: ${userMessage || "[attachment]"}`);
+    const actorName = (await options.resolveSenderName({
+        ...senderIdentity,
+        chatId,
+    })) || undefined;
+    const resolvedChatTitle = await options.resolveChatTitle(chatId);
+    const chatTitle = resolvedChatTitle || (chatType === "p2p" ? actorName : undefined);
+    await options.observeIncomingAuthorization({
+        chatId,
+        chatType,
+        chatTitle,
+        userId: actorId,
+        username: actorName,
+    });
+    const authResult = await options.evaluateIncomingAuthorization({
+        chatId,
+        chatType,
+        chatTitle,
+        userId: actorId,
+        username: actorName,
+    });
+    if (authResult.decision !== "allow") {
+        if (chatType === "p2p") {
+            await options.sendAuthorizationText({
+                chatId,
+                chatType,
+                text: options.buildUnauthorizedBlockedText({
+                    chatId,
+                    chatType,
+                    userId: actorId,
+                }),
+            });
+        }
+        return true;
+    }
+    options.rememberChat(threadId, {
+        chatId,
+        chatType,
+        ...(chatTitle ? { chatTitle } : {}),
+    });
+    await options.sendInboundAckReaction({ messageId });
+    await options.runInChat(threadId, async () => {
+        if (userMessage.startsWith("/") && incomingAttachments.length === 0) {
+            await options.handleCommand({
+                chatId,
+                chatType,
+                messageId,
+                command: userMessage,
+            });
+            return;
+        }
+        const attachmentLines = incomingAttachments.map((attachment) => {
+            const rel = path.relative(options.rootPath, attachment.path);
+            return renderChatMessageFileTag({
+                type: attachment.type,
+                path: rel,
+                ...(attachment.desc ? { caption: attachment.desc } : {}),
+            });
+        });
+        if (isFeishuGroupChat(chatType)) {
+            userMessage = stripFeishuAtMentions(userMessage);
+        }
+        const instructions = buildReplyContextInstruction({
+            text: buildChatInboundText(await augmentChatInboundInput({
+                context: options.context,
+                input: {
+                    channel: "feishu",
+                    chatId,
+                    chatType,
+                    chatKey: threadId,
+                    messageId,
+                    rootPath: options.rootPath,
+                    attachmentText: attachmentLines.length > 0 ? attachmentLines.join("\n") : undefined,
+                    bodyText: userMessage ? userMessage.trim() : undefined,
+                    attachments: incomingAttachments.map((attachment) => ({
+                        channel: "feishu",
+                        kind: attachment.type,
+                        path: attachment.path,
+                        desc: attachment.desc,
+                    })),
+                },
+            })) ||
+                (attachmentLines.length > 0
+                    ? `${attachmentLines.join("\n")}\n\n请查看以上附件。`
+                    : ""),
+            replyContext,
+        });
+        if (!instructions)
+            return;
+        await options.executeAndReply({
+            chatId,
+            chatType,
+            messageId,
+            instructions,
+            actorId,
+            actorName,
+            chatTitle,
+            extra: buildReplyContextExtra(replyContext),
+        });
+    });
+    return true;
+}
+//# sourceMappingURL=FeishuMessageHandler.js.map

package/bin/service/builtins/chat/channels/feishu/FeishuMessageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuMessageHandler.js","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/feishu/FeishuMessageHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,0DAA0D,CAAC;AAClE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAgJ5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoC,EACpC,IAAwB;IAExB,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,EAAE,OAAO;YAAE,OAAO;QAC3B,MAAM,EACJ,OAAO,EAAE,EACP,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,GACV,GACF,GAAG,IAAI,CAAC;QAET,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,cAAc,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC;QACxC,MAAM,mBAAmB,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAClD,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,mBAAmB;aAC/B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,mBAAmB,EAAE,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oDAAoD,mBAAmB,EAAE,CAC1E,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oEAAoE,mBAAmB,EAAE,CAC1F,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAEpD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,WAKH,CAAC;YACF,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,oBAAoB,CAAC;oBACvC,OAAO;oBACP,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,SAAS;oBACnB,SAAS,EAAE,UAAU;oBACrB,WAAW,EAAE,YAAY;oBACzB,OAAO;oBACP,eAAe,EAAE,SAAS;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,CAAC,gBAAgB,CAAC;oBAC7B,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,SAAS;oBACnB,SAAS,EAAE,UAAU;oBACrB,SAAS,EAAE,4BAA4B,MAAM,CAAC,KAAK,CAAC,EAAE;iBACvD,CAAC,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO;YACT,CAAC;YACD,IAAI,WAAW,CAAC,cAAc,EAAE,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO;YACT,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,uBAAuB,CAAC;gBAClD,OAAO;gBACP,IAAI;gBACJ,QAAQ;gBACR,cAAc;gBACd,OAAO;gBACP,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,UAAU;gBACrB,GAAG,WAAW;aACf,CAAC,CAAC;YACH,OAAO,GAAG,aAAa,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACnD,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACnC,MAAM,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;YACvD,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAC,MAQnC;IAMC,MAAM,MAAM,GAAG,yBAAyB,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,oCAAoC,MAAM,CAAC,eAAe,EAAE;SACxE,CAAC,CAAC;QACH,OAAO;YACL,WAAW,EAAE,EAAE;YACf,mBAAmB,EAAE,EAAE;YACvB,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,IAAI;QACxB,mBAAmB,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAC;YACpE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QACF,YAAY,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACrD,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB,CAAC,MAYtC;IACC,MAAM,EACJ,OAAO,EACP,QAAQ,EACR,cAAc,EACd,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,YAAY,GACb,GAAG,MAAM,CAAC;IACX,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAErC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,WAAW,IAAI,cAAc,EAAE,CAAC,CAAC;IACjF,MAAM,SAAS,GACb,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC;QAC/B,GAAG,cAAc;QACjB,MAAM;KACP,CAAC,CAAC,IAAI,SAAS,CAAC;IACnB,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,iBAAiB,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEpF,MAAM,OAAO,CAAC,4BAA4B,CAAC;QACzC,MAAM;QACN,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,6BAA6B,CAAC;QAC7D,MAAM;QACN,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACpC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACvB,MAAM,OAAO,CAAC,qBAAqB,CAAC;gBAClC,MAAM;gBACN,QAAQ;gBACR,IAAI,EAAE,OAAO,CAAC,4BAA4B,CAAC;oBACzC,MAAM;oBACN,QAAQ;oBACR,MAAM,EAAE,OAAO;iBAChB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE;QAC7B,MAAM;QACN,QAAQ;QACR,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,sBAAsB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAEpD,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC3C,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,OAAO,CAAC,aAAa,CAAC;gBAC1B,MAAM;gBACN,QAAQ;gBACR,SAAS;gBACT,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;YAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,wBAAwB,CAAC;gBAC9B,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,GAAG;gBACT,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,WAAW,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,YAAY,GAAG,4BAA4B,CAAC;YAChD,IAAI,EACF,oBAAoB,CAClB,MAAM,uBAAuB,CAAC;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE;oBACL,OAAO,EAAE,QAAQ;oBACjB,MAAM;oBACN,QAAQ;oBACR,OAAO,EAAE,QAAQ;oBACjB,SAAS;oBACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,cAAc,EACZ,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;oBACrE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;oBACtD,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;wBACpD,OAAO,EAAE,QAAiB;wBAC1B,IAAI,EAAE,UAAU,CAAC,IAAI;wBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;wBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;qBACtB,CAAC,CAAC;iBACJ;aACF,CAAC,CACH;gBACD,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;oBACzB,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc;oBAC7C,CAAC,CAAC,EAAE,CAAC;YACT,YAAY;SACb,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY;YAAE,OAAO;QAE1B,MAAM,OAAO,CAAC,eAAe,CAAC;YAC5B,MAAM;YACN,QAAQ;YACR,SAAS;YACT,YAAY;YACZ,OAAO;YACP,SAAS;YACT,SAAS;YACT,KAAK,EAAE,sBAAsB,CAAC,YAAY,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/bin/service/builtins/chat/channels/feishu/FeishuPlatformClient.d.ts

@@ -6,7 +6,7 @@
  * - 查询类能力与发送类能力已经拆到旁路模块，当前文件只保留平台宿主职责。
  * - `FeishuBot` 只调用这里暴露的平台能力，不再直接持有底层 Feishu 连接细节。
  */
-import type { AgentContext } from "../../../../../agent/AgentContextTypes.js";
+import type { AgentContext } from "../../../../../runtime/AgentContextTypes.js";
 import type { FeishuConfig, FeishuDownloadedAttachment, FeishuMessageEvent, FeishuMessagePayloadType } from "../../../../../service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 import type { ChatChannelTestResult } from "../../../../../service/builtins/chat/types/ChannelStatus.js";
 import type { ParsedFeishuAttachmentCommand } from "../../../../../service/builtins/chat/types/FeishuAttachment.js";

package/bin/service/builtins/chat/channels/feishu/FeishuPlatformClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeishuPlatformClient.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/feishu/FeishuPlatformClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FeishuPlatformClient.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/feishu/FeishuPlatformClient.ts"],"names":[],"mappings":"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"}

package/bin/service/builtins/chat/channels/feishu/FeishuPlatformLookup.d.ts

@@ -6,7 +6,7 @@
  * - `FeishuPlatformClient` 只保留运行时状态与 token 管理，这里负责具体 OpenAPI 查询细节。
  */
 import * as Lark from "@larksuiteoapi/node-sdk";
-import type { JsonObject } from "../../../../../utils/types/Json.js";
+import type { JsonObject } from "../../../../../types/common/Json.js";
 import type { FeishuDownloadedAttachment } from "../../../../../service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 import type { FeishuIncomingAttachmentDescriptor } from "../../../../../service/builtins/chat/types/FeishuInboundAttachment.js";
 import type { InboundReplyContext } from "../../../../../service/builtins/chat/types/ReplyContext.js";

package/bin/service/builtins/chat/channels/feishu/FeishuPlatformLookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeishuPlatformLookup.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/feishu/FeishuPlatformLookup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,gEAAgE,CAAC;AACxE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,0DAA0D,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAIzF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC/C;;WAEG;QACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KACjD,CAAC;IACF;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B;;OAEG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrD;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC;;OAEG;IACH,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C;;OAEG;IACH,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;OAEG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAwHD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4G7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiE7B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAiE1C;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,kCAAkC,EAAE,CAAC;CACnD,GACA,OAAO,CAAC,0BAA0B,EAAE,CAAC,CA0CvC"}
+{"version":3,"file":"FeishuPlatformLookup.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/feishu/FeishuPlatformLookup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,gEAAgE,CAAC;AACxE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,0DAA0D,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAIzF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC/C;;WAEG;QACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KACjD,CAAC;IACF;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B;;OAEG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrD;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC;;OAEG;IACH,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C;;OAEG;IACH,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;OAEG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAwHD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4G7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiE7B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAiE1C;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IACN;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,kCAAkC,EAAE,CAAC;CACnD,GACA,OAAO,CAAC,0BAA0B,EAAE,CAAC,CA0CvC"}

package/bin/service/builtins/chat/channels/feishu/types/FeishuChannel.d.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
- * - `services/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ * - `service/builtins/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
  */
 /**
  * 飞书适配器配置。

package/bin/service/builtins/chat/channels/feishu/types/FeishuChannel.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
- * - `services/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ * - `service/builtins/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
  */
 export {};
 //# sourceMappingURL=FeishuChannel.js.map

package/bin/service/builtins/chat/channels/qq/QQ.d.ts

@@ -9,7 +9,7 @@
  */
 import { BaseChatChannel } from "../../../../../service/builtins/chat/channels/BaseChatChannel.js";
 import type { ChannelChatKeyParams, ChannelSendTextParams } from "../../../../../service/builtins/chat/channels/BaseChatChannel.js";
-import type { AgentContext } from "../../../../../agent/AgentContextTypes.js";
+import type { AgentContext } from "../../../../../runtime/AgentContextTypes.js";
 import type { ChatChannelTestResult } from "../../../../../service/builtins/chat/types/ChannelStatus.js";
 import type { QQConfig } from "../../../../../service/builtins/chat/channels/qq/types/QqChannel.js";
 /**
@@ -64,14 +64,14 @@ export declare class QQBot extends BaseChatChannel {
      * 处理 C2C 私聊消息。
      */
     private handleC2CMessage;
-    /**
-     * QQ 入站主流程。
-     */
-    private handleInboundMessage;
     /**
      * 处理频道消息。
      */
     private handleChannelMessage;
+    /**
+     * 构造 QQ 入站处理依赖。
+     */
+    private getMessageHandlerOptions;
     /**
      * 入站去重检查。
      */

package/bin/service/builtins/chat/channels/qq/QQ.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QQ.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/qq/QQ.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AAoBtF,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,wDAAwD,CAAC;AAGtG;;GAEG;AACH,qBAAa,KAAM,SAAQ,eAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;IACrE,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,cAAc,CAAM;gBAG1B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,OAAe;IAuB7B,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM;cAQ1C,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACH,iBAAiB,IAAI;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;KAC1D;IAcD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAgBtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;YACW,cAAc;IAoC5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;YACW,kBAAkB;IA2BhC;;OAEG;YACW,gBAAgB;IA2B9B;;OAEG;YACW,oBAAoB;IA6JlC;;OAEG;YACW,oBAAoB;IA+ElC;;OAEG;YACW,kCAAkC;IAmBhD;;OAEG;YACW,aAAa;IAiB3B;;OAEG;YACW,eAAe;CA4B9B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAWvB"}
+{"version":3,"file":"QQ.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/qq/QQ.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AAgBtF,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,wDAAwD,CAAC;AAGtG;;GAEG;AACH,qBAAa,KAAM,SAAQ,eAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;IACrE,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,cAAc,CAAM;gBAG1B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,OAAe;IAuB7B,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM;cAQ1C,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACH,iBAAiB,IAAI;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;KAC1D;IAcD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAgBtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;YACW,cAAc;IAoC5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;YACW,kBAAkB;IAOhC;;OAEG;YACW,gBAAgB;IAI9B;;OAEG;YACW,oBAAoB;IAIlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4ChC;;OAEG;YACW,kCAAkC;IAmBhD;;OAEG;YACW,aAAa;IAiB3B;;OAEG;YACW,eAAe;CA4B9B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAWvB"}

package/bin/service/builtins/chat/channels/qq/QQ.js

@@ -10,10 +10,10 @@
 import { BaseChatChannel } from "../../../../../service/builtins/chat/channels/BaseChatChannel.js";
 import { parseChatMessageMarkup } from "../../../../../service/builtins/chat/runtime/ChatMessageMarkup.js";
 import { QqInboundDedupeStore } from "./QQInboundDedupe.js";
-import { buildQqAuditText, extractQqAuthorIdentity, extractQqInboundAttachments, extractQqTextContent, resolveQqInboundChatTitle, stripQqBotMention, } from "./QQInbound.js";
 import { getQqEventCaptureConfig } from "./QQEventCapture.js";
 import { QQGatewayClient } from "./QQGatewayClient.js";
-import { buildQqInboundInstructions, extractQqReadyIdentity, resolveQqC2cChatId, resolveQqCommandAction, resolveQqGroupChatId, } from "./QQSupport.js";
+import { extractQqReadyIdentity, resolveQqCommandAction, } from "./QQSupport.js";
+import { handleQqC2CMessage, handleQqChannelMessage, handleQqGroupMessage, } from "./QQMessageHandler.js";
 import { EventType } from "../../../../../service/builtins/chat/channels/qq/types/QqChannel.js";
 /**
  * QQ 平台适配器。
@@ -177,248 +177,50 @@ export class QQBot extends BaseChatChannel {
      * 处理群聊消息。
      */
     async handleGroupMessage(params) {
-        const eventType = String(params.eventType || "").trim();
-        const data = params.data;
-        const messageId = typeof data.id === "string" ? data.id.trim() : String(data.id || "").trim();
-        if (!messageId)
-            return;
-        const groupId = resolveQqGroupChatId(data);
-        if (!groupId) {
-            this.logger.warn("QQ 群消息缺少 groupId，已忽略", {
-                eventType: eventType || EventType.GROUP_MESSAGE_CREATE,
-                messageId,
-            });
-            return;
-        }
-        await this.handleInboundMessage({
-            eventType: eventType || EventType.GROUP_MESSAGE_CREATE,
-            chatId: groupId,
-            chatType: "group",
-            data,
-        });
+        await handleQqGroupMessage(this.getMessageHandlerOptions(), params);
     }
     /**
      * 处理 C2C 私聊消息。
      */
     async handleC2CMessage(data) {
-        const messageId = typeof data.id === "string" ? data.id.trim() : String(data.id || "").trim();
-        if (!messageId)
-            return;
-        const actor = extractQqAuthorIdentity(data.author, data);
-        const chatId = resolveQqC2cChatId({
-            data,
-            actorUserId: actor.userId,
-        });
-        if (!chatId) {
-            this.logger.warn("QQ C2C 消息缺少 userId，已忽略", {
-                eventType: EventType.C2C_MESSAGE_CREATE,
-                messageId,
-            });
-            return;
-        }
-        await this.handleInboundMessage({
-            eventType: EventType.C2C_MESSAGE_CREATE,
-            chatId,
-            chatType: "c2c",
-            data,
-            actor,
-        });
+        await handleQqC2CMessage(this.getMessageHandlerOptions(), data);
     }
     /**
-     * QQ 入站主流程。
+     * 处理频道消息。
      */
-    async handleInboundMessage(params) {
-        const eventType = String(params.eventType || "").trim();
-        const chatId = String(params.chatId || "").trim();
-        const messageId = typeof params.data.id === "string"
-            ? params.data.id.trim()
-            : String(params.data.id || "").trim();
-        if (!chatId || !messageId)
-            return;
-        if (await this.shouldSkipDuplicatedInboundMessage(eventType, messageId)) {
-            return;
-        }
-        const actor = params.actor || extractQqAuthorIdentity(params.data.author, params.data);
-        const chatType = params.chatType;
-        if (!actor.userId) {
-            this.logger.warn("QQ 入站消息缺少发送者 userId，已忽略", {
-                eventType,
-                chatId,
-                chatType,
-                messageId,
-            });
-            return;
-        }
-        const chatTitle = resolveQqInboundChatTitle({
-            chatType,
-            data: params.data,
-            actorName: actor.username,
-        });
-        const isGroup = chatType === "group";
-        const chatKey = this.getChatKey({ chatId, chatType });
-        const rawContent = String(params.data.content || "");
-        const incomingAttachments = extractQqInboundAttachments(params.data);
-        const hasIncomingAttachment = incomingAttachments.length > 0;
-        const cleanedText = isGroup
-            ? stripQqBotMention(rawContent, this.botUserId)
-            : extractQqTextContent(rawContent);
-        await this.observeIncomingAuthorization({
-            chatId,
-            chatType,
-            chatTitle,
-            userId: actor.userId,
-            username: actor.username,
-        });
-        const authResult = await this.evaluateIncomingAuthorization({
-            chatId,
-            chatType,
-            chatTitle,
-            userId: actor.userId,
-            username: actor.username,
-        });
-        if (authResult.decision !== "allow") {
-            if (!isGroup) {
-                await this.sendAuthorizationText({
-                    chatId,
-                    chatType,
-                    text: this.buildUnauthorizedBlockedText({
-                        chatId,
-                        chatType,
-                        userId: actor.userId,
-                    }),
-                });
-            }
-            return;
-        }
-        const enqueueAudit = async (opts) => {
-            await this.enqueueAuditMessage({
-                chatId,
-                messageId,
-                userId: actor.userId,
-                text: buildQqAuditText({
-                    rawContent,
-                    cleanedText,
-                    hasIncomingAttachment,
-                }),
-                meta: {
-                    chatType,
-                    username: actor.username,
-                    chatTitle,
-                    eventType,
-                    reason: opts.reason,
-                    ...(opts.kind ? { kind: opts.kind } : {}),
-                },
-            });
-        };
-        if (actor.userId && this.botUserId && actor.userId === this.botUserId) {
-            if (isGroup) {
-                await enqueueAudit({ reason: "bot_originated" });
-            }
-            this.logger.debug("忽略机器人自身消息", {
-                messageId,
-                chatId,
-                chatType,
-                botUserId: this.botUserId,
-            });
-            return;
-        }
-        this.logger.info(`收到 ${chatType} 消息 [${chatId}]: ${cleanedText}`);
-        if (!rawContent && !hasIncomingAttachment) {
-            if (isGroup) {
-                await enqueueAudit({ reason: "empty_payload" });
-            }
-            return;
-        }
-        if (cleanedText.startsWith("/")) {
-            await enqueueAudit({
-                reason: "command_received",
-                kind: "command",
-            });
-            await this.handleCommand(chatId, chatType, messageId, cleanedText);
-            return;
-        }
-        if (!cleanedText && !hasIncomingAttachment) {
-            await enqueueAudit({ reason: "empty_after_clean" });
-            return;
-        }
-        const instructions = await buildQqInboundInstructions({
-            context: this.context,
-            rootPath: this.rootPath,
-            chatId,
-            chatKey,
-            messageId,
-            userMessage: cleanedText,
-            attachments: incomingAttachments,
-            getAuthToken: () => this.gateway.getAuthToken(),
-        });
-        if (!instructions) {
-            await enqueueAudit({ reason: "empty_after_build" });
-            return;
-        }
-        await this.executeAndReply(chatId, chatType, messageId, instructions, actor, chatTitle);
+    async handleChannelMessage(data) {
+        await handleQqChannelMessage(this.getMessageHandlerOptions(), data);
     }
     /**
-     * 处理频道消息。
+     * 构造 QQ 入站处理依赖。
      */
-    async handleChannelMessage(data) {
-        const { id: messageId, channel_id: channelId, content, author } = data;
-        if (!channelId || !messageId)
-            return;
-        const chatType = "channel";
-        if (await this.shouldSkipDuplicatedInboundMessage(EventType.AT_MESSAGE_CREATE, messageId)) {
-            return;
-        }
-        const userMessage = extractQqTextContent(String(content || ""));
-        const incomingAttachments = extractQqInboundAttachments(data);
-        const actor = extractQqAuthorIdentity(author, data);
-        const chatTitle = resolveQqInboundChatTitle({
-            chatType,
-            data,
-            actorName: actor.username,
-        });
-        await this.observeIncomingAuthorization({
-            chatId: channelId,
-            chatType,
-            chatTitle,
-            userId: actor.userId,
-            username: actor.username,
-        });
-        const authResult = await this.evaluateIncomingAuthorization({
-            chatId: channelId,
-            chatType,
-            chatTitle,
-            userId: actor.userId,
-            username: actor.username,
-        });
-        if (authResult.decision !== "allow") {
-            return;
-        }
-        if (actor.userId && this.botUserId && actor.userId === this.botUserId) {
-            this.logger.debug("忽略机器人自身消息（channel）", {
-                messageId,
-                channelId,
-                botUserId: this.botUserId,
-            });
-            return;
-        }
-        this.logger.info(`收到频道消息 [${channelId}]: ${userMessage}`);
-        if (userMessage.startsWith("/")) {
-            await this.handleCommand(channelId, "channel", messageId, userMessage);
-            return;
-        }
-        const instructions = await buildQqInboundInstructions({
+    getMessageHandlerOptions() {
+        return {
             context: this.context,
             rootPath: this.rootPath,
-            chatId: channelId,
-            chatKey: this.getChatKey({ chatId: channelId, chatType }),
-            messageId,
-            userMessage,
-            attachments: incomingAttachments,
-            getAuthToken: () => this.gateway.getAuthToken(),
-        });
-        if (!instructions)
-            return;
-        await this.executeAndReply(channelId, "channel", messageId, instructions, actor, chatTitle);
+            logger: this.logger,
+            getBotUserId: () => this.botUserId,
+            getChatKey: (params) => this.getChatKey(params),
+            observeIncomingAuthorization: async (params) => {
+                await this.observeIncomingAuthorization(params);
+            },
+            evaluateIncomingAuthorization: async (params) => await this.evaluateIncomingAuthorization(params),
+            sendAuthorizationText: async (params) => {
+                await this.sendAuthorizationText(params);
+            },
+            buildUnauthorizedBlockedText: (params) => this.buildUnauthorizedBlockedText(params),
+            shouldSkipDuplicatedInboundMessage: async (eventType, messageId) => await this.shouldSkipDuplicatedInboundMessage(eventType, messageId),
+            enqueueAuditMessage: async (params) => {
+                await this.enqueueAuditMessage(params);
+            },
+            handleCommand: async (params) => {
+                await this.handleCommand(params.chatId, params.chatType, params.messageId, params.command);
+            },
+            executeAndReply: async (params) => {
+                await this.executeAndReply(params.chatId, params.chatType, params.messageId, params.instructions, params.actor, params.chatTitle);
+            },
+            getAuthToken: async () => await this.gateway.getAuthToken(),
+        };
     }
     /**
      * 入站去重检查。