@downcity/plugins 1.0.4

package/bin/chat/channels/qq/QQMessageHandler.js

@@ -0,0 +1,284 @@
+/**
+ * QQ 入站消息处理器。
+ *
+ * 关键点（中文）
+ * - 负责 group / c2c / channel 三类入站消息的授权、去重、审计与执行入队。
+ * - 不直接持有 `QQBot` 实例；所有副作用通过显式函数注入。
+ * - `QQBot` 因此只保留渠道生命周期、dispatch 分流、发送与命令处理。
+ */
+import { buildQqAuditText, extractQqAuthorIdentity, extractQqInboundAttachments, extractQqTextContent, resolveQqInboundChatTitle, stripQqBotMention, } from "./QQInbound.js";
+import { buildQqInboundInstructions, resolveQqC2cChatId, resolveQqGroupChatId, } from "./QQSupport.js";
+import { EventType } from "./types/QqChannel.js";
+/**
+ * 处理群聊消息。
+ */
+export async function handleQqGroupMessage(options, params) {
+    const eventType = String(params.eventType || "").trim();
+    const data = params.data;
+    const messageId = typeof data.id === "string" ? data.id.trim() : String(data.id || "").trim();
+    if (!messageId)
+        return;
+    const groupId = resolveQqGroupChatId(data);
+    if (!groupId) {
+        options.logger.warn("QQ 群消息缺少 groupId，已忽略", {
+            eventType: eventType || EventType.GROUP_MESSAGE_CREATE,
+            messageId,
+        });
+        return;
+    }
+    await handleQqInboundMessage(options, {
+        eventType: eventType || EventType.GROUP_MESSAGE_CREATE,
+        chatId: groupId,
+        chatType: "group",
+        data,
+    });
+}
+/**
+ * 处理 C2C 私聊消息。
+ */
+export async function handleQqC2CMessage(options, data) {
+    const messageId = typeof data.id === "string" ? data.id.trim() : String(data.id || "").trim();
+    if (!messageId)
+        return;
+    const actor = extractQqAuthorIdentity(data.author, data);
+    const chatId = resolveQqC2cChatId({
+        data,
+        actorUserId: actor.userId,
+    });
+    if (!chatId) {
+        options.logger.warn("QQ C2C 消息缺少 userId，已忽略", {
+            eventType: EventType.C2C_MESSAGE_CREATE,
+            messageId,
+        });
+        return;
+    }
+    await handleQqInboundMessage(options, {
+        eventType: EventType.C2C_MESSAGE_CREATE,
+        chatId,
+        chatType: "c2c",
+        data,
+        actor,
+    });
+}
+/**
+ * 处理频道消息。
+ */
+export async function handleQqChannelMessage(options, data) {
+    const { id: messageId, channel_id: channelId, content, author } = data;
+    if (!channelId || !messageId)
+        return;
+    const chatType = "channel";
+    if (await options.shouldSkipDuplicatedInboundMessage(EventType.AT_MESSAGE_CREATE, messageId)) {
+        return;
+    }
+    const userMessage = extractQqTextContent(String(content || ""));
+    const incomingAttachments = extractQqInboundAttachments(data);
+    const actor = extractQqAuthorIdentity(author, data);
+    const chatTitle = resolveQqInboundChatTitle({
+        chatType,
+        data,
+        actorName: actor.username,
+    });
+    await options.observeIncomingAuthorization({
+        chatId: channelId,
+        chatType,
+        chatTitle,
+        userId: actor.userId,
+        username: actor.username,
+    });
+    const authResult = await options.evaluateIncomingAuthorization({
+        chatId: channelId,
+        chatType,
+        chatTitle,
+        userId: actor.userId,
+        username: actor.username,
+    });
+    if (authResult.decision !== "allow")
+        return;
+    const botUserId = options.getBotUserId();
+    if (actor.userId && botUserId && actor.userId === botUserId) {
+        options.logger.debug("忽略机器人自身消息（channel）", {
+            messageId,
+            channelId,
+            botUserId,
+        });
+        return;
+    }
+    options.logger.info(`收到频道消息 [${channelId}]: ${userMessage}`);
+    if (userMessage.startsWith("/")) {
+        await options.handleCommand({
+            chatId: channelId,
+            chatType: "channel",
+            messageId,
+            command: userMessage,
+        });
+        return;
+    }
+    const instructions = await buildQqInboundInstructions({
+        context: options.context,
+        rootPath: options.rootPath,
+        chatId: channelId,
+        chatKey: options.getChatKey({ chatId: channelId, chatType }),
+        messageId,
+        userMessage,
+        attachments: incomingAttachments,
+        getAuthToken: () => options.getAuthToken(),
+    });
+    if (!instructions)
+        return;
+    await options.executeAndReply({
+        chatId: channelId,
+        chatType: "channel",
+        messageId,
+        instructions,
+        actor,
+        chatTitle,
+    });
+}
+/**
+ * QQ group / c2c 入站主流程。
+ */
+async function handleQqInboundMessage(options, params) {
+    const eventType = String(params.eventType || "").trim();
+    const chatId = String(params.chatId || "").trim();
+    const messageId = typeof params.data.id === "string"
+        ? params.data.id.trim()
+        : String(params.data.id || "").trim();
+    if (!chatId || !messageId)
+        return;
+    if (await options.shouldSkipDuplicatedInboundMessage(eventType, messageId)) {
+        return;
+    }
+    const actor = params.actor || extractQqAuthorIdentity(params.data.author, params.data);
+    const chatType = params.chatType;
+    if (!actor.userId) {
+        options.logger.warn("QQ 入站消息缺少发送者 userId，已忽略", {
+            eventType,
+            chatId,
+            chatType,
+            messageId,
+        });
+        return;
+    }
+    const chatTitle = resolveQqInboundChatTitle({
+        chatType,
+        data: params.data,
+        actorName: actor.username,
+    });
+    const isGroup = chatType === "group";
+    const chatKey = options.getChatKey({ chatId, chatType });
+    const rawContent = String(params.data.content || "");
+    const incomingAttachments = extractQqInboundAttachments(params.data);
+    const hasIncomingAttachment = incomingAttachments.length > 0;
+    const botUserId = options.getBotUserId();
+    const cleanedText = isGroup
+        ? stripQqBotMention(rawContent, botUserId)
+        : extractQqTextContent(rawContent);
+    await options.observeIncomingAuthorization({
+        chatId,
+        chatType,
+        chatTitle,
+        userId: actor.userId,
+        username: actor.username,
+    });
+    const authResult = await options.evaluateIncomingAuthorization({
+        chatId,
+        chatType,
+        chatTitle,
+        userId: actor.userId,
+        username: actor.username,
+    });
+    if (authResult.decision !== "allow") {
+        if (!isGroup) {
+            await options.sendAuthorizationText({
+                chatId,
+                chatType,
+                text: options.buildUnauthorizedBlockedText({
+                    chatId,
+                    chatType,
+                    userId: actor.userId,
+                }),
+            });
+        }
+        return;
+    }
+    const enqueueAudit = async (opts) => {
+        await options.enqueueAuditMessage({
+            chatId,
+            messageId,
+            userId: actor.userId,
+            text: buildQqAuditText({
+                rawContent,
+                cleanedText,
+                hasIncomingAttachment,
+            }),
+            meta: {
+                chatType,
+                username: actor.username,
+                chatTitle,
+                eventType,
+                reason: opts.reason,
+                ...(opts.kind ? { kind: opts.kind } : {}),
+            },
+        });
+    };
+    if (actor.userId && botUserId && actor.userId === botUserId) {
+        if (isGroup) {
+            await enqueueAudit({ reason: "bot_originated" });
+        }
+        options.logger.debug("忽略机器人自身消息", {
+            messageId,
+            chatId,
+            chatType,
+            botUserId,
+        });
+        return;
+    }
+    options.logger.info(`收到 ${chatType} 消息 [${chatId}]: ${cleanedText}`);
+    if (!rawContent && !hasIncomingAttachment) {
+        if (isGroup) {
+            await enqueueAudit({ reason: "empty_payload" });
+        }
+        return;
+    }
+    if (cleanedText.startsWith("/")) {
+        await enqueueAudit({
+            reason: "command_received",
+            kind: "command",
+        });
+        await options.handleCommand({
+            chatId,
+            chatType,
+            messageId,
+            command: cleanedText,
+        });
+        return;
+    }
+    if (!cleanedText && !hasIncomingAttachment) {
+        await enqueueAudit({ reason: "empty_after_clean" });
+        return;
+    }
+    const instructions = await buildQqInboundInstructions({
+        context: options.context,
+        rootPath: options.rootPath,
+        chatId,
+        chatKey,
+        messageId,
+        userMessage: cleanedText,
+        attachments: incomingAttachments,
+        getAuthToken: () => options.getAuthToken(),
+    });
+    if (!instructions) {
+        await enqueueAudit({ reason: "empty_after_build" });
+        return;
+    }
+    await options.executeAndReply({
+        chatId,
+        chatType,
+        messageId,
+        instructions,
+        actor,
+        chatTitle,
+    });
+}
+//# sourceMappingURL=QQMessageHandler.js.map

