@tencent-connect/openclaw-qqbot 1.6.0-alpha.1 → 1.6.0-alpha.2

package/package.json

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

package/scripts/upgrade-via-source.sh

@@ -186,6 +186,19 @@ INSTALL_LOG="/tmp/openclaw-install-$(date +%s).log"
 echo "安装日志文件: $INSTALL_LOG"
 echo "详细信息将记录到日志文件中..."
 
+# 安装前先 stop gateway，防止 chokidar 在 plugins install 写入配置的中间状态
+# 触发 restart，导致 "unknown channel id: qqbot" 等错误
+_gw_was_running=0
+if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
+    _gw_was_running=1
+    echo "  暂停 gateway 服务（避免安装过程中中间状态 restart）..."
+    openclaw gateway stop 2>/dev/null || true
+    sleep 1
+fi
+
+# 清理之前可能残留的 staging 目录
+find "$HOME/.openclaw/extensions/" -maxdepth 1 -name ".openclaw-install-stage-*" -exec rm -rf {} + 2>/dev/null || true
+
 # 尝试安装并捕获详细输出
 if ! openclaw plugins install . 2>&1 | tee "$INSTALL_LOG"; then
     echo ""
@@ -243,9 +256,70 @@ if ! openclaw plugins install . 2>&1 | tee "$INSTALL_LOG"; then
     esac
 else
     echo ""
-    echo "✅ 插件安装成功！"
+    echo "✅ 插件安装命令执行完成"
     echo "安装日志已保存到: $INSTALL_LOG"
 
+    # 验证插件目录是否真正创建（防止 "安装成功" 但目录缺失的情况）
+    _plugin_dir_ok=0
+    for _candidate_name in openclaw-qqbot qqbot openclaw-qq; do
+        if [ -d "$HOME/.openclaw/extensions/$_candidate_name" ] && \
+           [ -f "$HOME/.openclaw/extensions/$_candidate_name/package.json" ]; then
+            _plugin_dir_ok=1
+            echo "  ✅ 插件目录验证通过: ~/.openclaw/extensions/$_candidate_name/"
+            break
+        fi
+    done
+    if [ "$_plugin_dir_ok" -eq 0 ]; then
+        echo ""
+        echo "⚠️  警告: 插件目录不存在！安装命令返回成功但目录未创建"
+        echo "  可能原因: staging 目录未正确 rename（参考 openclaw/issues）"
+        echo "  检查 staging 残留:"
+        ls -la "$HOME/.openclaw/extensions/" 2>/dev/null
+        echo ""
+        echo "  尝试自动修复: 清理残留并重试安装..."
+        find "$HOME/.openclaw/extensions/" -maxdepth 1 -name ".openclaw-install-stage-*" -exec rm -rf {} + 2>/dev/null || true
+        if openclaw plugins install . 2>&1 | tee -a "$INSTALL_LOG"; then
+            for _candidate_name in openclaw-qqbot qqbot openclaw-qq; do
+                if [ -d "$HOME/.openclaw/extensions/$_candidate_name" ]; then
+                    _plugin_dir_ok=1
+                    echo "  ✅ 重试安装成功: ~/.openclaw/extensions/$_candidate_name/"
+                    break
+                fi
+            done
+        fi
+        if [ "$_plugin_dir_ok" -eq 0 ]; then
+            echo "  ❌ 重试安装仍失败，插件目录不存在"
+            echo "  请手动排查: ls -la ~/.openclaw/extensions/"
+            # 清理无效的配置条目，防止 gateway 启动时报错
+            echo "  清理无效的配置条目..."
+            node -e "
+              const fs = require('fs');
+              const path = require('path');
+              for (const app of ['openclaw', 'clawdbot', 'moltbot']) {
+                const f = path.join(process.env.HOME, '.' + app, app + '.json');
+                if (!fs.existsSync(f)) continue;
+                const cfg = JSON.parse(fs.readFileSync(f, 'utf8'));
+                let changed = false;
+                // 移除 channels.qqbot（插件未加载时此配置会导致 unknown channel id 错误）
+                if (cfg.channels && cfg.channels.qqbot) { delete cfg.channels.qqbot; changed = true; }
+                // 清理 plugins.allow 中的 openclaw-qqbot
+                if (cfg.plugins && Array.isArray(cfg.plugins.allow)) {
+                  cfg.plugins.allow = cfg.plugins.allow.filter(x => x !== 'openclaw-qqbot');
+                  changed = true;
+                }
+                if (changed) fs.writeFileSync(f, JSON.stringify(cfg, null, 4) + '\n');
+                break;
+              }
+            " 2>/dev/null || true
+            echo "  已清理无效配置，gateway 可正常启动（无 qqbot 插件状态）"
+            read -t 10 -p "是否继续? (y/N): " _cont || _cont="N"
+            case "$_cont" in
+                [Yy]* ) echo "继续..." ;;
+                * ) exit 1 ;;
+            esac
+        fi
+    fi
+
     # 清理多余的 peerDependencies 传递依赖（兼容旧版 openclaw）：
     # openclaw v2026.3.4 之前的 plugins install 缺少 --omit=peer，会把 peerDeps
     # （openclaw 平台及其 400+ 传递依赖）也安装到插件 node_modules 中。
