@downcity/agent 1.1.10 → 1.1.12

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

@@ -0,0 +1,110 @@
+/**
+ * QQ Gateway WebSocket 连接事件绑定。
+ *
+ * 关键点（中文）
+ * - 只负责创建 WebSocket、绑定 open/message/close/error 事件。
+ * - runtime 状态仍由 `QQGatewayClient` 持有，避免连接 helper 变成第二个状态源。
+ * - message 解析与原始事件捕获在这里完成，业务 payload 交回 client 编排。
+ */
+import WebSocket from "ws";
+import { captureQqWsPayload } from "./QQEventCapture.js";
+import { parseQqGatewayPayload } from "./QQGatewaySupport.js";
+/**
+ * 建立 QQ Gateway WebSocket。
+ */
+export async function connectQqGatewayWebSocket(params) {
+    params.logger.info(`正在连接 WebSocket: ${params.gatewayUrl}`);
+    closePreviousSocket(params.getCurrentSocket());
+    params.stopHeartbeat();
+    params.resetLivenessState();
+    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(params.gatewayUrl);
+        params.setCurrentSocket(ws);
+        ws.on("open", () => {
+            if (params.getCurrentSocket() !== ws)
+                return;
+            params.logger.info("WebSocket 连接已建立");
+            params.resetReconnectAttempts();
+            params.clearReconnectTimer();
+            params.resetLivenessState();
+            resolveOnce();
+        });
+        ws.on("message", async (data) => {
+            if (params.getCurrentSocket() !== ws)
+                return;
+            await handleSocketMessage(params, data);
+        });
+        ws.on("close", (code, reason) => {
+            if (params.getCurrentSocket() !== ws)
+                return;
+            const reasonText = Buffer.isBuffer(reason)
+                ? reason.toString("utf-8")
+                : String(reason || "");
+            params.logger.warn(`WebSocket 连接关闭: ${code} - ${reasonText}`);
+            params.setCurrentSocket(null);
+            params.stopHeartbeat();
+            params.resetLivenessState();
+            params.scheduleReconnect(`ws_closed:${code}`);
+            rejectOnce(new Error(`QQ websocket closed before ready: ${code} ${reasonText}`));
+        });
+        ws.on("error", (error) => {
+            if (params.getCurrentSocket() !== ws)
+                return;
+            params.logger.error("WebSocket 错误", { error: String(error) });
+            rejectOnce(error);
+        });
+    });
+}
+/**
+ * 关闭旧 socket。
+ */
+function closePreviousSocket(previousWs) {
+    if (previousWs &&
+        (previousWs.readyState === WebSocket.OPEN ||
+            previousWs.readyState === WebSocket.CONNECTING)) {
+        try {
+            previousWs.close();
+        }
+        catch {
+            // 关键点（中文）：旧连接关闭失败不影响新连接建立。
+        }
+    }
+}
+/**
+ * 解析、捕获并分发一条 socket message。
+ */
+async function handleSocketMessage(params, data) {
+    try {
+        const payload = parseQqGatewayPayload(data);
+        if (!payload) {
+            params.logger.warn("收到无法解析的 QQ WebSocket 消息，已忽略");
+            return;
+        }
+        params.logger.debug(`收到 WebSocket 消息: op=${payload.op}, t=${payload.t || "N/A"}`);
+        await captureQqWsPayload({
+            config: params.captureConfig,
+            logger: params.logger,
+            payload,
+        });
+        await params.handlePayload(payload);
+    }
+    catch (error) {
+        params.logger.error("处理 WebSocket 消息失败", {
+            error: String(error),
+        });
+    }
+}
+//# sourceMappingURL=QQGatewayConnection.js.map

