@tencent-connect/openclaw-qqbot 1.6.2-alpha.3 → 1.6.3

package/README.md

@@ -149,9 +149,9 @@ AI can send videos directly. Supports local files and URLs.
 
 The plugin provides built-in slash commands that are intercepted before reaching the AI queue, giving instant responses for diagnostics and management.
 
-#### `/qqbot-ping` — Latency Test
+#### `/bot-ping` — Latency Test
 
-> **You**: `/qqbot-ping`
+> **You**: `/bot-ping`
 >
 > **QQBot**: ✅ pong！⏱ Latency: 602ms (network: 602ms, plugin: 0ms)
 
@@ -159,9 +159,9 @@ Measures end-to-end latency from QQ server push to plugin response, broken down
 
 <img width="360" src="docs/images/slash-ping.jpg" alt="Ping Demo" />
 
-#### `/qqbot-version` — Version Info
+#### `/bot-version` — Version Info
 
-> **You**: `/qqbot-version`
+> **You**: `/bot-version`
 >
 > **QQBot**: 🦞 Framework: OpenClaw 2026.3.13 (61d171a) / 🤖 Plugin: v1.6.2 / 🌟 GitHub repo
 
@@ -169,17 +169,17 @@ Shows framework version, plugin version, and a direct link to the official repos
 
 <img width="360" src="docs/images/slash-version.jpg" alt="Version Demo" />
 
-#### `/qqbot-help` — Command List
+#### `/bot-help` — Command List
 
-> **You**: `/qqbot-help`
+> **You**: `/bot-help`
 >
 > **QQBot**: Lists all available slash commands with clickable shortcuts.
 
 <img width="360" src="docs/images/slash-help.jpg" alt="Help Demo" />
 
-#### `/qqbot-upgrade` — Upgrade Guide
+#### `/bot-upgrade` — Upgrade Guide
 
-> **You**: `/qqbot-upgrade`
+> **You**: `/bot-upgrade`
 >
 > **QQBot**: 📌 Current version / ✅ Up to date / ⬆️ Upgrade guide / 🌟 GitHub repo
 
@@ -187,9 +187,9 @@ Shows current version, update status, upgrade guide link, and official repositor
 
 <img width="360" src="docs/images/slash-upgrade.jpg" alt="Upgrade Demo" /> 
 
-#### `/qqbot-logs` — Log Export
+#### `/bot-logs` — Log Export
 
-> **You**: `/qqbot-logs`
+> **You**: `/bot-logs`
 >
 > **QQBot**: 📋 Logs packaged (~2000 lines), sending file... *(sends a .txt file)*
 

package/README.zh.md

@@ -144,9 +144,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 插件内置一组斜杠指令，在消息进入 AI 队列前拦截处理，即时响应，用于诊断和管理。
 
-#### `/qqbot-ping` — 延迟测试
+#### `/bot-ping` — 延迟测试
 
-> **你**：`/qqbot-ping`
+> **你**：`/bot-ping`
 >
 > **QQBot**：✅ pong！⏱ 延迟: 602ms（网络传输: 602ms，插件处理: 0ms）
 
@@ -154,9 +154,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-ping.jpg" alt="Ping 演示" />
 
-#### `/qqbot-version` — 版本信息
+#### `/bot-version` — 版本信息
 
-> **你**：`/qqbot-version`
+> **你**：`/bot-version`
 >
 > **QQBot**：🦞框架版本：OpenClaw 2026.3.13 (61d171a) / 🤖QQBot 插件版本：v1.6.2 / 🌟官方 GitHub 仓库
 
@@ -164,17 +164,17 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-version.jpg" alt="Version 演示" />
 
-#### `/qqbot-help` — 指令列表
+#### `/bot-help` — 指令列表
 
-> **你**：`/qqbot-help`
+> **你**：`/bot-help`
 >
 > **QQBot**：列出所有可用的斜杠指令及说明，指令可点击快速输入。
 
 <img width="360" src="docs/images/slash-help.jpg" alt="Help 演示" />
 
-#### `/qqbot-upgrade` — 升级指引
+#### `/bot-upgrade` — 升级指引
 
