@ryantest/openclaw-qqbot 1.6.7-beta.4 → 1.6.7-beta.6

package/README.md

@@ -10,7 +10,7 @@
 
 **Connect your AI assistant to QQ — private chat, group chat, and rich media, all in one plugin.**
 
-### 🚀 Current Version: `v1.6.6`
+### 🚀 Current Version: `v1.6.7`
 
 [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)

package/README.zh.md

@@ -9,7 +9,7 @@
 
 **让你的 AI 助手接入 QQ — 私聊、群聊、富媒体，一个插件全搞定。**
 
-### 🚀 当前版本： `v1.6.6`
+### 🚀 当前版本： `v1.6.7`
 
 [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)

package/dist/src/commands/bot-clear-storage.d.ts

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

package/dist/src/commands/bot-clear-storage.js

@@ -0,0 +1,157 @@
+import path from "node:path";
+import fs from "node:fs";
+import { getHomeDir } from "../utils/platform.js";
+import { registerCommand } from "../slash-commands.js";
+function scanDirectoryFiles(dirPath) {
+    const files = [];
+    if (!fs.existsSync(dirPath))
+        return files;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                try {
+                    const stat = fs.statSync(fullPath);
+                    files.push({ filePath: fullPath, size: stat.size });
+                }
+                catch {
+                    // 跳过无法访问的文件
+                }
+            }
+        }
+    };
+    walk(dirPath);
+    files.sort((a, b) => b.size - a.size);
+    return files;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+function removeEmptyDirs(dirPath) {
+    if (!fs.existsSync(dirPath))
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            removeEmptyDirs(path.join(dirPath, entry.name));
+        }
+    }
+    try {
+        const remaining = fs.readdirSync(dirPath);
+        if (remaining.length === 0) {
+            fs.rmdirSync(dirPath);
+        }
+    }
+    catch {
+        // 目录可能正在被使用，跳过
+    }
+}
+registerCommand({
+    name: "bot-clear-storage",
+    description: "清理通过QQBot对话产生的文件以及下载的资源（保存在 OpenClaw 运行环境的主机上）",
+    usage: [
+        `/bot-clear-storage`,
+        ``,
+        `扫描当前机器人产生的下载文件并列出明细。`,
+        `确认后执行删除，释放主机磁盘空间。`,
+        ``,
+        `/bot-clear-storage --force   确认执行清理`,
+        ``,
+        `⚠️ 仅在私聊中可用。`,
+    ].join("\n"),
+    handler: (ctx) => {
+        const { appId, type } = ctx;
+        if (type !== "c2c") {
+            return `💡 请在私聊中使用此指令`;
+        }
+        const isForce = ctx.args.trim() === "--force";
+        const targetDir = path.join(getHomeDir(), ".openclaw", "media", "qqbot", "downloads", appId);
+        const displayDir = `~/.openclaw/media/qqbot/downloads/${appId}`;
+        if (!isForce) {
+            const files = scanDirectoryFiles(targetDir);
+            if (files.length === 0) {
+                return [
+                    `✅ 当前没有需要清理的文件`,
+                    ``,
+                    `目录 \`${displayDir}\` 为空或不存在。`,
+                ].join("\n");
+            }
+            const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+            const MAX_DISPLAY = 10;
+            const lines = [
+                `即将清理 \`${displayDir}\` 目录下所有文件，总共 ${files.length} 个文件，占用磁盘存储空间 ${formatBytes(totalSize)}。`,
+                ``,
+                `目录文件概况：`,
+            ];
+            const displayFiles = files.slice(0, MAX_DISPLAY);
+            for (const f of displayFiles) {
+                const relativePath = path.relative(targetDir, f.filePath);
+                const displayName = relativePath.replace(/\\/g, "/");
+                lines.push(`${displayName} (${formatBytes(f.size)})`, ``, ``);
+            }
+            if (files.length > MAX_DISPLAY) {
+                lines.push(`...[合计：${files.length} 个文件（${formatBytes(totalSize)}）]`, ``);
+            }
+            lines.push(``, `---`, ``, `确认清理后，上述保存在 OpenClaw 运行主机磁盘上的文件将永久删除，后续对话过程中AI无法再找回相关文件。`, `‼️ 点击指令确认删除`, `<qqbot-cmd-enter text="/bot-clear-storage --force" />`);
+            return lines.join("\n");
+        }
+        // ── --force 执行删除 ──
+        const files = scanDirectoryFiles(targetDir);
+        if (files.length === 0) {
+            return `✅ 目录已为空，无需清理`;
+        }
+        let deletedCount = 0;
+        let deletedSize = 0;
+        let failedCount = 0;
+        for (const f of files) {
+            try {
+                fs.unlinkSync(f.filePath);
+                deletedCount++;
+                deletedSize += f.size;
+            }
+            catch {
+                failedCount++;
+            }
+        }
+        try {
+            removeEmptyDirs(targetDir);
+        }
+        catch {
+            // 非关键，静默忽略
+        }
+        if (failedCount === 0) {
+            return [
+                `✅ 清理成功`,
+                ``,
+                `已删除 ${deletedCount} 个文件，释放 ${formatBytes(deletedSize)} 磁盘空间。`,
+            ].join("\n");
+        }
+        return [
+            `⚠️ 部分清理完成`,
+            ``,
+            `已删除 ${deletedCount} 个文件（${formatBytes(deletedSize)}），${failedCount} 个文件删除失败。`,
+        ].join("\n");
+    },
+});