package/bin/service/builtins/chat/channels/qq/QQGatewayConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayConnection.js","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/qq/QQGatewayConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,SAA2B,MAAM,IAAI,CAAC;AAM7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAoD9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAuC;IAEvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3D,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,aAAa,EAAE,CAAC;IACvB,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAE5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,KAAY,EAAE,EAAE;YAClC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC;QAEF,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAE5B,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACjB,IAAI,MAAM,CAAC,gBAAgB,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACtC,MAAM,CAAC,sBAAsB,EAAE,CAAC;YAChC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC7B,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;YACvC,IAAI,MAAM,CAAC,gBAAgB,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC7C,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE;YAC9C,IAAI,MAAM,CAAC,gBAAgB,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,IAAI,MAAM,UAAU,EAAE,CAAC,CAAC;YAC9D,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,iBAAiB,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YAC9C,UAAU,CAAC,IAAI,KAAK,CAAC,qCAAqC,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAC9B,IAAI,MAAM,CAAC,gBAAgB,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC7C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,UAA4B;IACvD,IACE,UAAU;QACV,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YACvC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU,CAAC,EACjD,CAAC;QACD,IAAI,CAAC;YACH,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,mBAAmB,CAChC,MAAuC,EACvC,IAAa;IAEb,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,KAAK,CACjB,uBAAuB,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,EAAE,CAC7D,CAAC;QACF,MAAM,kBAAkB,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,aAAa;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO;SACR,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * QQ Gateway 心跳发送辅助。
+ *
+ * 关键点（中文）
+ * - 只负责心跳 interval 归一化与单次 heartbeat payload 发送。
+ * - 心跳状态仍由 `QQGatewayClient` 持有，避免 helper 内部隐藏状态。
+ */
+import WebSocket from "ws";
+import type { Logger } from "../../../../../utils/logger/Logger.js";
+/**
+ * QQ Gateway heartbeat 发送参数。
+ */
+export interface SendQqGatewayHeartbeatParams {
+    /**
+     * 当前 socket。
+     */
+    socket: WebSocket | null;
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 最近一次服务端序列号。
+     */
+    lastSeq: number;
+    /**
+     * 心跳间隔。
+     */
+    heartbeatIntervalMs: number;
+    /**
+     * WebSocket READY 时间。
+     */
+    wsReadyAtMs: number;
+    /**
+     * 待 ACK 心跳开始时间。
+     */
+    pendingHeartbeatSinceMs: number;
+    /**
+     * 标记心跳发送成功。
+     */
+    markHeartbeatSent(nowMs: number): void;
+    /**
+     * 标记待 ACK 心跳开始时间。
+     */
+    markPendingHeartbeat(nowMs: number): void;
+    /**
+     * 触发 socket 自愈关闭。
+     */
+    closeSocketForRecovery(reason: string): void;
+}
+/**
+ * 归一化心跳间隔。
+ */
+export declare function normalizeQqHeartbeatIntervalMs(intervalMs: number): number;
+/**
+ * 发送单次 QQ Gateway heartbeat。
+ */
+export declare function sendQqGatewayHeartbeat(params: SendQqGatewayHeartbeatParams): void;
+//# sourceMappingURL=QQGatewayHeartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayHeartbeat.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/qq/QQGatewayHeartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAOvD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,4BAA4B,GACnC,IAAI,CAyCN"}

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

