@tencent-connect/openclaw-qqbot 1.5.7 → 1.6.0-alpha.2

package/dist/src/session-store.js

@@ -1,254 +0,0 @@
-/**
- * Session 持久化存储
- * 将 WebSocket 连接状态（sessionId、lastSeq）持久化到文件
- * 支持进程重启后通过 Resume 机制快速恢复连接
- */
-import fs from "node:fs";
-import path from "node:path";
-import { getQQBotDataDir } from "./utils/platform.js";
-// Session 文件目录
-const SESSION_DIR = getQQBotDataDir("sessions");
-// Session 过期时间（5分钟）- Resume 要求在断开后一定时间内恢复
-const SESSION_EXPIRE_TIME = 5 * 60 * 1000;
-// 写入节流时间（避免频繁写入）
-const SAVE_THROTTLE_MS = 1000;
-// 每个账户的节流状态
-const throttleState = new Map();
-/**
- * 确保目录存在
- */
-function ensureDir() {
-    if (!fs.existsSync(SESSION_DIR)) {
-        fs.mkdirSync(SESSION_DIR, { recursive: true });
-    }
-}
-/**
- * 获取 Session 文件路径
- */
-function getSessionPath(accountId) {
-    // 清理 accountId 中的特殊字符
-    const safeId = accountId.replace(/[^a-zA-Z0-9_-]/g, "_");
-    return path.join(SESSION_DIR, `session-${safeId}.json`);
-}
-/**
- * 加载 Session 状态
- * @param accountId 账户 ID
- * @param expectedAppId 当前使用的 appId，如果与保存时的 appId 不匹配则视为失效
- * @returns Session 状态，如果不存在、已过期或 appId 不匹配返回 null
- */
-export function loadSession(accountId, expectedAppId) {
-    const filePath = getSessionPath(accountId);
-    try {
-        if (!fs.existsSync(filePath)) {
-            return null;
-        }
-        const data = fs.readFileSync(filePath, "utf-8");
-        const state = JSON.parse(data);
-        // 检查是否过期
-        const now = Date.now();
-        if (now - state.savedAt > SESSION_EXPIRE_TIME) {
-            console.log(`[session-store] Session expired for ${accountId}, age: ${Math.round((now - state.savedAt) / 1000)}s`);
-            try {
-                fs.unlinkSync(filePath);
-            }
-            catch {
-                // 忽略删除错误
-            }
-            return null;
-        }
-        // 检查 appId 是否匹配（凭据变更检测）
-        if (expectedAppId && state.appId && state.appId !== expectedAppId) {
-            console.log(`[session-store] appId mismatch for ${accountId}: saved=${state.appId}, current=${expectedAppId}. Discarding stale session.`);
-            try {
-                fs.unlinkSync(filePath);
-            }
-            catch {
-                // 忽略删除错误
-            }
-            return null;
-        }
-        // 验证必要字段
-        if (!state.sessionId || state.lastSeq === null || state.lastSeq === undefined) {
-            console.log(`[session-store] Invalid session data for ${accountId}`);
-            return null;
-        }
-        console.log(`[session-store] Loaded session for ${accountId}: sessionId=${state.sessionId}, lastSeq=${state.lastSeq}, appId=${state.appId ?? "unknown"}, age=${Math.round((now - state.savedAt) / 1000)}s`);
-        return state;
-    }
-    catch (err) {
-        console.error(`[session-store] Failed to load session for ${accountId}: ${err}`);
-        return null;
-    }
-}
-/**
- * 保存 Session 状态（带节流，避免频繁写入）
- * @param state Session 状态
- */
-export function saveSession(state) {
-    const { accountId } = state;
-    // 获取或初始化节流状态
-    let throttle = throttleState.get(accountId);
-    if (!throttle) {
-        throttle = {
-            pendingState: null,
-            lastSaveTime: 0,
-            throttleTimer: null,
-        };
-        throttleState.set(accountId, throttle);
-    }
-    const now = Date.now();
-    const timeSinceLastSave = now - throttle.lastSaveTime;
-    // 如果距离上次保存时间足够长，立即保存
-    if (timeSinceLastSave >= SAVE_THROTTLE_MS) {
-        doSaveSession(state);
-        throttle.lastSaveTime = now;
-        throttle.pendingState = null;
-        // 清除待定的节流定时器
-        if (throttle.throttleTimer) {
-            clearTimeout(throttle.throttleTimer);
-            throttle.throttleTimer = null;
-        }
-    }
-    else {
-        // 记录待保存的状态
-        throttle.pendingState = state;
-        // 如果没有设置定时器，设置一个
-        if (!throttle.throttleTimer) {
-            const delay = SAVE_THROTTLE_MS - timeSinceLastSave;
-            throttle.throttleTimer = setTimeout(() => {
-                const t = throttleState.get(accountId);
-                if (t && t.pendingState) {
-                    doSaveSession(t.pendingState);
-                    t.lastSaveTime = Date.now();
-                    t.pendingState = null;
-                }
-                if (t) {
-                    t.throttleTimer = null;
-                }
-            }, delay);
-        }
-    }
-}
-/**
- * 实际执行保存操作
- */
-function doSaveSession(state) {
-    const filePath = getSessionPath(state.accountId);
-    try {
-        ensureDir();
-        // 更新保存时间
-        const stateToSave = {
-            ...state,
-            savedAt: Date.now(),
-        };
-        fs.writeFileSync(filePath, JSON.stringify(stateToSave, null, 2), "utf-8");
-        console.log(`[session-store] Saved session for ${state.accountId}: sessionId=${state.sessionId}, lastSeq=${state.lastSeq}`);
-    }
-    catch (err) {
-        console.error(`[session-store] Failed to save session for ${state.accountId}: ${err}`);
-    }
-}
-/**
- * 清除 Session 状态
- * @param accountId 账户 ID
- */
-export function clearSession(accountId) {
-    const filePath = getSessionPath(accountId);
-    // 清除节流状态
-    const throttle = throttleState.get(accountId);
-    if (throttle) {
-        if (throttle.throttleTimer) {
-            clearTimeout(throttle.throttleTimer);
-        }
-        throttleState.delete(accountId);
-    }
-    try {
-        if (fs.existsSync(filePath)) {
-            fs.unlinkSync(filePath);
-            console.log(`[session-store] Cleared session for ${accountId}`);
-        }
-    }
-    catch (err) {
-        console.error(`[session-store] Failed to clear session for ${accountId}: ${err}`);
-    }
-}
-/**
- * 更新 lastSeq（轻量级更新）
- * @param accountId 账户 ID
- * @param lastSeq 最新的消息序号
- */
-export function updateLastSeq(accountId, lastSeq) {
-    const existing = loadSession(accountId);
-    if (existing && existing.sessionId) {
-        saveSession({
-            ...existing,
-            lastSeq,
-        });
-    }
-}
-/**
- * 获取所有保存的 Session 状态
- */
-export function getAllSessions() {
-    const sessions = [];
-    try {
-        ensureDir();
-        const files = fs.readdirSync(SESSION_DIR);
-        for (const file of files) {
-            if (file.startsWith("session-") && file.endsWith(".json")) {
-                const filePath = path.join(SESSION_DIR, file);
-                try {
-                    const data = fs.readFileSync(filePath, "utf-8");
-                    const state = JSON.parse(data);
-                    sessions.push(state);
-                }
-                catch {
-                    // 忽略解析错误
-                }
-            }
-        }
-    }
-    catch {
-        // 目录不存在等错误
-    }
-    return sessions;
-}
-/**
- * 清理过期的 Session 文件
- */
-export function cleanupExpiredSessions() {
-    let cleaned = 0;
-    try {
-        ensureDir();
-        const files = fs.readdirSync(SESSION_DIR);
-        const now = Date.now();
-        for (const file of files) {
-            if (file.startsWith("session-") && file.endsWith(".json")) {
-                const filePath = path.join(SESSION_DIR, file);
-                try {
-                    const data = fs.readFileSync(filePath, "utf-8");
-                    const state = JSON.parse(data);
-                    if (now - state.savedAt > SESSION_EXPIRE_TIME) {
-                        fs.unlinkSync(filePath);
-                        cleaned++;
-                        console.log(`[session-store] Cleaned expired session: ${file}`);
-                    }
-                }
-                catch {
-                    // 忽略解析错误，但也删除损坏的文件
-                    try {
-                        fs.unlinkSync(filePath);
-                        cleaned++;
-                    }
-                    catch {
-                        // 忽略
-                    }
-                }
-            }
-        }
-    }
-    catch {
-        // 目录不存在等错误
-    }
-    return cleaned;
-}

