@downcity/agent 1.1.23 → 1.1.32

package/bin/plugin/builtins/chat/channels/qq/QQGatewayClient.d.ts

@@ -0,0 +1,155 @@
+/**
+ * QQGatewayClient：QQ 网关连接与发送客户端。
+ *
+ * 关键点（中文）
+ * - 这里专门负责 QQ Gateway WebSocket、心跳、自愈重连与状态持有。
+ * - 鉴权 / HTTP 探活 / 发送重试已经拆到旁路模块，当前文件只保留运行时编排。
+ * - QQBot 不再直接维护底层 ws / token 细节，只保留渠道编排职责。
+ */
+import type { Logger } from "../../../../../utils/logger/Logger.js";
+import type { QQEventCaptureConfig, QqDispatchHandler, QqGatewayRuntimeStatus } from "../../../../../plugin/builtins/chat/channels/qq/types/QqChannel.js";
+/**
+ * QQGatewayClient 构造参数。
+ */
+export interface QQGatewayClientOptions {
+    /**
+     * 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * QQ AppId。
+     */
+    appId: string;
+    /**
+     * QQ AppSecret。
+     */
+    appSecret: string;
+    /**
+     * 是否使用沙箱环境。
+     */
+    useSandbox: boolean;
+    /**
+     * QQ 原始事件捕获配置。
+     */
+    captureConfig: QQEventCaptureConfig;
+    /**
+     * Dispatch 事件回调。
+     */
+    onDispatch: (params: QqDispatchHandler) => Promise<void>;
+}
+/**
+ * QQ 网关客户端。
+ */
+export declare class QQGatewayClient {
+    private readonly rootPath;
+    private readonly logger;
+    private readonly appId;
+    private readonly appSecret;
+    private readonly useSandbox;
+    private readonly captureConfig;
+    private readonly onDispatch;
+    private ws;
+    private isRunning;
+    private heartbeatInterval;
+    private reconnectTimer;
+    private wsContextId;
+    private lastSeq;
+    private reconnectAttempts;
+    private readonly maxReconnectAttempts;
+    private heartbeatIntervalMs;
+    private lastHeartbeatSentAtMs;
+    private lastHeartbeatAckAtMs;
+    private pendingHeartbeatSinceMs;
+    private wsReadyAtMs;
+    private readonly sendRequestTimeoutMs;
+    private readonly sendMaxAttempts;
+    private accessToken;
+    private accessTokenExpires;
+    private readonly AUTH_API_BASE;
+    constructor(options: QQGatewayClientOptions);
+    /**
+     * 获取当前鉴权字符串。
+     */
+    getAuthToken(): Promise<string>;
+    /**
+     * 获取网关状态快照。
+     */
+    getExecutorStatus(): QqGatewayRuntimeStatus;
+    /**
+     * 执行 QQ 连通性测试。
+     */
+    testConnection(): Promise<import("../../types/ChannelStatus.js").ChatChannelTestResult>;
+    /**
+     * 启动 QQ 网关。
+     */
+    start(): Promise<void>;
+    /**
+     * 停止 QQ 网关。
+     */
+    stop(): Promise<void>;
+    /**
+     * 请求一次重连。
+     */
+    requestReconnect(reason: string, delayMs?: number): void;
+    /**
+     * 发送 QQ 消息。
+     */
+    sendMessage(chatId: string, chatType: string, messageId: string, text: string, msgSeq?: number): Promise<void>;
+    /**
+     * 获取 API 基础地址。
+     */
+    private getApiBase;
+    /**
+     * 获取默认 WebSocket Gateway。
+     */
+    private getWsGateway;
+    /**
+     * 获取 Gateway 地址。
+     */
+    private getGatewayUrl;
+    /**
+     * 重置网关活性状态。
+     */
+    private resetWsLivenessState;
+    /**
+     * 清理 token 缓存。
+     */
+    private clearAccessTokenCache;
+    /**
+     * 清理重连定时器。
+     */
+    private clearReconnectTimer;
+    /**
+     * 计划一次重连。
+     */
+    private scheduleReconnect;
+    /**
+     * 主动关闭当前 socket，交给 close 回调统一进入重连流程。
+     */
+    private closeSocketForRecovery;
+    /**
+     * 建立 WebSocket 连接。
+     */
+    private connectWebSocket;
+    /**
+     * 发送鉴权请求。
+     */
+    private sendIdentify;
+    /**
+     * 启动心跳。
+     */
+    private startHeartbeat;
+    /**
+     * 发送单次心跳。
+     */
+    private sendHeartbeat;
+    /**
+     * 停止心跳。
+     */
+    private stopHeartbeat;
+}
+//# sourceMappingURL=QQGatewayClient.d.ts.map

package/bin/plugin/builtins/chat/channels/qq/QQGatewayClient.d.ts.map

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

package/bin/plugin/builtins/chat/channels/qq/QQGatewayClient.js.map

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

package/bin/plugin/builtins/chat/channels/qq/QQGatewayConnection.d.ts

