@downcity/agent 1.1.1

package/bin/services/chat/channels/qq/QQGatewaySend.js

@@ -0,0 +1,120 @@
+/**
+ * QQ Gateway 发送辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里统一处理消息投递地址、超时、自动重试与自愈触发。
+ * - `QQGatewayClient` 只保留发送入口与状态持有，不再直接展开长流程。
+ */
+import { isRetryableQqSendFailure, resolveQqApiErrorText, waitBeforeQqSendRetry, } from "./QQSendSupport.js";
+function buildQqSendRequest(params) {
+    let url = "";
+    const body = {
+        content: params.text,
+        msg_type: 0,
+        msg_id: params.messageId,
+        msg_seq: params.msgSeq,
+    };
+    switch (params.chatType) {
+        case "group":
+            url = `${params.apiBase}/v2/groups/${params.chatId}/messages`;
+            break;
+        case "c2c":
+            url = `${params.apiBase}/v2/users/${params.chatId}/messages`;
+            break;
+        case "channel":
+            url = `${params.apiBase}/channels/${params.chatId}/messages`;
+            break;
+        default:
+            throw new Error(`未知的聊天类型: ${params.chatType}`);
+    }
+    return { url, body };
+}
+async function postQqMessageOnce(params) {
+    const authToken = await params.getAuthToken();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => {
+        controller.abort();
+    }, params.requestTimeoutMs);
+    let response;
+    try {
+        response = await fetch(params.url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: authToken,
+            },
+            body: JSON.stringify(params.body),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        const errorText = String(error);
+        if (errorText.toLowerCase().includes("abort")) {
+            throw new Error(`QQ send failed: timeout after ${params.requestTimeoutMs}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    const responseText = await response.text();
+    if (!response.ok) {
+        params.logger.error(`发送消息失败: ${response.status} - ${responseText}`);
+        throw new Error(`QQ send failed: HTTP ${response.status}: ${responseText}`);
+    }
+    const apiError = resolveQqApiErrorText(responseText);
+    if (apiError) {
+        throw new Error(`QQ send failed: ${apiError}`);
+    }
+    return { status: response.status, responseText };
+}
+/**
+ * 带自动重试与自愈触发的 QQ 消息发送。
+ */
+export async function sendQqMessageWithRetry(params) {
+    const request = buildQqSendRequest({
+        apiBase: params.apiBase,
+        chatId: params.chatId,
+        chatType: params.chatType,
+        messageId: params.messageId,
+        text: params.text,
+        msgSeq: params.msgSeq,
+    });
+    params.logger.debug(`发送消息到: ${request.url}`);
+    let lastError = null;
+    for (let attempt = 1; attempt <= params.maxAttempts; attempt++) {
+        try {
+            const { status, responseText } = await postQqMessageOnce({
+                logger: params.logger,
+                url: request.url,
+                body: request.body,
+                requestTimeoutMs: params.requestTimeoutMs,
+                getAuthToken: params.getAuthToken,
+            });
+            params.logger.debug(`消息发送成功: ${status}${responseText ? ` - ${responseText}` : ""}`);
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            const errorText = String(error);
+            const shouldRetry = attempt < params.maxAttempts && isRetryableQqSendFailure(errorText);
+            if (!shouldRetry) {
+                throw error;
+            }
+            params.logger.warn("QQ 回发失败，准备自动重试", {
+                attempt,
+                maxAttempts: params.maxAttempts,
+                chatType: params.chatType,
+                chatId: params.chatId,
+                messageId: params.messageId,
+                error: errorText,
+            });
+            params.clearAccessTokenCache();
+            params.closeSocketForRecovery("send_failed_retry");
+            params.scheduleReconnect("send_failed_retry", 0);
+            await waitBeforeQqSendRetry(attempt);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+//# sourceMappingURL=QQGatewaySend.js.map

package/bin/services/chat/channels/qq/QQGatewaySend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewaySend.js","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQGatewaySend.ts"],"names":[],"mappings":"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"}

package/bin/services/chat/channels/qq/QQGatewaySupport.d.ts

@@ -0,0 +1,39 @@
+/**
+ * QQGatewaySupport：QQ GatewayClient 的纯辅助逻辑。
+ *
+ * 关键点（中文）
+ * - 这里只放不依赖类实例的纯计算与纯解析逻辑。
+ * - 让 `QQGatewayClient` 专注于连接编排，而不是状态拼装与 payload 解码细节。
+ */
+import type { RawData } from "ws";
+import type { QQGatewayPayload, QqGatewayRuntimeStatus } from "../../../../shared/types/QqChannel.js";
+import type { QqGatewayHeartbeatState, QqGatewayRuntimeStatusInput } from "../../../../shared/types/QqGatewaySupport.js";
+/**
+ * 解析 QQ API 基础地址。
+ */
+export declare function resolveQqGatewayApiBase(useSandbox: boolean): string;
+/**
+ * 解析默认 WebSocket Gateway 地址。
+ */
+export declare function resolveQqGatewayWsUrl(useSandbox: boolean): string;
+/**
+ * 计算心跳 ACK 超时阈值。
+ */
+export declare function getQqHeartbeatAckTimeoutMs(heartbeatIntervalMs: number): number;
+/**
+ * 是否发生心跳 ACK 超时。
+ */
+export declare function hasQqHeartbeatTimeout(state: QqGatewayHeartbeatState, nowMs?: number): boolean;
+/**
+ * 心跳是否健康。
+ */
+export declare function hasQqHealthyHeartbeat(state: QqGatewayHeartbeatState, nowMs?: number): boolean;
+/**
+ * 构建 QQ 网关状态快照。
+ */
+export declare function buildQqGatewayRuntimeStatus(input: QqGatewayRuntimeStatusInput): QqGatewayRuntimeStatus;
+/**
+ * 解析原始 Gateway 载荷。
+ */
+export declare function parseQqGatewayPayload(rawData: RawData): QQGatewayPayload | null;
+//# sourceMappingURL=QQGatewaySupport.d.ts.map

package/bin/services/chat/channels/qq/QQGatewaySupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewaySupport.d.ts","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQGatewaySupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAO5C;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAInE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAIjE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,uBAAuB,EAC9B,KAAK,GAAE,MAAmB,GACzB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,uBAAuB,EAC9B,KAAK,GAAE,MAAmB,GACzB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CAqDxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAyB/E"}

package/bin/services/chat/channels/qq/QQGatewaySupport.js

@@ -0,0 +1,137 @@
+/**
+ * QQGatewaySupport：QQ GatewayClient 的纯辅助逻辑。
+ *
+ * 关键点（中文）
+ * - 这里只放不依赖类实例的纯计算与纯解析逻辑。
+ * - 让 `QQGatewayClient` 专注于连接编排，而不是状态拼装与 payload 解码细节。
+ */
+/**
+ * WebSocket OPEN 对应的 readyState 数值。
+ */
+const WS_OPEN_READY_STATE = 1;
+/**
+ * 解析 QQ API 基础地址。
+ */
+export function resolveQqGatewayApiBase(useSandbox) {
+    return useSandbox
+        ? "https://sandbox.api.sgroup.qq.com"
+        : "https://api.sgroup.qq.com";
+}
+/**
+ * 解析默认 WebSocket Gateway 地址。
+ */
+export function resolveQqGatewayWsUrl(useSandbox) {
+    return useSandbox
+        ? "wss://sandbox.api.sgroup.qq.com/websocket"
+        : "wss://api.sgroup.qq.com/websocket";
+}
+/**
+ * 计算心跳 ACK 超时阈值。
+ */
+export function getQqHeartbeatAckTimeoutMs(heartbeatIntervalMs) {
+    return Math.max(heartbeatIntervalMs * 3, 45000);
+}
+/**
+ * 是否发生心跳 ACK 超时。
+ */
+export function hasQqHeartbeatTimeout(state, nowMs = Date.now()) {
+    if (!state.pendingHeartbeatSinceMs)
+        return false;
+    return nowMs - state.pendingHeartbeatSinceMs >
+        getQqHeartbeatAckTimeoutMs(state.heartbeatIntervalMs);
+}
+/**
+ * 心跳是否健康。
+ */
+export function hasQqHealthyHeartbeat(state, nowMs = Date.now()) {
+    if (!state.wsReadyAtMs)
+        return false;
+    if (!state.pendingHeartbeatSinceMs)
+        return true;
+    return !hasQqHeartbeatTimeout(state, nowMs);
+}
+/**
+ * 构建 QQ 网关状态快照。
+ */
+export function buildQqGatewayRuntimeStatus(input) {
+    const now = Date.now();
+    const isOpen = input.wsReadyState === WS_OPEN_READY_STATE;
+    const hasContext = Boolean(String(input.wsContextId || "").trim());
+    const heartbeatState = {
+        heartbeatIntervalMs: input.heartbeatIntervalMs,
+        pendingHeartbeatSinceMs: input.pendingHeartbeatSinceMs,
+        wsReadyAtMs: input.wsReadyAtMs,
+    };
+    const heartbeatHealthy = hasQqHealthyHeartbeat(heartbeatState, now);
+    const heartbeatTimedOut = hasQqHeartbeatTimeout(heartbeatState, now);
+    const linkState = !input.isRunning
+        ? "disconnected"
+        : isOpen && hasContext && heartbeatHealthy
+            ? "connected"
+            : "unknown";
+    const statusText = !input.isRunning
+        ? "stopped"
+        : !isOpen
+            ? "connecting"
+            : !hasContext
+                ? "ws_open_wait_ready"
+                : heartbeatTimedOut
+                    ? "heartbeat_timeout"
+                    : heartbeatHealthy
+                        ? "ws_online"
+                        : "ws_open_wait_heartbeat";
+    return {
+        running: input.isRunning,
+        linkState,
+        statusText,
+        detail: {
+            appId: input.appId || null,
+            wsReadyState: input.wsReadyState,
+            wsContextId: input.wsContextId || null,
+            wsReadyAtMs: input.wsReadyAtMs || null,
+            heartbeatHealthy,
+            heartbeatIntervalMs: input.heartbeatIntervalMs,
+            heartbeatAckTimeoutMs: getQqHeartbeatAckTimeoutMs(input.heartbeatIntervalMs),
+            lastHeartbeatSentAtMs: input.lastHeartbeatSentAtMs || null,
+            lastHeartbeatAckAtMs: input.lastHeartbeatAckAtMs || null,
+            pendingHeartbeatSinceMs: input.pendingHeartbeatSinceMs || null,
+            reconnectAttempts: input.reconnectAttempts,
+            maxReconnectAttempts: input.maxReconnectAttempts,
+            reconnectScheduled: input.reconnectScheduled,
+            sandbox: input.useSandbox,
+        },
+    };
+}
+/**
+ * 解析原始 Gateway 载荷。
+ */
+export function parseQqGatewayPayload(rawData) {
+    try {
+        const text = Buffer.isBuffer(rawData)
+            ? rawData.toString("utf-8")
+            : Array.isArray(rawData)
+                ? Buffer.concat(rawData).toString("utf-8")
+                : typeof rawData === "string"
+                    ? rawData
+                    : Buffer.from(rawData).toString("utf-8");
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return null;
+        const obj = parsed;
+        const op = typeof obj.op === "number" ? obj.op : Number(obj.op);
+        if (!Number.isFinite(op))
+            return null;
+        return {
+            op,
+            ...(obj.d && typeof obj.d === "object" && !Array.isArray(obj.d)
+                ? { d: obj.d }
+                : {}),
+            ...(typeof obj.s === "number" ? { s: obj.s } : {}),
+            ...(typeof obj.t === "string" ? { t: obj.t } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=QQGatewaySupport.js.map

package/bin/services/chat/channels/qq/QQGatewaySupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewaySupport.js","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQGatewaySupport.ts"],"names":[],"mappings":"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"}

package/bin/services/chat/channels/qq/QQInbound.d.ts

@@ -0,0 +1,47 @@
+/**
+ * QQInbound：QQ 入站消息归一化辅助。
+ *
+ * 关键点（中文）
+ * - 只做字段提取、文本清洗、作者识别、附件宽松归一化。
+ * - 不依赖 QQBot 实例状态，便于测试与复用。
+ * - 具体“授权、入队、执行、回发”仍由 QQBot 负责编排。
+ */
+import type { QqIncomingAttachment } from "../../../chat/types/QqVoice.js";
+import type { QqActorIdentity, QQAuthor, QQMessageData } from "../../../../shared/types/QqChannel.js";
+/**
+ * 解析入站会话展示名（群名/频道名/私聊对象名）。
+ */
+export declare function resolveQqInboundChatTitle(params: {
+    chatType: string;
+    data: QQMessageData;
+    actorName?: string;
+}): string | undefined;
+/**
+ * 规范化可展示昵称。
+ */
+export declare function normalizeActorDisplayName(input: unknown): string | undefined;
+/**
+ * 从 QQ webhook 负载中抽取作者身份。
+ */
+export declare function extractQqAuthorIdentity(author: QQAuthor | undefined, data?: QQMessageData): QqActorIdentity;
+/**
+ * 提取纯文本内容。
+ */
+export declare function extractQqTextContent(content: string): string;
+/**
+ * 仅移除消息中的机器人 mention。
+ */
+export declare function stripQqBotMention(content: string, botUserId: string): string;
+/**
+ * 宽松提取 QQ 入站附件。
+ */
+export declare function extractQqInboundAttachments(data: QQMessageData): QqIncomingAttachment[];
+/**
+ * 构造入站审计文本，保证结果非空。
+ */
+export declare function buildQqAuditText(params: {
+    rawContent: string;
+    cleanedText: string;
+    hasIncomingAttachment: boolean;
+}): string;
+//# sourceMappingURL=QQInbound.d.ts.map

package/bin/services/chat/channels/qq/QQInbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQInbound.d.ts","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQInbound.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5F;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CA0CrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAC5B,IAAI,CAAC,EAAE,aAAa,GACnB,eAAe,CAuGjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,EAAE,CAWvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,MAAM,CAST"}

package/bin/services/chat/channels/qq/QQInbound.js

@@ -0,0 +1,235 @@
+/**
+ * QQInbound：QQ 入站消息归一化辅助。
+ *
+ * 关键点（中文）
+ * - 只做字段提取、文本清洗、作者识别、附件宽松归一化。
+ * - 不依赖 QQBot 实例状态，便于测试与复用。
+ * - 具体“授权、入队、执行、回发”仍由 QQBot 负责编排。
+ */
+import { extractQqIncomingAttachments } from "./VoiceInput.js";
+/**
+ * 解析入站会话展示名（群名/频道名/私聊对象名）。
+ */
+export function resolveQqInboundChatTitle(params) {
+    const chatType = String(params.chatType || "").trim().toLowerCase();
+    const raw = params.data;
+    const groupObj = raw.group && typeof raw.group === "object" && !Array.isArray(raw.group)
+        ? raw.group
+        : null;
+    const channelObj = raw.channel && typeof raw.channel === "object" && !Array.isArray(raw.channel)
+        ? raw.channel
+        : null;
+    const guildObj = raw.guild && typeof raw.guild === "object" && !Array.isArray(raw.guild)
+        ? raw.guild
+        : null;
+    const candidates = [
+        chatType === "c2c" ? normalizeActorDisplayName(params.actorName) : "",
+        raw.group_name,
+        raw.groupName,
+        raw.group_title,
+        raw.groupTitle,
+        raw.channel_name,
+        raw.channelName,
+        raw.guild_name,
+        raw.guildName,
+        raw.chat_name,
+        raw.chatName,
+        raw.title,
+        raw.name,
+        groupObj?.name,
+        groupObj?.title,
+        channelObj?.name,
+        channelObj?.title,
+        guildObj?.name,
+        guildObj?.title,
+    ];
+    for (const candidate of candidates) {
+        const value = normalizeActorDisplayName(candidate);
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+/**
+ * 规范化可展示昵称。
+ */
+export function normalizeActorDisplayName(input) {
+    const value = String(input || "").trim();
+    if (!value)
+        return undefined;
+    if (isLikelyOpaqueIdentifier(value))
+        return undefined;
+    return value;
+}
+/**
+ * 从 QQ webhook 负载中抽取作者身份。
+ */
+export function extractQqAuthorIdentity(author, data) {
+    const rawAuthor = author && typeof author === "object" && !Array.isArray(author)
+        ? author
+        : {};
+    const rawAuthorUser = rawAuthor.user &&
+        typeof rawAuthor.user === "object" &&
+        !Array.isArray(rawAuthor.user)
+        ? rawAuthor.user
+        : {};
+    const rawData = data && typeof data === "object" && !Array.isArray(data)
+        ? data
+        : {};
+    const rawSender = rawData.sender &&
+        typeof rawData.sender === "object" &&
+        !Array.isArray(rawData.sender)
+        ? rawData.sender
+        : {};
+    const rawMember = rawData.member &&
+        typeof rawData.member === "object" &&
+        !Array.isArray(rawData.member)
+        ? rawData.member
+        : {};
+    const userIdCandidates = [
+        author?.member_openid,
+        author?.user_openid,
+        author?.openid,
+        author?.union_openid,
+        author?.id,
+        author?.user_id,
+        author?.tiny_id,
+        author?.member_tinyid,
+        author?.user_tinyid,
+        author?.uid,
+        author?.user?.id,
+        author?.user?.user_id,
+        author?.user?.openid,
+        author?.user?.user_openid,
+        rawData.user_openid,
+        rawData.openid,
+        rawData.author_id,
+        rawData.user_id,
+        rawSender.user_openid,
+        rawSender.openid,
+        rawSender.id,
+        rawSender.user_id,
+        rawMember.user_openid,
+        rawMember.openid,
+        rawMember.id,
+        rawMember.user_id,
+    ];
+    const usernameCandidates = [
+        author?.nickname,
+        author?.username,
+        author?.name,
+        author?.user?.username,
+        author?.user?.nickname,
+        author?.user?.name,
+        rawAuthor.nick,
+        rawAuthor.display_name,
+        rawAuthor.displayName,
+        rawAuthor.member_nick,
+        rawAuthor.memberNick,
+        rawAuthor.card,
+        rawAuthor.remark,
+        rawAuthorUser.nick,
+        rawAuthorUser.display_name,
+        rawAuthorUser.displayName,
+        rawData.nickname,
+        rawData.username,
+        rawData.nick,
+        rawData.user_name,
+        rawData.userName,
+        rawData.display_name,
+        rawData.displayName,
+        rawSender.nickname,
+        rawSender.username,
+        rawSender.nick,
+        rawSender.user_name,
+        rawSender.userName,
+        rawSender.card,
+        rawMember.nickname,
+        rawMember.username,
+        rawMember.nick,
+        rawMember.card,
+    ];
+    const userId = userIdCandidates
+        .map((value) => (typeof value === "string" ? value.trim() : ""))
+        .find(Boolean);
+    const username = usernameCandidates
+        .map((value) => normalizeActorDisplayName(value))
+        .find(Boolean);
+    return {
+        ...(userId ? { userId } : {}),
+        ...(username ? { username } : {}),
+    };
+}
+/**
+ * 提取纯文本内容。
+ */
+export function extractQqTextContent(content) {
+    if (!content)
+        return "";
+    return String(content).replace(/\s+/g, " ").trim();
+}
+/**
+ * 仅移除消息中的机器人 mention。
+ */
+export function stripQqBotMention(content, botUserId) {
+    const raw = String(content || "");
+    if (!raw)
+        return "";
+    const normalizedBotUserId = String(botUserId || "").trim();
+    if (!normalizedBotUserId)
+        return raw.trim();
+    const escaped = escapeRegExp(normalizedBotUserId);
+    return raw
+        .replace(new RegExp(`<@!?${escaped}>`, "ig"), " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/**
+ * 宽松提取 QQ 入站附件。
+ */
+export function extractQqInboundAttachments(data) {
+    return extractQqIncomingAttachments({
+        attachments: data.attachments,
+        files: data.files,
+        file_info: data.file_info,
+        file_infos: data.file_infos,
+        media: data.media,
+        medias: data.medias,
+        audio: data.audio,
+        voice: data.voice,
+    });
+}
+/**
+ * 构造入站审计文本，保证结果非空。
+ */
+export function buildQqAuditText(params) {
+    const raw = String(params.rawContent || "").trim();
+    if (raw)
+        return raw;
+    const cleaned = String(params.cleanedText || "").trim();
+    if (cleaned)
+        return cleaned;
+    if (params.hasIncomingAttachment)
+        return "[attachment] (qq)";
+    return "[message] (no_text_or_supported_attachment)";
+}
+/**
+ * 判断一个字符串是否更像平台内部 ID。
+ */
+function isLikelyOpaqueIdentifier(input) {
+    const value = String(input || "").trim();
+    if (!value)
+        return false;
+    if (/^[0-9A-F]{24,}$/i.test(value))
+        return true;
+    if (/^[0-9]{18,}$/.test(value))
+        return true;
+    return false;
+}
+/**
+ * 正则转义。
+ */
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=QQInbound.js.map

package/bin/services/chat/channels/qq/QQInbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQInbound.js","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQInbound.ts"],"names":[],"mappings":"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"}

package/bin/services/chat/channels/qq/QQInboundDedupe.d.ts

@@ -0,0 +1,48 @@
+/**
+ * QQ 入站消息去重存储。
+ *
+ * 关键点（中文）
+ * - 解决 QQ 网关在重连 / 重启后可能重复投递历史消息的问题。
+ * - 去重 key 采用 `eventType:messageId`，避免跨事件类型冲突。
+ * - 使用本地文件持久化，保证“重启后”仍可去重（best-effort）。
+ */
+import type { Logger } from "../../../../shared/utils/logger/Logger.js";
+/**
+ * QqInboundDedupeStore：QQ 入站消息去重存储器。
+ */
+export declare class QqInboundDedupeStore {
+    private readonly logger;
+    private readonly filePath;
+    private readonly maxEntries;
+    private readonly ids;
+    private loaded;
+    constructor(params: {
+        rootPath: string;
+        logger: Logger;
+        maxEntries?: number;
+    });
+    /**
+     * 加载持久化去重数据（幂等）。
+     */
+    load(): Promise<void>;
+    /**
+     * 标记并检查是否重复。
+     *
+     * 返回值（中文）
+     * - true: 已处理过（应跳过）
+     * - false: 首次出现（应继续处理）
+     */
+    markAndCheckDuplicate(params: {
+        eventType: string;
+        messageId: string;
+    }): Promise<boolean>;
+    /**
+     * 修剪集合，限制内存 / 文件大小。
+     */
+    private trimToMaxEntries;
+    /**
+     * 持久化当前去重集合（best-effort）。
+     */
+    private persist;
+}
+//# sourceMappingURL=QQInboundDedupe.d.ts.map

package/bin/services/chat/channels/qq/QQInboundDedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQInboundDedupe.d.ts","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQInboundDedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAG7D;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA0B;IAC9C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAiBD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;;;;;OAMG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;IAepB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;YACW,OAAO;CAetB"}