@tencent-connect/openclaw-qqbot 1.5.6 → 1.5.7

package/scripts/draw_arch.py

@@ -1,174 +0,0 @@
-#!/usr/bin/env python3
-"""Generate QQBot + OpenClaw architecture diagram for product managers."""
-
-import matplotlib
-matplotlib.use('Agg')
-import matplotlib.pyplot as plt
-import matplotlib.patches as mpatches
-from matplotlib.patches import FancyBboxPatch, FancyArrowPatch
-import numpy as np
-
-# ── 中文字体 ──
-plt.rcParams['font.sans-serif'] = ['PingFang SC', 'Heiti SC', 'STHeiti', 'SimHei', 'Arial Unicode MS']
-plt.rcParams['axes.unicode_minus'] = False
-
-fig, ax = plt.subplots(1, 1, figsize=(20, 14))
-ax.set_xlim(0, 20)
-ax.set_ylim(0, 14)
-ax.axis('off')
-fig.patch.set_facecolor('#FAFBFC')
-
-# ── 颜色 ──
-C = {
-    'user':    '#4A90D9',
-    'qq':      '#12B7F5',
-    'plugin':  '#FF6B35',
-    'openclaw':'#6C5CE7',
-    'ai':      '#00B894',
-    'skill':   '#FDCB6E',
-    'white':   '#FFFFFF',
-    'text':    '#2D3436',
-    'light':   '#F0F0F5',
-    'border':  '#DFE6E9',
-}
-
-def rounded_box(x, y, w, h, color, label, sublabel=None, fontsize=13, icon=None, alpha=0.95):
-    box = FancyBboxPatch((x, y), w, h, boxstyle="round,pad=0.15",
-                         facecolor=color, edgecolor='white', linewidth=2, alpha=alpha, zorder=2)
-    ax.add_patch(box)
-    cy = y + h/2
-    if sublabel:
-        cy += 0.15
-    txt = f"{icon} {label}" if icon else label
-    ax.text(x + w/2, cy, txt, ha='center', va='center', fontsize=fontsize,
-            fontweight='bold', color='white' if color not in [C['white'], C['light'], C['skill']] else C['text'], zorder=3)
-    if sublabel:
-        ax.text(x + w/2, cy - 0.35, sublabel, ha='center', va='center', fontsize=9,
-                color='#ffffffbb' if color not in [C['white'], C['light'], C['skill']] else '#636e72', zorder=3)
-
-def section_box(x, y, w, h, color, label, fontsize=11):
-    box = FancyBboxPatch((x, y), w, h, boxstyle="round,pad=0.1",
-                         facecolor=color + '15', edgecolor=color, linewidth=1.5, linestyle='--', zorder=1)
-    ax.add_patch(box)
-    ax.text(x + 0.15, y + h - 0.25, label, ha='left', va='center', fontsize=fontsize,
-            fontweight='bold', color=color, zorder=3)
-
-def arrow(x1, y1, x2, y2, color='#636e72', style='->', label=None, lw=2):
-    ax.annotate('', xy=(x2, y2), xytext=(x1, y1),
-                arrowprops=dict(arrowstyle=style, color=color, lw=lw, connectionstyle="arc3,rad=0"),
-                zorder=4)
-    if label:
-        mx, my = (x1+x2)/2, (y1+y2)/2
-        ax.text(mx, my + 0.2, label, ha='center', va='center', fontsize=8, color=color,
-                bbox=dict(boxstyle='round,pad=0.2', facecolor='white', edgecolor='none', alpha=0.9), zorder=5)
-
-def double_arrow(x1, y1, x2, y2, color='#636e72', label=None, lw=2):
-    arrow(x1, y1, x2, y2, color=color, style='<->', label=label, lw=lw)
-
-# ══════════════════════════════════════════════
-# 标题
-# ══════════════════════════════════════════════
-ax.text(10, 13.5, 'OpenClaw QQBot 插件 · 系统架构', ha='center', va='center',
-        fontsize=22, fontweight='bold', color=C['text'])
-ax.text(10, 13.1, '让 AI 助手通过 QQ 与用户对话', ha='center', va='center',
-        fontsize=12, color='#636e72')
-
-# ══════════════════════════════════════════════
-# 第一层：用户侧
-# ══════════════════════════════════════════════
-rounded_box(1, 11.2, 2.5, 1.2, C['user'], '👤 QQ 用户', '私聊 / 群聊 / 频道', fontsize=14)
-rounded_box(5, 11.2, 2.5, 1.2, C['user'], '👥 QQ 群', '@ 机器人触发', fontsize=14)
-rounded_box(9, 11.2, 2.5, 1.2, C['user'], '📢 QQ 频道', '公域/私域频道', fontsize=14)
-
-# ══════════════════════════════════════════════
-# 第二层：QQ 平台
-# ══════════════════════════════════════════════
-section_box(0.5, 9, 12, 1.8, C['qq'], '')
-rounded_box(3, 9.3, 6, 1.2, C['qq'], '🐧 QQ 机器人平台', 'WebSocket 长连接 + HTTP API', fontsize=15)
-
-# 用户 → QQ 平台
-arrow(2.25, 11.2, 4.5, 10.5, C['qq'], label='发消息')
-arrow(6.25, 11.2, 6, 10.5, C['qq'])
-arrow(10.25, 11.2, 7.5, 10.5, C['qq'])
-
-# ══════════════════════════════════════════════
-# 第三层：QQBot 插件（核心）
-# ══════════════════════════════════════════════
-section_box(0.5, 5.2, 18.5, 3.5, C['plugin'], 'QQBot 渠道插件 (@tencent-connect/openclaw-qqbot)')
-
-# 左侧：网关
-rounded_box(1, 6.8, 3, 1.2, C['plugin'], '🔌 WebSocket 网关', '连接/心跳/重连/Resume', fontsize=11)
-# 中间：消息处理
-rounded_box(4.5, 6.8, 3.5, 1.2, C['plugin'], '📨 消息处理引擎', '收发/分块/限流/队列', fontsize=11)
-# 右侧：富媒体
-rounded_box(8.5, 6.8, 3, 1.2, C['plugin'], '🎨 富媒体处理', '图片/语音/视频/文件', fontsize=11)
-
-# 下排
-rounded_box(1, 5.5, 2.5, 1, '#E17055', '🔑 多账户管理', '独立Token/连接', fontsize=9)
-rounded_box(3.8, 5.5, 2.5, 1, '#E17055', '📢 主动消息', '推送/广播/定时', fontsize=9)
-rounded_box(6.6, 5.5, 2.5, 1, '#E17055', '🎙️ 语音处理', 'STT转文字/TTS合成', fontsize=9)
-rounded_box(9.4, 5.5, 2.5, 1, '#E17055', '🖼️ 本地图床', '自动上传/去重缓存', fontsize=9)
-
-# 右侧能力标签
-rounded_box(12.2, 7.5, 6.3, 1, C['skill'], '⭐ 核心能力', fontsize=12)
-capabilities = [
-    '✅ 私聊 / 群聊 / 频道 三场景',
-    '✅ 图片·语音·视频·文件 收发',
-    '✅ 语音转文字 (STT) + 文字转语音 (TTS)',
-    '✅ 多机器人同时在线',
-    '✅ 定时提醒 & 主动推送',
-    '✅ 断线自动重连 & Session 恢复',
-    '✅ 30+ 标签变体自动纠错',
-    '✅ 跨平台 Mac/Linux/Windows',
-]
-for i, cap in enumerate(capabilities):
-    ax.text(12.4, 7.2 - i * 0.28, cap, ha='left', va='center', fontsize=8.5,
-            color=C['text'], zorder=3)
-
-# QQ平台 → 插件
-double_arrow(6, 9.3, 6, 8.0, C['qq'], label='WebSocket', lw=2.5)
-
-# ══════════════════════════════════════════════
-# 第四层：OpenClaw 框架
-# ══════════════════════════════════════════════
-section_box(0.5, 1.5, 12, 3.4, C['openclaw'], 'OpenClaw AI 助手框架')
-
-rounded_box(1, 3.2, 2.8, 1.2, C['openclaw'], '🧠 对话管理', '上下文/多轮/记忆', fontsize=11)
-rounded_box(4.2, 3.2, 2.8, 1.2, C['openclaw'], '🔧 工具系统', 'Function Calling', fontsize=11)
-rounded_box(7.4, 3.2, 2.8, 1.2, C['openclaw'], '⏰ 定时任务', 'Cron 调度器', fontsize=11)
-
-rounded_box(1, 1.8, 3.5, 1.1, C['openclaw'], '📚 Skills 技能', 'qqbot-media / qqbot-cron', fontsize=10)
-rounded_box(5, 1.8, 3, 1.1, C['openclaw'], '🔌 插件系统', '渠道/工具插件', fontsize=10)
-rounded_box(8.5, 1.8, 3.5, 1.1, C['openclaw'], '⚙️ 配置管理', 'openclaw.json', fontsize=10)
-
-# 插件 → OpenClaw
-double_arrow(4, 5.5, 4, 4.4, C['openclaw'], label='消息桥接', lw=2.5)
-
-# ══════════════════════════════════════════════
-# 右侧：AI 模型层
-# ══════════════════════════════════════════════
-section_box(13, 1.5, 6, 3.4, C['ai'], 'AI 模型层（可替换）')
-
-rounded_box(13.5, 3.5, 5, 0.85, C['ai'], '🤖 Claude / GPT / DeepSeek / 混元 ...', fontsize=10)
-rounded_box(13.5, 2.5, 2.3, 0.8, '#00A884', '💬 对话', fontsize=10)
-rounded_box(16.2, 2.5, 2.3, 0.8, '#00A884', '🎨 画图', fontsize=10)
-rounded_box(13.5, 1.7, 2.3, 0.65, '#00A884', '🔍 搜索', fontsize=9)
-rounded_box(16.2, 1.7, 2.3, 0.65, '#00A884', '📝 写作', fontsize=9)
-
-# OpenClaw → AI
-double_arrow(10.3, 3.2, 13.5, 3.2, C['ai'], label='API 调用', lw=2.5)
-
-# ══════════════════════════════════════════════
-# 流程标注
-# ══════════════════════════════════════════════
-ax.text(10, 0.7, '💡 用户在 QQ 发消息 → QQBot 插件接收 → 交给 OpenClaw → AI 模型回复 → 通过 QQ 返回给用户',
-        ha='center', va='center', fontsize=11, color='#636e72', style='italic',
-        bbox=dict(boxstyle='round,pad=0.5', facecolor='#f8f9fa', edgecolor=C['border'], linewidth=1))
-
-ax.text(10, 0.2, 'v1.5.5 · @tencent-connect/openclaw-qqbot · MIT License',
-        ha='center', va='center', fontsize=9, color='#b2bec3')
-
-plt.tight_layout(pad=0.5)
-plt.savefig('/Users/lishoushuai/tmp/qqbot/docs/images/architecture.png', dpi=200, bbox_inches='tight',
-            facecolor='#FAFBFC', edgecolor='none')
-print("Architecture diagram saved to docs/images/architecture.png")

