快速开始

本指南将帮助你快速上手WebChatQQ，从安装到基本使用只需几个简单步骤。

安装与配置

前提条件

使用WebChatQQ需要满足以下条件：

• 现代浏览器（Chrome、Firefox、Edge或Safari等）
• 有效的网络连接
• 要映射的QQ群（可选）

安装步骤

1. 下载WebChatQQ项目文件（webchat-adapter.js和webchat-client.html）
2. 将文件放置在Web服务器目录或直接在本地打开

提示

如果只需要客户端，只需下载webchat-client.html文件即可。

配置服务器

如果你需要自己部署WebChatQQ服务端，请按照以下步骤操作：

1. 确保安装了Node.js环境
2. 安装必要的依赖：

   npm install ws ulid

3. 配置webchat-adapter.js文件：
   • 修改WebSocket服务器端口（默认为8088）
   • 设置管理员ID（可选）
   • 配置默认群组密码（可选）

开始使用

访问网页客户端

1. 在浏览器中打开webchat-client.html文件
2. 你将看到登录界面

登录步骤

1. 输入你的昵称（必填）
2. 输入群号（默认为1）
3. 输入密码（如果群设置了密码保护，默认密码为250712）
4. 点击"登录"按钮

连接到QQ群

成功登录后，你可以选择将当前网页群聊映射到QQ群：

1. 在消息输入框中输入以下命令：

   #map <QQ群号>

   例如：#map 123456789

2. 系统将会显示映射成功的消息

注意

要成功映射到QQ群，需要WebChatQQ服务器能够连接到对应的QQ机器人。

基本操作

发送消息

1. 在底部输入框中输入你要发送的文本
2. 点击"发送"按钮或按下Enter键发送消息

发送图片

1. 点击输入框旁边的图片图标
2. 选择你要发送的图片文件
3. 图片将自动上传并发送到群聊

查看成员列表

群聊成员列表显示在左侧边栏，包括：

• QQ群成员（标有QQ标签）
• 网页用户（标有Web标签）
• 机器人（标有Bot标签）

故障排除

如果你在使用过程中遇到问题，请检查：

1. 网络连接是否正常
2. WebSocket服务器是否运行正常
3. 密码是否正确
4. QQ群映射是否配置正确

更多详细信息，请参考常见问题页面。