package/dist/src/commands/bot-help.d.ts

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

package/dist/src/commands/bot-help.js

@@ -0,0 +1,24 @@
+import { registerCommand, getCommands, getPluginVersion } from "../slash-commands.js";
+registerCommand({
+    name: "bot-help",
+    description: "查看所有指令以及用途",
+    usage: [
+        `/bot-help`,
+        ``,
+        `列出所有可用的 QQBot 插件内置指令及其简要说明。`,
+        `使用 /指令名 ? 可查看某条指令的详细用法。`,
+    ].join("\n"),
+    handler: (ctx) => {
+        const GROUP_EXCLUDED_COMMANDS = new Set(["bot-upgrade", "bot-clear-storage"]);
+        const isGroup = ctx.type === "group";
+        const PLUGIN_VERSION = getPluginVersion();
+        const lines = [`### QQBot插件内置调试指令`, ``];
+        for (const [name, cmd] of getCommands()) {
+            if (isGroup && GROUP_EXCLUDED_COMMANDS.has(name))
+                continue;
+            lines.push(`<qqbot-cmd-input text="/${name}" show="/${name}"/> ${cmd.description}`);
+        }
+        lines.push(``, `> 插件版本 v${PLUGIN_VERSION}`);
+        return lines.join("\n");
+    },
+});

package/dist/src/commands/bot-logs.d.ts

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

package/dist/src/commands/bot-logs.js