@@ -0,0 +1,65 @@
+/**
+ * QQ Gateway WebSocket 连接事件绑定。
+ *
+ * 关键点（中文）
+ * - 只负责创建 WebSocket、绑定 open/message/close/error 事件。
+ * - runtime 状态仍由 `QQGatewayClient` 持有，避免连接 helper 变成第二个状态源。
+ * - message 解析与原始事件捕获在这里完成，业务 payload 交回 client 编排。
+ */
+import WebSocket from "ws";
+import type { Logger } from "../../../../../utils/logger/Logger.js";
+import type { QQEventCaptureConfig, QQGatewayPayload } from "../../../../../plugin/builtins/chat/channels/qq/types/QqChannel.js";
+/**
+ * QQ Gateway WebSocket 连接参数。
+ */
+export interface ConnectQqGatewayWebSocketParams {
+    /**
+     * Gateway WebSocket URL。
+     */
+    gatewayUrl: string;
+    /**
+     * 日志器。
+     */
+    logger: Logger;
+    /**
+     * 原始事件捕获配置。
+     */
+    captureConfig: QQEventCaptureConfig;
+    /**
+     * 当前 WebSocket。
+     */
+    getCurrentSocket(): WebSocket | null;
+    /**
+     * 更新当前 WebSocket。
+     */
+    setCurrentSocket(ws: WebSocket | null): void;
+    /**
+     * 重置连接活性状态。
+     */
+    resetLivenessState(): void;
+    /**
+     * 停止心跳。
+     */
+    stopHeartbeat(): void;
+    /**
+     * 清理重连 timer。
+     */
+    clearReconnectTimer(): void;
+    /**
+     * 重置重连次数。
+     */
+    resetReconnectAttempts(): void;
+    /**
+     * 计划重连。
+     */
+    scheduleReconnect(reason: string, delayMs?: number): void;
+    /**
+     * 处理已解析的 Gateway payload。
+     */
+    handlePayload(payload: QQGatewayPayload): Promise<void>;
+}
+/**
+ * 建立 QQ Gateway WebSocket。
+ */
+export declare function connectQqGatewayWebSocket(params: ConnectQqGatewayWebSocketParams): Promise<void>;
+//# sourceMappingURL=QQGatewayConnection.d.ts.map

package/bin/plugin/builtins/chat/channels/qq/QQGatewayConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayConnection.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/qq/QQGatewayConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,SAA2B,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,uDAAuD,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,EAAE,oBAAoB,CAAC;IACpC;;OAEG;IACH,gBAAgB,IAAI,SAAS,GAAG,IAAI,CAAC;IACrC;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7C;;OAEG;IACH,kBAAkB,IAAI,IAAI,CAAC;IAC3B;;OAEG;IACH,aAAa,IAAI,IAAI,CAAC;IACtB;;OAEG;IACH,mBAAmB,IAAI,IAAI,CAAC;IAC5B;;OAEG;IACH,sBAAsB,IAAI,IAAI,CAAC;IAC/B;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,IAAI,CAAC,CAuDf"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayConnection.js","sourceRoot":"","sources":["../../../../../../src/plugin/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/plugin/builtins/chat/channels/qq/QQGatewayHeartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayHeartbeat.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/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/plugin/builtins/chat/channels/qq/QQGatewayHeartbeat.js

@@ -0,0 +1,58 @@
+/**
+ * QQ Gateway 心跳发送辅助。
+ *
+ * 关键点（中文）
+ * - 只负责心跳 interval 归一化与单次 heartbeat payload 发送。
+ * - 心跳状态仍由 `QQGatewayClient` 持有，避免 helper 内部隐藏状态。
+ */
+import WebSocket from "ws";
+import { OpCode } from "../../../../../plugin/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/plugin/builtins/chat/channels/qq/QQGatewayHeartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayHeartbeat.js","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/qq/QQGatewayHeartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,uDAAuD,CAAC;AAC/E,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/plugin/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 "../../../../../plugin/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/plugin/builtins/chat/channels/qq/QQGatewayProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewayProtocol.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/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,uDAAuD,CAAC;AAG/D;;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/plugin/builtins/chat/channels/qq/QQGatewayProtocol.js

@@ -0,0 +1,93 @@
+/**
+ * QQ Gateway 协议处理。
+ *
+ * 关键点（中文）
+ * - 只负责 Gateway op code 的协议路由与 Identify payload 构造。
+ * - 不持有 WebSocket 生命周期状态，所有状态写入通过回调交回 `QQGatewayClient`。
+ * - 这样 client 保持单一状态源，协议细节也不会继续挤在连接编排类里。
+ */
+import { EventType, OpCode } from "../../../../../plugin/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/plugin/builtins/chat/channels/qq/QQGatewayProtocol.js.map

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

package/bin/plugin/builtins/chat/channels/qq/QQGatewaySend.d.ts

@@ -0,0 +1,84 @@
+/**
+ * QQ Gateway 发送辅助函数。
+ *
+ * 关键点（中文）
+ * - 这里统一处理消息投递地址、超时、自动重试与自愈触发。
+ * - `QQGatewayClient` 只保留发送入口与状态持有，不再直接展开长流程。
+ */
+import type { Logger } from "../../../../../utils/logger/Logger.js";
+import type { QQSendMessageBody } from "../../../../../plugin/builtins/chat/channels/qq/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/plugin/builtins/chat/channels/qq/QQGatewaySend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQGatewaySend.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/qq/QQGatewaySend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAO/F;;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"}

package/bin/plugin/builtins/chat/channels/qq/QQGatewaySend.js.map

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

package/bin/plugin/builtins/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 "../../../../../plugin/builtins/chat/channels/qq/types/QqChannel.js";
+import type { QqGatewayHeartbeatState, QqGatewayRuntimeStatusInput } from "../../../../../plugin/builtins/chat/channels/qq/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