@@ -310,31 +384,8 @@ else
         fi
     fi
 
-    # plugins install 一次性写入 openclaw.json（plugins.allow/entries/installs），
-    # 如果 gateway 正在运行，chokidar watcher 会检测到变化并自动 restart。
-    # 如果 gateway 未运行，则无需等待（最终 Step 6 会启动）。
-    echo ""
-    if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
-        echo "等待 gateway 自动重启完成..."
-        _gw_restarted=0
-        for _w in $(seq 1 20); do
-            sleep 1
-            if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
-                sleep 2
-                if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
-                    _gw_restarted=1
-                    break
-                fi
-            fi
-        done
-        if [ "$_gw_restarted" -eq 1 ]; then
-            echo "  gateway 已自动重启完成"
-        else
-            echo "  等待超时，将在最后一步重新启动"
-        fi
-    else
-        echo "  gateway 当前未运行，跳过自动重启等待（将在最后一步启动）"
-    fi
+    # gateway 已在安装前 stop，此时不会有自动 restart 的问题
+    # 所有配置写入完成后，在 Step 6 统一启动
 
     # 记录更新后的 qqbot 插件版本
     NEW_QQBOT_VERSION=$(node -e '
@@ -528,52 +579,33 @@ start_choice=$(printf '%s' "$start_choice" | tr '[:upper:]' '[:lower:]')
 case "$start_choice" in
     y|yes)
         echo ""
-        # plugins install 已触发自动 restart（Step 3 已等待完成），
-        # channels add / config set 只触发 hot reload（无需 restart）。
-        # 这里仍做一次显式 restart 作为兜底，确保插件正确加载。
-        # 如果 gateway 当前已在监听端口，先检查是否真需要 restart。
-        _need_restart=1
-        if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
-            # gateway 已在运行，如果 Step 3 的自动 restart 已成功加载新插件，
-            # 且 Step 4/5 只做了 hot reload，理论上不需要再 restart。
-            # 但为安全起见：如果版本有变化或配置有变化，仍 restart 一次。
-            if [ "$OLD_QQBOT_VERSION" = "$NEW_QQBOT_VERSION" ] && [ "${_config_changed:-0}" -eq 0 ]; then
-                echo "插件版本未变化且配置无变更，跳过冗余重启"
-                _need_restart=0
-            fi
-        fi
-
-        if [ "$_need_restart" -eq 1 ]; then
-            echo "正在后台重启 openclaw 网关服务..."
-            _restart_output=$(openclaw gateway restart 2>&1) || true
-            echo "$_restart_output"
+        # gateway 在 Step 3 安装前已 stop，此处统一 restart
+        echo "正在后台重启 openclaw 网关服务..."
+        _restart_output=$(openclaw gateway restart 2>&1) || true
+        echo "$_restart_output"
 
