@leoqlin/openclaw-qqbot 1.6.14 → 1.6.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leoqlin/openclaw-qqbot",
-  "version": "1.6.14",
+  "version": "1.6.16",
   "publishConfig": {
     "access": "public"
   },

package/skills/qqbot-upgrade/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qqbot-upgrade
-description: 通过官方脚本将 openclaw-qqbot 插件升级到最新 npm 版本。当用户要求更新 QQ 机器人插件、升级 qqbot 扩展或同步官方最新版时使用。
+description: 检查 openclaw-qqbot 插件是否有新版本，告知用户版本信息，经用户确认后再通过官方脚本升级。当用户询问 QQ 机器人插件是否有更新、要求升级 qqbot 扩展或同步官方最新版时使用。
 metadata: {"openclaw":{"emoji":"⬆️","requires":{"config":["channels.qqbot"]}}}
 ---
 
@@ -8,15 +8,43 @@ metadata: {"openclaw":{"emoji":"⬆️","requires":{"config":["channels.qqbot"]}
 
 ## 何时使用
 
-用户表达以下意图时，应在**本机终端**执行升级命令（不要只口头说明「去官网升级」）：
+用户表达以下意图时触发此技能：
 
+- 询问 `openclaw-qqbot` 或 QQBot 插件**是否有新版本**
 - 更新 / 升级 `openclaw-qqbot` 或 QQBot 插件
 - 拉取官方最新 npm 包
 - 执行与「upgrade-via-npm」相关的操作
 
 ---
 
-## 标准命令
+## 执行流程（必须严格按顺序）
+
+### 第 1 步：查询版本信息
+
+先分别获取**本地已安装版本**和 **npm 远端最新版本**，在终端执行：
+
+```bash
+# 本地版本（在扩展目录读取 package.json）
+LOCAL_VER=$(node -e "console.log(require('～/.openclaw/extensions/openclaw-qqbot/package.json').version)" 2>/dev/null || echo "未知")
+
+# 远端最新版本
+REMOTE_VER=$(npm view @leoqlin/openclaw-qqbot version 2>/dev/null || echo "查询失败")
+
+echo "本地版本: $LOCAL_VER"
+echo "远端最新: $REMOTE_VER"
+```
+
+### 第 2 步：向用户报告并等待确认
+
+将查询结果**清晰地告知用户**，例如：
+
+> 当前本地版本：x.y.z，npm 最新版本：a.b.c。
+
+- 若版本相同，告知用户「已是最新版本，无需升级」，**流程结束**。
+- 若有新版本，**必须先告知用户升级预计耗时及影响，再询问是否升级**，例如：「发现新版本 a.b.c（当前 x.y.z）。升级预计需要 5–10 分钟，升级过程中无法回复消息，请耐心等待。是否要升级？」
+- ⚠️ **禁止跳过此步骤直接执行升级命令。必须等用户明确回复确认（如「好」「是」「升级」「确认」等肯定表达）后，才进入第 3 步。**
+
+### 第 3 步：执行升级（仅在用户确认后）
 
 在 **bash** 环境中执行（需已安装 `curl`，且能访问 GitHub）：
 
@@ -47,3 +75,5 @@ curl -fsSL https://raw.githubusercontent.com/leol1024/openclaw-qqbot/feat/stream
 ## 执行后
 
 根据脚本退出码与终端输出向用户简要汇报：成功则说明已按官方流程升级；失败则摘录关键错误并提示检查网络、Node/npm 与权限。
+
+- ⚠️ **升级脚本已包含自动重启 gateway 的步骤，升级成功后不要再提示用户手动重启 gateway。**