@downcity/agent 1.1.1

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

@@ -0,0 +1,540 @@
+/**
+ * QQGatewayClient：QQ 网关连接与发送客户端。
+ *
+ * 关键点（中文）
+ * - 这里专门负责 QQ Gateway WebSocket、心跳、自愈重连与状态持有。
+ * - 鉴权 / HTTP 探活 / 发送重试已经拆到旁路模块，当前文件只保留运行时编排。
+ * - QQBot 不再直接维护底层 ws / token 细节，只保留渠道编排职责。
+ */
+import WebSocket from "ws";
+import { EventType, OpCode } from "../../../../shared/types/QqChannel.js";
+import { captureQqWsPayload } from "./QQEventCapture.js";
+import { fetchQqAccessToken, fetchQqGatewayUrl, testQqGatewayConnection, } from "./QQGatewayAuth.js";
+import { buildQqGatewayRuntimeStatus, getQqHeartbeatAckTimeoutMs, hasQqHealthyHeartbeat, hasQqHeartbeatTimeout, parseQqGatewayPayload, resolveQqGatewayApiBase, resolveQqGatewayWsUrl, } from "./QQGatewaySupport.js";
+import { sendQqMessageWithRetry } from "./QQGatewaySend.js";
+/**
+ * QQ 网关客户端。
+ */
+export class QQGatewayClient {
+    rootPath;
+    logger;
+    appId;
+    appSecret;
+    useSandbox;
+    captureConfig;
+    onDispatch;
+    ws = null;
+    isRunning = false;
+    heartbeatInterval = null;
+    reconnectTimer = null;
+    wsContextId = "";
+    lastSeq = 0;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    heartbeatIntervalMs = 30000;
+    lastHeartbeatSentAtMs = 0;
+    lastHeartbeatAckAtMs = 0;
+    pendingHeartbeatSinceMs = 0;
+    wsReadyAtMs = 0;
+    sendRequestTimeoutMs = 15000;
+    sendMaxAttempts = 3;
+    accessToken = "";
+    accessTokenExpires = 0;
+    AUTH_API_BASE = "https://bots.qq.com";
+    constructor(options) {
+        this.rootPath = options.rootPath;
+        this.logger = options.logger;
+        this.appId = options.appId;
+        this.appSecret = options.appSecret;
+        this.useSandbox = options.useSandbox;
+        this.captureConfig = options.captureConfig;
+        this.onDispatch = options.onDispatch;
+    }
+    /**
+     * 获取当前鉴权字符串。
+     */
+    async getAuthToken() {
+        const result = await fetchQqAccessToken({
+            logger: this.logger,
+            authApiBase: this.AUTH_API_BASE,
+            appId: this.appId,
+            appSecret: this.appSecret,
+            cachedAccessToken: this.accessToken,
+            cachedAccessTokenExpiresAtMs: this.accessTokenExpires,
+        });
+        this.accessToken = result.accessToken;
+        this.accessTokenExpires = result.accessTokenExpiresAtMs;
+        return `QQBot ${result.accessToken}`;
+    }
+    /**
+     * 获取网关状态快照。
+     */
+    getExecutorStatus() {
+        const readyState = typeof this.ws?.readyState === "number" ? this.ws.readyState : null;
+        return buildQqGatewayRuntimeStatus({
+            isRunning: this.isRunning,
+            wsReadyState: readyState,
+            wsContextId: this.wsContextId,
+            wsReadyAtMs: this.wsReadyAtMs,
+            heartbeatIntervalMs: this.heartbeatIntervalMs,
+            lastHeartbeatSentAtMs: this.lastHeartbeatSentAtMs,
+            lastHeartbeatAckAtMs: this.lastHeartbeatAckAtMs,
+            pendingHeartbeatSinceMs: this.pendingHeartbeatSinceMs,
+            reconnectAttempts: this.reconnectAttempts,
+            maxReconnectAttempts: this.maxReconnectAttempts,
+            reconnectScheduled: Boolean(this.reconnectTimer),
+            useSandbox: this.useSandbox,
+            appId: this.appId,
+        });
+    }
+    /**
+     * 执行 QQ 连通性测试。
+     */
+    async testConnection() {
+        return testQqGatewayConnection({
+            appId: this.appId,
+            appSecret: this.appSecret,
+            useSandbox: this.useSandbox,
+            apiBase: this.getApiBase(),
+            getAuthToken: () => this.getAuthToken(),
+            getExecutorStatus: () => this.getExecutorStatus(),
+            requestReconnect: (reason, delayMs) => {
+                this.requestReconnect(reason, delayMs);
+            },
+        });
+    }
+    /**
+     * 启动 QQ 网关。
+     */
+    async start() {
+        if (this.isRunning) {
+            this.logger.warn("QQ Gateway 已在运行中，跳过重复启动");
+            return;
+        }
+        this.isRunning = true;
+        this.reconnectAttempts = 0;
+        this.clearReconnectTimer();
+        this.resetWsLivenessState();
+        const gatewayUrl = await this.getGatewayUrl();
+        await this.connectWebSocket(gatewayUrl);
+    }
+    /**
+     * 停止 QQ 网关。
+     */
+    async stop() {
+        this.isRunning = false;
+        this.clearReconnectTimer();
+        this.stopHeartbeat();
+        this.resetWsLivenessState();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    /**
+     * 请求一次重连。
+     */
+    requestReconnect(reason, delayMs) {
+        this.scheduleReconnect(reason, delayMs);
+    }
+    /**
+     * 发送 QQ 消息。
+     */
+    async sendMessage(chatId, chatType, messageId, text, msgSeq = 1) {
+        try {
+            await sendQqMessageWithRetry({
+                logger: this.logger,
+                apiBase: this.getApiBase(),
+                chatId,
+                chatType,
+                messageId,
+                text,
+                msgSeq,
+                maxAttempts: this.sendMaxAttempts,
+                requestTimeoutMs: this.sendRequestTimeoutMs,
+                getAuthToken: () => this.getAuthToken(),
+                clearAccessTokenCache: () => this.clearAccessTokenCache(),
+                closeSocketForRecovery: (reason) => this.closeSocketForRecovery(reason),
+                scheduleReconnect: (reason, delayMs) => this.scheduleReconnect(reason, delayMs),
+            });
+        }
+        catch (error) {
+            this.logger.error("发送 QQ 消息失败", { error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * 获取 API 基础地址。
+     */
+    getApiBase() {
+        return resolveQqGatewayApiBase(this.useSandbox);
+    }
+    /**
+     * 获取默认 WebSocket Gateway。
+     */
+    getWsGateway() {
+        return resolveQqGatewayWsUrl(this.useSandbox);
+    }
+    /**
+     * 获取 Gateway 地址。
+     */
+    async getGatewayUrl() {
+        return fetchQqGatewayUrl({
+            logger: this.logger,
+            apiBase: this.getApiBase(),
+            authToken: await this.getAuthToken(),
+            fallbackWsGateway: this.getWsGateway(),
+        });
+    }
+    /**
+     * 计算心跳 ACK 超时阈值。
+     */
+    getHeartbeatAckTimeoutMs() {
+        return getQqHeartbeatAckTimeoutMs(this.heartbeatIntervalMs);
+    }
+    /**
+     * 是否发生心跳 ACK 超时。
+     */
+    hasHeartbeatTimeout(nowMs = Date.now()) {
+        return hasQqHeartbeatTimeout({
+            heartbeatIntervalMs: this.heartbeatIntervalMs,
+            pendingHeartbeatSinceMs: this.pendingHeartbeatSinceMs,
+            wsReadyAtMs: this.wsReadyAtMs,
+        }, nowMs);
+    }
+    /**
+     * 心跳是否健康。
+     */
+    hasHealthyHeartbeat(nowMs = Date.now()) {
+        return hasQqHealthyHeartbeat({
+            heartbeatIntervalMs: this.heartbeatIntervalMs,
+            pendingHeartbeatSinceMs: this.pendingHeartbeatSinceMs,
+            wsReadyAtMs: this.wsReadyAtMs,
+        }, nowMs);
+    }
+    /**
+     * 重置网关活性状态。
+     */
+    resetWsLivenessState() {
+        this.wsContextId = "";
+        this.lastSeq = 0;
+        this.wsReadyAtMs = 0;
+        this.lastHeartbeatSentAtMs = 0;
+        this.lastHeartbeatAckAtMs = 0;
+        this.pendingHeartbeatSinceMs = 0;
+    }
+    /**
+     * 清理 token 缓存。
+     */
+    clearAccessTokenCache() {
+        this.accessToken = "";
+        this.accessTokenExpires = 0;
+    }
+    /**
+     * 清理重连定时器。
+     */
+    clearReconnectTimer() {
+        if (!this.reconnectTimer)
+            return;
+        clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = null;
+    }
+    /**
+     * 计划一次重连。
+     */
+    scheduleReconnect(reason, delayMs) {
+        if (!this.isRunning)
+            return;
+        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+            this.logger.error("QQ 重连次数已达上限，停止自动重连", {
+                reason,
+                reconnectAttempts: this.reconnectAttempts,
+                maxReconnectAttempts: this.maxReconnectAttempts,
+            });
+            return;
+        }
+        const delay = typeof delayMs === "number" && Number.isFinite(delayMs)
+            ? Math.max(0, Math.trunc(delayMs))
+            : 5000 * (this.reconnectAttempts + 1);
+        if (this.reconnectTimer) {
+            if (delay > 0)
+                return;
+            this.clearReconnectTimer();
+        }
+        this.reconnectAttempts += 1;
+        const attempt = this.reconnectAttempts;
+        this.logger.info(`QQ 准备重连（原因: ${reason}，第 ${attempt}/${this.maxReconnectAttempts} 次），${delay / 1000} 秒后执行`);
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = null;
+            if (!this.isRunning)
+                return;
+            try {
+                this.clearAccessTokenCache();
+                const newGatewayUrl = await this.getGatewayUrl();
+                await this.connectWebSocket(newGatewayUrl);
+            }
+            catch (error) {
+                this.logger.error("QQ 重连失败", { error: String(error), reason });
+                this.scheduleReconnect("reconnect_failed");
+            }
+        }, delay);
+    }
+    /**
+     * 主动关闭当前 socket，交给 close 回调统一进入重连流程。
+     */
+    closeSocketForRecovery(reason) {
+        const ws = this.ws;
+        if (!ws)
+            return;
+        if (ws.readyState !== WebSocket.OPEN && ws.readyState !== WebSocket.CONNECTING) {
+            return;
+        }
+        this.logger.warn(`触发 QQ 链路自愈关闭: ${reason}`);
+        try {
+            ws.close();
+        }
+        catch (error) {
+            this.logger.debug("关闭 QQ WebSocket 失败（忽略）", {
+                error: String(error),
+                reason,
+            });
+        }
+    }
+    /**
+     * 建立 WebSocket 连接。
+     */
+    async connectWebSocket(gatewayUrl) {
+        this.logger.info(`正在连接 WebSocket: ${gatewayUrl}`);
+        const previousWs = this.ws;
+        if (previousWs &&
+            (previousWs.readyState === WebSocket.OPEN ||
+                previousWs.readyState === WebSocket.CONNECTING)) {
+            try {
+                previousWs.close();
+            }
+            catch {
+                // ignore close failure
+            }
+        }
+        this.stopHeartbeat();
+        this.resetWsLivenessState();
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const resolveOnce = () => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve();
+            };
+            const rejectOnce = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(error);
+            };
+            const ws = new WebSocket(gatewayUrl);
+            this.ws = ws;
+            ws.on("open", () => {
+                if (this.ws !== ws)
+                    return;
+                this.logger.info("WebSocket 连接已建立");
+                this.reconnectAttempts = 0;
+                this.clearReconnectTimer();
+                this.resetWsLivenessState();
+                resolveOnce();
+            });
+            ws.on("message", async (data) => {
+                if (this.ws !== ws)
+                    return;
+                try {
+                    const payload = this.parseGatewayPayload(data);
+                    if (!payload) {
+                        this.logger.warn("收到无法解析的 QQ WebSocket 消息，已忽略");
+                        return;
+                    }
+                    this.logger.debug(`收到 WebSocket 消息: op=${payload.op}, t=${payload.t || "N/A"}`);
+                    await captureQqWsPayload({
+                        config: this.captureConfig,
+                        logger: this.logger,
+                        payload,
+                    });
+                    await this.handleWebSocketMessage(payload);
+                }
+                catch (error) {
+                    this.logger.error("处理 WebSocket 消息失败", {
+                        error: String(error),
+                    });
+                }
+            });
+            ws.on("close", (code, reason) => {
+                if (this.ws !== ws)
+                    return;
+                const reasonText = Buffer.isBuffer(reason)
+                    ? reason.toString("utf-8")
+                    : String(reason || "");
+                this.logger.warn(`WebSocket 连接关闭: ${code} - ${reasonText}`);
+                this.ws = null;
+                this.stopHeartbeat();
+                this.resetWsLivenessState();
+                this.scheduleReconnect(`ws_closed:${code}`);
+                rejectOnce(new Error(`QQ websocket closed before ready: ${code} ${reasonText}`));
+            });
+            ws.on("error", (error) => {
+                if (this.ws !== ws)
+                    return;
+                this.logger.error("WebSocket 错误", { error: String(error) });
+                rejectOnce(error);
+            });
+        });
+    }
+    /**
+     * 解析原始 Gateway 载荷。
+     */
+    parseGatewayPayload(rawData) {
+        return parseQqGatewayPayload(rawData);
+    }
+    /**
+     * 处理网关消息。
+     */
+    async handleWebSocketMessage(payload) {
+        const { op, d, s, t } = payload;
+        if (s) {
+            this.lastSeq = s;
+        }
+        switch (op) {
+            case OpCode.Hello: {
+                const heartbeatIntervalMs = typeof d?.heartbeat_interval === "number" ? d.heartbeat_interval : 30000;
+                this.startHeartbeat(heartbeatIntervalMs);
+                await this.sendIdentify();
+                break;
+            }
+            case OpCode.Dispatch: {
+                const eventType = String(t || "");
+                if (eventType === EventType.READY) {
+                    this.wsContextId = typeof d?.context_id === "string" ? d.context_id : "";
+                    this.wsReadyAtMs = Date.now();
+                }
+                else if (eventType === EventType.RESUMED) {
+                    this.wsReadyAtMs = Date.now();
+                }
+                await this.onDispatch({
+                    eventType,
+                    data: d || {},
+                });
+                break;
+            }
+            case OpCode.HeartbeatAck:
+                this.lastHeartbeatAckAtMs = Date.now();
+                this.pendingHeartbeatSinceMs = 0;
+                this.logger.debug("收到心跳响应");
+                break;
+            case OpCode.Reconnect:
+                this.logger.warn("服务端要求重连");
+                this.closeSocketForRecovery("server_reconnect_opcode");
+                break;
+            case OpCode.InvalidContext:
+                this.logger.error("无效的 Context，需要重新鉴权");
+                this.clearAccessTokenCache();
+                setTimeout(async () => {
+                    try {
+                        await this.sendIdentify();
+                    }
+                    catch (error) {
+                        this.logger.error("重新鉴权失败", { error: String(error) });
+                    }
+                }, 2000);
+                break;
+        }
+    }
+    /**
+     * 发送鉴权请求。
+     */
+    async sendIdentify() {
+        const authToken = await this.getAuthToken();
+        const intents = this.getIntents();
+        this.logger.info(`发送鉴权请求 (Identify)，intents: ${intents}`);
+        const identifyPayload = {
+            op: OpCode.Identify,
+            d: {
+                token: authToken,
+                intents,
+                shard: [0, 1],
+                properties: {
+                    $os: "linux",
+                    $browser: "downcity",
+                    $device: "downcity",
+                },
+            },
+        };
+        this.logger.debug(`Identify payload: ${JSON.stringify(identifyPayload)}`);
+        this.ws?.send(JSON.stringify(identifyPayload));
+        this.logger.info("已发送鉴权请求");
+    }
+    /**
+     * 获取订阅事件位掩码。
+     */
+    getIntents() {
+        const GROUP_AND_C2C_EVENT = 1 << 25;
+        const AUDIO_ACTION = 1 << 29;
+        return GROUP_AND_C2C_EVENT | AUDIO_ACTION;
+    }
+    /**
+     * 启动心跳。
+     */
+    startHeartbeat(intervalMs) {
+        this.stopHeartbeat();
+        this.heartbeatIntervalMs =
+            Number.isFinite(intervalMs) && intervalMs > 0 ? Math.trunc(intervalMs) : 30000;
+        this.pendingHeartbeatSinceMs = 0;
+        this.lastHeartbeatSentAtMs = 0;
+        this.sendHeartbeat();
+        this.heartbeatInterval = setInterval(() => {
+            this.sendHeartbeat();
+        }, this.heartbeatIntervalMs);
+    }
+    /**
+     * 发送单次心跳。
+     */
+    sendHeartbeat() {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        const now = Date.now();
+        if (this.hasHeartbeatTimeout(now)) {
+            this.logger.warn("QQ 心跳 ACK 超时，准备重连", {
+                pendingHeartbeatSinceMs: this.pendingHeartbeatSinceMs,
+                heartbeatAckTimeoutMs: this.getHeartbeatAckTimeoutMs(),
+            });
+            this.closeSocketForRecovery("heartbeat_ack_timeout");
+            return;
+        }
+        const heartbeatPayload = {
+            op: OpCode.Heartbeat,
+            d: this.lastSeq || null,
+        };
+        try {
+            ws.send(JSON.stringify(heartbeatPayload));
+            this.lastHeartbeatSentAtMs = now;
+            if (!this.pendingHeartbeatSinceMs) {
+                this.pendingHeartbeatSinceMs = now;
+            }
+            this.logger.debug("发送心跳");
+        }
+        catch (error) {
+            this.logger.warn("发送 QQ 心跳失败，准备重连", {
+                error: String(error),
+            });
+            this.closeSocketForRecovery("heartbeat_send_failed");
+        }
+    }
+    /**
+     * 停止心跳。
+     */
+    stopHeartbeat() {
+        if (!this.heartbeatInterval)
+            return;
+        clearInterval(this.heartbeatInterval);
+        this.heartbeatInterval = null;
+    }
+}
+//# sourceMappingURL=QQGatewayClient.js.map

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * QQ Gateway 发送辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里统一处理消息投递地址、超时、自动重试与自愈触发。
+ * - `QQGatewayClient` 只保留发送入口与状态持有，不再直接展开长流程。
+ */
+import type { Logger } from "../../../../shared/utils/logger/Logger.js";
+import type { QQSendMessageBody } from "../../../../shared/types/QqChannel.js";
+/**
+ * 单次发送请求构造结果。
+ */
+export interface QqSendRequest {
+    /**
+     * 请求 URL。
+     */
+    url: string;
+    /**
+     * 请求体。
+     */
+    body: QQSendMessageBody;
+}
+/**
+ * QQ 发送重试流程参数。
+ */
+export interface SendQqMessageWithRetryParams {
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * OpenAPI 基础地址。
+     */
+    apiBase: string;
+    /**
+     * 会话 ID。
+     */
+    chatId: string;
+    /**
+     * 会话类型。
+     */
+    chatType: string;
+    /**
+     * 原始消息 ID。
+     */
+    messageId: string;
+    /**
+     * 文本内容。
+     */
+    text: string;
+    /**
+     * QQ 消息序号。
+     */
+    msgSeq: number;
+    /**
+     * 最大重试次数。
+     */
+    maxAttempts: number;
+    /**
+     * 单次 HTTP 超时时间。
+     */
+    requestTimeoutMs: number;
+    /**
+     * 获取鉴权 token 的回调。
+     */
+    getAuthToken: () => Promise<string>;
+    /**
+     * 发送失败后清理 token 缓存的回调。
+     */
+    clearAccessTokenCache: () => void;
+    /**
+     * 发送失败后主动关闭 ws 的回调。
+     */
+    closeSocketForRecovery: (reason: string) => void;
+    /**
+     * 发送失败后触发重连的回调。
+     */
+    scheduleReconnect: (reason: string, delayMs?: number) => void;
+}
+/**
+ * 带自动重试与自愈触发的 QQ 消息发送。
+ */
+export declare function sendQqMessageWithRetry(params: SendQqMessageWithRetryParams): Promise<void>;
+//# sourceMappingURL=QQGatewaySend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewaySend.d.ts","sourceRoot":"","sources":["../../../../../src/services/chat/channels/qq/QQGatewaySend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAOrE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC;;OAEG;IACH,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC;;OAEG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD;;OAEG;IACH,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAmHD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CAmDf"}