-            if echo "$_restart_output" | grep -qi "not loaded\|not found\|not running\|not installed"; then
-                # gateway 服务未加载（常见于首次安装或 launchd 服务被卸载的情况）
-                # 正确恢复流程：install 注册 launchd plist → start 启动服务
-                echo ""
-                echo "⚠️  gateway 服务未加载，尝试自动恢复..."
-                echo ""
-                echo "  [1/2] 注册 gateway 服务..."
-                _install_out=$(openclaw gateway install 2>&1) || true
-                echo "  $_install_out"
+        if echo "$_restart_output" | grep -qi "not loaded\|not found\|not running\|not installed"; then
+            echo ""
+            echo "⚠️  gateway 服务未加载，尝试自动恢复..."
+            echo ""
+            echo "  [1/2] 注册 gateway 服务..."
+            _install_out=$(openclaw gateway install 2>&1) || true
+            echo "  $_install_out"
+            echo ""
+            echo "  [2/2] 启动 gateway 服务..."
+            _start_out=$(openclaw gateway start 2>&1) || true
+            echo "  $_start_out"
+            if echo "$_start_out" | grep -qi "restart\|started\|bootstrap"; then
                 echo ""
-                echo "  [2/2] 启动 gateway 服务..."
-                _start_out=$(openclaw gateway start 2>&1) || true
-                echo "  $_start_out"
-                # 检查恢复是否成功
-                if echo "$_start_out" | grep -qi "restart\|started\|bootstrap"; then
-                    echo ""
-                    echo "✅ gateway 服务恢复成功"
-                else
-                    echo ""
-                    echo "⚠️  自动恢复可能失败，请手动执行："
-                    echo "  openclaw gateway install && openclaw gateway start"
-                fi
+                echo "✅ gateway 服务恢复成功"
             else
                 echo ""
-                echo "✅ openclaw 网关已在后台重启"
+                echo "⚠️  自动恢复可能失败，请手动执行："
+                echo "  openclaw gateway install && openclaw gateway start"
             fi
+        else
+            echo ""
+            echo "✅ openclaw 网关已在后台重启"
         fi
         echo ""
         # 等待 gateway 端口就绪
@@ -591,10 +623,26 @@ case "$start_choice" in
         echo ""
 
         if [ "$_port_ready" -eq 0 ]; then
-            echo "⚠️  等待超时，gateway 可能仍在启动中"
-            echo "请手动检查: openclaw doctor"
-            echo "或查看日志: tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log"
-        else
+            echo "⚠️  等待超时，尝试 openclaw doctor --fix 自动修复..."
+            _doctor_output=$(openclaw doctor --fix 2>&1) || true
+            echo "$_doctor_output"
+            # doctor --fix 后再尝试 restart 一次
+            echo ""
+            echo "doctor 修复后重试 gateway restart..."
+            openclaw gateway restart 2>&1 || true
+            sleep 5
+            if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
+                echo "✅ doctor --fix 后 gateway 启动成功"
+                _port_ready=1
+            else
+                echo "❌ 仍然无法启动，请手动排查:"
+                echo "  openclaw doctor"
+                echo "  tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log"
+            fi
+        fi
+
+        # 端口就绪后：检查 qqbot 连接 + 跟踪日志
+        if [ "$_port_ready" -eq 1 ]; then
             echo "✅ Gateway 端口已就绪"
             echo ""
             # 检查 qqbot WS 是否连接成功（最多等 20 秒）
@@ -603,7 +651,6 @@ case "$start_choice" in
             _restart_ts=$(date +%s)
             _qqbot_ready=0
             for _j in $(seq 1 10); do
-                # 只检查在本次重启之后出现的 "Gateway ready" 日志
                 if [ -f "$_LOG_FILE" ]; then
                     _last_line=$(grep "Gateway ready" "$_LOG_FILE" 2>/dev/null | tail -1 || true)
                     if [ -n "$_last_line" ]; then

package/skills/qqbot-media/SKILL.md

@@ -27,7 +27,7 @@ metadata: {"openclaw":{"emoji":"📸","requires":{"config":["channels.qqbot"]}}}
 ## 规则
 
 1. **路径必须是绝对路径**（以 `/` 或 `http` 开头）