package/scripts/npm-upgrade.sh

@@ -1,120 +0,0 @@
-#!/bin/bash
-
-# QQBot 通过 npm 包升级
-#
-# 用法:
-#   npm-upgrade.sh                                    # 升级到 latest（默认）
-#   npm-upgrade.sh --tag alpha                        # 升级到 alpha
-#   npm-upgrade.sh --version 1.0.0-alpha.0            # 升级到指定版本
-
-set -eo pipefail
-
-PKG_NAME="@tencent-connect/openclaw-qqbot"
-INSTALL_SRC=""
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --tag)     INSTALL_SRC="${PKG_NAME}@$2"; shift 2 ;;
-        --version) INSTALL_SRC="${PKG_NAME}@$2"; shift 2 ;;
-        -h|--help)
-            echo "用法:"
-            echo "  npm-upgrade.sh                              # 升级到 latest（默认）"
-            echo "  npm-upgrade.sh --tag alpha                   # 升级到 alpha"
-            echo "  npm-upgrade.sh --version 1.0.0-alpha.0       # 升级到指定版本"
-            exit 0
-            ;;
-        *) echo "未知选项: $1"; exit 1 ;;
-    esac
-done
-INSTALL_SRC="${INSTALL_SRC:-${PKG_NAME}@latest}"
-
-# 检测 CLI
-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
-
-APP_CONFIG="$HOME/.$CMD/$CMD.json"
-EXTENSIONS_DIR="$HOME/.$CMD/extensions"
-
-echo "==========================================="
-echo "  QQBot npm 升级: $INSTALL_SRC"
-echo "==========================================="
-echo ""
-
-# [1/4] 备份并临时移除通道配置（避免 plugins install 因 unknown channel 拒绝执行）
-echo "[1/4] 备份通道配置..."
-if [ -f "$APP_CONFIG" ]; then
-    node -e "
-        const fs = require('fs');
-        const cfg = JSON.parse(fs.readFileSync('$APP_CONFIG', 'utf8'));
-        const keys = ['qqbot', 'openclaw-qqbot', 'openclaw-qq'];
-        let saved = null;
-        for (const key of keys) {
-            const ch = cfg.channels && cfg.channels[key];
-            if (ch) { saved = ch; delete cfg.channels[key]; break; }
-        }
-        // 清理 plugins.entries 中的旧记录（避免 stale config entry 告警）
-        if (cfg.plugins && cfg.plugins.entries) {
-            delete cfg.plugins.entries['openclaw-qqbot'];
-        }
-        if (saved) {
-            fs.writeFileSync('$APP_CONFIG.qqbot-backup.json', JSON.stringify(saved, null, 2));
-            fs.writeFileSync('$APP_CONFIG', JSON.stringify(cfg, null, 4) + '\n');
-            console.log('  ✅ 已备份并临时移除 channels.qqbot');
-        } else {
-            console.log('  ℹ️  无已有通道配置');
-        }
-    " 2>/dev/null || echo "  ⚠️  备份失败"
-else
-    echo "  ℹ️  无配置文件"
-fi
-
-# [2/4] 清理旧插件目录
-echo ""
-echo "[2/4] 清理旧插件..."
-for old_plugin in openclaw-qqbot qqbot openclaw-qq @sliverp/qqbot @tencent-connect/qqbot @tencent-connect/openclaw-qq @tencent-connect/openclaw-qqbot; do
-    $CMD plugins uninstall "$old_plugin" 2>/dev/null && echo "  已卸载: $old_plugin" || true
-done
-for dir_name in openclaw-qqbot qqbot openclaw-qq; do
-    if [ -d "$EXTENSIONS_DIR/$dir_name" ]; then
-        rm -rf "$EXTENSIONS_DIR/$dir_name"
-        echo "  已清理残留目录: $dir_name"
-    fi
-done
-
-# [3/4] 安装新版本
-echo ""
-echo "[3/4] 安装新版本..."
-$CMD plugins install "$INSTALL_SRC" 2>&1
-
-# 恢复通道配置
-BACKUP_FILE="$APP_CONFIG.qqbot-backup.json"
-if [ -f "$BACKUP_FILE" ] && [ -f "$APP_CONFIG" ]; then
-    node -e "
-        const fs = require('fs');
-        const cfg = JSON.parse(fs.readFileSync('$APP_CONFIG', 'utf8'));
-        const saved = JSON.parse(fs.readFileSync('$BACKUP_FILE', 'utf8'));
-        cfg.channels = cfg.channels || {};
-        cfg.channels.qqbot = saved;
-        fs.writeFileSync('$APP_CONFIG', JSON.stringify(cfg, null, 4) + '\n');
-        fs.unlinkSync('$BACKUP_FILE');
-        console.log('  ✅ 通道配置已恢复');
-    " 2>/dev/null || echo "  ⚠️  通道配置恢复失败，请手动检查: $APP_CONFIG"
-fi
-
-# [4/4] 重启网关
-echo ""
-echo "[4/4] 重启网关..."
-$CMD gateway restart 2>&1 || true
-
-echo ""
-echo "==========================================="
-echo "  ✅ 升级完成"
-echo "==========================================="
-echo ""
-echo "常用命令:"
-echo "  $CMD logs --follow        # 跟踪日志"
-echo "  $CMD gateway restart      # 重启服务"
-echo "  $CMD plugins list         # 查看插件列表"

