@ryantest/openclaw-qqbot 0.0.1

package/dist/src/message-queue.js

@@ -0,0 +1,115 @@
+// 消息队列配置
+const MESSAGE_QUEUE_SIZE = 1000;
+const PER_USER_QUEUE_SIZE = 20;
+const MAX_CONCURRENT_USERS = 10;
+/**
+ * 创建按用户并发的消息队列（同用户串行，跨用户并行）
+ */
+export function createMessageQueue(ctx) {
+    const { accountId, log } = ctx;
+    const userQueues = new Map();
+    const activeUsers = new Set();
+    let messagesProcessed = 0;
+    let handleMessageFnRef = null;
+    let totalEnqueued = 0;
+    const getMessagePeerId = (msg) => {
+        if (msg.type === "guild")
+            return `guild:${msg.channelId ?? "unknown"}`;
+        if (msg.type === "group")
+            return `group:${msg.groupOpenid ?? "unknown"}`;
+        return `dm:${msg.senderId}`;
+    };
+    const drainUserQueue = async (peerId) => {
+        if (activeUsers.has(peerId))
+            return;
+        if (activeUsers.size >= MAX_CONCURRENT_USERS) {
+            log?.info(`[qqbot:${accountId}] Max concurrent users (${MAX_CONCURRENT_USERS}) reached, ${peerId} will wait`);
+            return;
+        }
+        const queue = userQueues.get(peerId);
+        if (!queue || queue.length === 0) {
+            userQueues.delete(peerId);
+            return;
+        }
+        activeUsers.add(peerId);
+        try {
+            while (queue.length > 0 && !ctx.isAborted()) {
+                const msg = queue.shift();
+                totalEnqueued = Math.max(0, totalEnqueued - 1);
+                try {
+                    if (handleMessageFnRef) {
+                        await handleMessageFnRef(msg);
+                        messagesProcessed++;
+                    }
+                }
+                catch (err) {
+                    log?.error(`[qqbot:${accountId}] Message processor error for ${peerId}: ${err}`);
+                }
+            }
+        }
+        finally {
+            activeUsers.delete(peerId);
+            userQueues.delete(peerId);
+            for (const [waitingPeerId, waitingQueue] of userQueues) {
+                if (activeUsers.size >= MAX_CONCURRENT_USERS)
+                    break;
+                if (waitingQueue.length > 0 && !activeUsers.has(waitingPeerId)) {
+                    drainUserQueue(waitingPeerId);
+                }
+            }
+        }
+    };
+    const enqueue = (msg) => {
+        const peerId = getMessagePeerId(msg);
+        let queue = userQueues.get(peerId);
+        if (!queue) {
+            queue = [];
+            userQueues.set(peerId, queue);
+        }
+        if (queue.length >= PER_USER_QUEUE_SIZE) {
+            const dropped = queue.shift();
+            log?.error(`[qqbot:${accountId}] Per-user queue full for ${peerId}, dropping oldest message ${dropped?.messageId}`);
+        }
+        totalEnqueued++;
+        if (totalEnqueued > MESSAGE_QUEUE_SIZE) {
+            log?.error(`[qqbot:${accountId}] Global queue limit reached (${totalEnqueued}), message from ${peerId} may be delayed`);
+        }
+        queue.push(msg);
+        log?.debug?.(`[qqbot:${accountId}] Message enqueued for ${peerId}, user queue: ${queue.length}, active users: ${activeUsers.size}`);
+        drainUserQueue(peerId);
+    };
+    const startProcessor = (handleMessageFn) => {
+        handleMessageFnRef = handleMessageFn;
+        log?.info(`[qqbot:${accountId}] Message processor started (per-user concurrency, max ${MAX_CONCURRENT_USERS} users)`);
+    };
+    const getSnapshot = (senderPeerId) => {
+        let totalPending = 0;
+        for (const [, q] of userQueues) {
+            totalPending += q.length;
+        }
+        const senderQueue = userQueues.get(senderPeerId);
+        return {
+            totalPending,
+            activeUsers: activeUsers.size,
+            maxConcurrentUsers: MAX_CONCURRENT_USERS,
+            senderPending: senderQueue ? senderQueue.length : 0,
+        };
+    };
+    const clearUserQueue = (peerId) => {
+        const queue = userQueues.get(peerId);
+        if (!queue || queue.length === 0)
+            return 0;
+        const droppedCount = queue.length;
+        queue.length = 0;
+        totalEnqueued = Math.max(0, totalEnqueued - droppedCount);
+        return droppedCount;
+    };
+    const executeImmediate = (msg) => {
+        if (handleMessageFnRef) {
+            handleMessageFnRef(msg).catch(err => {
+                log?.error(`[qqbot:${accountId}] Immediate execution error: ${err}`);
+            });
+        }
+    };
+    return { enqueue, startProcessor, getSnapshot, getMessagePeerId, clearUserQueue, executeImmediate };
+}

