1）程序启动后没反应/无法推送

• 先确认 OneBot 配置正确
  • config.yml 的 http.api_url 能访问
  • config.yml 的 websocket.url 能连接
• 确认机器人在线
  • OneBot 框架本身要先登录 QQ 并保持在线
• 查看日志
  • data/logs/bilibili.log
  • 重点关注：连接失败、鉴权失败、发送消息失败等提示

2）Web 管理后台打不开

• 以 config.yml 为准确认后台地址：
  • web.host（默认 127.0.0.1）
  • web.port（默认 5000，你的配置可能是 5068）
• 浏览器访问：
  • http://{web.host}:{web.port}/#/login
• 端口被占用时：
  • 修改 web.port 换一个端口后重启程序

3）群命令提示“只能在群聊中使用”

这是正常的权限/场景限制：

• 群订阅直播 / 群订阅动态 / 群直播列表 / 群动态列表 / 群取消… 只能在群聊里使用
• 私聊里请使用对应的私聊命令（不带“群”字）

4）订阅提示找不到用户/找不到直播间

可能原因：

• 输入的 用户名拼写不正确
• 输入 UID/房间号不正确
• 目标用户没有直播间/直播间不可用

建议：

• 优先使用 UID 或房间号（更稳定）
• 用户名方式依赖查询，偶尔会受网络/接口影响

5）动态图片/渲染异常

建议检查 config.yml 的 Chrome 路径：

• chrome.executable_path

如果你的电脑没有安装 Chrome 或安装路径非默认，建议填写 绝对路径 并重启程序。

6）更新命令无效/没有更新按钮

• 自动更新只对 主人QQ 开放
• 先在 Web 后台设置主人QQ
• 然后私聊机器人发送：
  • 更新哔哩哔哩 或 更新Bilibili