@tencent-connect/openclaw-qqbot 1.0.0-alpha.0

package/scripts/pull-latest.sh

@@ -0,0 +1,316 @@
+#!/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 "========================================="

package/scripts/send-proactive.ts

@@ -0,0 +1,273 @@
+#!/usr/bin/env npx ts-node
+/**
+ * QQBot 主动消息 CLI 工具
+ * 
+ * 使用示例：
+ *   # 发送私聊消息
+ *   npx ts-node scripts/send-proactive.ts --to "用户openid" --text "你好！"
+ *   
+ *   # 发送群聊消息
+ *   npx ts-node scripts/send-proactive.ts --to "群组openid" --type group --text "群公告"
+ *   
+ *   # 列出已知用户
+ *   npx ts-node scripts/send-proactive.ts --list
+ *   
+ *   # 列出群聊用户
+ *   npx ts-node scripts/send-proactive.ts --list --type group
+ *   
+ *   # 广播消息
+ *   npx ts-node scripts/send-proactive.ts --broadcast --text "系统公告" --type c2c --limit 10
+ */
+
+import { 
+  sendProactiveMessageDirect,
+  listKnownUsers, 
+  getKnownUsersStats,
+  broadcastMessage,
+} from "../src/proactive.js";
+import type { ResolvedQQBotAccount } from "../src/types.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+// 解析命令行参数
+function parseArgs(): Record<string, string | boolean> {
+  const args: Record<string, string | boolean> = {};
+  const argv = process.argv.slice(2);
+  
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const nextArg = argv[i + 1];
+      if (nextArg && !nextArg.startsWith("--")) {
+        args[key] = nextArg;
+        i++;
+      } else {
+        args[key] = true;
+      }
+    }
+  }
+  
+  return args;
+}
+
+// 从配置文件加载账户信息
+function loadAccount(accountId = "default"): ResolvedQQBotAccount | null {
+  const configPath = path.join(process.env.HOME || "/home/ubuntu", "clawd", "config.json");
+  
+  try {
+    if (!configPath || !fs.existsSync(configPath)) {
+      // 尝试从环境变量获取
+      const appId = process.env.QQBOT_APP_ID;
+      const clientSecret = process.env.QQBOT_CLIENT_SECRET;
+      
+      if (appId && clientSecret) {
+        return {
+          accountId,
+          appId,
+          clientSecret,
+          enabled: true,
+          secretSource: "env",
+        };
+      }
+      
+      console.error("配置文件不存在且环境变量未设置");
+      return null;
+    }
+    
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    const qqbot = config.channels?.qqbot;
+    
+    if (!qqbot) {
+      console.error("配置中没有 qqbot 配置");
+      return null;
+    }
+    
+    // 解析账户配置
+    if (accountId === "default") {
+      return {
+        accountId: "default",
+        appId: qqbot.appId || process.env.QQBOT_APP_ID,
+        clientSecret: qqbot.clientSecret || process.env.QQBOT_CLIENT_SECRET,
+        enabled: qqbot.enabled ?? true,
+        secretSource: qqbot.clientSecret ? "config" : "env",
+      };
+    }
+    
+    const accountConfig = qqbot.accounts?.[accountId];
+    if (accountConfig) {
+      return {
+        accountId,
+        appId: accountConfig.appId || qqbot.appId || process.env.QQBOT_APP_ID,
+        clientSecret: accountConfig.clientSecret || qqbot.clientSecret || process.env.QQBOT_CLIENT_SECRET,
+        enabled: accountConfig.enabled ?? true,
+        secretSource: accountConfig.clientSecret ? "config" : "env",
+      };
+    }
+    
+    console.error(`账户 ${accountId} 不存在`);
+    return null;
+  } catch (err) {
+    console.error(`加载配置失败: ${err}`);
+    return null;
+  }
+}
+
+async function main() {
+  const args = parseArgs();
+  
+  // 显示帮助
+  if (args.help || args.h) {
+    console.log(`
+QQBot 主动消息 CLI 工具
+
+用法:
+  npx ts-node scripts/send-proactive.ts [选项]
+
+选项:
+  --to <openid>      目标用户或群组的 openid
+  --text <message>   要发送的消息内容
+  --type <type>      消息类型: c2c (私聊) 或 group (群聊)，默认 c2c
+  --account <id>     账户 ID，默认 default
+  
+  --list             列出已知用户
+  --stats            显示用户统计
+  --broadcast        广播消息给所有已知用户
+  --limit <n>        限制数量
+  
+  --help, -h         显示帮助
+
+示例:
+  # 发送私聊消息
+  npx ts-node scripts/send-proactive.ts --to "0Eda5EA7-xxx" --text "你好！"
+  
+  # 发送群聊消息
+  npx ts-node scripts/send-proactive.ts --to "A1B2C3D4" --type group --text "群公告"
+  
+  # 列出最近 10 个私聊用户
+  npx ts-node scripts/send-proactive.ts --list --type c2c --limit 10
+  
+  # 广播消息
+  npx ts-node scripts/send-proactive.ts --broadcast --text "系统公告" --limit 5
+`);
+    return;
+  }
+  
+  const accountId = (args.account as string) || "default";
+  const type = (args.type as "c2c" | "group") || "c2c";
+  const limit = args.limit ? parseInt(args.limit as string, 10) : undefined;
+  
+  // 列出已知用户
+  if (args.list) {
+    const users = listKnownUsers({ 
+      type: args.type as "c2c" | "group" | "channel" | undefined,
+      accountId: args.account as string | undefined,
+      limit,
+    });
+    
+    if (users.length === 0) {
+      console.log("没有已知用户");
+      return;
+    }
+    
+    console.log(`\n已知用户列表 (共 ${users.length} 个):\n`);
+    console.log("类型\t\tOpenID\t\t\t\t\t\t昵称\t\t最后交互时间");
+    console.log("─".repeat(100));
+    
+    for (const user of users) {
+      const lastTime = new Date(user.lastInteractionAt).toLocaleString();
+      console.log(`${user.type}\t\t${user.openid.slice(0, 20)}...\t${user.nickname || "-"}\t\t${lastTime}`);
+    }
+    return;
+  }
+  
+  // 显示统计
+  if (args.stats) {
+    const stats = getKnownUsersStats(args.account as string | undefined);
+    console.log(`\n用户统计:`);
+    console.log(`  总计: ${stats.total}`);
+    console.log(`  私聊: ${stats.c2c}`);
+    console.log(`  群聊: ${stats.group}`);
+    console.log(`  频道: ${stats.channel}`);
+    return;
+  }
+  
+  // 广播消息
+  if (args.broadcast) {
+    if (!args.text) {
+      console.error("请指定消息内容 (--text)");
+      process.exit(1);
+    }
+    
+    // 加载配置用于广播
+    const configPath = detectConfigPath();
+    let cfg: Record<string, unknown> = {};
+    try {
+      if (configPath && fs.existsSync(configPath)) {
+        cfg = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+      }
+    } catch {}
+    
+    console.log(`\n开始广播消息...\n`);
+    const result = await broadcastMessage(args.text as string, cfg as any, {
+      type,
+      accountId,
+      limit,
+    });
+    
+    console.log(`\n广播完成:`);
+    console.log(`  发送总数: ${result.total}`);
+    console.log(`  成功: ${result.success}`);
+    console.log(`  失败: ${result.failed}`);
+    
+    if (result.failed > 0) {
+      console.log(`\n失败详情:`);
+      for (const r of result.results) {
+        if (!r.result.success) {
+          console.log(`  ${r.to}: ${r.result.error}`);
+        }
+      }
+    }
+    return;
+  }
+  
+  // 发送单条消息
+  if (args.to && args.text) {
+    const account = loadAccount(accountId);
+    if (!account) {
+      console.error("无法加载账户配置");
+      process.exit(1);
+    }
+    
+    console.log(`\n发送消息...`);
+    console.log(`  目标: ${args.to}`);
+    console.log(`  类型: ${type}`);
+    console.log(`  内容: ${args.text}`);
+    
+    const result = await sendProactiveMessageDirect(
+      account,
+      args.to as string,
+      args.text as string,
+      type
+    );
+    
+    if (result.success) {
+      console.log(`\n✅ 发送成功!`);
+      console.log(`  消息ID: ${result.messageId}`);
+      console.log(`  时间戳: ${result.timestamp}`);
+    } else {
+      console.log(`\n❌ 发送失败: ${result.error}`);
+      process.exit(1);
+    }
+    return;
+  }
+  
+  // 没有有效参数
+  console.error("请指定操作。使用 --help 查看帮助。");
+  process.exit(1);
+}
+
+main().catch((err) => {
+  console.error(`执行失败: ${err}`);
+  process.exit(1);
+});