-2. **标签必须闭合**：`<qqmedia>...</qqmedia>`
+2. **标签必须用开闭标签包裹路径**：`<qqmedia>路径</qqmedia>`
 3. **文件大小上限 10MB**
 4. **你有能力发送本地图片/文件**——直接用标签包裹路径即可，**不要说"无法发送"**
 5. 发送语音时不要重复语音中已朗读的文字

package/src/gateway.ts

@@ -7,7 +7,8 @@ import { loadSession, saveSession, clearSession, type SessionState } from "./ses
 import { recordKnownUser, flushKnownUsers, listKnownUsers } from "./known-users.js";
 import { getQQBotRuntime } from "./runtime.js";
 import { setRefIndex, getRefIndex, formatRefEntryForAgent, flushRefIndex, type RefAttachmentSummary } from "./ref-index-store.js";
-import { matchSlashCommand, getPluginVersion, type SlashCommandContext, type QueueSnapshot } from "./slash-commands.js";
+import { matchSlashCommand, getPluginVersion, type SlashCommandContext, type SlashCommandFileResult, type QueueSnapshot } from "./slash-commands.js";
+import { triggerUpdateCheck } from "./update-checker.js";
 import { startImageServer, isImageServerRunning, downloadFile, type ImageServerConfig } from "./image-server.js";
 import { getImageSize, formatQQBotMarkdownImage, hasQQBotImageSize, DEFAULT_IMAGE_SIZE } from "./utils/image-size.js";
 import { parseQQBotPayload, encodePayloadForCron, isCronReminderPayload, isMediaPayload, type CronReminderPayload, type MediaPayload } from "./utils/payload.js";
@@ -343,6 +344,49 @@ async function ensureImageServer(log?: GatewayContext["log"], publicBaseUrl?: st
   }
 }
 
+// ============ 启动问候语（首次安装/版本更新 vs 普通重启） ============
+
+// 模块级变量：进程生命周期内只有首次为 true
+// 区分 gateway restart（进程重启）和 health-monitor 断线重连
+let isFirstReadyGlobal = true;
+
+const STARTUP_MARKER_FILE = path.join(getQQBotDataDir("data"), "startup-marker.json");
+
+/**
+ * 判断是否为首次安装或版本更新，返回对应的问候语。
+ * - 首次安装 / 版本变更 → "Haha，我的'灵魂'已上线，随时等你吩咐。"
+ * - 普通重启             → "我重新登上了，有事随时找我。"
+ */
+function getStartupGreeting(): string {
+  const currentVersion = getPluginVersion();
+  let isFirstOrUpdated = true;
+
+  try {
+    if (fs.existsSync(STARTUP_MARKER_FILE)) {
+      const data = JSON.parse(fs.readFileSync(STARTUP_MARKER_FILE, "utf8"));
+      if (data.version === currentVersion) {
+        isFirstOrUpdated = false;
+      }
+    }
+  } catch {
+    // 文件损坏或不存在，视为首次
+  }
+
+  // 更新 marker 文件
+  try {
+    fs.writeFileSync(STARTUP_MARKER_FILE, JSON.stringify({
+      version: currentVersion,
+      startedAt: new Date().toISOString(),
+    }) + "\n");
+  } catch {
+    // ignore
+  }
+
+  return isFirstOrUpdated
+    ? `Haha，我的'灵魂'已上线，随时等你吩咐。`
+    : `我重新登上了，有事随时找我。`;
+}
+
 /**
  * 启动 Gateway WebSocket 连接（带自动重连）
  * 支持流式消息发送
@@ -362,6 +406,9 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
     }
   }
 
+  // 后台版本检查（detached 子进程，零阻塞）
+  triggerUpdateCheck(log);
+
   // 初始化 API 配置（markdown 支持）
   initApiConfig({
     markdownSupport: account.markdownSupport,
@@ -436,6 +483,46 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
   let isConnecting = false; // 防止并发连接
   let reconnectTimer: ReturnType<typeof setTimeout> | null = null; // 重连定时器
   let shouldRefreshToken = false; // 下次连接是否需要刷新 token
+  // 使用模块级 isFirstReadyGlobal，确保只有进程级重启才发送问候语
+  // health-monitor 重连不会重新初始化为 true
+
+  /** 异步发送启动问候语（READY 或 RESUMED 时调用） */
+  const sendStartupGreetings = (trigger: "READY" | "RESUMED") => {
+    (async () => {
+      try {
+        const greeting = getStartupGreeting();
+        log?.info(`[qqbot:${account.accountId}] Sending startup greeting (trigger=${trigger}): "${greeting}"`);
+        const token = await getAccessToken(account.appId, account.clientSecret);
+        const users = listKnownUsers({ accountId: account.accountId, type: "c2c" });
+        for (const user of users) {
+          try {
+            await sendProactiveC2CMessage(token, user.openid, greeting);
+            log?.info(`[qqbot:${account.accountId}] Sent startup greeting to c2c:${user.openid}`);
+          } catch (err) {
+            log?.debug?.(`[qqbot:${account.accountId}] Failed to send startup greeting to c2c:${user.openid}: ${err}`);
+          }
+          await new Promise(r => setTimeout(r, 500));
+        }
+        const groups = listKnownUsers({ accountId: account.accountId, type: "group" });
+        const sentGroups = new Set<string>();
+        for (const user of groups) {
+          const gid = user.groupOpenid;
+          if (!gid || sentGroups.has(gid)) continue;
+          sentGroups.add(gid);
+          try {
+            await sendProactiveGroupMessage(token, gid, greeting);
+            log?.info(`[qqbot:${account.accountId}] Sent startup greeting to group:${gid}`);
+          } catch (err) {
+            log?.debug?.(`[qqbot:${account.accountId}] Failed to send startup greeting to group:${gid}: ${err}`);
+          }
+          await new Promise(r => setTimeout(r, 500));
+        }
+        log?.info(`[qqbot:${account.accountId}] Startup greetings sent (${users.length} c2c, ${sentGroups.size} groups)`);
+      } catch (err) {
+        log?.error(`[qqbot:${account.accountId}] Failed to send startup greetings: ${err}`);
+      }
+    })();
+  };
 
   // ============ P1-2: 尝试从持久化存储恢复 Session ============
   // 传入当前 appId，如果 appId 已变更（换了机器人），旧 session 自动失效
