@tencent-connect/openclaw-qqbot 1.6.5-alpha.2 → 1.6.5-alpha.4

package/dist/src/api.js

@@ -2,7 +2,6 @@
  * QQ Bot API 鉴权和请求封装
  * [修复版] 已重构为支持多实例并发，消除全局变量冲突
  */
-import { createRequire } from "node:module";
 import os from "node:os";
 import { computeFileHash, getCachedFileInfo, setCachedFileInfo } from "./utils/upload-cache.js";
 import { sanitizeFileName } from "./utils/platform.js";
@@ -11,12 +10,8 @@ const TOKEN_URL = "https://bots.qq.com/app/getAppAccessToken";
 // ============ Plugin User-Agent ============
 // 格式: QQBotPlugin/{version} (Node/{nodeVersion}; {os})
 // 示例: QQBotPlugin/1.6.0 (Node/22.14.0; darwin)
-const _require = createRequire(import.meta.url);
-let _pluginVersion = "unknown";
-try {
-    _pluginVersion = _require("../package.json").version ?? "unknown";
-}
-catch { /* fallback */ }
+import { getPackageVersion } from "./utils/pkg-version.js";
+const _pluginVersion = getPackageVersion(import.meta.url);
 export const PLUGIN_USER_AGENT = `QQBotPlugin/${_pluginVersion} (Node/${process.versions.node}; ${os.platform()})`;
 // 运行时配置
 let currentMarkdownSupport = false;
@@ -234,21 +229,48 @@ export async function apiRequest(accessToken, method, path, body, timeoutMs) {
     });
     const traceId = res.headers.get("x-tps-trace-id") ?? "";
     console.log(`[qqbot-api] <<< Status: ${res.status} ${res.statusText}${traceId ? ` | TraceId: ${traceId}` : ""}`);
-    let data;
     let rawBody;
     try {
         rawBody = await res.text();
-        console.log(`[qqbot-api] <<< Body:`, rawBody);
-        data = JSON.parse(rawBody);
     }
     catch (err) {
-        throw new Error(`Failed to parse response[${path}]: ${err instanceof Error ? err.message : String(err)}`);
+        throw new Error(`读取响应失败[${path}]: ${err instanceof Error ? err.message : String(err)}`);
     }
+    console.log(`[qqbot-api] <<< Body:`, rawBody);
+    // 检测非 JSON 响应（HTML 网关错误页 / CDN 限流页等）
+    const contentType = res.headers.get("content-type") ?? "";
+    const isHtmlResponse = contentType.includes("text/html") || rawBody.trimStart().startsWith("<");
     if (!res.ok) {
-        const error = data;
-        throw new Error(`API Error [${path}]: ${error.message ?? JSON.stringify(data)}`);
+        if (isHtmlResponse) {
+            // HTML 响应 = 网关/限流层返回的错误页，给出友好提示
+            const statusHint = res.status === 502 || res.status === 503 || res.status === 504
+                ? "调用发生异常，请稍候重试"
+                : res.status === 429
+                    ? "请求过于频繁，已被限流"
+                    : `开放平台返回 HTTP ${res.status}`;
+            throw new Error(`${statusHint}（${path}），请稍后重试`);
+        }
+        // JSON 错误响应
+        try {
+            const error = JSON.parse(rawBody);
+            throw new Error(`API Error [${path}]: ${error.message ?? rawBody}`);
+        }
+        catch (parseErr) {
+            if (parseErr instanceof Error && parseErr.message.startsWith("API Error"))
+                throw parseErr;
+            throw new Error(`API Error [${path}] HTTP ${res.status}: ${rawBody.slice(0, 200)}`);
+        }
+    }
+    // 成功响应但不是 JSON（极端异常情况）
+    if (isHtmlResponse) {
+        throw new Error(`QQ 服务端返回了非 JSON 响应（${path}），可能是临时故障，请稍后重试`);
+    }
+    try {
+        return JSON.parse(rawBody);
+    }
+    catch {
+        throw new Error(`开放平台响应格式异常（${path}），请稍后重试`);
     }
-    return data;
 }
 // ============ 上传重试（指数退避） ============
 const UPLOAD_MAX_RETRIES = 2;

package/dist/src/slash-commands.js

@@ -18,16 +18,9 @@ import { getUpdateInfo, checkVersionExists } from "./update-checker.js";
 import { getHomeDir, getQQBotDataDir, isWindows } from "./utils/platform.js";
 import { saveCredentialBackup } from "./credential-backup.js";
 import { fileURLToPath } from "node:url";
+import { getPackageVersion } from "./utils/pkg-version.js";
 const require = createRequire(import.meta.url);
