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

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

@@ -0,0 +1,252 @@
+import { registerCommand, getPluginVersion } from "../slash-commands.js";
+import { getUpdateInfo, checkVersionExists } from "../update-checker.js";
+import { checkUpgradeCompatibility, fireHotUpgrade, isUpgrading, setUpgrading, preUpgradeCredentialBackup, saveUpgradeGreetingTarget, } from "../upgrade-utils.js";
+const DEFAULT_UPGRADE_URL = "https://docs.qq.com/doc/DSGxOZk1oVnVKVkpq";
+registerCommand({
+    name: "bot-upgrade",
+    description: "检查更新并查看升级指引",
+    usage: [
+        `/bot-upgrade              检查是否有新版本`,
+        `/bot-upgrade --latest     确认升级到最新版本（需 upgradeMode=hot-reload）`,
+        `/bot-upgrade --version X  升级到指定版本（需 upgradeMode=hot-reload）`,
+        `/bot-upgrade --pkg scope/name  指定 npm 包（如 ryantest/openclaw-qqbot）`,
+        `/bot-upgrade --force      强制重新安装当前版本（需 upgradeMode=hot-reload）`,
+        `/bot-upgrade --local      使用本地升级脚本（跳过远端下载）`,
+    ].join("\n"),
+    handler: async (ctx) => {
+        const PLUGIN_VERSION = getPluginVersion();
+        const url = ctx.accountConfig?.upgradeUrl || DEFAULT_UPGRADE_URL;
+        const upgradeMode = ctx.accountConfig?.upgradeMode || "hot-reload";
+        const args = ctx.args.trim();
+        const info = await getUpdateInfo();
+        const GITHUB_URL = "https://github.com/tencent-connect/openclaw-qqbot/";
+        // ── doc 模式（默认）：只展示升级指引，不执行热更新 ──
+        if (upgradeMode !== "hot-reload") {
+            if (info.checkedAt === 0) {
+                return `⏳ 版本检查中，请稍后再试`;
+            }
+            if (info.error) {
+                return [
+                    `❌ 主机网络访问异常，无法检查更新`,
+                    ``,
+                    `查看升级指引：[点击查看](${url})`,
+                ].join("\n");
+            }
+            if (!info.hasUpdate) {
+                return [
+                    `✅ 当前已是最新版本 v${PLUGIN_VERSION}`,
+                    ``,
+                    `项目地址：[GitHub](${GITHUB_URL})`,
+                ].join("\n");
+            }
+            return [
+                `🆕 发现新版本`,
+                ``,
+                `当前版本：**v${PLUGIN_VERSION}**`,
+                `最新版本：**v${info.latest}**`,
+                ``,
+                `📖 升级指引：[点击查看](${url})`,
+                `🌟 官方 GitHub 仓库：[点击前往](${GITHUB_URL})`,
+            ].join("\n");
+        }
+        // ── hot-reload 模式：执行热更新 ──
+        if (ctx.type !== "c2c") {
+            return `💡 请在私聊中使用此指令`;
+        }
+        if (isUpgrading()) {
+            return `⏳ 正在升级中，请稍候...`;
+        }
+        let isForce = false;
+        let isLatest = false;
+        let isLocal = false;
+        let versionArg;
+        let pkgArg;
+        const tokens = args ? args.split(/\s+/).filter(Boolean) : [];
+        for (let i = 0; i < tokens.length; i += 1) {
+            const t = tokens[i];
+            if (t === "--force") {
+                isForce = true;
+                continue;
+            }
+            if (t === "--latest") {
+                isLatest = true;
+                continue;
+            }
+            if (t === "--local") {
+                isLocal = true;
+                continue;
+            }
+            if (t === "--pkg") {
+                const next = tokens[i + 1];
+                if (!next || next.startsWith("--")) {
+                    return `❌ 参数错误：--pkg 需要包名\n\n示例：/bot-upgrade --pkg ryantest/openclaw-qqbot`;
+                }
+                pkgArg = next;
+                i += 1;
+                continue;
+            }
+            if (t.startsWith("--pkg=")) {
+                const v = t.slice("--pkg=".length).trim();
+                if (!v) {
+                    return `❌ 参数错误：--pkg 需要包名\n\n示例：/bot-upgrade --pkg ryantest/openclaw-qqbot`;
+                }
+                pkgArg = v;
+                continue;
+            }
+            if (t === "--version") {
+                const next = tokens[i + 1];
+                if (!next || next.startsWith("--")) {
+                    return `❌ 参数错误：--version 需要版本号\n\n示例：/bot-upgrade --version 1.6.5`;
+                }
+                versionArg = next.replace(/^v/, "");
+                i += 1;
+                continue;
+            }
+            if (t.startsWith("--version=")) {
+                const v = t.slice("--version=".length).trim();
+                if (!v) {
+                    return `❌ 参数错误：--version 需要版本号\n\n示例：/bot-upgrade --version 1.6.5`;
+                }
+                versionArg = v.replace(/^v/, "");
+                continue;
+            }
+            if (!t.startsWith("--") && !versionArg) {
+                versionArg = t.replace(/^v/, "");
+                continue;
+            }
+        }
+        // ── 无参数：只展示信息+确认按钮 ──
+        if (!versionArg && !isLatest && !isForce) {
+            if (info.checkedAt === 0) {
+                return `⏳ 版本检查中，请稍后再试`;
+            }
+            if (info.error) {
+                return [
+                    `❌ 主机网络访问异常，无法检查更新`,
+                    ``,
+                    `查看手动升级指引：[点击查看](${url})`,
+                ].join("\n");
+            }
+            if (!info.hasUpdate) {
+                const lines = [
+                    `✅ 当前已是最新版本 v${PLUGIN_VERSION}`,
+                    ``,
+                    `项目地址：[GitHub](${GITHUB_URL})`,
+                ];
+                return lines.join("\n");
+            }
+            return [
+                `🆕 发现新版本`,
+                ``,
+                `当前版本：**v${PLUGIN_VERSION}**`,
+                `最新版本：**v${info.latest}**`,
+                ``,
+                `升级将重启 Gateway 服务，期间短暂不可用。`,
+                `请确认主机网络可正常访问 npm 仓库。`,
+                ``,
+                `**点击确认升级** <qqbot-cmd-enter text="/bot-upgrade --latest" />`,
+                ``,
+                `手动升级指引：[点击查看](${url})`,
+                `🌟官方 GitHub 仓库：[点击前往](${GITHUB_URL})`,
+            ].join("\n");
+        }
+        let upgradePkg = pkgArg || ctx.accountConfig?.upgradePkg;
+        if (upgradePkg) {
+            upgradePkg = upgradePkg.trim();
+            if (!upgradePkg.startsWith("@"))
+                upgradePkg = `@${upgradePkg}`;
+        }
+        // ── --version 指定版本：先校验版本号是否存在 ──
+        if (versionArg) {
+            const exists = await checkVersionExists(versionArg, upgradePkg);
+            if (!exists) {
+                return `❌ 版本 ${versionArg} 不存在，请检查版本号`;
+            }
+            if (versionArg === PLUGIN_VERSION && !isForce) {
+                return `✅ 当前已是 v${PLUGIN_VERSION}，无需升级`;
+            }
+        }
+        // ── --latest：检查是否需要升级 ──
+        if (isLatest && !versionArg) {
+            if (info.checkedAt === 0) {
+                return `⏳ 版本检查中，请稍后再试`;
+            }
+            if (info.error) {
+                return [
+                    `❌ 主机网络访问异常，无法检查更新`,
+                    ``,
+                    `查看手动升级指引：[点击查看](${url})`,
+                ].join("\n");
+            }
+            if (!info.hasUpdate && !isForce) {
+                return `✅ 当前已是 v${PLUGIN_VERSION}，无需升级`;
+            }
+        }
+        const targetVersion = versionArg || info.latest || undefined;
+        const isReinstall = isForce && targetVersion === PLUGIN_VERSION;
+        // ── 环境兼容性检查 ──
+        const compat = checkUpgradeCompatibility();
+        if (!compat.ok) {
+            return [
+                `🚫 当前环境不满足热更新要求：`,
+                ``,
+                ...compat.errors,
+                ...(compat.warnings.length ? [``, ...compat.warnings] : []),
+                ``,
+                `查看手动升级指引：[点击查看](${url})`,
+            ].join("\n");
+        }
+        setUpgrading(true);
+        preUpgradeCredentialBackup(ctx.accountId, ctx.appId);
+        const startResult = fireHotUpgrade(targetVersion, upgradePkg, isLocal);
+        if (!startResult.ok) {
+            setUpgrading(false);
+            if (startResult.reason === "no-script") {
+                return [
+                    `❌ 未找到升级脚本，无法执行热更新`,
+                    ``,
+                    `可能原因：升级后脚本目录被清理，或远端下载失败（查看日志了解详情）`,
+                    `💡 可尝试不带 \`--local\` 重试，或手动升级`,
+                    ``,
+                    `查看手动升级指引：[点击查看](${url})`,
+                ].join("\n");
+            }
+            if (startResult.reason === "no-cli") {
+                return [
+                    `❌ 未找到 CLI 工具，无法执行热更新`,
+                    ``,
+                    `查看手动升级指引：[点击查看](${url})`,
+                ].join("\n");
+            }
+            if (startResult.reason === "no-powershell") {
+                return [
+                    `❌ 未找到 PowerShell，无法执行热更新`,
+                    ``,
+                    `请确认系统中已安装 PowerShell（Windows 10+ 自带）`,
+                    `查看手动升级指引：[点击查看](${url})`,
+                ].join("\n");
+            }
+            return [
+                `❌ 当前环境不支持热更新（需要 bash）`,
+                ``,
+                `查看手动升级指引：[点击查看](${url})`,
+            ].join("\n");
+        }
+        saveUpgradeGreetingTarget(ctx.accountId, ctx.appId, ctx.senderId);
+        const resultLines = isReinstall
+            ? [
+                `🔄 正在重新安装 v${PLUGIN_VERSION}...`,
+                ``,
+                `预计 30~60 秒完成，届时会自动通知您`,
+            ]
+            : [
+                `🔄 正在升级...`,
+                ``,
+                `当前版本：v${PLUGIN_VERSION}`,
+                ...(targetVersion ? [`目标版本：v${targetVersion}`] : []),
+                ``,
+                `预计 30~60 秒完成，届时会自动通知您`,
+            ];
+        return resultLines.join("\n");
+    },
+});

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

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

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