package/dist/src/slash-commands.d.ts

@@ -1,48 +0,0 @@
-/**
- * QQ Bot 斜杠指令处理模块
- *
- * 支持的指令：
- * - /echo <message>    直接回复消息（不经过 AI）
- * - /debug             切换 debug 模式（开启后附带链路耗时统计）
- * - /upgrade           自动执行插件更新
- */
-import type { ResolvedQQBotAccount } from "./types.js";
-export declare function isDebugEnabled(peerId: string): boolean;
-export declare function setDebugEnabled(peerId: string, enabled: boolean): void;
-export interface TimingTrace {
-    /** QQ 平台事件时间戳 */
-    eventTimestamp?: string;
-    /** 收到 QQ WebSocket 消息的时间 */
-    messageReceivedAt: number;
-    /** 发送给 OpenClaw 的时间 */
-    dispatchToOpenClawAt?: number;
-    /** 消息发送完成的时间 */
-    sendCompleteAt?: number;
-}
-/** 格式化耗时统计为可读文本 */
-export declare function formatTimingTrace(trace: TimingTrace): string;
-export interface SlashCommandResult {
-    /** 是否是斜杠指令（true 表示已处理，不需要继续走 AI） */
-    handled: boolean;
-}
-interface SendContext {
-    type: "c2c" | "guild" | "dm" | "group";
-    senderId: string;
-    messageId: string;
-    channelId?: string;
-    groupOpenid?: string;
-    account: ResolvedQQBotAccount;
-    peerId: string;
-    log?: {
-        info: (msg: string) => void;
-        error: (msg: string) => void;
-        debug?: (msg: string) => void;
-    };
-}
-/**
- * 尝试处理斜杠指令
- *
- * @returns handled=true 表示该消息已作为指令处理，不需要继续走 AI 管道
- */
-export declare function handleSlashCommand(content: string, ctx: SendContext, receivedAt?: number, eventTimestamp?: string): Promise<SlashCommandResult>;
-export {};

