SmartQQ-Bot安装与配置指南

1. 项目基础介绍

SmartQQ-Bot 是一个基于 WebQQ 的机器人项目，由 Node.js 编写而成。它能够实现手机 QQ 扫描登录、接收和发送消息、支持好友、群和讨论组等功能，并且提供了 HTTP API 供其他程序调用。

2. 项目使用的关键技术和框架

本项目主要使用了以下技术和框架：

• Node.js：一个基于Chrome V8引擎的JavaScript运行环境，用于构建高效的网络应用。
• Express：一个简洁、灵活的 Node.js Web 应用框架，用于创建 HTTP 服务。
• WebSocket：一种在单个 TCP 连接上进行全双工通讯的协议，用于实现实时数据传输。

3. 项目安装和配置的准备工作

在开始安装 SmartQQ-Bot 之前，请确保您的系统中已经安装了以下软件：

• Node.js：本项目运行的基石，版本要求至少是 LTS 版本。
• npm：Node.js 的包管理工具，用于安装项目依赖。

详细安装步骤

1. 安装 Node.js 和 npm

   如果您的系统中尚未安装 Node.js 和 npm，请访问 Node.js 官方网站下载并安装适合您操作系统的版本。

2. 克隆项目到本地

   打开命令行工具，执行以下命令克隆项目：

   git clone https://github.com/floatinghotpot/qqbot.git
   

3. 安装项目依赖

   进入项目目录，使用 npm 安装项目所需的依赖：

   cd qqbot
   npm install
   

4. 启动 SmartQQ-Bot

   在项目目录下，运行以下命令启动机器人：

   node main.js
   

   如果是 Mac 系统，机器人将请求二维码图片并自动打开。如果是其他系统，则需要用浏览器访问 http://本机IP:3100/ 来获取二维码。

5. 扫描二维码登录

   使用手机 QQ 扫描出现的二维码，并允许 SmartQQ 登录。

6. 使用 HTTP API 或命令行工具

   一旦机器人启动并且登录成功，您可以使用 HTTP API 或附带的命令行工具 qq 来与机器人交互。

   例如，使用命令行工具查看好友列表：

   qq list buddy
   

   或者发送消息给指定好友：

   qq send buddy {qq_number/nick} {msg}
   

请按照上述步骤进行安装和配置，您应该能够成功运行 SmartQQ-Bot 并开始使用它的功能。