@@ -0,0 +1,33 @@
+import { getUpdateInfo } from "../update-checker.js";
+import { getFrameworkVersion } from "../upgrade-utils.js";
+import { registerCommand, getPluginVersion } from "../slash-commands.js";
+registerCommand({
+    name: "bot-version",
+    description: "查看插件版本号",
+    usage: [
+        `/bot-version`,
+        ``,
+        `查看当前 QQBot 插件版本和 OpenClaw 框架版本。`,
+        `同时检查是否有新版本可用。`,
+    ].join("\n"),
+    handler: async () => {
+        const PLUGIN_VERSION = getPluginVersion();
+        const frameworkVersion = getFrameworkVersion();
+        const lines = [
+            `🦞框架版本：${frameworkVersion}`,
+            `🤖QQBot 插件版本：v${PLUGIN_VERSION}`,
+        ];
+        const info = await getUpdateInfo();
+        if (info.checkedAt === 0) {
+            lines.push(`⏳ 版本检查中...`);
+        }
+        else if (info.error) {
+            lines.push(`⚠️ 版本检查失败`);
+        }
+        else if (info.hasUpdate && info.latest) {
+            lines.push(`🆕最新可用版本：v${info.latest}，点击 <qqbot-cmd-input text="/bot-upgrade" show="/bot-upgrade"/> 查看升级指引`);
+        }
+        lines.push(`🌟官方 GitHub 仓库：[点击前往](https://github.com/tencent-connect/openclaw-qqbot/)`);
+        return lines.join("\n");
+    },
+});

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