@@ -589,15 +676,40 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
       // 命中插件级指令，直接回复
       log?.info(`[qqbot:${account.accountId}] Slash command matched: ${content}, replying directly`);
       const token = await getAccessToken(account.appId, account.clientSecret);
+
+      // 解析回复：纯文本 or 带文件的结果
+      const isFileResult = typeof reply === "object" && reply !== null && "filePath" in reply;
+      const replyText = isFileResult ? (reply as SlashCommandFileResult).text : reply as string;
+      const replyFile = isFileResult ? (reply as SlashCommandFileResult).filePath : null;
+
+      // 先发送文本回复
       if (msg.type === "c2c") {
-        await sendC2CMessage(token, msg.senderId, reply, msg.messageId);
+        await sendC2CMessage(token, msg.senderId, replyText, msg.messageId);
       } else if (msg.type === "group" && msg.groupOpenid) {
-        await sendGroupMessage(token, msg.groupOpenid, reply, msg.messageId);
+        await sendGroupMessage(token, msg.groupOpenid, replyText, msg.messageId);
       } else if (msg.channelId) {
-        await sendChannelMessage(token, msg.channelId, reply, msg.messageId);
+        await sendChannelMessage(token, msg.channelId, replyText, msg.messageId);
       } else if (msg.type === "dm") {
-        // 频道私信走 C2C
-        await sendC2CMessage(token, msg.senderId, reply, msg.messageId);
+        await sendC2CMessage(token, msg.senderId, replyText, msg.messageId);
+      }
+
+      // 如果有文件需要发送
+      if (replyFile) {
+        try {
+          const targetType = msg.type === "group" ? "group" : msg.type === "c2c" || msg.type === "dm" ? "c2c" : "channel";
+          const targetId = msg.type === "group" ? (msg.groupOpenid || msg.senderId) : msg.type === "c2c" || msg.type === "dm" ? msg.senderId : (msg.channelId || msg.senderId);
+          const mediaCtx: MediaTargetContext = {
+            targetType,
+            targetId,
+            account,
+            replyToId: msg.messageId,
+            logPrefix: `[qqbot:${account.accountId}]`,
+          };
+          await sendDocument(mediaCtx, replyFile);
+          log?.info(`[qqbot:${account.accountId}] Slash command file sent: ${replyFile}`);
+        } catch (fileErr) {
+          log?.error(`[qqbot:${account.accountId}] Failed to send slash command file: ${fileErr}`);
+        }
       }
     } catch (err) {
       log?.error(`[qqbot:${account.accountId}] Slash command error: ${err}`);
@@ -1061,7 +1173,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
         ];
         // TTS 能力声明：仅在启用时告知 AI 可以发语音（与 qqbot-media SKILL.md 互补）
         // STT 无需声明：转写结果已在动态上下文的 ASR 行中，AI 自然可见