package/bin/chat/channels/qq/QQMessageHandler.js.map

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

package/bin/chat/channels/qq/QQSendSupport.d.ts

@@ -0,0 +1,20 @@
+/**
+ * QQSendSupport：QQ 回发重试与错误归因辅助。
+ *
+ * 关键点（中文）
+ * - 这里只放与“发送失败处理”有关的纯辅助逻辑。
+ * - `QQGatewayClient` 只调用这些函数，不再内嵌大段重试细节。
+ */
+/**
+ * 解析 QQ API 业务错误文本。
+ */
+export declare function resolveQqApiErrorText(responseText: string): string | null;
+/**
+ * 判断一次发送失败是否值得自动重试。
+ */
+export declare function isRetryableQqSendFailure(errorText: string): boolean;
+/**
+ * 发送重试前等待一段退避时间。
+ */
+export declare function waitBeforeQqSendRetry(attempt: number): Promise<void>;
+//# sourceMappingURL=QQSendSupport.d.ts.map

package/bin/chat/channels/qq/QQSendSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQSendSupport.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/qq/QQSendSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA8BnE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1E"}

package/bin/chat/channels/qq/QQSendSupport.js

@@ -0,0 +1,86 @@
+/**
+ * QQSendSupport：QQ 回发重试与错误归因辅助。
+ *
+ * 关键点（中文）
+ * - 这里只放与“发送失败处理”有关的纯辅助逻辑。
+ * - `QQGatewayClient` 只调用这些函数，不再内嵌大段重试细节。
+ */
+/**
+ * 解析 QQ API 业务错误文本。
+ */
+export function resolveQqApiErrorText(responseText) {
+    if (!responseText)
+        return null;
+    try {
+        const parsed = JSON.parse(responseText);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return null;
+        const payload = parsed;
+        const codeValue = payload.code ?? payload.errcode ?? payload.retcode;
+        const code = typeof codeValue === "number"
+            ? codeValue
+            : typeof codeValue === "string" && codeValue.trim()
+                ? Number(codeValue)
+                : undefined;
+        if (!Number.isFinite(code) || code === 0)
+            return null;
+        const messageCandidates = [payload.message, payload.msg, payload.error, payload.errmsg]
+            .map((item) => (typeof item === "string" ? item.trim() : ""))
+            .filter(Boolean);
+        const detail = messageCandidates[0] || responseText.slice(0, 200);
+        return `API code ${code}${detail ? `: ${detail}` : ""}`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 判断一次发送失败是否值得自动重试。
+ */
+export function isRetryableQqSendFailure(errorText) {
+    const text = String(errorText || "").toLowerCase();
+    if (!text)
+        return false;
+    if (text.includes("http 400") ||
+        text.includes("http 404") ||
+        text.includes("requires chattype + messageid") ||
+        (text.includes("unknown") && text.includes("chat") && text.includes("type")) ||
+        text.includes("未知的聊天类型") ||
+        text.includes("msg_id") ||
+        text.includes("messageid") ||
+        text.includes("message id")) {
+        return false;
+    }
+    return (text.includes("http 401") ||
+        text.includes("http 403") ||
+        text.includes("http 408") ||
+        text.includes("http 429") ||
+        text.includes("http 5") ||
+        text.includes("fetch failed") ||
+        text.includes("network") ||
+        text.includes("socket") ||
+        text.includes("econn") ||
+        text.includes("etimedout") ||
+        text.includes("eai_again") ||
+        text.includes("enotfound"));
+}
+/**
+ * 发送重试前等待一段退避时间。
+ */
+export async function waitBeforeQqSendRetry(attempt) {
+    const safeAttempt = Number.isFinite(attempt) && attempt > 0 ? Math.trunc(attempt) : 1;
+    const delayMs = Math.min(4000, 600 * 2 ** (safeAttempt - 1));
+    const jitterMs = Math.floor(Math.random() * 180);
+    await sleepMs(delayMs + jitterMs);
+}
+/**
+ * Promise 版 sleep。
+ */
+async function sleepMs(ms) {
+    if (!Number.isFinite(ms) || ms <= 0)
+        return;
+    await new Promise((resolve) => {
+        setTimeout(resolve, Math.trunc(ms));
+    });
+}
+//# sourceMappingURL=QQSendSupport.js.map

package/bin/chat/channels/qq/QQSendSupport.js.map

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

package/bin/chat/channels/qq/QQSupport.d.ts

@@ -0,0 +1,102 @@
+/**
+ * QQ 渠道辅助逻辑。
+ *
+ * 关键点（中文）
+ * - 把 READY 身份解析、命令映射、入站增强组装等从 `QQ.ts` 抽离。
+ * - 这些逻辑尽量保持纯函数或最小依赖，便于单测与复用。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
+import type { QQMessageData } from "../../../chat/channels/qq/types/QqChannel.js";
+import type { QqIncomingAttachment } from "../../../chat/types/QqVoice.js";
+/**
+ * QQ READY 身份快照。
+ */
+export interface QqReadyIdentity {
+    /**
+     * 当前 ws context id。
+     */
+    wsContextId: string;
+    /**
+     * 机器人展示名。
+     */
+    botDisplayName: string;
+    /**
+     * 机器人用户主键。
+     */
+    botUserId: string;
+}
+/**
+ * QQ 命令动作定义。
+ */
+export interface QqCommandAction {
+    /**
+     * 动作类型。
+     */
+    action: "reply_only" | "clear_chat";
+    /**
+     * 回复文本。
+     */
+    responseText: string;
+}
+/**
+ * QQ 入站增强组装参数。
+ */
+export interface BuildQqInboundInstructionsParams {
+    /**
+     * 当前执行上下文。
+     */
+    context: AgentContext;
+    /**
+     * 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 平台 chatId。
+     */
+    chatId: string;
+    /**
+     * chat queue key。
+     */
+    chatKey: string;
+    /**
+     * 当前消息 id。
+     */
+    messageId: string;
+    /**
+     * 用户文本。
+     */
+    userMessage: string;
+    /**
+     * 附件列表。
+     */
+    attachments: QqIncomingAttachment[];
+    /**
+     * 获取 gateway 鉴权头的回调。
+     */
+    getAuthToken: () => Promise<string>;
+}
+/**
+ * 解析 READY 事件中的机器人身份信息。
+ */
+export declare function extractQqReadyIdentity(data: JsonObject): QqReadyIdentity;
+/**
+ * 解析 QQ 命令动作。
+ */
+export declare function resolveQqCommandAction(command: string): QqCommandAction;
+/**
+ * 解析 QQ 群消息的 chatId。
+ */
+export declare function resolveQqGroupChatId(data: QQMessageData): string;
+/**
+ * 解析 QQ C2C 消息的 chatId。
+ */
+export declare function resolveQqC2cChatId(params: {
+    data: QQMessageData;
+    actorUserId?: string;
+}): string;
+/**
+ * 构造 QQ 入站执行指令（文本 + 语音转写增强）。
+ */
+export declare function buildQqInboundInstructions(params: BuildQqInboundInstructionsParams): Promise<string>;
+//# sourceMappingURL=QQSupport.d.ts.map

package/bin/chat/channels/qq/QQSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQSupport.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/qq/QQSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,uCAAuC,CAAC;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CA8BxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAyCvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAWhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAmBT;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAgDjB"}