@@ -0,0 +1,232 @@
+import path from "node:path";
+import fs from "node:fs";
+import { getHomeDir, getQQBotDataDir, isWindows } from "../utils/platform.js";
+import { registerCommand } from "../slash-commands.js";
+/**
+ * 从 openclaw.json / clawdbot.json / moltbot.json 的 logging.file 配置中
+ * 提取用户自定义的日志文件路径。
+ */
+function getConfiguredLogFiles() {
+    const homeDir = getHomeDir();
+    const files = [];
+    for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+        try {
+            const cfgPath = path.join(homeDir, `.${cli}`, `${cli}.json`);
+            if (!fs.existsSync(cfgPath))
+                continue;
+            const cfg = JSON.parse(fs.readFileSync(cfgPath, "utf8"));
+            const logFile = cfg?.logging?.file;
+            if (logFile && typeof logFile === "string") {
+                files.push(path.resolve(logFile));
+            }
+            break;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return files;
+}
+function collectCandidateLogDirs() {
+    const homeDir = getHomeDir();
+    const dirs = new Set();
+    const pushDir = (p) => {
+        if (!p)
+            return;
+        const normalized = path.resolve(p);
+        dirs.add(normalized);
+    };
+    const pushStateDir = (stateDir) => {
+        if (!stateDir)
+            return;
+        pushDir(stateDir);
+        pushDir(path.join(stateDir, "logs"));
+    };
+    for (const logFile of getConfiguredLogFiles()) {
+        pushDir(path.dirname(logFile));
+    }
+    for (const [key, value] of Object.entries(process.env)) {
+        if (!value)
+            continue;
+        if (/STATE_DIR$/i.test(key) && /(OPENCLAW|CLAWDBOT|MOLTBOT)/i.test(key)) {
+            pushStateDir(value);
+        }
+    }
+    for (const name of [".openclaw", ".clawdbot", ".moltbot", "openclaw", "clawdbot", "moltbot"]) {
+        pushDir(path.join(homeDir, name));
+        pushDir(path.join(homeDir, name, "logs"));
+    }
+    const searchRoots = new Set([
+        homeDir,
+        process.cwd(),
+        path.dirname(process.cwd()),
+    ]);
+    if (process.env.APPDATA)
+        searchRoots.add(process.env.APPDATA);
+    if (process.env.LOCALAPPDATA)
+        searchRoots.add(process.env.LOCALAPPDATA);
+    for (const root of searchRoots) {
+        try {
+            const entries = fs.readdirSync(root, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                if (!/(openclaw|clawdbot|moltbot)/i.test(entry.name))
+                    continue;
+                const base = path.join(root, entry.name);
+                pushDir(base);
+                pushDir(path.join(base, "logs"));
+            }
+        }
+        catch {
+            // 无权限或不存在，跳过
+        }
+    }
+    if (!isWindows()) {
+        for (const name of ["openclaw", "clawdbot", "moltbot"]) {
+            pushDir(path.join("/var/log", name));
+        }
+    }
+    const tmpRoots = new Set();
+    if (isWindows()) {
+        tmpRoots.add("C:\\tmp");
+        if (process.env.TEMP)
+            tmpRoots.add(process.env.TEMP);
+        if (process.env.TMP)
+            tmpRoots.add(process.env.TMP);
+        if (process.env.LOCALAPPDATA)
+            tmpRoots.add(path.join(process.env.LOCALAPPDATA, "Temp"));
+    }
+    else {
+        tmpRoots.add("/tmp");
+    }
+    for (const tmpRoot of tmpRoots) {
+        for (const name of ["openclaw", "clawdbot", "moltbot"]) {
+            pushDir(path.join(tmpRoot, name));
+        }
+    }
+    return Array.from(dirs);
+}
+function collectRecentLogFiles(logDirs) {
+    const candidates = [];
+    const dedupe = new Set();
+    const pushFile = (filePath, sourceDir) => {
+        const normalized = path.resolve(filePath);
+        if (dedupe.has(normalized))
+            return;
+        try {
+            const stat = fs.statSync(normalized);
+            if (!stat.isFile())
+                return;
+            dedupe.add(normalized);
+            candidates.push({ filePath: normalized, sourceDir, mtimeMs: stat.mtimeMs });
+        }
+        catch {
+            // 文件不存在或无权限
+        }
+    };
+    for (const logFile of getConfiguredLogFiles()) {
+        pushFile(logFile, path.dirname(logFile));
+    }
+    for (const dir of logDirs) {
+        pushFile(path.join(dir, "gateway.log"), dir);
+        pushFile(path.join(dir, "gateway.err.log"), dir);
+        pushFile(path.join(dir, "openclaw.log"), dir);
+        pushFile(path.join(dir, "clawdbot.log"), dir);
+        pushFile(path.join(dir, "moltbot.log"), dir);
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile())
+                    continue;
+                if (!/\.(log|txt)$/i.test(entry.name))
+                    continue;
+                if (!/(gateway|openclaw|clawdbot|moltbot)/i.test(entry.name))
+                    continue;
+                pushFile(path.join(dir, entry.name), dir);
+            }
+        }
+        catch {
+            // 无权限或不存在，跳过
+        }
+    }
+    candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return candidates;
+}
+registerCommand({
+    name: "bot-logs",
+    description: "导出本地日志文件",
+    usage: [
+        `/bot-logs`,
+        ``,
+        `导出最近的 OpenClaw 日志文件（最多 4 个）。`,
+        `每个文件最多保留最后 1000 行，以文件形式返回。`,
+    ].join("\n"),
+    handler: () => {
+        const logDirs = collectCandidateLogDirs();
+        const recentFiles = collectRecentLogFiles(logDirs).slice(0, 4);
+        if (recentFiles.length === 0) {
+            const existingDirs = logDirs.filter(d => { try {
+                return fs.existsSync(d);
+            }
+            catch {
+                return false;
+            } });
+            const searched = existingDirs.length > 0
+                ? existingDirs.map(d => `  • ${d}`).join("\n")
+                : logDirs.slice(0, 6).map(d => `  • ${d}`).join("\n") + (logDirs.length > 6 ? `\n  …及其他 ${logDirs.length - 6} 个路径` : "");
+            return [
+                `⚠️ 未找到日志文件`,
+                ``,
+                `已搜索以下${existingDirs.length > 0 ? "已存在的" : ""}路径：`,
+                searched,
+                ``,
+                `💡 如果日志在自定义路径，请在配置文件中添加：`,
+                `  "logging": { "file": "/path/to/your/logfile.log" }`,
+            ].join("\n");
+        }
+        const lines = [];
+        let totalIncluded = 0;
+        let totalOriginal = 0;
+        let truncatedCount = 0;
+        const MAX_LINES_PER_FILE = 1000;
+        for (const logFile of recentFiles) {
+            try {
+                const content = fs.readFileSync(logFile.filePath, "utf8");
+                const allLines = content.split("\n");
+                const totalFileLines = allLines.length;
+                const tail = allLines.slice(-MAX_LINES_PER_FILE);
+                if (tail.length > 0) {
+                    const fileName = path.basename(logFile.filePath);
+                    lines.push(`\n========== ${fileName} (last ${tail.length} of ${totalFileLines} lines) ==========`);
+                    lines.push(`from: ${logFile.sourceDir}`);
+                    lines.push(...tail);
+                    totalIncluded += tail.length;
+                    totalOriginal += totalFileLines;
+                    if (totalFileLines > MAX_LINES_PER_FILE)
+                        truncatedCount++;
+                }
+            }
+            catch {
+                lines.push(`[读取 ${path.basename(logFile.filePath)} 失败]`);
+            }
+        }
+        if (lines.length === 0) {
+            return `⚠️ 找到日志文件但读取失败，请检查文件权限`;
+        }
+        const tmpDir = getQQBotDataDir("downloads");
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+        const tmpFile = path.join(tmpDir, `bot-logs-${timestamp}.txt`);
+        fs.writeFileSync(tmpFile, lines.join("\n"), "utf8");
+        const fileCount = recentFiles.length;
+        const topSources = Array.from(new Set(recentFiles.map(item => item.sourceDir))).slice(0, 3);
+        let summaryText = `${fileCount} 个日志文件，共 ${totalIncluded} 行`;
+        if (truncatedCount > 0) {
+            summaryText += `（${truncatedCount} 个文件因过长仅保留最后 ${MAX_LINES_PER_FILE} 行，原始共 ${totalOriginal} 行）`;
+        }
+        return {
+            text: `📋 ${summaryText}\n📂 来源：${topSources.join(" | ")}`,
+            filePath: tmpFile,
+        };
+    },
+});