-        if (hasTTS) staticParts.push("语音合成已启用，可用<qqmedia>发送语音");
+        if (hasTTS) staticParts.push("语音合成已启用，发送媒体格式：<qqmedia>路径</qqmedia>");
         const staticInstruction = staticParts.join(" | ");
 
         // 静态指引作为 systemPrompts 的首项注入
@@ -2348,44 +2460,21 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
                 });
                 onReady?.(d);
 
-                // 启动成功后向已知用户发送上线通知（异步，不阻塞主流程）
-                (async () => {
-                  try {
-                    const greeting = `Haha，我的'灵魂'已上线，随时等你吩咐。`;
-                    const token = await getAccessToken(account.appId, account.clientSecret);
-                    const users = listKnownUsers({ accountId: account.accountId, type: "c2c" });
-                    for (const user of users) {
-                      try {
-                        await sendProactiveC2CMessage(token, user.openid, greeting);
-                        log?.info(`[qqbot:${account.accountId}] Sent startup greeting to c2c:${user.openid}`);
-                      } catch (err) {
-                        log?.debug?.(`[qqbot:${account.accountId}] Failed to send startup greeting to c2c:${user.openid}: ${err}`);
-                      }
-                      // 避免频率限制
-                      await new Promise(r => setTimeout(r, 500));
-                    }
-                    const groups = listKnownUsers({ accountId: account.accountId, type: "group" });
-                    // 群组去重（同一群只发一次）
-                    const sentGroups = new Set<string>();
-                    for (const user of groups) {
-                      const gid = user.groupOpenid;
-                      if (!gid || sentGroups.has(gid)) continue;
-                      sentGroups.add(gid);
-                      try {
-                        await sendProactiveGroupMessage(token, gid, greeting);
-                        log?.info(`[qqbot:${account.accountId}] Sent startup greeting to group:${gid}`);
-                      } catch (err) {
-                        log?.debug?.(`[qqbot:${account.accountId}] Failed to send startup greeting to group:${gid}: ${err}`);
-                      }
-                      await new Promise(r => setTimeout(r, 500));
-                    }
-                    log?.info(`[qqbot:${account.accountId}] Startup greetings sent (${users.length} c2c, ${sentGroups.size} groups)`);
-                  } catch (err) {
-                    log?.error(`[qqbot:${account.accountId}] Failed to send startup greetings: ${err}`);
-                  }
-                })();
+                // 仅 startGateway 后的首次 READY 才发送上线通知
+                // ws 断线重连（resume 失败后重新 Identify）产生的 READY 不发送
+                if (!isFirstReadyGlobal) {
+                  log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (reconnect READY, not first startup)`);
+                } else {
+                  isFirstReadyGlobal = false;
+                  sendStartupGreetings("READY");
+                } // end isFirstReady
               } else if (t === "RESUMED") {
                 log?.info(`[qqbot:${account.accountId}] Session resumed`);
+                // RESUMED 也属于首次启动（gateway restart 通常走 resume）
+                if (isFirstReadyGlobal) {
+                  isFirstReadyGlobal = false;
+                  sendStartupGreetings("RESUMED");
+                }
                 // P1-2: 更新 Session 连接时间
                 if (sessionId) {
                   saveSession({