-// 读取 package.json 中的版本号
-let PLUGIN_VERSION = "unknown";
-try {
-    const pkg = require("../package.json");
-    PLUGIN_VERSION = pkg.version ?? "unknown";
-}
-catch {
-    // fallback
-}
+let PLUGIN_VERSION = getPackageVersion(import.meta.url);
 // 获取 openclaw 框架版本（缓存结果，只执行一次）
 let _frameworkVersion = null;
 function getFrameworkVersion() {

package/dist/src/update-checker.js

@@ -9,6 +9,7 @@
  */
 import { createRequire } from "node:module";
 import https from "node:https";
+import { getPackageVersion } from "./utils/pkg-version.js";
 const require = createRequire(import.meta.url);
 const PKG_NAME = "@tencent-connect/openclaw-qqbot";
 const ENCODED_PKG = encodeURIComponent(PKG_NAME);
@@ -16,14 +17,7 @@ const REGISTRIES = [
     `https://registry.npmjs.org/${ENCODED_PKG}`,
     `https://registry.npmmirror.com/${ENCODED_PKG}`,
 ];
-let CURRENT_VERSION = "unknown";
-try {
-    const pkg = require("../package.json");
-    CURRENT_VERSION = pkg.version ?? "unknown";
-}
-catch {
-    // fallback
-}
+let CURRENT_VERSION = getPackageVersion(import.meta.url);
 let _log;
 function fetchJson(url, timeoutMs) {
     return new Promise((resolve, reject) => {

package/dist/src/utils/pkg-version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 从 import.meta.url 向上遍历目录树查找 package.json 并读取 version。
+ * 不依赖硬编码的 "../" 层级，无论编译输出结构如何变化都能可靠找到。
+ */
+export declare function getPackageVersion(metaUrl?: string): string;

package/dist/src/utils/pkg-version.js

@@ -0,0 +1,51 @@
+/**
+ * 从 import.meta.url 向上遍历目录树查找 package.json 并读取 version。
+ * 不依赖硬编码的 "../" 层级，无论编译输出结构如何变化都能可靠找到。
+ */
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import path from "node:path";
+import fs from "node:fs";
+let _cached = null;
+export function getPackageVersion(metaUrl) {
+    if (_cached !== null)
+        return _cached;
+    // Strategy 1: 从调用者的 import.meta.url（或本模块）向上遍历找 package.json
+    const startFile = metaUrl ? fileURLToPath(metaUrl) : fileURLToPath(import.meta.url);
+    let dir = path.dirname(startFile);
+    const root = path.parse(dir).root;
+    while (dir !== root) {
+        const candidate = path.join(dir, "package.json");
+        try {
+            if (fs.existsSync(candidate)) {
+                const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
+                // 确认是我们自己的包（避免找到其他 package.json）
+                if (pkg.name === "@tencent-connect/openclaw-qqbot" && pkg.version) {
+                    _cached = pkg.version;
+                    return _cached;
+                }
+            }
+        }
+        catch {
+            // ignore and try parent
+        }
+        dir = path.dirname(dir);
+    }
+    // Strategy 2: fallback 用 createRequire 尝试常见相对路径
+    try {
+        const require = createRequire(metaUrl ?? import.meta.url);
+        for (const rel of ["../../package.json", "../package.json", "./package.json"]) {
+            try {
+                const pkg = require(rel);
+                if (pkg?.version) {
+                    _cached = pkg.version;
+                    return _cached;
+                }
+            }
+            catch { /* next */ }
+        }
+    }
+    catch { /* fallback */ }
+    _cached = "unknown";
+    return _cached;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-connect/openclaw-qqbot",
-  "version": "1.6.5-alpha.2",
+  "version": "1.6.5-alpha.4",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,7 +22,11 @@
     "id": "openclaw-qqbot",
     "extensions": [
       "./dist/index.js"
-    ]
+    ],
+    "channel": {
+      "id": "qqbot",
+      "label": "QQ Bot"
+    }
   },
   "scripts": {
     "build": "tsc || true",

package/scripts/upgrade-via-npm.ps1

@@ -242,7 +242,7 @@ if ($MissingModules.Count -gt 0) {
 $nmDir = Join-Path $STAGING_DIR "node_modules"
 if (Test-Path $nmDir) {
     $BundledOK = $true
-    foreach ($dep in @("ws", "undici")) {
+    foreach ($dep in @("ws", "silk-wasm")) {
         if (-not (Test-Path (Join-Path $nmDir $dep))) {
             Write-Host "  [WARN] Bundled dependency missing: $dep" -ForegroundColor Yellow
             $BundledOK = $false
@@ -273,6 +273,7 @@ Write-Host "  [OK] All preflight checks passed"
 # [3/5] Replace plugin directory (in-place overwrite to avoid file-lock issues)
 Write-Host ""
 Write-Host "[3/5] Replacing plugin directory..."
+if (-not (Test-Path $EXTENSIONS_DIR)) { New-Item -ItemType Directory -Path $EXTENSIONS_DIR -Force | Out-Null }
 $TARGET_DIR = Join-Path $EXTENSIONS_DIR "openclaw-qqbot"
 
 if (-not (Test-Path $TARGET_DIR)) {

package/scripts/upgrade-via-npm.sh

@@ -1,22 +1,27 @@
 #!/bin/bash
 
-# qqbot 通过 npm 包升级（纯文件操作版本）
+# qqbot 通过 openclaw 原生插件指令升级
 #
-# 默认只做文件替换，不修改 openclaw.json 配置文件。
-# 但如果提供了 --appid/--secret 参数（首次安装场景），
-# 则在文件安装完成后自动写入通道配置。
+# 使用 openclaw plugins install/update 原生命令进行安装和升级，
+# 保留 appid/secret 配置写入、热更新 (--no-restart)、结构化输出等功能。
+#
+# 升级策略：
+#   1. 已安装（plugins.installs 有记录）→ openclaw plugins update
+#   2. 未安装 / update 失败 → 删除旧目录 + openclaw plugins install
 #
 # 用法:
 #   upgrade-via-npm.sh                                    # 升级到 latest（默认）
 #   upgrade-via-npm.sh --version <version>                # 升级到指定版本
 #   upgrade-via-npm.sh --self-version                     # 升级到当前仓库 package.json 版本
 #   upgrade-via-npm.sh --appid <appid> --secret <secret>  # 首次安装时配置 appid/secret
-#   upgrade-via-npm.sh --no-restart                        # 只做文件替换，不重启 gateway（供热更指令使用）
+#   upgrade-via-npm.sh --no-restart                       # 只做文件替换，不重启 gateway（供热更指令使用）
 
 set -eo pipefail
 
 PKG_NAME="@tencent-connect/openclaw-qqbot"
+PLUGIN_ID="openclaw-qqbot"
 INSTALL_SRC=""
+TARGET_VERSION=""
 APPID=""
 SECRET=""
 NO_RESTART=false
@@ -56,16 +61,19 @@ while [[ $# -gt 0 ]]; do
     case "$1" in
         --tag)
             [ -z "$2" ] && echo "❌ --tag 需要参数" && exit 1
+            TARGET_VERSION="$2"
             INSTALL_SRC="${PKG_NAME}@$2"
             shift 2
             ;;
         --version)
             [ -z "$2" ] && echo "❌ --version 需要参数" && exit 1
+            TARGET_VERSION="$2"
             INSTALL_SRC="${PKG_NAME}@$2"
             shift 2
             ;;
         --self-version)
             [ -z "$LOCAL_VERSION" ] && echo "❌ 无法从 package.json 读取版本" && exit 1
+            TARGET_VERSION="$LOCAL_VERSION"
             INSTALL_SRC="${PKG_NAME}@${LOCAL_VERSION}"
             shift 1
             ;;
@@ -100,7 +108,7 @@ if [ -z "$APPID" ] && [ -z "$SECRET" ] && [ -n "$QQBOT_TOKEN" ]; then
     SECRET="${QQBOT_TOKEN#*:}"
 fi
 
-# 检测 CLI（仅用于确定 extensions 目录路径）
+# 检测 CLI
 CMD=""
 for name in openclaw clawdbot moltbot; do
     command -v "$name" &>/dev/null && CMD="$name" && break
@@ -110,91 +118,126 @@ done
 EXTENSIONS_DIR="$HOME/.$CMD/extensions"
 
 echo "==========================================="
-echo "  qqbot npm 升级: $INSTALL_SRC"
+echo "  qqbot 升级: $INSTALL_SRC"
 echo "==========================================="
 echo ""
 
-# [1/5] 下载并安装新版本到临时目录
-echo "[1/5] 下载新版本..."
-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
+# 记录升级前的版本
+OLD_VERSION=""
+OLD_PKG="$EXTENSIONS_DIR/$PLUGIN_ID/package.json"
+if [ -f "$OLD_PKG" ]; then
+    OLD_VERSION="$(node -e "
+      try {
+        const v = JSON.parse(require('fs').readFileSync('$OLD_PKG', 'utf8')).version;
+        if (v) process.stdout.write(String(v));
+      } catch {}
+    " 2>/dev/null || true)"
+    echo "  当前版本: ${OLD_VERSION:-unknown}"
+fi
+
+# [1/4] 通过 openclaw 原生指令安装/升级
+echo ""
+echo "[1/4] 安装/升级插件..."
+
+UPGRADE_OK=false
+
+# 检测安装状态：同时检查配置记录和磁盘目录
+HAS_INSTALL_RECORD="$(node -e "
+  try {
+    const fs = require('fs');
+    const p = '$HOME/.$CMD/$CMD.json';
+    const cfg = JSON.parse(fs.readFileSync(p, 'utf8'));
+    const inst = cfg.plugins && cfg.plugins.installs && cfg.plugins.installs['$PLUGIN_ID'];
+    if (inst) process.stdout.write('yes');
+  } catch {}
+" 2>/dev/null || true)"
+HAS_PLUGIN_DIR=false
+[ -d "$EXTENSIONS_DIR/$PLUGIN_ID" ] && [ -f "$EXTENSIONS_DIR/$PLUGIN_ID/package.json" ] && HAS_PLUGIN_DIR=true
+
+# 决策矩阵：
+#   配置有记录 + 目录存在 → update（最佳路径）
+#   配置有记录 + 目录不存在 → 清理残留记录，走 install
+#   配置无记录 + 目录存在 → 删目录，走 install（配置与文件不一致）
+#   配置无记录 + 目录不存在 → 走 install（全新安装）
+#
+# 指定了具体版本（--version/--tag/--self-version）时：
+#   update 不支持指定版本，直接走 删除 + install
+
+USE_UPDATE=false
+
+if [ "$HAS_INSTALL_RECORD" = "yes" ] && [ "$HAS_PLUGIN_DIR" = "true" ] && [ -z "$TARGET_VERSION" ]; then
+    # 配置和目录都齐全，且未指定版本 → 走 update
+    USE_UPDATE=true
+    echo "  [检测] 配置记录 ✓ | 插件目录 ✓ | 未指定版本 → 使用 update"
+elif [ "$HAS_INSTALL_RECORD" = "yes" ] && [ "$HAS_PLUGIN_DIR" = "true" ]; then
+    echo "  [检测] 配置记录 ✓ | 插件目录 ✓ | 指定版本 $TARGET_VERSION → 使用 reinstall"
+elif [ "$HAS_INSTALL_RECORD" = "yes" ]; then
+    echo "  [检测] 配置记录 ✓ | 插件目录 ✗ → 配置与文件不一致，使用 install"
+elif [ "$HAS_PLUGIN_DIR" = "true" ]; then
+    echo "  [检测] 配置记录 ✗ | 插件目录 ✓ → 目录残留，清理后 install"
+else
+    echo "  [检测] 配置记录 ✗ | 插件目录 ✗ → 全新安装"
+fi
+
+if [ "$USE_UPDATE" = "true" ]; then
+    echo "  尝试 update..."
+    if $CMD plugins update "$PLUGIN_ID" 2>&1; then
+        UPGRADE_OK=true
+        echo "  ✅ update 成功"
     else
-        echo "  尝试默认 registry..."
-        npm pack "$INSTALL_SRC" --quiet 2>&1 && PACK_OK=true && break
+        echo "  ⚠️  update 失败，回退到 reinstall..."
     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 目录：放在 ~/.openclaw/ 下（extensions 的父目录），
-# 同一文件系统保证 mv 原子操作，同时避免 OpenClaw 扫描 extensions/ 时发现它。
-STAGING_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-staging"
-rm -rf "$STAGING_DIR"
-mkdir -p "$STAGING_DIR"
-cp -R "$PACKAGE_DIR/"* "$STAGING_DIR/"
-
-# 依赖处理：所有 production dependencies 都声明为 bundledDependencies，
-# npm pack 时已打包进 tgz，解压后 node_modules/ 已包含全部依赖，无需 npm install。
-# 注意：不能执行 npm install，否则会安装 peerDependencies（openclaw 平台及其 400+ 传递依赖），
-# 导致插件目录膨胀到 900MB+，而这些依赖在运行时由宿主 openclaw 提供。
-if [ -d "$STAGING_DIR/node_modules" ]; then
-    BUNDLED_COUNT=$(ls -d "$STAGING_DIR/node_modules"/*/ "$STAGING_DIR/node_modules"/@*/*/ 2>/dev/null | 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"
+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"
+    done
+
+    echo "  执行 install: $INSTALL_SRC"
+    if $CMD plugins install "$INSTALL_SRC" --pin 2>&1; then
+        UPGRADE_OK=true
+        echo "  ✅ install 成功"
+    else
+        echo "❌ install 失败"
+        echo "QQBOT_NEW_VERSION=unknown"
+        echo "QQBOT_REPORT=❌ QQBot 安装失败，请检查网络和 npm registry"
+        exit 1
+    fi
+fi
 
-# ── Preflight 检查：在写入 extensions 之前确保新包完整有效 ──
+# [2/4] 验证安装
 echo ""
-echo "[2/5] Preflight 检查..."
+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)"
+
+# Preflight 检查
 PREFLIGHT_OK=true
+TARGET_DIR="$EXTENSIONS_DIR/$PLUGIN_ID"
 
-# (a) package.json 存在且可解析，且包含 version 字段
-STAGING_PKG="$STAGING_DIR/package.json"
-if [ ! -f "$STAGING_PKG" ]; then
-    echo "  ❌ 新包缺少 package.json"
+if [ -z "$NEW_VERSION" ]; then
+    echo "  ❌ 无法读取新版本号"
     PREFLIGHT_OK=false
 else
-    STAGING_VERSION="$(node -e "
-      try {
-        const v = JSON.parse(require('fs').readFileSync('$STAGING_PKG', 'utf8')).version;
-        if (v) process.stdout.write(String(v));
-      } catch {}
-    " 2>/dev/null || true)"
-    if [ -z "$STAGING_VERSION" ]; then
-        echo "  ❌ package.json 无法解析或缺少 version 字段"
-        PREFLIGHT_OK=false
-    else
-        echo "  ✅ 版本号: $STAGING_VERSION"
-    fi
+    echo "  ✅ 版本号: $NEW_VERSION"
 fi
 
-# (b) 入口文件存在（dist/index.js 或 index.js）
+# 入口文件
 ENTRY_FILE=""
 for candidate in "dist/index.js" "index.js"; do
-    if [ -f "$STAGING_DIR/$candidate" ]; then
+    if [ -f "$TARGET_DIR/$candidate" ]; then
         ENTRY_FILE="$candidate"
         break
     fi
@@ -206,23 +249,23 @@ else
     echo "  ✅ 入口文件: $ENTRY_FILE"
 fi
 
-# (c) 核心目录 dist/src 存在
-if [ ! -d "$STAGING_DIR/dist/src" ]; then
-    echo "  ❌ 缺少核心目录 dist/src/"
-    PREFLIGHT_OK=false
-else
-    CORE_JS_COUNT=$(find "$STAGING_DIR/dist/src" -name "*.js" -type f 2>/dev/null | wc -l | tr -d ' ')
+# 核心目录
+if [ -d "$TARGET_DIR/dist/src" ]; then
+    CORE_JS_COUNT=$(find "$TARGET_DIR/dist/src" -name "*.js" -type f 2>/dev/null | wc -l | tr -d ' ')
     echo "  ✅ dist/src/ 包含 ${CORE_JS_COUNT} 个 JS 文件"
     if [ "$CORE_JS_COUNT" -lt 5 ]; then
         echo "  ❌ JS 文件数量异常偏少（预期 ≥ 5，实际 ${CORE_JS_COUNT}）"
         PREFLIGHT_OK=false
     fi
+else
+    echo "  ❌ 缺少核心目录 dist/src/"
+    PREFLIGHT_OK=false
 fi
 
-# (d) 关键模块文件存在
+# 关键模块
 MISSING_MODULES=""
 for module in "dist/src/gateway.js" "dist/src/api.js" "dist/src/admin-resolver.js"; do
-    if [ ! -f "$STAGING_DIR/$module" ]; then
+    if [ ! -f "$TARGET_DIR/$module" ]; then
         MISSING_MODULES="$MISSING_MODULES $module"
     fi
 done
@@ -233,11 +276,11 @@ else
     echo "  ✅ 关键模块完整"
 fi
 
-# (e) bundled node_modules 健康检查
-if [ -d "$STAGING_DIR/node_modules" ]; then
+# bundled 依赖
+if [ -d "$TARGET_DIR/node_modules" ]; then
     BUNDLED_OK=true
-    for dep in "ws" "undici"; do
-        if [ ! -d "$STAGING_DIR/node_modules/$dep" ]; then
+    for dep in "ws" "silk-wasm"; do
+        if [ ! -d "$TARGET_DIR/node_modules/$dep" ]; then
             echo "  ⚠️  bundled 依赖缺失: $dep"
             BUNDLED_OK=false
         fi
@@ -247,103 +290,20 @@ if [ -d "$STAGING_DIR/node_modules" ]; then
     fi
 fi
 
-# (f) 如果有旧版本，检查新版本是否合理（不允许降级到 0.x 等异常版本）
-if [ -n "$STAGING_VERSION" ]; then
-    STAGING_MAJOR="$(echo "$STAGING_VERSION" | cut -d. -f1)"
-    if [ "$STAGING_MAJOR" = "0" ]; then
-        echo "  ⚠️  新版本主版本号为 0（$STAGING_VERSION），可能不是正式发布版"
-    fi
-fi
-
-# 检查结果
 if [ "$PREFLIGHT_OK" != "true" ]; then
     echo ""
-    echo "❌ Preflight 检查未通过，中止升级（旧版本未受影响）"
-    rm -rf "$STAGING_DIR"
+    echo "❌ 验证未通过"
+    echo "QQBOT_NEW_VERSION=unknown"
+    echo "QQBOT_REPORT=⚠️ QQBot 升级异常，验证未通过"
     exit 1
 fi
-echo "  ✅ Preflight 检查全部通过"
+echo "  ✅ 验证全部通过"
 
-# [3/5] 原子替换：使用 mv -T/rename 确保目录切换尽可能原子
-# 策略：先把 staging 放到 extensions/ 同级的临时名，再做单次 mv 替换
+# [3/4] 输出结构化信息（供 TS handler 解析）
 echo ""
-echo "[3/5] 原子替换插件目录..."
-TARGET_DIR="$EXTENSIONS_DIR/openclaw-qqbot"
-OLD_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-old"
-
-rm -rf "$OLD_DIR"
-
-# 先把 staging 目录移到 extensions/ 下的临时位置（同文件系统，确保 mv 是 rename 操作）
-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 但中间零操作，最小化目录不存在的时间窗口
-    mv "$TARGET_DIR" "$OLD_DIR" && mv "$STAGING_IN_EXT" "$TARGET_DIR"
-else
-    mv "$STAGING_IN_EXT" "$TARGET_DIR"
-fi
-rm -rf "$OLD_DIR"
-
-# 清理可能残留的旧版 staging 目录（extensions 内外都清理）
-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"
-
-# 执行 postinstall 脚本创建 openclaw SDK symlink
-# （upgrade-via-npm 是纯文件操作，不走 npm install，所以 postinstall 不会自动触发）
-POSTINSTALL_SCRIPT="$TARGET_DIR/scripts/postinstall-link-sdk.js"
-if [ -f "$POSTINSTALL_SCRIPT" ]; then
-    echo "  执行 postinstall: 创建 openclaw SDK symlink..."
-    POSTINSTALL_OUTPUT="$(cd "$TARGET_DIR" && node "$POSTINSTALL_SCRIPT" 2>&1)" || true
-    [ -n "$POSTINSTALL_OUTPUT" ] && echo "  $POSTINSTALL_OUTPUT"
-    # 验证 symlink 是否创建成功
-    if [ -d "$TARGET_DIR/node_modules/openclaw" ]; then
-        echo "  ✅ openclaw SDK symlink 已就绪"
-    else
-        echo "  ⚠️  openclaw SDK symlink 未创建，插件可能无法加载"
-        echo "  尝试手动创建 symlink..."
-        # 手动 fallback：尝试从 CLI 数据目录名推断全局包名
-        _CLI_DATA_DIR="$(dirname "$EXTENSIONS_DIR")"
-        _CLI_NAME="$(basename "$_CLI_DATA_DIR" | sed 's/^\.//')"
-        _GLOBAL_ROOT="$(npm root -g 2>/dev/null || true)"
-        if [ -n "$_GLOBAL_ROOT" ] && [ -n "$_CLI_NAME" ] && [ -d "$_GLOBAL_ROOT/$_CLI_NAME" ]; then
-            mkdir -p "$TARGET_DIR/node_modules"
-            ln -sf "$_GLOBAL_ROOT/$_CLI_NAME" "$TARGET_DIR/node_modules/openclaw" 2>/dev/null && \
-                echo "  ✅ 手动 symlink 创建成功: -> $_GLOBAL_ROOT/$_CLI_NAME" || \
-                echo "  ❌ 手动 symlink 创建也失败了"
-        else
-            echo "  ❌ 无法定位全局 $_CLI_NAME 安装路径（npm root -g: $_GLOBAL_ROOT）"
-        fi
-    fi
-else
-    echo "  ⚠️  未找到 postinstall 脚本，跳过 symlink 创建"
-fi
-
-# [4/5] 输出新版本号和升级报告（供调用方解析）
-echo ""
-echo "[4/5] 验证安装..."
-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 "[3/4] 升级结果..."
 echo "QQBOT_NEW_VERSION=${NEW_VERSION:-unknown}"
 
-# 输出结构化升级报告（QQBOT_REPORT=...），供 TS handler 解析后直接回复用户
 if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
     echo "QQBOT_REPORT=✅ QQBot 升级完成: v${NEW_VERSION}"
 else
@@ -352,13 +312,10 @@ fi
 
 echo ""
 echo "==========================================="
-echo "  ✅ 文件安装完成"
+echo "  ✅ 安装完成"
 echo "==========================================="
 
-# --no-restart 模式（热更新场景）：文件替换完成后立即退出，
-# 让调用方尽快触发 gateway restart，避免 openclaw 配置轮询
-# 在旧进程中检测到插件变更产生 "plugin not found" warning 刷屏。
-# appid/secret 配置在热更新场景下已经存在，无需重新写入。
+# --no-restart 模式（热更新场景）：立即退出，让调用方触发 gateway restart
 if [ "$NO_RESTART" = "true" ]; then
     echo ""
     echo "[跳过重启] --no-restart 已指定，脚本立即退出以便调用方触发 gateway restart"
@@ -394,10 +351,9 @@ if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
 
     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 失败，尝试直接编辑配置文件..."
+        # qqbot 是插件自定义通道，openclaw channels add --channel 不支持，
+        # 直接编辑配置文件写入 channels.qqbot
         CONFIG_FILE="$HOME/.$CMD/$CMD.json"
         if [ -f "$CONFIG_FILE" ] && node -e "
             const fs = require('fs');
@@ -408,10 +364,10 @@ if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
             cfg.channels.qqbot.clientSecret = '$SECRET';
             fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
         " 2>&1; then
-            echo "  ✅ 通道配置写入成功（直接编辑配置文件）"
+            echo "  ✅ 通道配置写入成功"
         else
-            echo "  ❌ 配置写入失败，请手动配置:"
-            echo "     $CMD channels add --channel qqbot --token \"${APPID}:${SECRET}\""
+            echo "  ❌ 配置写入失败，请手动编辑 $CONFIG_FILE 添加 channels.qqbot:"
+            echo "     { \"channels\": { \"qqbot\": { \"appId\": \"$APPID\", \"clientSecret\": \"...\" } } }"
         fi
     fi
 elif [ -n "$APPID" ] || [ -n "$SECRET" ]; then
@@ -419,11 +375,10 @@ elif [ -n "$APPID" ] || [ -n "$SECRET" ]; then
     echo "⚠️  --appid 和 --secret 必须同时提供"
 fi
 
-# [5/5] 重启 gateway 使新版本生效
+# [4/4] 重启 gateway 使新版本生效
 echo ""
 
 # 手动升级场景：提前写入 startup-marker，阻止重启后 bot 重复推送升级通知
-# （控制台已打印同款提示语，无需 bot 再发一次）
 if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
     MARKER_DIR="$HOME/.openclaw/qqbot/data"
     mkdir -p "$MARKER_DIR"
@@ -435,7 +390,6 @@ fi
 echo "[重启] 重启 gateway 使新版本生效..."
 if $CMD gateway restart 2>&1; then
     echo "  ✅ gateway 已重启"
-    # 打印与 bot 通知同款的更新提示语（手动升级场景无需通过 bot 推送）
     echo ""
     if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
         echo "🎉 QQBot 插件已更新至 v${NEW_VERSION}，在线等候你的吩咐。"

package/src/api.ts

@@ -3,7 +3,6 @@
  * [修复版] 已重构为支持多实例并发，消除全局变量冲突
  */
 
-import { createRequire } from "node:module";
 import os from "node:os";
 import { computeFileHash, getCachedFileInfo, setCachedFileInfo } from "./utils/upload-cache.js";
 import { sanitizeFileName } from "./utils/platform.js";
@@ -14,9 +13,8 @@ const TOKEN_URL = "https://bots.qq.com/app/getAppAccessToken";
 // ============ Plugin User-Agent ============
 // 格式: QQBotPlugin/{version} (Node/{nodeVersion}; {os})
 // 示例: QQBotPlugin/1.6.0 (Node/22.14.0; darwin)
-const _require = createRequire(import.meta.url);
-let _pluginVersion = "unknown";
-try { _pluginVersion = _require("../package.json").version ?? "unknown"; } catch { /* fallback */ }
+import { getPackageVersion } from "./utils/pkg-version.js";
+const _pluginVersion = getPackageVersion(import.meta.url);
 export const PLUGIN_USER_AGENT = `QQBotPlugin/${_pluginVersion} (Node/${process.versions.node}; ${os.platform()})`;
 
 // 运行时配置
@@ -285,22 +283,48 @@ export async function apiRequest<T = unknown>(
   const traceId = res.headers.get("x-tps-trace-id") ?? "";
   console.log(`[qqbot-api] <<< Status: ${res.status} ${res.statusText}${traceId ? ` | TraceId: ${traceId}` : ""}`);
 
-  let data: T;
   let rawBody: string;
   try {
     rawBody = await res.text();
-    console.log(`[qqbot-api] <<< Body:`, rawBody);
-    data = JSON.parse(rawBody) as T;
   } catch (err) {
-    throw new Error(`Failed to parse response[${path}]: ${err instanceof Error ? err.message : String(err)}`);
+    throw new Error(`读取响应失败[${path}]: ${err instanceof Error ? err.message : String(err)}`);
   }
+  console.log(`[qqbot-api] <<< Body:`, rawBody);
+
+  // 检测非 JSON 响应（HTML 网关错误页 / CDN 限流页等）
+  const contentType = res.headers.get("content-type") ?? "";
+  const isHtmlResponse = contentType.includes("text/html") || rawBody.trimStart().startsWith("<");
 
   if (!res.ok) {
-    const error = data as { message?: string; code?: number };
-    throw new Error(`API Error [${path}]: ${error.message ?? JSON.stringify(data)}`);
+    if (isHtmlResponse) {
+      // HTML 响应 = 网关/限流层返回的错误页，给出友好提示
+      const statusHint = res.status === 502 || res.status === 503 || res.status === 504
+        ? "调用发生异常，请稍候重试"
+        : res.status === 429
+          ? "请求过于频繁，已被限流"
+          : `开放平台返回 HTTP ${res.status}`;
+      throw new Error(`${statusHint}（${path}），请稍后重试`);
+    }
+    // JSON 错误响应
+    try {
+      const error = JSON.parse(rawBody) as { message?: string; code?: number };
+      throw new Error(`API Error [${path}]: ${error.message ?? rawBody}`);
+    } catch (parseErr) {
+      if (parseErr instanceof Error && parseErr.message.startsWith("API Error")) throw parseErr;
+      throw new Error(`API Error [${path}] HTTP ${res.status}: ${rawBody.slice(0, 200)}`);
+    }
   }
 
-  return data;
+  // 成功响应但不是 JSON（极端异常情况）
+  if (isHtmlResponse) {
+    throw new Error(`QQ 服务端返回了非 JSON 响应（${path}），可能是临时故障，请稍后重试`);
+  }
+
+  try {
+    return JSON.parse(rawBody) as T;
+  } catch {
+    throw new Error(`开放平台响应格式异常（${path}），请稍后重试`);
+  }
 }
 
 // ============ 上传重试（指数退避） ============

package/src/slash-commands.ts

@@ -20,16 +20,10 @@ import { getUpdateInfo, checkVersionExists } from "./update-checker.js";
 import { getHomeDir, getQQBotDataDir, isWindows } from "./utils/platform.js";
 import { saveCredentialBackup } from "./credential-backup.js";
 import { fileURLToPath } from "node:url";
+import { getPackageVersion } from "./utils/pkg-version.js";
 const require = createRequire(import.meta.url);
 
-// 读取 package.json 中的版本号
-let PLUGIN_VERSION = "unknown";
-try {
-  const pkg = require("../package.json");
-  PLUGIN_VERSION = pkg.version ?? "unknown";
-} catch {
-  // fallback
-}
+let PLUGIN_VERSION = getPackageVersion(import.meta.url);
 
 // 获取 openclaw 框架版本（缓存结果，只执行一次）
 let _frameworkVersion: string | null = null;

package/src/update-checker.ts

@@ -10,6 +10,7 @@
 
 import { createRequire } from "node:module";
 import https from "node:https";
+import { getPackageVersion } from "./utils/pkg-version.js";
 
 const require = createRequire(import.meta.url);
 
@@ -21,13 +22,7 @@ const REGISTRIES = [
   `https://registry.npmmirror.com/${ENCODED_PKG}`,
 ];
 
-let CURRENT_VERSION = "unknown";
-try {
-  const pkg = require("../package.json");
-  CURRENT_VERSION = pkg.version ?? "unknown";
-} catch {
-  // fallback
-}
+let CURRENT_VERSION = getPackageVersion(import.meta.url);
 
 export interface UpdateInfo {
   current: string;

package/src/utils/pkg-version.ts

@@ -0,0 +1,54 @@
+/**
+ * 从 import.meta.url 向上遍历目录树查找 package.json 并读取 version。
+ * 不依赖硬编码的 "../" 层级，无论编译输出结构如何变化都能可靠找到。
+ */
+
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import path from "node:path";
+import fs from "node:fs";
+
+let _cached: string | null = null;
+
+export function getPackageVersion(metaUrl?: string): string {
+  if (_cached !== null) return _cached;
+
+  // Strategy 1: 从调用者的 import.meta.url（或本模块）向上遍历找 package.json
+  const startFile = metaUrl ? fileURLToPath(metaUrl) : fileURLToPath(import.meta.url);
+  let dir = path.dirname(startFile);
+  const root = path.parse(dir).root;
+
+  while (dir !== root) {
+    const candidate = path.join(dir, "package.json");
+    try {
+      if (fs.existsSync(candidate)) {
+        const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
+        // 确认是我们自己的包（避免找到其他 package.json）
+        if (pkg.name === "@tencent-connect/openclaw-qqbot" && pkg.version) {
+          _cached = pkg.version as string;
+          return _cached;
+        }
+      }
+    } catch {
+      // ignore and try parent
+    }
+    dir = path.dirname(dir);
+  }
+
+  // Strategy 2: fallback 用 createRequire 尝试常见相对路径
+  try {
+    const require = createRequire(metaUrl ?? import.meta.url);
+    for (const rel of ["../../package.json", "../package.json", "./package.json"]) {
+      try {
+        const pkg = require(rel);
+        if (pkg?.version) {
+          _cached = pkg.version as string;
+          return _cached;
+        }
+      } catch { /* next */ }
+    }
+  } catch { /* fallback */ }
+
+  _cached = "unknown";
+  return _cached;
+}