@@ -0,0 +1,58 @@
+/**
+ * QQ Gateway 心跳发送辅助。
+ *
+ * 关键点（中文）
+ * - 只负责心跳 interval 归一化与单次 heartbeat payload 发送。
+ * - 心跳状态仍由 `QQGatewayClient` 持有，避免 helper 内部隐藏状态。
+ */
+import WebSocket from "ws";
+import { OpCode } from "../../../../../service/builtins/chat/channels/qq/types/QqChannel.js";
+import { getQqHeartbeatAckTimeoutMs, hasQqHeartbeatTimeout, } from "./QQGatewaySupport.js";
+/**
+ * 归一化心跳间隔。
+ */
+export function normalizeQqHeartbeatIntervalMs(intervalMs) {
+    return Number.isFinite(intervalMs) && intervalMs > 0
+        ? Math.trunc(intervalMs)
+        : 30000;
+}
+/**
+ * 发送单次 QQ Gateway heartbeat。
+ */
+export function sendQqGatewayHeartbeat(params) {
+    const ws = params.socket;
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return;
+    const now = Date.now();
+    if (hasQqHeartbeatTimeout({
+        heartbeatIntervalMs: params.heartbeatIntervalMs,
+        pendingHeartbeatSinceMs: params.pendingHeartbeatSinceMs,
+        wsReadyAtMs: params.wsReadyAtMs,
+    }, now)) {
+        params.logger.warn("QQ 心跳 ACK 超时，准备重连", {
+            pendingHeartbeatSinceMs: params.pendingHeartbeatSinceMs,
+            heartbeatAckTimeoutMs: getQqHeartbeatAckTimeoutMs(params.heartbeatIntervalMs),
+        });
+        params.closeSocketForRecovery("heartbeat_ack_timeout");
+        return;
+    }
+    const heartbeatPayload = {
+        op: OpCode.Heartbeat,
+        d: params.lastSeq || null,
+    };
+    try {
+        ws.send(JSON.stringify(heartbeatPayload));
+        params.markHeartbeatSent(now);
+        if (!params.pendingHeartbeatSinceMs) {
+            params.markPendingHeartbeat(now);
+        }
+        params.logger.debug("发送心跳");
+    }
+    catch (error) {
+        params.logger.warn("发送 QQ 心跳失败，准备重连", {
+            error: String(error),
+        });
+        params.closeSocketForRecovery("heartbeat_send_failed");
+    }
+}
+//# sourceMappingURL=QQGatewayHeartbeat.js.map

package/bin/service/builtins/chat/channels/qq/QQGatewayHeartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayHeartbeat.js","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/qq/QQGatewayHeartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,wDAAwD,CAAC;AAChF,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AA4C/B;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QACxB,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAoC;IAEpC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;QAAE,OAAO;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IACE,qBAAqB,CACnB;QACE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;QACvD,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,EACD,GAAG,CACJ,EACD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;YACtC,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;YACvD,qBAAqB,EAAE,0BAA0B,CAC/C,MAAM,CAAC,mBAAmB,CAC3B;SACF,CAAC,CAAC;QACH,MAAM,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG;QACvB,EAAE,EAAE,MAAM,CAAC,SAAS;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;KAC1B,CAAC;IACF,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;YACpC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * QQ Gateway 协议处理。
+ *
+ * 关键点（中文）
+ * - 只负责 Gateway op code 的协议路由与 Identify payload 构造。
+ * - 不持有 WebSocket 生命周期状态，所有状态写入通过回调交回 `QQGatewayClient`。
+ * - 这样 client 保持单一状态源，协议细节也不会继续挤在连接编排类里。
+ */
+import type WebSocket from "ws";
+import type { Logger } from "../../../../../utils/logger/Logger.js";
+import type { QQGatewayPayload, QqDispatchHandler } from "../../../../../service/builtins/chat/channels/qq/types/QqChannel.js";
+/**
+ * Gateway payload 处理参数。
+ */
+export interface HandleQqGatewayPayloadParams {
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前 payload。
+     */
+    payload: QQGatewayPayload;
+    /**
+     * 记录服务端序列号。
+     */
+    setLastSeq(seq: number): void;
+    /**
+     * 启动心跳。
+     */
+    startHeartbeat(intervalMs: number): void;
+    /**
+     * 发送 Identify。
+     */
+    sendIdentify(): Promise<void>;
+    /**
+     * 标记 READY。
+     */
+    markReady(contextId: string): void;
+    /**
+     * 标记 RESUMED。
+     */
+    markResumed(): void;
+    /**
+     * 标记心跳 ACK。
+     */
+    markHeartbeatAck(): void;
+    /**
+     * 清理 access token 缓存。
+     */
+    clearAccessTokenCache(): void;
+    /**
+     * 触发 socket 自愈关闭。
+     */
+    closeSocketForRecovery(reason: string): void;
+    /**
+     * Dispatch 事件回调。
+     */
+    onDispatch(params: QqDispatchHandler): Promise<void>;
+}
+/**
+ * Identify 发送参数。
+ */
+export interface SendQqGatewayIdentifyParams {
+    /**
+     * 当前 socket。
+     */
+    socket: WebSocket | null;
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 获取鉴权 token。
+     */
+    getAuthToken(): Promise<string>;
+}
+/**
+ * 处理 QQ Gateway payload。
+ */
+export declare function handleQqGatewayPayload(params: HandleQqGatewayPayloadParams): Promise<void>;
+/**
+ * 发送 QQ Gateway Identify。
+ */
+export declare function sendQqGatewayIdentify(params: SendQqGatewayIdentifyParams): Promise<void>;
+//# sourceMappingURL=QQGatewayProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayProtocol.d.ts","sourceRoot":"","sources":["../../../../../../src/service/builtins/chat/channels/qq/QQGatewayProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,wDAAwD,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;IACpB;;OAEG;IACH,gBAAgB,IAAI,IAAI,CAAC;IACzB;;OAEG;IACH,qBAAqB,IAAI,IAAI,CAAC;IAC9B;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAsBf"}

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

