常用命令
WebChatQQ提供了多种命令，让用户可以快速执行特定操作。本页面详细介绍可用的命令及其用法。
命令格式
WebChatQQ的命令遵循以下格式：
#命令名 [参数]或者使用斜杠前缀（兼容格式）：
/命令名 [参数]所有命令都需要在消息输入框中输入并发送。
群聊管理命令
群映射命令
#map
将当前网页群聊映射到指定的QQ群。
语法：
#map <QQ群号>参数：
<QQ群号>：要映射的QQ群号，必须是数字
示例：
#map 123456789权限：所有用户
说明：
- 映射成功后，当前网页群聊将与指定QQ群建立双向消息同步
- 群成员列表将显示QQ群成员
- 一个网页群只能映射到一个QQ群
#unmap
解除当前网页群聊与QQ群的映射关系。
语法：
#unmap参数：无
示例：
#unmap权限：所有用户
说明：
- 解除映射后，网页群聊将不再接收或转发QQ群消息
- 群成员列表将只显示网页用户
密码管理命令
#setpass
设置当前群聊的访问密码。
语法：
#setpass <密码>参数：
<密码>：新的群聊密码
示例：
#setpass mypassword123权限：仅管理员
说明：
- 设置密码后，新用户加入需要提供正确密码
- 密码区分大小写
- 密码长度不限，但建议使用安全密码
#removepass
移除当前群聊的访问密码。
语法：
#removepass参数：无
示例：
#removepass权限：仅管理员
说明：
- 移除密码后，任何人都可以自由加入群聊
- 不影响已经在群内的用户
消息管理命令
#clear
清除当前群聊的历史消息记录。
语法：
#clear参数：无
示例：
#clear权限：所有用户
说明：
- 清除操作不可撤销
- 只影响当前群聊的历史记录
- 不影响其他群聊或服务器存储的完整历史记录
交互命令
#poke
戳一戳指定的群成员。
语法：
#poke <昵称>参数：
<昵称>：要戳的成员昵称
示例：
#poke 小明权限：所有用户
说明：
- 被戳的成员会看到"xxx戳了戳你"的提示
- 如果被戳的是QQ用户，QQ客户端也会收到戳一戳提醒
- 成员昵称必须完全匹配（区分大小写）
系统命令
#web:状态
显示当前网页群聊的连接状态信息。
语法：
#web:状态参数：无
示例：
#web:状态权限：所有用户
说明：
- 显示当前群聊ID
- 显示当前QQ群映射状态
- 显示密码保护状态
- 显示WebSocket连接状态
#help
显示可用命令的帮助信息。
语法：
#help参数：无
示例：
#help权限：所有用户
说明：
- 显示基本命令列表和简短说明
- 更详细的命令说明请参考本文档
命令组合使用
某些命令可以组合使用，例如：
- 先使用
#map映射QQ群，再使用#poke戳一戳QQ群成员 - 使用
#setpass设置密码后，可以使用#removepass移除密码
命令最佳实践
- 使用
#map命令前，确保WebChatQQ服务器能够连接到对应的QQ机器人 - 定期使用
#clear命令清理历史记录，保持聊天界面整洁 - 管理员应谨慎使用密码设置命令，避免意外阻止用户访问
- 使用
#web:状态命令可以快速检查连接状态，排查问题