-> **你**：`/qqbot-upgrade`
+> **你**：`/bot-upgrade`
 >
 > **QQBot**：📌当前版本 / ✅当前已是最新版本 / ⬆️升级指引 / 🌟官方 GitHub 仓库
 
@@ -182,9 +182,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-upgrade.jpg" alt="Upgrade 演示" /> 
 
-#### `/qqbot-logs` — 日志导出
+#### `/bot-logs` — 日志导出
 
-> **你**：`/qqbot-logs`
+> **你**：`/bot-logs`
 >
 > **QQBot**：📋 日志已打包（约 2000 行），正在发送文件… *（发送 .txt 文件）*
 

package/dist/src/gateway.js

@@ -315,7 +315,7 @@ export async function startGateway(ctx) {
             log?.info(`[qqbot:${account.accountId}] ${w}`);
         }
     }
-    // 后台版本检查（供 /qqbot-version、/qqbot-upgrade 指令被动查询）
+    // 后台版本检查（供 /bot-version、/bot-upgrade 指令被动查询）
     triggerUpdateCheck(log);
     // 初始化 API 配置（markdown 支持）
     initApiConfig({

package/dist/src/slash-commands.js

@@ -58,10 +58,10 @@ function registerCommand(cmd) {
 }
 // ============ 内置指令 ============
 /**
- * /qqbot-ping — 测试当前 openclaw 与 QQ 连接的网络延迟
+ * /bot-ping — 测试当前 openclaw 与 QQ 连接的网络延迟
  */
 registerCommand({
-    name: "qqbot-ping",
+    name: "bot-ping",
     description: "测试当前 openclaw 与 QQ 连接的网络延迟",
     handler: (ctx) => {
         const now = Date.now();
@@ -83,10 +83,10 @@ registerCommand({
     },
 });
 /**
- * /qqbot-version — 查看插件版本号
+ * /bot-version — 查看插件版本号
  */
 registerCommand({
-    name: "qqbot-version",
+    name: "bot-version",
     description: "查看插件版本号",
     handler: () => {
         const frameworkVersion = getFrameworkVersion();
@@ -102,17 +102,17 @@ registerCommand({
             lines.push(`⚠️ 版本检查失败`);
         }
         else if (info.hasUpdate && info.latest) {
-            lines.push(`🆕最新可用版本：v${info.latest}，点击 <qqbot-cmd-input text="/qqbot-upgrade" show="/qqbot-upgrade"/> 查看升级指引`);
+            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");
     },
 });
 /**
- * /qqbot-help — 查看所有指令以及用途
+ * /bot-help — 查看所有指令以及用途
  */
 registerCommand({
-    name: "qqbot-help",
+    name: "bot-help",
     description: "查看所有指令以及用途",
     handler: () => {
         const lines = [`### QQBot插件内置调试指令`, ``];
@@ -125,10 +125,10 @@ registerCommand({
 });
 const DEFAULT_UPGRADE_URL = "https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg";
 /**
- * /qqbot-upgrade — 查看版本更新状态 + 升级指引
+ * /bot-upgrade — 查看版本更新状态 + 升级指引
  */
 registerCommand({
-    name: "qqbot-upgrade",
+    name: "bot-upgrade",
     description: "查看版本更新与升级指引",
     handler: (ctx) => {
         const url = ctx.accountConfig?.upgradeUrl || DEFAULT_UPGRADE_URL;
@@ -153,10 +153,10 @@ registerCommand({
     },
 });
 /**
- * /qqbot-logs — 导出本地日志文件
+ * /bot-logs — 导出本地日志文件
  */
 registerCommand({
-    name: "qqbot-logs",
+    name: "bot-logs",
     description: "导出本地日志文件",
     handler: () => {
         const homeDir = process.env.HOME || "~";
@@ -190,7 +190,7 @@ registerCommand({
             fs.mkdirSync(tmpDir, { recursive: true });
         }
         const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-        const tmpFile = path.join(tmpDir, `qqbot-logs-${timestamp}.txt`);
+        const tmpFile = path.join(tmpDir, `bot-logs-${timestamp}.txt`);
         fs.writeFileSync(tmpFile, lines.join("\n"), "utf8");
         const totalLines = lines.filter(l => !l.startsWith("=")).length;
         return {

package/dist/src/types.d.ts

@@ -58,7 +58,7 @@ export interface QQBotAccountConfig {
      */
     urlDirectUpload?: boolean;
     /**
-     * /qqbot-upgrade 指令返回的升级指引网址
+     * /bot-upgrade 指令返回的升级指引网址
      * 默认: https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg
      */
     upgradeUrl?: string;

package/dist/src/update-checker.d.ts

@@ -2,8 +2,10 @@
  * 后台版本检查器
  *
  * - triggerUpdateCheck(): gateway 启动时调用，后台检查 npm registry 是否有新版本
- * - getUpdateInfo(): 返回上次检查结果（供 /qqbot-version、/qqbot-help 指令使用）
- * - formatUpdateNotice(): 格式化更新提示文本
+ * - getUpdateInfo(): 返回上次检查结果（供 /bot-version、/bot-help 指令使用）
+ *
+ * 使用 HTTPS 直接请求 npm registry API（不依赖 npm CLI），
+ * 支持多 registry fallback：npmjs.org → npmmirror.com，解决国内网络问题。
  */
 export interface UpdateInfo {
     current: string;

package/dist/src/update-checker.js

@@ -2,13 +2,20 @@
  * 后台版本检查器
  *
  * - triggerUpdateCheck(): gateway 启动时调用，后台检查 npm registry 是否有新版本
- * - getUpdateInfo(): 返回上次检查结果（供 /qqbot-version、/qqbot-help 指令使用）
- * - formatUpdateNotice(): 格式化更新提示文本
+ * - getUpdateInfo(): 返回上次检查结果（供 /bot-version、/bot-help 指令使用）
+ *
+ * 使用 HTTPS 直接请求 npm registry API（不依赖 npm CLI），
+ * 支持多 registry fallback：npmjs.org → npmmirror.com，解决国内网络问题。
  */
 import { createRequire } from "node:module";
-import { execFile } from "node:child_process";
+import https from "node:https";
 const require = createRequire(import.meta.url);
 const PKG_NAME = "@tencent-connect/openclaw-qqbot";
+const ENCODED_PKG = encodeURIComponent(PKG_NAME);
+const REGISTRIES = [
+    `https://registry.npmjs.org/${ENCODED_PKG}`,
+    `https://registry.npmmirror.com/${ENCODED_PKG}`,
+];
 let CURRENT_VERSION = "unknown";
 try {
     const pkg = require("../package.json");
@@ -24,6 +31,43 @@ let _lastInfo = {
     checkedAt: 0,
 };
 let _checking = false;
+function fetchJson(url, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const req = https.get(url, { timeout: timeoutMs, headers: { Accept: "application/json" } }, (res) => {
+            if (res.statusCode !== 200) {
+                res.resume();
+                reject(new Error(`HTTP ${res.statusCode} from ${url}`));
+                return;
+            }
+            let data = "";
+            res.on("data", (chunk) => { data += chunk; });
+            res.on("end", () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch (e) {
+                    reject(e);
+                }
+            });
+        });
+        req.on("error", reject);
+        req.on("timeout", () => { req.destroy(); reject(new Error(`timeout fetching ${url}`)); });
+    });
+}
+async function fetchDistTags(log) {
+    for (const url of REGISTRIES) {
+        try {
+            const json = await fetchJson(url, 10_000);
+            const tags = json["dist-tags"];
+            if (tags && typeof tags === "object")
+                return tags;
+        }
+        catch (e) {
+            log?.debug?.(`[qqbot:update-checker] ${url} failed: ${e.message}`);
+        }
+    }
+    throw new Error("all registries failed");
+}
 export function triggerUpdateCheck(log) {
     if (_checking)
         return;
@@ -33,33 +77,25 @@ export function triggerUpdateCheck(log) {
     }
     _checking = true;
     log?.debug?.(`[qqbot:update-checker] checking (current: ${CURRENT_VERSION})...`);
-    // 获取 dist-tags，同时比较 latest 和 alpha 通道
-    execFile("npm", ["view", PKG_NAME, "dist-tags", "--json"], { timeout: 15_000, env: { ...process.env, PATH: process.env.PATH } }, (err, stdout, _stderr) => {
-        _checking = false;
+    fetchDistTags(log).then((tags) => {
         const now = Date.now();
-        if (err) {
-            log?.debug?.(`[qqbot:update-checker] check failed: ${err.message}`);
-            _lastInfo = { current: CURRENT_VERSION, latest: null, hasUpdate: false, checkedAt: now, error: err.message };
-            return;
-        }
-        try {
-            const tags = JSON.parse(stdout.trim());
-            // 当前是 prerelease → 和 alpha 通道比；正式版 → 和 latest 通道比
-            const currentIsPrerelease = CURRENT_VERSION.includes("-");
-            const compareTarget = currentIsPrerelease
-                ? (tags.alpha || tags.latest || null)
-                : (tags.latest || null);
-            const hasUpdate = typeof compareTarget === "string"
-                && compareTarget !== CURRENT_VERSION
-                && compareVersions(compareTarget, CURRENT_VERSION) > 0;
-            _lastInfo = { current: CURRENT_VERSION, latest: compareTarget, hasUpdate, checkedAt: now };
-            if (hasUpdate) {
-                log?.info?.(`[qqbot:update-checker] new version available: ${compareTarget} (current: ${CURRENT_VERSION})`);
-            }
-        }
-        catch (parseErr) {
-            _lastInfo = { current: CURRENT_VERSION, latest: null, hasUpdate: false, checkedAt: now, error: String(parseErr) };
+        const currentIsPrerelease = CURRENT_VERSION.includes("-");
+        const compareTarget = currentIsPrerelease
+            ? (tags.alpha || tags.latest || null)
+            : (tags.latest || null);
+        const hasUpdate = typeof compareTarget === "string"
+            && compareTarget !== CURRENT_VERSION
+            && compareVersions(compareTarget, CURRENT_VERSION) > 0;
+        _lastInfo = { current: CURRENT_VERSION, latest: compareTarget, hasUpdate, checkedAt: now };
+        if (hasUpdate) {
+            log?.info?.(`[qqbot:update-checker] new version available: ${compareTarget} (current: ${CURRENT_VERSION})`);
         }
+    }).catch((err) => {
+        const now = Date.now();
+        log?.debug?.(`[qqbot:update-checker] check failed: ${err.message}`);
+        _lastInfo = { current: CURRENT_VERSION, latest: null, hasUpdate: false, checkedAt: now, error: err.message };
+    }).finally(() => {
+        _checking = false;
     });
 }
 export function getUpdateInfo() {

package/package.json

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

package/scripts/upgrade-via-npm.sh

@@ -115,7 +115,18 @@ EXTRACT_DIR=$(mktemp -d)
 trap "rm -rf '$TMPDIR_PACK' '$EXTRACT_DIR'" EXIT
 
 cd "$TMPDIR_PACK"
-npm pack "$INSTALL_SRC" --quiet 2>&1 || { echo "❌ npm pack 失败"; exit 1; }
+# 多 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"

package/src/gateway.ts

@@ -411,7 +411,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
     }
   }
 
-  // 后台版本检查（供 /qqbot-version、/qqbot-upgrade 指令被动查询）
+  // 后台版本检查（供 /bot-version、/bot-upgrade 指令被动查询）
   triggerUpdateCheck(log);
 
   // 初始化 API 配置（markdown 支持）

package/src/slash-commands.ts

@@ -127,10 +127,10 @@ function registerCommand(cmd: SlashCommand): void {
 // ============ 内置指令 ============
 
 /**
- * /qqbot-ping — 测试当前 openclaw 与 QQ 连接的网络延迟
+ * /bot-ping — 测试当前 openclaw 与 QQ 连接的网络延迟
  */
 registerCommand({
-  name: "qqbot-ping",
+  name: "bot-ping",
   description: "测试当前 openclaw 与 QQ 连接的网络延迟",
   handler: (ctx) => {
     const now = Date.now();
@@ -153,10 +153,10 @@ registerCommand({
 });
 
 /**
- * /qqbot-version — 查看插件版本号
+ * /bot-version — 查看插件版本号
  */
 registerCommand({
-  name: "qqbot-version",
+  name: "bot-version",
   description: "查看插件版本号",
   handler: () => {
     const frameworkVersion = getFrameworkVersion();
@@ -170,7 +170,7 @@ registerCommand({
     } else if (info.error) {
       lines.push(`⚠️ 版本检查失败`);
     } else if (info.hasUpdate && info.latest) {
-      lines.push(`🆕最新可用版本：v${info.latest}，点击 <qqbot-cmd-input text="/qqbot-upgrade" show="/qqbot-upgrade"/> 查看升级指引`);
+      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");
@@ -178,10 +178,10 @@ registerCommand({
 });
 
 /**
- * /qqbot-help — 查看所有指令以及用途
+ * /bot-help — 查看所有指令以及用途
  */
 registerCommand({
-  name: "qqbot-help",
+  name: "bot-help",
   description: "查看所有指令以及用途",
   handler: () => {
     const lines = [`### QQBot插件内置调试指令`, ``];
@@ -196,10 +196,10 @@ registerCommand({
 const DEFAULT_UPGRADE_URL = "https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg";
 
 /**
- * /qqbot-upgrade — 查看版本更新状态 + 升级指引
+ * /bot-upgrade — 查看版本更新状态 + 升级指引
  */
 registerCommand({
-  name: "qqbot-upgrade",
+  name: "bot-upgrade",
   description: "查看版本更新与升级指引",
   handler: (ctx) => {
     const url = ctx.accountConfig?.upgradeUrl || DEFAULT_UPGRADE_URL;
@@ -225,10 +225,10 @@ registerCommand({
 });
 
 /**
- * /qqbot-logs — 导出本地日志文件
+ * /bot-logs — 导出本地日志文件
  */
 registerCommand({
-  name: "qqbot-logs",
+  name: "bot-logs",
   description: "导出本地日志文件",
   handler: () => {
     const homeDir = process.env.HOME || "~";
@@ -264,7 +264,7 @@ registerCommand({
       fs.mkdirSync(tmpDir, { recursive: true });
     }
     const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-    const tmpFile = path.join(tmpDir, `qqbot-logs-${timestamp}.txt`);
+    const tmpFile = path.join(tmpDir, `bot-logs-${timestamp}.txt`);
     fs.writeFileSync(tmpFile, lines.join("\n"), "utf8");
 
     const totalLines = lines.filter(l => !l.startsWith("=")).length;

package/src/types.ts

@@ -60,7 +60,7 @@ export interface QQBotAccountConfig {
    */
   urlDirectUpload?: boolean;
   /**
-   * /qqbot-upgrade 指令返回的升级指引网址
+   * /bot-upgrade 指令返回的升级指引网址
    * 默认: https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg
    */
   upgradeUrl?: string;

package/src/update-checker.ts

@@ -2,16 +2,24 @@
  * 后台版本检查器
  *
  * - triggerUpdateCheck(): gateway 启动时调用，后台检查 npm registry 是否有新版本
- * - getUpdateInfo(): 返回上次检查结果（供 /qqbot-version、/qqbot-help 指令使用）
- * - formatUpdateNotice(): 格式化更新提示文本
+ * - getUpdateInfo(): 返回上次检查结果（供 /bot-version、/bot-help 指令使用）
+ *
+ * 使用 HTTPS 直接请求 npm registry API（不依赖 npm CLI），
+ * 支持多 registry fallback：npmjs.org → npmmirror.com，解决国内网络问题。
  */
 
 import { createRequire } from "node:module";
-import { execFile } from "node:child_process";
+import https from "node:https";
 
 const require = createRequire(import.meta.url);
 
 const PKG_NAME = "@tencent-connect/openclaw-qqbot";
+const ENCODED_PKG = encodeURIComponent(PKG_NAME);
+
+const REGISTRIES = [
+  `https://registry.npmjs.org/${ENCODED_PKG}`,
+  `https://registry.npmmirror.com/${ENCODED_PKG}`,
+];
 
 let CURRENT_VERSION = "unknown";
 try {
@@ -38,6 +46,38 @@ let _lastInfo: UpdateInfo = {
 
 let _checking = false;
 
+function fetchJson(url: string, timeoutMs: number): Promise<any> {
+  return new Promise((resolve, reject) => {
+    const req = https.get(url, { timeout: timeoutMs, headers: { Accept: "application/json" } }, (res) => {
+      if (res.statusCode !== 200) {
+        res.resume();
+        reject(new Error(`HTTP ${res.statusCode} from ${url}`));
+        return;
+      }
+      let data = "";
+      res.on("data", (chunk: string) => { data += chunk; });
+      res.on("end", () => {
+        try { resolve(JSON.parse(data)); } catch (e) { reject(e); }
+      });
+    });
+    req.on("error", reject);
+    req.on("timeout", () => { req.destroy(); reject(new Error(`timeout fetching ${url}`)); });
+  });
+}
+
+async function fetchDistTags(log?: { debug?: (msg: string) => void }): Promise<Record<string, string>> {
+  for (const url of REGISTRIES) {
+    try {
+      const json = await fetchJson(url, 10_000);
+      const tags = json["dist-tags"];
+      if (tags && typeof tags === "object") return tags;
+    } catch (e: any) {
+      log?.debug?.(`[qqbot:update-checker] ${url} failed: ${e.message}`);
+    }
+  }
+  throw new Error("all registries failed");
+}
+
 export function triggerUpdateCheck(log?: {
   info: (msg: string) => void;
   error: (msg: string) => void;
@@ -51,38 +91,26 @@ export function triggerUpdateCheck(log?: {
   _checking = true;
   log?.debug?.(`[qqbot:update-checker] checking (current: ${CURRENT_VERSION})...`);
 
-  // 获取 dist-tags，同时比较 latest 和 alpha 通道
-  execFile(
-    "npm",
-    ["view", PKG_NAME, "dist-tags", "--json"],
-    { timeout: 15_000, env: { ...process.env, PATH: process.env.PATH } },
-    (err, stdout, _stderr) => {
-      _checking = false;
-      const now = Date.now();
-      if (err) {
-        log?.debug?.(`[qqbot:update-checker] check failed: ${err.message}`);
-        _lastInfo = { current: CURRENT_VERSION, latest: null, hasUpdate: false, checkedAt: now, error: err.message };
-        return;
-      }
-      try {
-        const tags = JSON.parse(stdout.trim());
-        // 当前是 prerelease → 和 alpha 通道比；正式版 → 和 latest 通道比
-        const currentIsPrerelease = CURRENT_VERSION.includes("-");
-        const compareTarget = currentIsPrerelease
-          ? (tags.alpha || tags.latest || null)
-          : (tags.latest || null);
-        const hasUpdate = typeof compareTarget === "string"
-          && compareTarget !== CURRENT_VERSION
-          && compareVersions(compareTarget, CURRENT_VERSION) > 0;
-        _lastInfo = { current: CURRENT_VERSION, latest: compareTarget, hasUpdate, checkedAt: now };
-        if (hasUpdate) {
-          log?.info?.(`[qqbot:update-checker] new version available: ${compareTarget} (current: ${CURRENT_VERSION})`);
-        }
-      } catch (parseErr) {
-        _lastInfo = { current: CURRENT_VERSION, latest: null, hasUpdate: false, checkedAt: now, error: String(parseErr) };
-      }
-    },
-  );
+  fetchDistTags(log).then((tags) => {
+    const now = Date.now();
+    const currentIsPrerelease = CURRENT_VERSION.includes("-");
+    const compareTarget = currentIsPrerelease
+      ? (tags.alpha || tags.latest || null)
+      : (tags.latest || null);
+    const hasUpdate = typeof compareTarget === "string"
+      && compareTarget !== CURRENT_VERSION
+      && compareVersions(compareTarget, CURRENT_VERSION) > 0;
+    _lastInfo = { current: CURRENT_VERSION, latest: compareTarget, hasUpdate, checkedAt: now };
+    if (hasUpdate) {
+      log?.info?.(`[qqbot:update-checker] new version available: ${compareTarget} (current: ${CURRENT_VERSION})`);
+    }
+  }).catch((err) => {
+    const now = Date.now();
+    log?.debug?.(`[qqbot:update-checker] check failed: ${err.message}`);
+    _lastInfo = { current: CURRENT_VERSION, latest: null, hasUpdate: false, checkedAt: now, error: err.message };
+  }).finally(() => {
+    _checking = false;
+  });
 }
 
 export function getUpdateInfo(): UpdateInfo {