package/dist/src/commands/bot-ping.d.ts

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

package/dist/src/commands/bot-ping.js

@@ -0,0 +1,29 @@
+import { registerCommand } from "../slash-commands.js";
+registerCommand({
+    name: "bot-ping",
+    description: "测试当前 openclaw 与 QQ 连接的网络延迟",
+    usage: [
+        `/bot-ping`,
+        ``,
+        `测试 OpenClaw 主机与 QQ 服务器之间的网络延迟。`,
+        `返回网络传输耗时和插件处理耗时。`,
+    ].join("\n"),
+    handler: (ctx) => {
+        const now = Date.now();
+        const eventTime = new Date(ctx.eventTimestamp).getTime();
+        if (isNaN(eventTime)) {
+            return `✅ pong!`;
+        }
+        const totalMs = now - eventTime;
+        const qqToPlugin = ctx.receivedAt - eventTime;
+        const pluginProcess = now - ctx.receivedAt;
+        const lines = [
+            `✅ pong！`,
+            ``,
+            `⏱ 延迟: ${totalMs}ms`,
+            `  ├ 网络传输: ${qqToPlugin}ms`,
+            `  └ 插件处理: ${pluginProcess}ms`,
+        ];
+        return lines.join("\n");
+    },
+});

package/dist/src/commands/bot-upgrade.d.ts

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