@@ -0,0 +1,93 @@
+/**
+ * QQ Gateway 协议处理。
+ *
+ * 关键点（中文）
+ * - 只负责 Gateway op code 的协议路由与 Identify payload 构造。
+ * - 不持有 WebSocket 生命周期状态，所有状态写入通过回调交回 `QQGatewayClient`。
+ * - 这样 client 保持单一状态源，协议细节也不会继续挤在连接编排类里。
+ */
+import { EventType, OpCode } from "../../../../../service/builtins/chat/channels/qq/types/QqChannel.js";
+/**
+ * 处理 QQ Gateway payload。
+ */
+export async function handleQqGatewayPayload(params) {
+    const { op, d, s, t } = params.payload;
+    if (s) {
+        params.setLastSeq(s);
+    }
+    switch (op) {
+        case OpCode.Hello: {
+            const heartbeatIntervalMs = typeof d?.heartbeat_interval === "number" ? d.heartbeat_interval : 30000;
+            params.startHeartbeat(heartbeatIntervalMs);
+            await params.sendIdentify();
+            break;
+        }
+        case OpCode.Dispatch: {
+            const eventType = String(t || "");
+            if (eventType === EventType.READY) {
+                params.markReady(typeof d?.context_id === "string" ? d.context_id : "");
+            }
+            else if (eventType === EventType.RESUMED) {
+                params.markResumed();
+            }
+            await params.onDispatch({
+                eventType,
+                data: d || {},
+            });
+            break;
+        }
+        case OpCode.HeartbeatAck:
+            params.markHeartbeatAck();
+            params.logger.debug("收到心跳响应");
+            break;
+        case OpCode.Reconnect:
+            params.logger.warn("服务端要求重连");
+            params.closeSocketForRecovery("server_reconnect_opcode");
+            break;
+        case OpCode.InvalidContext:
+            params.logger.error("无效的 Context，需要重新鉴权");
+            params.clearAccessTokenCache();
+            setTimeout(async () => {
+                try {
+                    await params.sendIdentify();
+                }
+                catch (error) {
+                    params.logger.error("重新鉴权失败", { error: String(error) });
+                }
+            }, 2000);
+            break;
+    }
+}
+/**
+ * 发送 QQ Gateway Identify。
+ */
+export async function sendQqGatewayIdentify(params) {
+    const authToken = await params.getAuthToken();
+    const intents = getQqGatewayIntents();
+    params.logger.info(`发送鉴权请求 (Identify)，intents: ${intents}`);
+    const identifyPayload = {
+        op: OpCode.Identify,
+        d: {
+            token: authToken,
+            intents,
+            shard: [0, 1],
+            properties: {
+                $os: "linux",
+                $browser: "downcity",
+                $device: "downcity",
+            },
+        },
+    };
+    params.logger.debug(`Identify payload: ${JSON.stringify(identifyPayload)}`);
+    params.socket?.send(JSON.stringify(identifyPayload));
+    params.logger.info("已发送鉴权请求");
+}
+/**
+ * 获取订阅事件位掩码。
+ */
+function getQqGatewayIntents() {
+    const GROUP_AND_C2C_EVENT = 1 << 25;
+    const AUDIO_ACTION = 1 << 29;
+    return GROUP_AND_C2C_EVENT | AUDIO_ACTION;
+}
+//# sourceMappingURL=QQGatewayProtocol.js.map

