@tencent-connect/openclaw-qqbot 1.6.5-alpha.4 → 1.6.5-alpha.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.4`
+### 🚀 Current Version: `v1.6.5`
 
 [![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.4`
+### 🚀 当前版本： `v1.6.5`
 
 [![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/slash-commands.js

@@ -251,7 +251,7 @@ registerCommand({
         return lines.join("\n");
     },
 });
-const DEFAULT_UPGRADE_URL = "https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg";
+const DEFAULT_UPGRADE_URL = "https://docs.qq.com/doc/DSGxOZk1oVnVKVkpq";
 function saveUpgradeGreetingTarget(accountId, appId, openid) {
     const safeAccountId = accountId.replace(/[^a-zA-Z0-9._-]/g, "_");
     const safeAppId = appId.replace(/[^a-zA-Z0-9._-]/g, "_");
@@ -561,6 +561,38 @@ function findPowerShell() {
     }
     return null;
 }
+/**
+ * 将升级脚本复制到临时位置，避免升级过程中插件目录被清理后脚本丢失。
+ * 返回临时脚本路径，失败返回 null。
+ */
+function copyScriptToTemp(scriptPath) {
+    try {
+        const ext = path.extname(scriptPath);
+        const tmpDir = path.join(getHomeDir(), ".openclaw", ".qqbot-upgrade-tmp");
+        fs.mkdirSync(tmpDir, { recursive: true });
+        const tmpScript = path.join(tmpDir, `upgrade-via-npm${ext}`);
+        fs.copyFileSync(scriptPath, tmpScript);
+        if (!isWindows()) {
+            fs.chmodSync(tmpScript, 0o755);
+        }
+        return tmpScript;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 清理临时升级脚本目录
+ */
+function cleanupTempScript() {
+    try {
+        const tmpDir = path.join(getHomeDir(), ".openclaw", ".qqbot-upgrade-tmp");
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch {
+        // 非关键，静默忽略
+    }
+}
 /**
  * 执行热更新：执行脚本(--no-restart) → 立即触发 gateway restart
  *
@@ -570,11 +602,15 @@ function findPowerShell() {
  * - 新进程启动时 getStartupGreeting() 检测到版本变更，自动通知管理员
  *
  * Windows 使用 PowerShell 执行 .ps1 脚本，Mac/Linux 使用 bash 执行 .sh 脚本。
+ *
+ * 安全机制：脚本会被复制到临时目录再执行，避免升级过程中插件目录被操作导致脚本自身丢失。
  */
 function fireHotUpgrade(targetVersion) {
-    const scriptPath = getUpgradeScriptPath();
-    if (!scriptPath)
+    const originalScriptPath = getUpgradeScriptPath();
+    if (!originalScriptPath)
         return { ok: false, reason: "no-script" };
+    // 将脚本复制到临时位置，避免升级过程中脚本被删除
+    const scriptPath = copyScriptToTemp(originalScriptPath) || originalScriptPath;
     const cli = findCli();
     if (!cli)
         return { ok: false, reason: "no-cli" };
@@ -601,7 +637,7 @@ function fireHotUpgrade(targetVersion) {
         shell = bash;
         shellArgs = [scriptPath, "--no-restart", ...(targetVersion ? ["--version", targetVersion] : [])];
     }
-    console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath}, cli=${cli}, target=${targetVersion || "latest"}`);
+    console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath} (original: ${originalScriptPath}), cli=${cli}, target=${targetVersion || "latest"}`);
     // 异步执行升级脚本
     execFile(shell, shellArgs, {
         timeout: 120_000,
@@ -614,6 +650,7 @@ function fireHotUpgrade(targetVersion) {
                 console.error(`[qqbot] fireHotUpgrade: stdout: ${stdout.slice(0, 2000)}`);
             if (_stderr)
                 console.error(`[qqbot] fireHotUpgrade: stderr: ${_stderr.slice(0, 2000)}`);
+            cleanupTempScript();
             _upgrading = false;
             return;
         }
@@ -623,10 +660,13 @@ function fireHotUpgrade(targetVersion) {
         const newVersion = versionMatch?.[1];
         if (newVersion === "unknown") {
             console.error(`[qqbot] fireHotUpgrade: script output QQBOT_NEW_VERSION=unknown, aborting restart`);
+            cleanupTempScript();
             _upgrading = false;
             return;
         }
         console.log(`[qqbot] fireHotUpgrade: new version=${newVersion || "(not detected)"}, triggering restart...`);
+        // 脚本执行成功，清理临时脚本副本
+        cleanupTempScript();
         // 文件替换成功，在 restart 之前把 source 从 path 切换为 npm，
         // 确保新进程启动时读到的是 npm source，不会被本地源码覆盖。
         switchPluginSourceToNpm();

package/package.json

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

package/scripts/upgrade-via-npm.sh

@@ -139,6 +139,46 @@ fi
 echo ""
 echo "[1/4] 安装/升级插件..."
 
+# ── 兼容 openclaw 3.23+ 配置严格校验 ──
+# 3.23+ 在 plugins install/update 时会校验整个配置文件，
+# 如果 channels.qqbot 已存在但 qqbot 插件尚未加载，校验会失败。
+# 解决：install/update 前临时移除 channels.qqbot，成功后恢复。
+CONFIG_FILE="$HOME/.$CMD/$CMD.json"
+QQBOT_CHANNEL_BACKUP=""
+if [ -f "$CONFIG_FILE" ]; then
+    QQBOT_CHANNEL_BACKUP="$(node -e "
+      try {
+        const fs = require('fs');
+        const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+        if (cfg.channels && cfg.channels.qqbot) {
+          process.stdout.write(JSON.stringify(cfg.channels.qqbot));
+          delete cfg.channels.qqbot;
+          if (Object.keys(cfg.channels).length === 0) delete cfg.channels;
+          fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
+        }
+      } catch {}
+    " 2>/dev/null || true)"
+    if [ -n "$QQBOT_CHANNEL_BACKUP" ]; then
+        echo "  [兼容] 临时移除 channels.qqbot 以通过配置校验"
+    fi
+fi
+
+# 恢复 channels.qqbot 的函数（install/update 完成后调用）
+restore_qqbot_channel() {
+    if [ -n "$QQBOT_CHANNEL_BACKUP" ] && [ -f "$CONFIG_FILE" ]; then
+        node -e "
+          try {
+            const fs = require('fs');
+            const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+            if (!cfg.channels) cfg.channels = {};
+            cfg.channels.qqbot = $QQBOT_CHANNEL_BACKUP;
+            fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
+          } catch {}
+        " 2>/dev/null || true
+        echo "  [兼容] 已恢复 channels.qqbot 配置"
+    fi
+}
+
 UPGRADE_OK=false
 
 # 检测安装状态：同时检查配置记录和磁盘目录
@@ -190,38 +230,55 @@ if [ "$USE_UPDATE" = "true" ]; then
 fi
 
 if [ "$UPGRADE_OK" != "true" ]; then
-    # 清理旧目录（包含当前插件和历史遗留名称）
-    for dir_name in "$PLUGIN_ID" qqbot openclaw-qq; do
-        [ -d "$EXTENSIONS_DIR/$dir_name" ] && rm -rf "$EXTENSIONS_DIR/$dir_name" && echo "  已清理: $EXTENSIONS_DIR/$dir_name"
+    # 备份旧目录（而非直接删除），install 失败时可回滚
+    BACKUP_DIR=""
+    if [ -d "$EXTENSIONS_DIR/$PLUGIN_ID" ]; then
+        BACKUP_DIR="$EXTENSIONS_DIR/.openclaw-qqbot-backup-$$"
+        mv "$EXTENSIONS_DIR/$PLUGIN_ID" "$BACKUP_DIR"
+        echo "  已备份旧目录: $BACKUP_DIR"
+    fi
+
+    # 清理历史遗留名称（这些不需要回滚）
+    for dir_name in qqbot openclaw-qq; do
+        [ -d "$EXTENSIONS_DIR/$dir_name" ] && rm -rf "$EXTENSIONS_DIR/$dir_name" && echo "  已清理历史目录: $EXTENSIONS_DIR/$dir_name"
     done
 
     echo "  执行 install: $INSTALL_SRC"
     if $CMD plugins install "$INSTALL_SRC" --pin 2>&1; then
         UPGRADE_OK=true
         echo "  ✅ install 成功"
+        # install 成功，清理备份
+        if [ -n "$BACKUP_DIR" ] && [ -d "$BACKUP_DIR" ]; then
+            rm -rf "$BACKUP_DIR"
+            echo "  已清理旧版备份"
+        fi
+        # 清理 openclaw CLI install 可能留下的额外 backup 目录
+        find "$EXTENSIONS_DIR" -maxdepth 1 -name ".openclaw-qqbot-backup-*" -exec rm -rf {} + 2>/dev/null || true
     else
-        echo "❌ install 失败"
+        echo "  ❌ install 失败"
+        # 回滚：恢复旧目录
+        if [ -n "$BACKUP_DIR" ] && [ -d "$BACKUP_DIR" ]; then
+            mv "$BACKUP_DIR" "$EXTENSIONS_DIR/$PLUGIN_ID"
+            echo "  ↩️  已回滚到旧版本"
+        fi
+        restore_qqbot_channel
         echo "QQBOT_NEW_VERSION=unknown"
-        echo "QQBOT_REPORT=❌ QQBot 安装失败，请检查网络和 npm registry"
+        echo "QQBOT_REPORT=❌ QQBot 安装失败（已回滚到旧版本），请检查网络和 npm registry"
         exit 1
     fi
 fi
 
+# install/update 完成，恢复 channels.qqbot
+restore_qqbot_channel
+
 # [2/4] 验证安装
 echo ""
 echo "[2/4] 验证安装..."
 
-NEW_VERSION="$(node -e "
-  try {
-    const fs = require('fs');
-    const path = require('path');
-    const p = path.join('$EXTENSIONS_DIR', '$PLUGIN_ID', 'package.json');
-    if (fs.existsSync(p)) {
-      const v = JSON.parse(fs.readFileSync(p, 'utf8')).version;
-      if (v) { process.stdout.write(v); process.exit(0); }
-    }
-  } catch {}
-" 2>/dev/null || true)"
+PKG_JSON="$EXTENSIONS_DIR/$PLUGIN_ID/package.json"
+if [ -f "$PKG_JSON" ]; then
+  NEW_VERSION="$(node -e "process.stdout.write(JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')).version||'')" "$PKG_JSON" 2>/dev/null || true)"
+fi
 
 # Preflight 检查
 PREFLIGHT_OK=true
@@ -299,6 +356,19 @@ if [ "$PREFLIGHT_OK" != "true" ]; then
 fi
 echo "  ✅ 验证全部通过"
 
+# 确保 openclaw/plugin-sdk 可解析：
+# openclaw plugins install 不会执行 npm lifecycle scripts，
+# 需要手动调用 postinstall-link-sdk.js 创建 node_modules/openclaw → 全局 openclaw 的符号链接
+POSTINSTALL_SCRIPT="$TARGET_DIR/scripts/postinstall-link-sdk.js"
+if [ -f "$POSTINSTALL_SCRIPT" ]; then
+    echo "  执行 postinstall-link-sdk..."
+    if node "$POSTINSTALL_SCRIPT" 2>&1; then
+        echo "  ✅ plugin-sdk 链接就绪"
+    else
+        echo "  ⚠️  postinstall-link-sdk 失败，插件可能无法加载"
+    fi
+fi
+
 # [3/4] 输出结构化信息（供 TS handler 解析）
 echo ""
 echo "[3/4] 升级结果..."

package/scripts/upgrade-via-source.sh

@@ -444,6 +444,27 @@ else
     # gateway 已在安装前 stop，此时不会有自动 restart 的问题
     # 所有配置写入完成后，在 Step 6 统一启动
 
+    # 确保 openclaw/plugin-sdk 可解析：
+    # openclaw plugins install 不会执行 npm lifecycle scripts，
+    # 需要手动调用 postinstall-link-sdk.js 创建 node_modules/openclaw → 全局 openclaw 的符号链接。
+    # 必须在 peerDeps 清理之后执行，否则 symlink 会被清理逻辑删除。
+    for _candidate_name in openclaw-qqbot qqbot openclaw-qq; do
+        _postinstall="$HOME/.openclaw/extensions/$_candidate_name/scripts/postinstall-link-sdk.js"
+        if [ -f "$_postinstall" ]; then
+            echo "  执行 postinstall-link-sdk..."
+            if node "$_postinstall" 2>&1; then
+                echo "  ✅ plugin-sdk 链接就绪"
+            else
+                echo "  ⚠️  postinstall-link-sdk 失败，插件可能无法加载"
+            fi
+            break
+        fi
+    done
+
+    # 清理 openclaw CLI install 留下的 backup 目录，
+    # 避免 gateway 发现两个同 id 插件不断刷 duplicate plugin id 警告
+    find "$HOME/.openclaw/extensions/" -maxdepth 1 -name ".openclaw-qqbot-backup-*" -exec rm -rf {} + 2>/dev/null || true
+
     # 记录更新后的 qqbot 插件版本
     NEW_QQBOT_VERSION=$(node -e '
         try {

package/src/slash-commands.ts

@@ -337,7 +337,7 @@ registerCommand({
   },
 });
 
-const DEFAULT_UPGRADE_URL = "https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg";
+const DEFAULT_UPGRADE_URL = "https://docs.qq.com/doc/DSGxOZk1oVnVKVkpq";
 
 function saveUpgradeGreetingTarget(accountId: string, appId: string, openid: string): void {
   const safeAccountId = accountId.replace(/[^a-zA-Z0-9._-]/g, "_");
@@ -660,6 +660,38 @@ function findPowerShell(): string | null {
   return null;
 }
 
+/**
+ * 将升级脚本复制到临时位置，避免升级过程中插件目录被清理后脚本丢失。
+ * 返回临时脚本路径，失败返回 null。
+ */
+function copyScriptToTemp(scriptPath: string): string | null {
+  try {
+    const ext = path.extname(scriptPath);
+    const tmpDir = path.join(getHomeDir(), ".openclaw", ".qqbot-upgrade-tmp");
+    fs.mkdirSync(tmpDir, { recursive: true });
+    const tmpScript = path.join(tmpDir, `upgrade-via-npm${ext}`);
+    fs.copyFileSync(scriptPath, tmpScript);
+    if (!isWindows()) {
+      fs.chmodSync(tmpScript, 0o755);
+    }
+    return tmpScript;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 清理临时升级脚本目录
+ */
+function cleanupTempScript(): void {
+  try {
+    const tmpDir = path.join(getHomeDir(), ".openclaw", ".qqbot-upgrade-tmp");
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  } catch {
+    // 非关键，静默忽略
+  }
+}
+
 /**
  * 执行热更新：执行脚本(--no-restart) → 立即触发 gateway restart
  *
@@ -669,10 +701,15 @@ function findPowerShell(): string | null {
  * - 新进程启动时 getStartupGreeting() 检测到版本变更，自动通知管理员
  *
  * Windows 使用 PowerShell 执行 .ps1 脚本，Mac/Linux 使用 bash 执行 .sh 脚本。
+ *
+ * 安全机制：脚本会被复制到临时目录再执行，避免升级过程中插件目录被操作导致脚本自身丢失。
  */
 function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
-  const scriptPath = getUpgradeScriptPath();
-  if (!scriptPath) return { ok: false, reason: "no-script" };
+  const originalScriptPath = getUpgradeScriptPath();
+  if (!originalScriptPath) return { ok: false, reason: "no-script" };
+
+  // 将脚本复制到临时位置，避免升级过程中脚本被删除
+  const scriptPath = copyScriptToTemp(originalScriptPath) || originalScriptPath;
 
   const cli = findCli();
   if (!cli) return { ok: false, reason: "no-cli" };
@@ -699,7 +736,7 @@ function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
     shellArgs = [scriptPath, "--no-restart", ...(targetVersion ? ["--version", targetVersion] : [])];
   }
 
-  console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath}, cli=${cli}, target=${targetVersion || "latest"}`);
+  console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath} (original: ${originalScriptPath}), cli=${cli}, target=${targetVersion || "latest"}`);
 
   // 异步执行升级脚本
   execFile(shell, shellArgs, {
@@ -711,6 +748,7 @@ function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
       console.error(`[qqbot] fireHotUpgrade: script failed: ${error.message}`);
       if (stdout) console.error(`[qqbot] fireHotUpgrade: stdout: ${stdout.slice(0, 2000)}`);
       if (_stderr) console.error(`[qqbot] fireHotUpgrade: stderr: ${_stderr.slice(0, 2000)}`);
+      cleanupTempScript();
       _upgrading = false;
       return;
     }
@@ -722,12 +760,16 @@ function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
     const newVersion = versionMatch?.[1];
     if (newVersion === "unknown") {
       console.error(`[qqbot] fireHotUpgrade: script output QQBOT_NEW_VERSION=unknown, aborting restart`);
+      cleanupTempScript();
       _upgrading = false;
       return;
     }
 
     console.log(`[qqbot] fireHotUpgrade: new version=${newVersion || "(not detected)"}, triggering restart...`);
 
+    // 脚本执行成功，清理临时脚本副本
+    cleanupTempScript();
+
     // 文件替换成功，在 restart 之前把 source 从 path 切换为 npm，
     // 确保新进程启动时读到的是 npm source，不会被本地源码覆盖。
     switchPluginSourceToNpm();

package/scripts/upgrade-via-alt-pkg.sh

@@ -1,307 +0,0 @@
-#!/bin/bash
-
-# qqbot 测试脚本：自由切换不同的 QQBot npm 包
-#
-# 支持从任意 npm 包安装指定版本到 openclaw extensions 目录。
-# 可用于在不同包之间切换测试，如 @sliverp/qqbot、@tencent-connect/openclaw-qqbot 等。
-#
-# 用法:
-#   upgrade-via-alt-pkg.sh --pkg <包名> --version <version>   # 指定包+版本
-#   upgrade-via-alt-pkg.sh --pkg <包名>                        # 指定包，安装 latest
-#   upgrade-via-alt-pkg.sh --appid <appid> --secret <secret>   # 首次安装时配置
-#   upgrade-via-alt-pkg.sh --no-restart                        # 只做文件替换，不重启
-#
-# 示例:
-#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.1
-#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.4
-#   bash scripts/upgrade-via-alt-pkg.sh --pkg @tencent-connect/openclaw-qqbot --version 1.6.4
-#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot
-#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.4 --appid 12345 --secret abc123
-
-set -eo pipefail
-
-PKG_NAME=""
-VERSION=""
-INSTALL_SRC=""
-APPID=""
-SECRET=""
-NO_RESTART=false
-
-print_usage() {
-    echo "用法:"
-    echo "  upgrade-via-alt-pkg.sh --pkg <包名> --version <版本号>"
-    echo "  upgrade-via-alt-pkg.sh --pkg <包名>                      # 安装 latest"
-    echo ""
-    echo "选项:"
-    echo "  --pkg <name>          npm 包名（必填，如 @sliverp/qqbot、@tencent-connect/openclaw-qqbot）"
-    echo "  --version <version>   指定版本号（如 1.5.1, 1.5.4, 1.6.4）"
-    echo "  --appid <appid>       QQ机器人 appid（首次安装时必填）"
-    echo "  --secret <secret>     QQ机器人 secret（首次安装时必填）"
-    echo "  --no-restart          只做文件替换，不重启 gateway"
-    echo "  -h, --help            显示帮助信息"
-    echo ""
-    echo "环境变量:"
-    echo "  QQBOT_APPID           QQ机器人 appid"
-    echo "  QQBOT_SECRET          QQ机器人 secret"
-    echo "  QQBOT_TOKEN           QQ机器人 token (appid:secret)"
-    echo ""
-    echo "示例:"
-    echo "  # 从 @sliverp/qqbot 包安装 v1.5.1"
-    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.1"
-    echo ""
-    echo "  # 从 @sliverp/qqbot 包安装 v1.5.4"
-    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.4"
-    echo ""
-    echo "  # 从官方包安装 v1.6.4"
-    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @tencent-connect/openclaw-qqbot --version 1.6.4"
-    echo ""
-    echo "  # 切回 @sliverp/qqbot 包的 latest"
-    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot"
-}
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --pkg|--package)
-            [ -z "$2" ] && echo "❌ --pkg 需要参数" && exit 1
-            PKG_NAME="$2"
-            shift 2
-            ;;
-        --version)
-            [ -z "$2" ] && echo "❌ --version 需要参数" && exit 1
-            VERSION="$2"
-            shift 2
-            ;;
-        --tag)
-            [ -z "$2" ] && echo "❌ --tag 需要参数" && exit 1
-            VERSION="$2"
-            shift 2
-            ;;
-        --appid)
-            [ -z "$2" ] && echo "❌ --appid 需要参数" && exit 1
-            APPID="$2"
-            shift 2
-            ;;
-        --secret)
-            [ -z "$2" ] && echo "❌ --secret 需要参数" && exit 1
-            SECRET="$2"
-            shift 2
-            ;;
-        --no-restart)
-            NO_RESTART=true
-            shift 1
-            ;;
-        -h|--help)
-            print_usage
-            exit 0
-            ;;
-        *) echo "未知选项: $1"; print_usage; exit 1 ;;
-    esac
-done
-
-# --pkg 必填
-if [ -z "$PKG_NAME" ]; then
-    echo "❌ 必须指定 --pkg 参数"
-    echo ""
-    print_usage
-    exit 1
-fi
-
-if [ -n "$VERSION" ]; then
-    INSTALL_SRC="${PKG_NAME}@${VERSION}"
-else
-    INSTALL_SRC="${PKG_NAME}@latest"
-fi
-
-# 环境变量 fallback
-APPID="${APPID:-$QQBOT_APPID}"
-SECRET="${SECRET:-$QQBOT_SECRET}"
-if [ -z "$APPID" ] && [ -z "$SECRET" ] && [ -n "$QQBOT_TOKEN" ]; then
-    APPID="${QQBOT_TOKEN%%:*}"
-    SECRET="${QQBOT_TOKEN#*:}"
-fi
-
-# 检测 CLI（仅用于确定 extensions 目录路径）
-CMD=""
-for name in openclaw clawdbot moltbot; do
-    command -v "$name" &>/dev/null && CMD="$name" && break
-done
-[ -z "$CMD" ] && echo "❌ 未找到 openclaw / clawdbot / moltbot" && exit 1
-
-EXTENSIONS_DIR="$HOME/.$CMD/extensions"
-
-echo "==========================================="
-echo "  qqbot 测试升级: $INSTALL_SRC"
-echo "==========================================="
-echo ""
-
-# [1/3] 下载并安装新版本到临时目录
-echo "[1/3] 下载新版本..."
-TMPDIR_PACK=$(mktemp -d)
-EXTRACT_DIR=$(mktemp -d)
-trap "rm -rf '$TMPDIR_PACK' '$EXTRACT_DIR'" EXIT
-
-cd "$TMPDIR_PACK"
-# 多 registry fallback：npmjs.org → npmmirror（国内镜像）→ 默认 registry
-PACK_OK=false
-for _registry in "https://registry.npmjs.org/" "https://registry.npmmirror.com/" ""; do
-    if [ -n "$_registry" ]; then
-        echo "  尝试 registry: $_registry"
-        npm pack "$INSTALL_SRC" --registry "$_registry" --quiet 2>&1 && PACK_OK=true && break
-    else
-        echo "  尝试默认 registry..."
-        npm pack "$INSTALL_SRC" --quiet 2>&1 && PACK_OK=true && break
-    fi
-done
-$PACK_OK || { echo "❌ npm pack 失败（所有 registry 均不可用）"; exit 1; }
-TGZ_FILE=$(ls -1 *.tgz 2>/dev/null | head -1)
-[ -z "$TGZ_FILE" ] && echo "❌ 未找到下载的 tgz 文件" && exit 1
-echo "  已下载: $TGZ_FILE"
-
-tar xzf "$TGZ_FILE" -C "$EXTRACT_DIR"
-PACKAGE_DIR="$EXTRACT_DIR/package"
-[ ! -d "$PACKAGE_DIR" ] && echo "❌ 解压失败，未找到 package 目录" && exit 1
-
-# 准备 staging 目录
-STAGING_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-staging"
-rm -rf "$STAGING_DIR"
-mkdir -p "$STAGING_DIR"
-cp -R "$PACKAGE_DIR/." "$STAGING_DIR/"
-
-# 依赖处理
-if [ -d "$STAGING_DIR/node_modules" ]; then
-    BUNDLED_COUNT=$(find "$STAGING_DIR/node_modules" -mindepth 1 -maxdepth 2 -type d | wc -l | tr -d ' ')
-    echo "  bundled 依赖已就绪（${BUNDLED_COUNT} 个包）"
-else
-    echo "  ⚠️  未找到 bundled node_modules，尝试安装依赖..."
-    NPM_TMP_CACHE=$(mktemp -d)
-    (cd "$STAGING_DIR" && npm install --omit=dev --omit=peer --ignore-scripts --cache="$NPM_TMP_CACHE" --quiet 2>&1) || echo "  ⚠️  依赖安装失败"
-    rm -rf "$NPM_TMP_CACHE"
-fi
-
-# 清理下载临时文件
-rm -rf "$TMPDIR_PACK" "$EXTRACT_DIR"
-cd "$HOME"
-
-# [2/3] 原子替换插件目录
-echo ""
-echo "[2/3] 原子替换插件目录..."
-TARGET_DIR="$EXTENSIONS_DIR/openclaw-qqbot"
-OLD_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-old"
-
-rm -rf "$OLD_DIR"
-
-STAGING_IN_EXT="$EXTENSIONS_DIR/.openclaw-qqbot-new"
-rm -rf "$STAGING_IN_EXT"
-mv "$STAGING_DIR" "$STAGING_IN_EXT"
-
-if [ -d "$TARGET_DIR" ]; then
-    mv "$TARGET_DIR" "$OLD_DIR" && mv "$STAGING_IN_EXT" "$TARGET_DIR"
-else
-    mv "$STAGING_IN_EXT" "$TARGET_DIR"
-fi
-rm -rf "$OLD_DIR"
-
-# 清理可能残留的旧版 staging 目录
-rm -rf "$EXTENSIONS_DIR/openclaw-qqbot.staging"
-rm -rf "$EXTENSIONS_DIR/.qqbot-upgrade-staging"
-rm -rf "$EXTENSIONS_DIR/.qqbot-upgrade-old"
-
-# 清理历史遗留的其他目录名
-for dir_name in qqbot openclaw-qq; do
-    [ -d "$EXTENSIONS_DIR/$dir_name" ] && rm -rf "$EXTENSIONS_DIR/$dir_name"
-done
-echo "  已安装到: $TARGET_DIR"
-
-# [3/3] 输出新版本号和升级报告
-echo ""
-echo "[3/3] 验证安装..."
-NEW_VERSION="$(node -e "
-  try {
-    const fs = require('fs');
-    const path = require('path');
-    const p = path.join('$EXTENSIONS_DIR', 'openclaw-qqbot', 'package.json');
-    if (fs.existsSync(p)) {
-      const v = JSON.parse(fs.readFileSync(p, 'utf8')).version;
-      if (v) { process.stdout.write(v); process.exit(0); }
-    }
-  } catch {}
-" 2>/dev/null || true)"
-echo "QQBOT_NEW_VERSION=${NEW_VERSION:-unknown}"
-
-if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
-    echo "QQBOT_REPORT=✅ QQBot 升级完成 ($PKG_NAME): v${NEW_VERSION}"
-else
-    echo "QQBOT_REPORT=⚠️ QQBot 升级异常，无法确认新版本"
-fi
-
-echo ""
-echo "==========================================="
-echo "  ✅ 文件安装完成"
-echo "==========================================="
-
-# --no-restart 模式
-if [ "$NO_RESTART" = "true" ]; then
-    echo ""
-    echo "[跳过重启] --no-restart 已指定，脚本立即退出以便调用方触发 gateway restart"
-    exit 0
-fi
-
-# [4/4] 配置 appid/secret（仅在提供了参数时执行）
-if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
-    echo ""
-    echo "[配置] 写入 qqbot 通道配置..."
-    DESIRED_TOKEN="${APPID}:${SECRET}"
-
-    CURRENT_TOKEN=""
-    for _app in openclaw clawdbot moltbot; do
-        _cfg="$HOME/.$_app/$_app.json"
-        if [ -f "$_cfg" ]; then
-            CURRENT_TOKEN=$(node -e "
-                const cfg = JSON.parse(require('fs').readFileSync('$_cfg', 'utf8'));
-                const keys = ['qqbot', 'openclaw-qqbot', 'openclaw-qq'];
-                for (const key of keys) {
-                    const ch = cfg.channels && cfg.channels[key];
-                    if (!ch) continue;
-                    if (ch.token) { process.stdout.write(ch.token); process.exit(0); }
-                    if (ch.appId && ch.clientSecret) { process.stdout.write(ch.appId + ':' + ch.clientSecret); process.exit(0); }
-                }
-            " 2>/dev/null || true)
-            [ -n "$CURRENT_TOKEN" ] && break
-        fi
-    done
-
-    if [ "$CURRENT_TOKEN" = "$DESIRED_TOKEN" ]; then
-        echo "  ✅ 当前配置已是目标值，跳过写入"
-    elif $CMD channels add --channel qqbot --token "$DESIRED_TOKEN" 2>&1; then
-        echo "  ✅ 通道配置写入成功"
-    else
-        echo "  ⚠️  $CMD channels add 失败，尝试直接编辑配置文件..."
-        CONFIG_FILE="$HOME/.$CMD/$CMD.json"
-        if [ -f "$CONFIG_FILE" ] && node -e "
-            const fs = require('fs');
-            const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
-            if (!cfg.channels) cfg.channels = {};
-            if (!cfg.channels.qqbot) cfg.channels.qqbot = {};
-            cfg.channels.qqbot.appId = '$APPID';
-            cfg.channels.qqbot.clientSecret = '$SECRET';
-            fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
-        " 2>&1; then
-            echo "  ✅ 通道配置写入成功（直接编辑配置文件）"
-        else
-            echo "  ❌ 配置写入失败，请手动配置:"
-            echo "     $CMD channels add --channel qqbot --token \"${APPID}:${SECRET}\""
-        fi
-    fi
-elif [ -n "$APPID" ] || [ -n "$SECRET" ]; then
-    echo ""
-    echo "⚠️  --appid 和 --secret 必须同时提供"
-fi
-
-# [5/5] 重启 gateway 使新版本生效
-echo ""
-echo "[重启] 重启 gateway 使新版本生效..."
-if $CMD gateway restart 2>&1; then
-    echo "  ✅ gateway 已重启"
-else
-    echo "  ⚠️  gateway 重启失败，请手动执行: $CMD gateway restart"
-fi