package/dist/src/slash-commands.js

@@ -1,212 +0,0 @@
-/**
- * QQ Bot 斜杠指令处理模块
- *
- * 支持的指令：
- * - /echo <message>    直接回复消息（不经过 AI）
- * - /debug             切换 debug 模式（开启后附带链路耗时统计）
- * - /upgrade           自动执行插件更新
- */
-import { exec } from "node:child_process";
-import { promisify } from "node:util";
-import { getAccessToken, sendC2CMessage, sendGroupMessage, sendChannelMessage, clearTokenCache, } from "./api.js";
-const execAsync = promisify(exec);
-// ============ Debug 模式管理 ============
-/** 每个会话（peerId）独立的 debug 开关 */
-const debugSessions = new Map();
-export function isDebugEnabled(peerId) {
-    return debugSessions.get(peerId) === true;
-}
-export function setDebugEnabled(peerId, enabled) {
-    if (enabled) {
-        debugSessions.set(peerId, true);
-    }
-    else {
-        debugSessions.delete(peerId);
-    }
-}
-/** 格式化耗时统计为可读文本 */
-export function formatTimingTrace(trace) {
-    const lines = ["📊 链路耗时统计"];
-    const t0 = trace.messageReceivedAt;
-    const eventTs = trace.eventTimestamp ? new Date(trace.eventTimestamp).getTime() : 0;
-    const platformDelay = eventTs > 0 ? `${t0 - eventTs}ms` : "N/A";
-    lines.push(`├ 平台→QQBot插件: ${platformDelay}`);
-    if (trace.dispatchToOpenClawAt) {
-        lines.push(`├ QQBot插件耗时: ${trace.dispatchToOpenClawAt - t0}ms`);
-    }
-    if (trace.sendCompleteAt && trace.dispatchToOpenClawAt) {
-        lines.push(`└ OpenClaw耗时: ${trace.sendCompleteAt - trace.dispatchToOpenClawAt}ms`);
-    }
-    return lines.join("\n");
-}
-/** 发送带 token 重试的消息 */
-async function sendReply(ctx, text) {
-    const { type, senderId, messageId, channelId, groupOpenid, account } = ctx;
-    const send = async (token) => {
-        if (type === "c2c") {
-            await sendC2CMessage(token, senderId, text, messageId);
-        }
-        else if (type === "group" && groupOpenid) {
-            await sendGroupMessage(token, groupOpenid, text, messageId);
-        }
-        else if (channelId) {
-            await sendChannelMessage(token, channelId, text, messageId);
-        }
-    };
-    try {
-        const token = await getAccessToken(account.appId, account.clientSecret);
-        await send(token);
-    }
-    catch (err) {
-        const errMsg = String(err);
-        if (errMsg.includes("401") || errMsg.includes("token") || errMsg.includes("access_token")) {
-            clearTokenCache(account.appId);
-            const newToken = await getAccessToken(account.appId, account.clientSecret);
-            await send(newToken);
-        }
-        else {
-            throw err;
-        }
-    }
-}
-// ============ 指令处理 ============
-/** 处理 /echo 指令 */
-async function handleEcho(ctx, args, receivedAt, eventTimestamp) {
-    const message = args.trim();
-    if (message) {
-        await sendReply(ctx, message);
-    }
-    // 计算事件时间戳 → 插件收到消息的延迟（QQ 平台 → WebSocket 传输耗时）
-    const eventTs = eventTimestamp ? new Date(eventTimestamp).getTime() : 0;
-    const platformDelay = eventTs > 0 ? `${receivedAt - eventTs}ms` : "N/A";
-    const timing = [
-        "⏱ 通道耗时",
-        `├ 事件时间: ${eventTs > 0 ? new Date(eventTs).toISOString() : "N/A"}`,
-        `├ 平台→插件: ${platformDelay}`,
-        `└ 插件处理: ${Date.now() - receivedAt}ms`,
-    ].join("\n");
-    await sendReply(ctx, timing);
-}
-/** 处理 /debug 指令 */
-async function handleDebug(ctx) {
-    const current = isDebugEnabled(ctx.peerId);
-    const next = !current;
-    setDebugEnabled(ctx.peerId, next);
-    const status = next
-        ? "🔍 Debug 模式已开启\n后续消息回复将附带链路耗时统计"
-        : "🔕 Debug 模式已关闭";
-    await sendReply(ctx, status);
-}
-/** 处理 /upgrade 指令 */
-async function handleUpgrade(ctx) {
-    await sendReply(ctx, "⏳ 正在执行插件更新，请稍候...");
-    // 检测 CLI 名称
-    let cmdName = "";
-    for (const name of ["openclaw", "clawdbot", "moltbot"]) {
-        try {
-            await execAsync(`command -v ${name}`);
-            cmdName = name;
-            break;
-        }
-        catch {
-            // not found, try next
-        }
-    }
-    if (!cmdName) {
-        await sendReply(ctx, "❌ 更新失败: 未找到 openclaw / clawdbot / moltbot CLI");
-        return;
-    }
-    const PKG_NAME = "@tencent-connect/openclaw-qqbot";
-    const steps = [];
-    let hasError = false;
-    try {
-        // [1/2] 直接安装最新版本（覆盖安装，不先 uninstall 避免触发框架自动重启）
-        steps.push("[1/2] 安装最新版本...");
-        try {
-            const { stdout, stderr } = await execAsync(`${cmdName} plugins install "${PKG_NAME}@latest"`, { timeout: 120000 });
-            const output = (stdout + "\n" + stderr).trim();
-            if (output) {
-                const lines = output.split("\n").filter(l => l.trim());
-                steps.push(...lines.slice(0, 10).map(l => `  ${l}`));
-                if (lines.length > 10) {
-                    steps.push(`  ... (${lines.length - 10} more lines)`);
-                }
-            }
-            steps.push("  ✅ 安装成功");
-        }
-        catch (installErr) {
-            const errOutput = installErr instanceof Error ? installErr.stderr || installErr.message : String(installErr);
-            steps.push(`  ❌ 安装失败: ${String(errOutput).slice(0, 200)}`);
-            hasError = true;
-        }
-    }
-    catch (err) {
-        steps.push(`❌ 更新过程出错: ${String(err).slice(0, 200)}`);
-        hasError = true;
-    }
-    // 先发送结果汇总（必须在重启之前发送，否则进程被杀后无法发送）
-    if (!hasError) {
-        steps.push("[2/2] 即将重启网关...");
-    }
-    const header = hasError ? "❌ 插件更新完成（有错误）" : "✅ 插件更新完成";
-    const result = `${header}\n${"=".repeat(30)}\n${steps.join("\n")}`;
-    try {
-        await sendReply(ctx, result);
-    }
-    catch (sendErr) {
-        ctx.log?.error(`[qqbot] Failed to send upgrade result: ${sendErr}`);
-    }
-    // 最后再重启网关（重启会杀掉当前进程，之后的代码不会执行）
-    if (!hasError) {
-        try {
-            await execAsync(`${cmdName} gateway restart`, { timeout: 30000 });
-        }
-        catch (restartErr) {
-            const errOutput = restartErr instanceof Error ? restartErr.stderr || restartErr.message : String(restartErr);
-            ctx.log?.error(`[qqbot] Gateway restart failed: ${errOutput}`);
-        }
-    }
-}
-// ============ 指令分发 ============
-/**
- * 尝试处理斜杠指令
- *
- * @returns handled=true 表示该消息已作为指令处理，不需要继续走 AI 管道
- */
-export async function handleSlashCommand(content, ctx, receivedAt, eventTimestamp) {
-    const trimmed = content.trim();
-    if (!trimmed.startsWith("/")) {
-        return { handled: false };
-    }
-    // 解析指令名和参数
-    const spaceIdx = trimmed.indexOf(" ");
-    const command = spaceIdx === -1 ? trimmed.toLowerCase() : trimmed.slice(0, spaceIdx).toLowerCase();
-    const args = spaceIdx === -1 ? "" : trimmed.slice(spaceIdx + 1);
-    ctx.log?.info(`[qqbot:${ctx.account.accountId}] Slash command: ${command}, args: ${args.slice(0, 50)}`);
-    try {
-        switch (command) {
-            case "/echo":
-                await handleEcho(ctx, args, receivedAt ?? Date.now(), eventTimestamp);
-                return { handled: true };
-            case "/debug":
-                await handleDebug(ctx);
-                return { handled: true };
-            case "/upgrade":
-                await handleUpgrade(ctx);
-                return { handled: true };
-            default:
-                // 不是已知指令，交给 AI 处理
-                return { handled: false };
-        }
-    }
-    catch (err) {
-        ctx.log?.error(`[qqbot:${ctx.account.accountId}] Slash command error: ${err}`);
-        try {
-            await sendReply(ctx, `❌ 指令执行失败: ${String(err).slice(0, 200)}`);
-        }
-        catch {
-            // 发送错误消息也失败了，只能记日志
-        }
-        return { handled: true };
-    }
-}

