切换外观
邮箱注册与密码设置
VexBot 使用邮件验证创建社区账号，QQ 与官网共享账号库。社区账号 ID、游戏 UUID、QQ 绑定与白名单是独立概念；注册不会自动创建游戏身份、绑定 QQ 或加入白名单。
配置注册
- 在管理面板「成员 → 注册账号」填写社区名称和 SMTP 设置。
- 按邮件服务商提供的组合填写主机、端口和加密方式，填写发件邮箱、登录账号及授权码。
- 先使用默认的验证码有效期、重发间隔和额度，打开注册开关并单独保存。
- 打开同一 Bot 地址的
/register页面，完成下面的测试注册；仅保存设置不会发信。 - 如需接入其他网站，再按 网站来源设置 配置精确来源。内置同源注册页无需添加来源。
| 面板项 | 填写说明 |
|---|---|
| SMTP 主机 | 邮件服务商提供的域名或 IP，不含 https://、路径和空格 |
| 端口 / 加密方式 | 必须匹配服务商的 SSL 或 STARTTLS 服务；VexBot 不接受明文 SMTP |
| 发件邮箱 | 验证邮件的 From 地址，需符合服务商发信要求 |
| 登录账号 / 授权码 | SMTP 认证凭据；授权码不是网站 API 密钥，也不是玩家密码 |
| 注册网页地址 | 可选，写入网页注册邮件的入口；不自动部署网页或授权跨域来源 |
| 网站后端 API 密钥 | 仅在自有网站服务端查询账号时配置，浏览器注册无需此密钥 |
注册默认关闭，用户申请后才发送验证码。配置保存在配置目录下 data/registration-settings.json，立即生效。
支持 SSL / TLS 和 STARTTLS，校验证书，不使用明文 SMTP。Python SMTP 接口说明。请按邮件服务商要求填写端口与授权码。
默认验证码有效 5 分钟、错误最多 5 次、重发间隔 60 秒、每小时最多 60 封，可在面板调整时间和邮件额度。每个来源 IP／QQ 用户 10 分钟最多申请 5 次。限流与验证码摘要保存在 Bot 主数据库（默认 SQLite，可选 MySQL），重启不清空。保存注册设置会使旧验证码失效。
第一次注册与验收
- 在部署 Bot 的同一台电脑打开
http://127.0.0.1:5800/register；修改过面板端口时使用实际端口，远程玩家使用可访问的 Bot 地址。 - 填写尚未注册的测试玩家名和测试邮箱，点击发送验证码。玩家名使用 3–16 位英文字母、数字或下划线。
- 检查收件箱及垃圾邮件，在页面填入六位邮件验证码，设置并确认 8–128 字符密码，然后完成注册。
- 在面板「成员 → 注册账号」搜索测试玩家名，确认邮箱、账号和密码列的“已设置”状态；同一玩家名或邮箱再次注册应被拒绝。
- 若计划开放群注册，用另一个尚未注册的玩家名和自己的 QQ 完成下面的群流程，确认机器人只发送简短文字反馈。
保存设置本身不是邮件验收。关闭新注册后，已有账号仍可通过原邮箱在 /account-password 设置或重置密码；官网登录还需官网设置中的登录开关，详见 登录与本人信息。
群命令
text
/申请 Steve 123456789
/注册 012345示例中的 Steve 换成玩家名，123456789 换成发送消息的本人 QQ，012345 换成邮件收到的六位验证码，保留前导零。QQ 号必须与申请人一致，验证码发到 QQ号@qq.com。只支持已关联的群；必须由原申请人，在原服务器关联的原群确认验证码。参数缺失、验证码错误／过期、邮件失败会显示具体文字提示。机器人不会把邮件验证码、访问令牌或 SMTP 授权码回显到群；玩家按上述格式提交一次性验证码。
注册创建的是社区账号。游戏绑定仍使用游戏 /qbind 和群 绑定 验证码，不根据玩家名猜测 UUID。游戏登录默认关闭；启用后可使用注册密码或绑定 QQ 确认，参见 游戏登录接入。注册本身不修改存档或白名单。
密码与游戏官网登录
已有账号可使用 Bot 同源 /account-password 页面，通过注册邮箱设置或重置密码。官网登录开关与新注册开关独立；关闭新注册不会自动禁止已有账号登录。游戏内登录见游戏登录，AuthMe 等原插件的密码重置见原插件密码找回。不要把官网密码接口当成任意游戏认证插件的通用改密接口。
API 接入
注册按 request → verify 处理，重发使用 resend；密码重置按 /api/v1/account/password/request → /verify 处理。验证码只能消费一次，密码重置会撤销旧用户和游戏登录会话。字段、错误码和限流见账号 API，跨域授权及网站部署见官网接入。