@@ -11,12 +11,7 @@
  *   从而计算「开平→插件」和「插件处理」两段耗时
  */
 import type { QQBotAccountConfig } from "./types.js";
-export declare function getFrameworkVersion(): string;
-/**
- * 解析框架版本字符串中的日期版本号
- * 输入示例: "OpenClaw 2026.3.13 (61d171a)" → "2026.3.13"
- */
-export declare function parseFrameworkDateVersion(versionStr: string): string | null;
+export { getFrameworkVersion, parseFrameworkDateVersion } from "./upgrade-utils.js";
 /** 斜杠指令上下文（消息元数据 + 运行时状态） */
 export interface SlashCommandContext {
     /** 消息类型 */
@@ -67,6 +62,26 @@ export interface SlashCommandFileResult {
     /** 要发送的本地文件路径 */
     filePath: string;
 }
+/** 斜杠指令定义 */
+export interface SlashCommand {
+    /** 指令名（不含 /） */
+    name: string;
+    /** 简要描述 */
+    description: string;
+    /** 详细用法说明（支持多行），用于 /指令 ? 查询 */
+    usage?: string;
+    /** 处理函数 */
+    handler: (ctx: SlashCommandContext) => SlashCommandResult | Promise<SlashCommandResult>;
+}
+export declare function registerCommand(cmd: SlashCommand): void;
+/** 获取指令注册表（只读访问，供 bot-help 等使用） */
+export declare function getCommands(): ReadonlyMap<string, SlashCommand>;
+import "./commands/bot-ping.js";
+import "./commands/bot-version.js";
+import "./commands/bot-help.js";
+import "./commands/bot-upgrade.js";
+import "./commands/bot-logs.js";
+import "./commands/bot-clear-storage.js";
 /**
  * 尝试匹配并执行插件级斜杠指令
  *