WebUI 控制台指南

PicoOnebot 内置了一套现代化的 Web 管理控制台，用于查看机器人实时状态、扫码登录、管理网络连接与密钥鉴权。

---

访问与认证

• 访问地址：http://<运行设备或服务器IP>:6099
• 初始默认密码：picopico

首次使用该密码登录后，系统将弹出强制修改密码对话框，设置新密码后请妥善保管。若后续需要再次修改密码，可在控制台右上角「系统设置」中进行调整。

---

控制台核心面板

1. 仪表盘与登录管理 (Dashboard)

• 实时连接状态：显示当前 QQ 账号是否已成功与腾讯服务器建立在线会话；
• 扫码登录区域：
  • 未登录时动态刷新二维码；
  • 使用手机 QQ 客户端扫码后，状态将自动变更为「登录成功」并拉取当前机器人的昵称、头像与 UIN；
• 登出与重新扫码：支持在界面上一键注销当前账号并重新生成二维码切换登录账号。

2. 网络配置面板 (Network Settings)

用于管理 OneBot v11 协议的上报通道。支持实时新增、开启/禁用或删除配置项，修改无需重启容器：

• 反向 WebSocket 配置：指定下游框架的服务端地址、重连间隔及 Access Token；
• 正向 WebSocket 服务：控制本地正向 WebSocket 服务监听端口与连接鉴权；
• HTTP 上报与 API：配置 HTTP 消息事件 POST 接收端地址与 HTTP API 调用监听端。

点击「保存并应用」后，PicoOnebot 会立刻停掉旧的监听与反向连接、按新配置重新拉起，并在提示语里说明实际重启了几个监听、起了几条反向连接。注意两点：

• 反向 WebSocket 是异步握手的，保存那一刻只是「开始连接」，连上没连上要看概览页的连接列表——绿灯才是真连上，黄灯表示已启用但还没连上（鼠标下方那行文字会写明「重连中…」还是「监听未启动：端口被占用」之类的原因）。
• webui.host / webui.port、总开关 enable、event_queue_size 这几项不在热重载范围内，改完提示语会明确告诉你需要重启 QQ。

3. 日志监控面板 (Live Logs)

• 实时抓取并滚动展示应用核心 Hook 层与 OneBot 协议层的关键事件日志；
• 支持按日志级别（INFO / WARN / ERROR）筛选过滤；
• 便于快速定位消息是否成功解析、是否顺利推送至机器人框架。