@tencent-connect/openclaw-qqbot 1.5.6 → 1.5.7

package/dist/src/slash-commands.js

@@ -0,0 +1,212 @@
+/**
+ * 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/utils/audio-convert.d.ts

@@ -22,8 +22,6 @@ export declare function isVoiceAttachment(att: {
 export declare function formatDuration(durationMs: number): string;
 export declare function isAudioFile(filePath: string): boolean;
 export interface TTSConfig {
-    /** TTS 引擎类型：openai 兼容 API 或 Edge TTS */
-    provider: "openai" | "edge";
     baseUrl: string;
     apiKey: string;
     model: string;
@@ -34,10 +32,6 @@ export interface TTSConfig {
     queryParams?: Record<string, string>;
     /** 自定义速度（默认不传） */
     speed?: number;
-    /** Edge TTS 专用：语速调整，如 "+10%"、"-20%" */
-    rate?: string;
-    /** Edge TTS 专用：音调调整，如 "+10%"、"-10%" */
-    pitch?: string;
 }
 export declare function resolveTTSConfig(cfg: Record<string, unknown>): TTSConfig | null;
 export declare function textToSpeechPCM(text: string, ttsCfg: TTSConfig): Promise<{

package/dist/src/utils/audio-convert.js

@@ -132,7 +132,6 @@ function resolveTTSFromBlock(block, providerCfg) {
     const queryParams = { ...(providerCfg?.queryParams ?? {}), ...(block?.queryParams ?? {}) };
     const speed = block?.speed;
     return {
-        provider: "openai",
         baseUrl: baseUrl.replace(/\/+$/, ""),
         apiKey,
         model,
@@ -142,27 +141,12 @@ function resolveTTSFromBlock(block, providerCfg) {
         ...(speed !== undefined ? { speed } : {}),
     };
 }
-function resolveEdgeTTSFromBlock(block) {
-    const voice = block?.voice || "zh-CN-XiaoxiaoNeural";
-    return {
-        provider: "edge",
-        baseUrl: "",
-        apiKey: "",
-        model: "edge-tts",
-        voice,
-        ...(block?.rate ? { rate: block.rate } : {}),
-        ...(block?.pitch ? { pitch: block.pitch } : {}),
-    };
-}
 export function resolveTTSConfig(cfg) {
     const c = cfg;
     // 优先使用 channels.qqbot.tts（插件专属配置）
     const channelTts = c?.channels?.qqbot?.tts;
     if (channelTts && channelTts.enabled !== false) {
         const providerId = channelTts?.provider || "openai";
-        if (providerId === "edge") {
-            return resolveEdgeTTSFromBlock(channelTts);
-        }
         const providerCfg = c?.models?.providers?.[providerId];
         const result = resolveTTSFromBlock(channelTts, providerCfg);
         if (result)
@@ -172,9 +156,6 @@ export function resolveTTSConfig(cfg) {
     const msgTts = c?.messages?.tts;
     if (msgTts && msgTts.auto !== "disabled") {
         const providerId = msgTts?.provider || "openai";
-        if (providerId === "edge") {
-            return resolveEdgeTTSFromBlock(msgTts);
-        }
         const providerBlock = msgTts?.[providerId];
         const providerCfg = c?.models?.providers?.[providerId];
         const result = resolveTTSFromBlock(providerBlock ?? {}, providerCfg);
@@ -205,76 +186,6 @@ function buildTTSRequest(ttsCfg) {
     return { url, headers };
 }
 export async function textToSpeechPCM(text, ttsCfg) {
-    if (ttsCfg.provider === "edge") {
-        return edgeTTSToPCM(text, ttsCfg);
-    }
-    return openaiTTSToPCM(text, ttsCfg);
-}
-async function edgeTTSToPCM(text, ttsCfg) {
-    const sampleRate = 24000;
-    const startTime = Date.now();
-    console.log(`[tts:edge] Request: voice=${ttsCfg.voice}, rate=${ttsCfg.rate ?? "default"}, pitch=${ttsCfg.pitch ?? "default"}`);
-    console.log(`[tts:edge] Input text (${text.length} chars): "${text.slice(0, 80)}${text.length > 80 ? "..." : ""}"`);
-    const { EdgeTTS } = await import("node-edge-tts");
-    const tts = new EdgeTTS({
-        voice: ttsCfg.voice,
-        outputFormat: `raw-${sampleRate}hz-16bit-mono-pcm`,
-        ...(ttsCfg.rate ? { rate: ttsCfg.rate } : {}),
-        ...(ttsCfg.pitch ? { pitch: ttsCfg.pitch } : {}),
-        timeout: 60000,
-    });
-    const tmpDir = fs.mkdtempSync(path.join(require("node:os").tmpdir(), "edge-tts-"));
-    const tmpFile = path.join(tmpDir, "tts.pcm");
-    try {
-        await tts.ttsPromise(text, tmpFile);
-        const pcmBuffer = fs.readFileSync(tmpFile);
-        console.log(`[tts:edge] Done: ${pcmBuffer.length} bytes, total=${Date.now() - startTime}ms`);
-        return { pcmBuffer, sampleRate };
-    }
-    catch (err) {
-        // raw PCM 格式可能不支持，回退到 mp3
-        console.log(`[tts:edge] PCM format failed, trying mp3 fallback: ${err instanceof Error ? err.message : String(err)}`);
-        const tmpMp3 = path.join(tmpDir, "tts.mp3");
-        try {
-            const ttsMp3 = new EdgeTTS({
-                voice: ttsCfg.voice,
-                outputFormat: "audio-24khz-96kbitrate-mono-mp3",
-                ...(ttsCfg.rate ? { rate: ttsCfg.rate } : {}),
-                ...(ttsCfg.pitch ? { pitch: ttsCfg.pitch } : {}),
-                timeout: 60000,
-            });
-            await ttsMp3.ttsPromise(text, tmpMp3);
-            const mp3Buffer = fs.readFileSync(tmpMp3);
-            console.log(`[tts:edge] mp3 generated: ${mp3Buffer.length} bytes`);
-            const ffmpegCmd = await checkFfmpeg();
-            if (ffmpegCmd) {
-                const pcmBuf = await ffmpegToPCM(ffmpegCmd, tmpMp3, sampleRate);
-                console.log(`[tts:edge] Done: mp3→PCM (ffmpeg), ${pcmBuf.length} bytes, total=${Date.now() - startTime}ms`);
-                return { pcmBuffer: pcmBuf, sampleRate };
-            }
-            const pcmBuf = await wasmDecodeMp3ToPCM(mp3Buffer, sampleRate);
-            if (pcmBuf) {
-                console.log(`[tts:edge] Done: mp3→PCM (wasm), ${pcmBuf.length} bytes, total=${Date.now() - startTime}ms`);
-                return { pcmBuffer: pcmBuf, sampleRate };
-            }
-            throw new Error("Edge TTS: no decoder available for mp3");
-        }
-        finally {
-            try {
-                fs.unlinkSync(tmpMp3);
-            }
-            catch { }
-        }
-    }
-    finally {
-        try {
-            fs.unlinkSync(tmpFile);
-            fs.rmdirSync(tmpDir);
-        }
-        catch { }
-    }
-}
-async function openaiTTSToPCM(text, ttsCfg) {
     const sampleRate = 24000;
     const { url, headers } = buildTTSRequest(ttsCfg);
     console.log(`[tts] Request: model=${ttsCfg.model}, voice=${ttsCfg.voice}, authStyle=${ttsCfg.authStyle ?? "bearer"}, url=${url}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-connect/openclaw-qqbot",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/{upgrade.sh → cleanup-legacy-plugins.sh}

@@ -1,11 +1,11 @@
 #!/bin/bash
-# QQBot 插件升级脚本
+# qqbot 插件升级脚本
 # 用于清理旧版本插件并重新安装
 # 兼容 clawdbot 和 openclaw 两种安装
 
 set -e
 
-echo "=== QQBot 插件升级脚本 ==="
+echo "=== qqbot 插件升级脚本 ==="
 
 # 检测使用的是 clawdbot 还是 openclaw
 detect_installation() {
@@ -123,5 +123,5 @@ echo ""
 echo "接下来请执行以下命令重新安装插件:"
 echo "  cd /path/to/openclaw-qqbot"
 echo "  $CMD plugins install ."
-echo "  $CMD channels add --channel qqbot --token \"AppID:AppSecret\""
+echo "  $CMD channels add --channel qqbot --token \"appid:appsecret\""
 echo "  $CMD gateway restart"

package/scripts/set-markdown.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
-# QQBot Markdown 配置脚本
-# 用于单独设置是否启用 Markdown 消息格式
+# qqbot markdown 配置脚本
+# 用于单独设置是否启用 markdown 消息格式
 # 直接编辑 JSON 配置文件，避免框架验证拒绝未注册的 channel
 
 set -e
@@ -29,18 +29,18 @@ show_help() {
     echo "用法: $0 [选项]"
     echo ""
     echo "选项:"
-    echo "  enable, on, yes      启用 Markdown 消息格式"
-    echo "  disable, off, no     禁用 Markdown 消息格式（使用纯文本）"
-    echo "  status               显示当前 Markdown 配置状态"
+    echo "  enable, on, yes      启用 markdown 消息格式"
+    echo "  disable, off, no     禁用 markdown 消息格式（使用纯文本）"
+    echo "  status               显示当前 markdown 配置状态"
     echo "  -h, --help           显示帮助信息"
     echo ""
     echo "示例:"
-    echo "  $0 enable            启用 Markdown"
-    echo "  $0 disable           禁用 Markdown"
+    echo "  $0 enable            启用 markdown"
+    echo "  $0 disable           禁用 markdown"
     echo "  $0 status            查看当前状态"
     echo "  $0                   交互式选择"
     echo ""
-    echo "⚠️  注意: 启用 Markdown 需要在 QQ 开放平台申请 Markdown 消息权限"
+    echo "⚠️  注意: 启用 markdown 需要在 QQ 开放平台申请 markdown 消息权限"
     echo "         如果没有权限，消息将无法正常发送！"
 }
 
@@ -57,22 +57,22 @@ set_markdown_value() {
 }
 
 enable_markdown() {
-    echo "✅ 启用 Markdown 消息格式..."
+    echo "✅ 启用 markdown 消息格式..."
     set_markdown_value true
     echo ""
-    echo "Markdown 已启用。"
-    echo "⚠️  请确保您已在 QQ 开放平台申请了 Markdown 消息权限。"
+    echo "markdown 已启用。"
+    echo "⚠️  请确保您已在 QQ 开放平台申请了 markdown 消息权限。"
 }
 
 disable_markdown() {
-    echo "❌ 禁用 Markdown 消息格式（使用纯文本）..."
+    echo "❌ 禁用 markdown 消息格式（使用纯文本）..."
     set_markdown_value false
     echo ""
-    echo "Markdown 已禁用，将使用纯文本格式发送消息。"
+    echo "markdown 已禁用，将使用纯文本格式发送消息。"
 }
 
 show_status() {
-    echo "当前 Markdown 配置状态:"
+    echo "当前 markdown 配置状态:"
     echo "  配置文件: $OPENCLAW_CONFIG"
     echo ""
     current=$(node -e "
@@ -82,7 +82,7 @@ show_status() {
     if [ "$current" = "true" ]; then
         echo "  状态: ✅ 已启用"
         echo ""
-        echo "  ⚠️  请确保您已在 QQ 开放平台申请了 Markdown 消息权限。"
+        echo "  ⚠️  请确保您已在 QQ 开放平台申请了 markdown 消息权限。"
     elif [ "$current" = "false" ]; then
         echo "  状态: ❌ 已禁用（纯文本模式）"
     else
@@ -92,20 +92,20 @@ show_status() {
 
 interactive_select() {
     echo "========================================="
-    echo "  QQBot Markdown 配置"
+    echo "  qqbot markdown 配置"
     echo "========================================="
     echo ""
     show_status
     echo ""
     echo "-----------------------------------------"
     echo ""
-    echo "是否启用 Markdown 消息格式？"
+    echo "是否启用 markdown 消息格式？"
     echo ""
-    echo "⚠️  注意: 启用 Markdown 需要在 QQ 开放平台申请 Markdown 消息权限"
+    echo "⚠️  注意: 启用 markdown 需要在 QQ 开放平台申请 markdown 消息权限"
     echo "         如果没有权限，消息将无法正常发送！"
     echo ""
-    echo "  1) 启用 Markdown"
-    echo "  2) 禁用 Markdown（纯文本）"
+    echo "  1) 启用 markdown"
+    echo "  2) 禁用 markdown（纯文本）"
     echo "  3) 取消"
     echo ""
     read -t 10 -p "请选择 [1-3] (默认: 2): " choice || choice="2"