package/scripts/pull-latest.sh

@@ -1,316 +0,0 @@
-#!/bin/bash
-
-# QQBot 拉取最新源码并更新
-# 从 GitHub 拉取最新代码，安装依赖并重启网关
-# 兼容 clawdbot / openclaw / moltbot，macOS 开箱即用
-#
-# 用法:
-#   pull-latest.sh                          # 拉取最新代码并更新
-#   pull-latest.sh --branch main            # 指定分支（默认 main）
-#   pull-latest.sh --force                  # 跳过交互，强制更新
-#   pull-latest.sh --repo <git-url>         # 指定仓库地址
-
-set -euo pipefail
-
-##############################################################################
-# 常量 & 参数
-##############################################################################
-readonly DEFAULT_REPO="https://github.com/tencent-connect/openclaw-qqbot.git"
-readonly GATEWAY_PORT=18789
-readonly SUPPORTED_CLIS=(openclaw clawdbot moltbot)
-
-FORCE=false
-BRANCH="main"
-REPO_URL=""
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        -f|--force) FORCE=true; shift ;;
-        -b|--branch) BRANCH="$2"; shift 2 ;;
-        --repo) REPO_URL="$2"; shift 2 ;;
-        -h|--help)
-            echo "QQBot 拉取最新源码并更新"
-            echo ""
-            echo "用法:"
-            echo "  pull-latest.sh                          # 拉取最新代码并更新"
-            echo "  pull-latest.sh --branch main            # 指定分支（默认 main）"
-            echo "  pull-latest.sh --force                  # 跳过交互，强制更新"
-            echo "  pull-latest.sh --repo <git-url>         # 指定仓库地址"
-            exit 0
-            ;;
-        *)
-            echo "未知选项: $1 (使用 --help 查看帮助)"
-            exit 1
-            ;;
-    esac
-done
-REPO_URL="${REPO_URL:-$DEFAULT_REPO}"
-
-##############################################################################
-# 工具函数
-##############################################################################
-json_get() {
-    local file="$1" expr="$2"
-    node -e "process.stdout.write(String((function(){$expr})(JSON.parse(require('fs').readFileSync('$file','utf8')))||''))" 2>/dev/null || true
-}
-
-##############################################################################
-# 环境检查
-##############################################################################
-printf "%b\n" "\033[32m=========================================\033[0m"
-printf "%b\n" "\033[32m  QQBot 拉取最新源码并更新\033[0m"
-printf "%b\n" "\033[32m=========================================\033[0m"
-echo ""
-
-# 检查必要命令
-for dep in node npm git; do
-    if ! command -v "$dep" &>/dev/null; then
-        printf "%b\n" "\033[31m❌ 未检测到 $dep，请先安装\033[0m"
-        exit 1
-    fi
-done
-
-printf "%b\n" "\033[34m系统信息:\033[0m"
-echo "  macOS  $(sw_vers -productVersion 2>/dev/null || echo '未知')"
-echo "  Node   $(node -v)"
-echo "  npm    $(npm -v)"
-echo "  Git    $(git --version 2>/dev/null | awk '{print $3}')"
-echo "  仓库   $REPO_URL"
-echo "  分支   $BRANCH"
-
-# 检测 CLI
-CMD=""
-for name in "${SUPPORTED_CLIS[@]}"; do
-    if command -v "$name" &>/dev/null; then
-        CMD="$name"
-        break
-    fi
-done
-if [ -z "$CMD" ]; then
-    printf "%b\n" "\033[31m❌ 未找到 openclaw / clawdbot / moltbot 命令，请先安装其中之一\033[0m"
-    exit 1
-fi
-echo "  CLI    $CMD ($($CMD --version 2>/dev/null || echo '未知版本'))"
-
-APP_HOME="$HOME/.$CMD"
-APP_CONFIG="$APP_HOME/$CMD.json"
-
-##############################################################################
-# 定位插件目录
-##############################################################################
-PROJ_DIR=""
-FRESH_INSTALL=false
-
-for app in "${SUPPORTED_CLIS[@]}"; do
-    for plugin_dir in openclaw-qqbot qqbot openclaw-qq; do
-        ext_dir="$HOME/.$app/extensions/$plugin_dir"
-        if [ -d "$ext_dir" ] && [ -f "$ext_dir/package.json" ]; then
-            PROJ_DIR="$ext_dir"
-            break 2
-        fi
-    done
-done
-
-if [ -z "$PROJ_DIR" ]; then
-    PROJ_DIR="$APP_HOME/extensions/openclaw-qqbot"
-    FRESH_INSTALL=true
-    echo "  插件   未安装（首次安装）"
-else
-    echo "  插件   $PROJ_DIR"
-fi
-
-##############################################################################
-# 第一步：获取当前版本
-##############################################################################
-echo ""
-printf "%b\n" "\033[34m1. 获取当前版本...\033[0m"
-
-LOCAL_VER=""
-LOCAL_COMMIT=""
-if [ "$FRESH_INSTALL" = true ]; then
-    echo "  首次安装，无本地版本"
-else
-    [ -f "$PROJ_DIR/package.json" ] && LOCAL_VER=$(json_get "$PROJ_DIR/package.json" "c => c.version")
-    [ -d "$PROJ_DIR/.git" ] && LOCAL_COMMIT=$(cd "$PROJ_DIR" && git rev-parse --short HEAD 2>/dev/null || echo "")
-    echo "  当前版本: ${LOCAL_VER:-未知}${LOCAL_COMMIT:+ (${LOCAL_COMMIT})}"
-fi
-
-##############################################################################
-# 第二步：备份通道配置
-##############################################################################
-echo ""
-printf "%b\n" "\033[34m2. 备份通道配置...\033[0m"
-
-SAVED_CHANNELS_JSON=""
-for app in "${SUPPORTED_CLIS[@]}"; do
-    cfg="$HOME/.$app/$app.json"
-    [ -f "$cfg" ] || continue
-    SAVED_CHANNELS_JSON=$(node -e "
-        const cfg = JSON.parse(require('fs').readFileSync('$cfg', 'utf8'));
-        // 尝试所有可能的 channel key（原仓库 + 本仓库）
-        const keys = ['qqbot', 'openclaw-qqbot', 'openclaw-qq'];
-        for (const key of keys) {
-            const ch = cfg.channels && cfg.channels[key];
-            if (ch) { process.stdout.write(JSON.stringify(ch)); process.exit(0); }
-        }
-    " 2>/dev/null || true)
-    [ -n "$SAVED_CHANNELS_JSON" ] && break
-done
-
-if [ -n "$SAVED_CHANNELS_JSON" ]; then
-    echo "  ✅ 已备份 qqbot 通道配置"
-else
-    echo "  ℹ️  未找到已有通道配置"
-fi
-
-##############################################################################
-# 第三步：拉取最新代码
-##############################################################################
-echo ""
-printf "%b\n" "\033[34m3. 拉取最新代码...\033[0m"
-
-TMP_DIR="${TMPDIR:-/tmp}/qqbot-update-$$"
-cleanup() { rm -rf "$TMP_DIR" 2>/dev/null; }
-trap cleanup EXIT INT TERM
-
-if [ -d "$PROJ_DIR/.git" ] && [ "$FRESH_INSTALL" = false ]; then
-    cd "$PROJ_DIR"
-
-    # 有本地修改直接重置，插件目录不需要保留用户改动
-    if ! git diff --quiet 2>/dev/null || ! git diff --cached --quiet 2>/dev/null; then
-        echo "  检测到本地修改，自动重置..."
-        git checkout -- . 2>/dev/null
-        git clean -fd 2>/dev/null
-    fi
-
-    echo "  切换到分支 $BRANCH..."
-    git fetch --all --prune 2>&1 | tail -3
-    git checkout "$BRANCH" 2>/dev/null || git checkout -b "$BRANCH" "origin/$BRANCH" 2>/dev/null || true
-    git reset --hard "origin/$BRANCH" 2>/dev/null
-
-    REMOTE_COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "")
-    NEW_VER=$(json_get "$PROJ_DIR/package.json" "c => c.version")
-
-    if [ -n "$LOCAL_COMMIT" ] && [ "$LOCAL_COMMIT" = "$REMOTE_COMMIT" ]; then
-        echo "  ✅ 已是最新 ($LOCAL_VER, commit: $LOCAL_COMMIT)，继续检查依赖..."
-    else
-        echo "  更新: ${LOCAL_COMMIT:-???} → ${REMOTE_COMMIT}"
-        git --no-pager log --oneline "${LOCAL_COMMIT}..HEAD" 2>/dev/null | head -10 || true
-    fi
-else
-    rm -rf "$TMP_DIR"
-    echo "  克隆仓库..."
-    if ! git clone --branch "$BRANCH" --depth 1 "$REPO_URL" "$TMP_DIR" 2>&1 | tail -3; then
-        printf "%b\n" "\033[31m❌ Git clone 失败\033[0m"
-        echo ""
-        echo "请排查:"
-        echo "  1. 检查网络: curl -I https://github.com"
-        echo "  2. 检查仓库地址: $REPO_URL"
-        echo "  3. 如果是私有仓库，确认已配置 SSH key 或 token"
-        exit 1
-    fi
-
-    mkdir -p "$PROJ_DIR"
-    rsync -a --delete --exclude 'node_modules' "$TMP_DIR/" "$PROJ_DIR/"
-
-    cd "$PROJ_DIR"
-    REMOTE_COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "")
-    NEW_VER=$(json_get "$PROJ_DIR/package.json" "c => c.version")
-    echo "  已克隆到版本: ${NEW_VER:-未知} (${REMOTE_COMMIT})"
-    cleanup
-fi
-
-NEW_VER="${NEW_VER:-未知}"
-printf "%b\n" "\033[32m  ✅ 代码已更新到 $NEW_VER\033[0m"
-
-##############################################################################
-# 第四步：安装依赖
-##############################################################################
-echo ""
-printf "%b\n" "\033[34m4. 安装依赖...\033[0m"
-
-cd "$PROJ_DIR"
-if ! npm install --omit=dev 2>&1 | tail -5; then
-    printf "%b\n" "\033[31m❌ npm 依赖安装失败\033[0m"
-    echo ""
-    echo "请排查:"
-    echo "  1. 手动重试: cd $PROJ_DIR && npm install --omit=dev"
-    echo "  2. 清理后重试: rm -rf $PROJ_DIR/node_modules && npm install --omit=dev"
-    echo "  3. 切换镜像: npm config set registry https://registry.npmmirror.com/"
-    exit 1
-fi
-echo "  ✅ 依赖安装完成"
-
-##############################################################################
-# 第五步：恢复配置 → 重启网关
-##############################################################################
-echo ""
-printf "%b\n" "\033[34m5. 恢复配置并重启网关...\033[0m"
-
-# 恢复通道配置
-if [ -n "$SAVED_CHANNELS_JSON" ]; then
-    if node -e "
-        const fs = require('fs');
-        const cfg = JSON.parse(fs.readFileSync('$APP_CONFIG', 'utf8'));
-        cfg.channels = cfg.channels || {};
-        cfg.channels.qqbot = $SAVED_CHANNELS_JSON;
-        fs.writeFileSync('$APP_CONFIG', JSON.stringify(cfg, null, 4) + '\n');
-    " 2>/dev/null; then
-        echo "  ✅ 通道配置已恢复"
-    else
-        printf "%b\n" "\033[33m  ⚠️  通道配置写入失败，请手动检查: $APP_CONFIG\033[0m"
-    fi
-elif [ "$FRESH_INSTALL" = true ]; then
-    echo ""
-    printf "%b\n" "\033[33m  ⚠️  首次安装，请配置 QQ Bot 凭据:\033[0m"
-    echo "     $CMD channels add --channel qqbot --token 'YOUR_APPID:YOUR_SECRET'"
-    echo ""
-fi
-
-# 停止旧 gateway
-echo "  停止旧网关..."
-$CMD gateway stop 2>/dev/null || true
-sleep 1
-
-# 强制杀占用端口的进程
-PORT_PID=$(lsof -ti:"$GATEWAY_PORT" 2>/dev/null || true)
-if [ -n "$PORT_PID" ]; then
-    printf "%b\n" "\033[33m  ⚠️  端口 $GATEWAY_PORT 仍被占用 (PID: $PORT_PID)，强制终止...\033[0m"
-    kill -9 $PORT_PID 2>/dev/null || true
-    sleep 1
-fi
-
-# 卸载 launchd 服务（防止自动拉起旧进程）
-for svc in ai.openclaw.gateway ai.clawdbot.gateway ai.moltbot.gateway; do
-    launchctl bootout "gui/$(id -u)/$svc" 2>/dev/null || true
-done
-
-# 启动网关
-echo "  启动网关..."
-if $CMD gateway 2>&1; then
-    printf "%b\n" "\033[32m  ✅ 网关已启动\033[0m"
-else
-    echo ""
-    printf "%b\n" "\033[33m  ⚠️  网关启动失败（不影响已安装的插件）\033[0m"
-    echo ""
-    echo "  请手动启动:"
-    echo "    1. 安装服务: $CMD gateway install"
-    echo "    2. 启动网关: $CMD gateway"
-    echo "    3. 查看日志: $CMD logs --follow"
-fi
-
-##############################################################################
-# 完成
-##############################################################################
-echo ""
-printf "%b\n" "\033[32m=========================================\033[0m"
-printf "%b\n" "\033[32m  ✅ QQBot 已更新到 ${NEW_VER}${REMOTE_COMMIT:+ (${REMOTE_COMMIT})}\033[0m"
-[ -n "$LOCAL_VER" ] && printf "%b\n" "\033[32m     (从 ${LOCAL_VER}${LOCAL_COMMIT:+ (${LOCAL_COMMIT})} 升级)\033[0m"
-printf "%b\n" "\033[32m=========================================\033[0m"
-echo ""
-echo "常用命令:"
-echo "  $CMD logs --follow        # 跟踪日志"
-echo "  $CMD gateway restart      # 重启服务"
-echo "  $CMD plugins list         # 查看插件列表"
-echo "  cd $PROJ_DIR && git log   # 查看更新历史"
-echo "========================================="