package/dist/src/onboarding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * QQBot CLI Onboarding Adapter
+ *
+ * 提供 openclaw onboard 命令的交互式配置支持
+ */
+import type { ChannelOnboardingAdapter } from "openclaw/plugin-sdk";
+/**
+ * QQBot Onboarding Adapter
+ */
+export declare const qqbotOnboardingAdapter: ChannelOnboardingAdapter;

package/dist/src/onboarding.js

@@ -0,0 +1,203 @@
+import { DEFAULT_ACCOUNT_ID, listQQBotAccountIds, resolveQQBotAccount } from "./config.js";
+/**
+ * 解析默认账户 ID
+ */
+function resolveDefaultQQBotAccountId(cfg) {
+    const ids = listQQBotAccountIds(cfg);
+    return ids[0] ?? DEFAULT_ACCOUNT_ID;
+}
+/**
+ * QQBot Onboarding Adapter
+ */
+export const qqbotOnboardingAdapter = {
+    channel: "qqbot",
+    getStatus: async (ctx) => {
+        const cfg = ctx.cfg;
+        const configured = listQQBotAccountIds(cfg).some((accountId) => {
+            const account = resolveQQBotAccount(cfg, accountId);
+            return Boolean(account.appId && account.clientSecret);
+        });
+        return {
+            channel: "qqbot",
+            configured,
+            statusLines: [`QQ Bot: ${configured ? "已配置" : "需要 AppID 和 ClientSecret"}`],
+            selectionHint: configured ? "已配置" : "支持 QQ 群聊和私聊（流式消息）",
+            quickstartScore: configured ? 1 : 20,
+        };
+    },
+    configure: async (ctx) => {
+        const cfg = ctx.cfg;
+        const prompter = ctx.prompter;
+        const accountOverrides = ctx.accountOverrides;
+        const shouldPromptAccountIds = ctx.shouldPromptAccountIds;
+        const qqbotOverride = accountOverrides?.qqbot?.trim();
+        const defaultAccountId = resolveDefaultQQBotAccountId(cfg);
+        let accountId = qqbotOverride ?? defaultAccountId;
+        // 是否需要提示选择账户
+        if (shouldPromptAccountIds && !qqbotOverride) {
+            const existingIds = listQQBotAccountIds(cfg);
+            if (existingIds.length > 1) {
+                accountId = await prompter.select({
+                    message: "选择 QQBot 账户",
+                    options: existingIds.map((id) => ({
+                        value: id,
+                        label: id === DEFAULT_ACCOUNT_ID ? "默认账户" : id,
+                    })),
+                    initialValue: accountId,
+                });
+            }
+        }
+        let next = cfg;
+        const resolvedAccount = resolveQQBotAccount(next, accountId);
+        const accountConfigured = Boolean(resolvedAccount.appId && resolvedAccount.clientSecret);
+        const allowEnv = accountId === DEFAULT_ACCOUNT_ID;
+        const envAppId = typeof process !== "undefined" ? process.env?.QQBOT_APP_ID?.trim() : undefined;
+        const envSecret = typeof process !== "undefined" ? process.env?.QQBOT_CLIENT_SECRET?.trim() : undefined;
+        const canUseEnv = allowEnv && Boolean(envAppId && envSecret);
+        const hasConfigCredentials = Boolean(resolvedAccount.config.appId && resolvedAccount.config.clientSecret);
+        let appId = null;
+        let clientSecret = null;
+        // 显示帮助
+        if (!accountConfigured) {
+            await prompter.note([
+                "1) 打开 QQ 开放平台: https://q.qq.com/",
+                "2) 创建机器人应用，获取 AppID 和 ClientSecret",
+                "3) 在「开发设置」中添加沙箱成员（测试阶段）",
+                "4) 你也可以设置环境变量 QQBOT_APP_ID 和 QQBOT_CLIENT_SECRET",
+                "",
+                "文档: https://bot.q.qq.com/wiki/",
+                "",
+                "此版本支持流式消息发送！",
+            ].join("\n"), "QQ Bot 配置");
+        }
+        // 检测环境变量
+        if (canUseEnv && !hasConfigCredentials) {
+            const keepEnv = await prompter.confirm({
+                message: "检测到环境变量 QQBOT_APP_ID 和 QQBOT_CLIENT_SECRET，是否使用？",
+                initialValue: true,
+            });
+            if (keepEnv) {
+                next = {
+                    ...next,
+                    channels: {
+                        ...next.channels,
+                        qqbot: {
+                            ...(next.channels?.qqbot || {}),
+                            enabled: true,
+                            allowFrom: resolvedAccount.config?.allowFrom ?? ["*"],
+                        },
+                    },
+                };
+            }
+            else {
+                // 手动输入
+                appId = String(await prompter.text({
+                    message: "请输入 QQ Bot AppID",
+                    placeholder: "例如: 102146862",
+                    initialValue: resolvedAccount.appId || undefined,
+                    validate: (value) => (value?.trim() ? undefined : "AppID 不能为空"),
+                })).trim();
+                clientSecret = String(await prompter.text({
+                    message: "请输入 QQ Bot ClientSecret",
+                    placeholder: "你的 ClientSecret",
+                    validate: (value) => (value?.trim() ? undefined : "ClientSecret 不能为空"),
+                })).trim();
+            }
+        }
+        else if (hasConfigCredentials) {
+            // 已有配置
+            const keep = await prompter.confirm({
+                message: "QQ Bot 已配置，是否保留当前配置？",
+                initialValue: true,
+            });
+            if (!keep) {
+                appId = String(await prompter.text({
+                    message: "请输入 QQ Bot AppID",
+                    placeholder: "例如: 102146862",
+                    initialValue: resolvedAccount.appId || undefined,
+                    validate: (value) => (value?.trim() ? undefined : "AppID 不能为空"),
+                })).trim();
+                clientSecret = String(await prompter.text({
+                    message: "请输入 QQ Bot ClientSecret",
+                    placeholder: "你的 ClientSecret",
+                    validate: (value) => (value?.trim() ? undefined : "ClientSecret 不能为空"),
+                })).trim();
+            }
+        }
+        else {
+            // 没有配置，需要输入
+            appId = String(await prompter.text({
+                message: "请输入 QQ Bot AppID",
+                placeholder: "例如: 102146862",
+                initialValue: resolvedAccount.appId || undefined,
+                validate: (value) => (value?.trim() ? undefined : "AppID 不能为空"),
+            })).trim();
+            clientSecret = String(await prompter.text({
+                message: "请输入 QQ Bot ClientSecret",
+                placeholder: "你的 ClientSecret",
+                validate: (value) => (value?.trim() ? undefined : "ClientSecret 不能为空"),
+            })).trim();
+        }
+        // 默认允许所有人执行命令（用户无感知）
+        const allowFrom = resolvedAccount.config?.allowFrom ?? ["*"];
+        // 应用配置（markdownSupport 默认开启，如需关闭可用 set-markdown.sh）
+        if (appId && clientSecret) {
+            const existingQQBot = next.channels?.qqbot || {};
+            // 保留已有的 markdownSupport 设置，新装默认 true
+            const markdownSupport = existingQQBot.markdownSupport ?? true;
+            if (accountId === DEFAULT_ACCOUNT_ID) {
+                next = {
+                    ...next,
+                    channels: {
+                        ...next.channels,
+                        qqbot: {
+                            ...existingQQBot,
+                            enabled: true,
+                            appId,
+                            clientSecret,
+                            markdownSupport,
+                            allowFrom,
+                        },
+                    },
+                };
+            }
+            else {
+                const existingAccounts = (next.channels?.qqbot?.accounts || {});
+                const existingAccount = existingAccounts[accountId] || {};
+                const acctMarkdown = existingAccount.markdownSupport ?? true;
+                next = {
+                    ...next,
+                    channels: {
+                        ...next.channels,
+                        qqbot: {
+                            ...existingQQBot,
+                            enabled: true,
+                            accounts: {
+                                ...existingAccounts,
+                                [accountId]: {
+                                    ...existingAccount,
+                                    enabled: true,
+                                    appId,
+                                    clientSecret,
+                                    markdownSupport: acctMarkdown,
+                                    allowFrom,
+                                },
+                            },
+                        },
+                    },
+                };
+            }
+        }
+        return { success: true, cfg: next, accountId };
+    },
+    disable: (cfg) => {
+        const config = cfg;
+        return {
+            ...config,
+            channels: {
+                ...config.channels,
+                qqbot: { ...(config.channels?.qqbot || {}), enabled: false },
+            },
+        };
+    },
+};