package/bin/service/builtins/chat/channels/qq/QQGatewayProtocol.js.map

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

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

@@ -0,0 +1,129 @@
+/**
+ * QQ 入站消息处理器。
+ *
+ * 关键点（中文）
+ * - 负责 group / c2c / channel 三类入站消息的授权、去重、审计与执行入队。
+ * - 不直接持有 `QQBot` 实例；所有副作用通过显式函数注入。
+ * - `QQBot` 因此只保留渠道生命周期、dispatch 分流、发送与命令处理。
+ */
+import type { Logger } from "../../../../../utils/logger/Logger.js";
+import type { AgentContext } from "../../../../../runtime/AgentContextTypes.js";
+import type { ChannelChatKeyParams, IncomingAuthorizationParams, IncomingAuthorizationResult } from "../../../../../service/builtins/chat/channels/BaseChatChannel.js";
+import type { ChannelUserMessageMeta } from "../../../../../service/builtins/chat/channels/BaseChatChannelSupport.js";
+import type { QQMessageData } from "./types/QqChannel.js";
+/**
+ * QQ 消息作者身份。
+ */
+export type QqMessageActor = {
+    /**
+     * QQ 用户 ID / openid。
+     */
+    userId?: string;
+    /**
+     * QQ 用户展示名。
+     */
+    username?: string;
+};
+/**
+ * QQ 入站消息处理依赖。
+ */
+export interface QQMessageHandlerOptions {
+    /**
+     * 当前 agent context。
+     */
+    context: AgentContext;
+    /**
+     * 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前 bot 用户 ID。
+     */
+    getBotUserId(): string;
+    /**
+     * 计算 channel chatKey。
+     */
+    getChatKey(params: ChannelChatKeyParams): string;
+    /**
+     * 入站主体观测。
+     */
+    observeIncomingAuthorization(params: IncomingAuthorizationParams): Promise<void>;
+    /**
+     * 入站授权判定。
+     */
+    evaluateIncomingAuthorization(params: IncomingAuthorizationParams): Promise<IncomingAuthorizationResult>;
+    /**
+     * 发送授权失败提示。
+     */
+    sendAuthorizationText(params: {
+        chatId: string;
+        text: string;
+        chatType?: string;
+    }): Promise<void>;
+    /**
+     * 构建授权失败提示文案。
+     */
+    buildUnauthorizedBlockedText(params?: {
+        userId?: string;
+        chatId?: string;
+        chatType?: string;
+    }): string;
+    /**
+     * 入站去重判断。
+     */
+    shouldSkipDuplicatedInboundMessage(eventType: string, messageId: string | undefined): Promise<boolean>;
+    /**
+     * Audit 队列写入。
+     */
+    enqueueAuditMessage(params: {
+        chatId: string;
+        messageId?: string;
+        userId?: string;
+        text: string;
+        meta?: ChannelUserMessageMeta;
+    }): Promise<void>;
+    /**
+     * 命令处理。
+     */
+    handleCommand(params: {
+        chatId: string;
+        chatType: string;
+        messageId: string;
+        command: string;
+    }): Promise<void>;
+    /**
+     * 执行入队。
+     */
+    executeAndReply(params: {
+        chatId: string;
+        chatType: string;
+        messageId: string;
+        instructions: string;
+        actor?: QqMessageActor;
+        chatTitle?: string;
+    }): Promise<void>;
+    /**
+     * QQ access token 获取函数，用于入站附件下载。
+     */
+    getAuthToken(): Promise<string>;
+}
+/**
+ * 处理群聊消息。
+ */
+export declare function handleQqGroupMessage(options: QQMessageHandlerOptions, params: {
+    eventType: string;
+    data: QQMessageData;
+}): Promise<void>;
+/**
+ * 处理 C2C 私聊消息。
+ */
+export declare function handleQqC2CMessage(options: QQMessageHandlerOptions, data: QQMessageData): Promise<void>;
+/**
+ * 处理频道消息。
+ */
+export declare function handleQqChannelMessage(options: QQMessageHandlerOptions, data: QQMessageData): Promise<void>;
+//# sourceMappingURL=QQMessageHandler.d.ts.map

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

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