package/dist/src/types.d.ts

@@ -1,146 +0,0 @@
-/**
- * QQ Bot 配置类型
- */
-export interface QQBotConfig {
-    appId: string;
-    clientSecret?: string;
-    clientSecretFile?: string;
-}
-/**
- * 解析后的 QQ Bot 账户
- */
-export interface ResolvedQQBotAccount {
-    accountId: string;
-    name?: string;
-    enabled: boolean;
-    appId: string;
-    clientSecret: string;
-    secretSource: "config" | "file" | "env" | "none";
-    /** 系统提示词 */
-    systemPrompt?: string;
-    /** 图床服务器公网地址 */
-    imageServerBaseUrl?: string;
-    /** 是否支持 markdown 消息（默认 true） */
-    markdownSupport: boolean;
-    config: QQBotAccountConfig;
-}
-/**
- * QQ Bot 账户配置
- */
-export interface QQBotAccountConfig {
-    enabled?: boolean;
-    name?: string;
-    appId?: string;
-    clientSecret?: string;
-    clientSecretFile?: string;
-    dmPolicy?: "open" | "pairing" | "allowlist";
-    allowFrom?: string[];
-    /** 系统提示词，会添加在用户消息前面 */
-    systemPrompt?: string;
-    /** 图床服务器公网地址，用于发送图片，例如 http://your-ip:18765 */
-    imageServerBaseUrl?: string;
-    /** 是否支持 markdown 消息（默认 true，设为 false 可禁用） */
-    markdownSupport?: boolean;
-    /**
-     * @deprecated 请使用 audioFormatPolicy.uploadDirectFormats
-     * 可直接上传的音频格式（不转换为 SILK），向后兼容
-     */
-    voiceDirectUploadFormats?: string[];
-    /**
-     * 音频格式策略配置
-     * 统一管理入站（STT）和出站（上传）的音频格式转换行为
-     */
-    audioFormatPolicy?: AudioFormatPolicy;
-}
-/**
- * 音频格式策略：控制哪些格式可跳过转换
- */
-export interface AudioFormatPolicy {
-    /**
-     * STT 模型直接支持的音频格式（入站：跳过 SILK→WAV 转换）
-     * 如果 STT 服务支持直接处理某些格式（如 silk/amr），可将其加入此列表
-     * 例如: [".silk", ".amr", ".wav", ".mp3", ".ogg"]
-     * 默认为空（所有语音都先转换为 WAV 再送 STT）
-     */
-    sttDirectFormats?: string[];
-    /**
-     * QQ 平台支持直传的音频格式（出站：跳过→SILK 转换）
-     * 默认为 [".wav", ".mp3", ".silk"]（QQ Bot API 原生支持的三种格式）
-     * 仅当需要覆盖默认值时才配置此项
-     */
-    uploadDirectFormats?: string[];
-}
-/**
- * 富媒体附件
- */
-export interface MessageAttachment {
-    content_type: string;
-    filename?: string;
-    height?: number;
-    width?: number;
-    size?: number;
-    url: string;
-    voice_wav_url?: string;
-    asr_refer_text?: string;
-}
-/**
- * C2C 消息事件
- */
-export interface C2CMessageEvent {
-    author: {
-        id: string;
-        union_openid: string;
-        user_openid: string;
-    };
-    content: string;
-    id: string;
-    timestamp: string;
-    message_scene?: {
-        source: string;
-    };
-    attachments?: MessageAttachment[];
-}
-/**
- * 频道 AT 消息事件
- */
-export interface GuildMessageEvent {
-    id: string;
-    channel_id: string;
-    guild_id: string;
-    content: string;
-    timestamp: string;
-    author: {
-        id: string;
-        username?: string;
-        bot?: boolean;
-    };
-    member?: {
-        nick?: string;
-        joined_at?: string;
-    };
-    attachments?: MessageAttachment[];
-}
-/**
- * 群聊 AT 消息事件
- */
-export interface GroupMessageEvent {
-    author: {
-        id: string;
-        member_openid: string;
-    };
-    content: string;
-    id: string;
-    timestamp: string;
-    group_id: string;
-    group_openid: string;
-    attachments?: MessageAttachment[];
-}
-/**
- * WebSocket 事件负载
- */
-export interface WSPayload {
-    op: number;
-    d?: unknown;
-    s?: number;
-    t?: string;
-}

package/dist/src/types.js

@@ -1 +0,0 @@
-export {};