package/dist/src/outbound-deliver.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 出站消息投递模块
+ *
+ * 从 gateway deliver 回调中提取的两大发送管线：
+ * 1. parseAndSendMediaTags — 解析 <qqimg/qqvoice/qqvideo/qqfile/qqmedia> 标签并按顺序发送
+ * 2. sendPlainReply — 处理不含媒体标签的普通回复（markdown 图片/纯文本+图片）
+ */
+import type { ResolvedQQBotAccount } from "./types.js";
+export interface DeliverEventContext {
+    type: "c2c" | "guild" | "dm" | "group";
+    senderId: string;
+    messageId: string;
+    channelId?: string;
+    groupOpenid?: string;
+    msgIdx?: string;
+}
+export interface DeliverAccountContext {
+    account: ResolvedQQBotAccount;
+    qualifiedTarget: string;
+    log?: {
+        info: (msg: string) => void;
+        error: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+}
+/** token 重试包装 */
+export type SendWithRetryFn = <T>(sendFn: (token: string) => Promise<T>) => Promise<T>;
+/** 一次性消费引用 ref */
+export type ConsumeQuoteRefFn = () => string | undefined;
+/**
+ * 解析回复文本中的媒体标签并按顺序发送。
+ *
+ * @returns true 如果检测到媒体标签并已处理；false 表示无媒体标签，调用方继续走普通文本管线
+ */
+export declare function parseAndSendMediaTags(replyText: string, event: DeliverEventContext, actx: DeliverAccountContext, sendWithRetry: SendWithRetryFn, consumeQuoteRef: ConsumeQuoteRefFn): Promise<{
+    handled: boolean;
+    normalizedText: string;
+}>;
+export interface PlainReplyPayload {
+    text?: string;
+    mediaUrls?: string[];
+    mediaUrl?: string;
+}
+/**
+ * 发送不含媒体标签的普通回复。
+ * 处理 markdown 图片嵌入、Base64 富媒体、纯文本分块、本地媒体自动路由。
+ */
+export declare function sendPlainReply(payload: PlainReplyPayload, replyText: string, event: DeliverEventContext, actx: DeliverAccountContext, sendWithRetry: SendWithRetryFn, consumeQuoteRef: ConsumeQuoteRefFn, toolMediaUrls: string[]): Promise<void>;