简介
HarukaBot 是一款基于 NoneBot2 开发的 B 站内容推送机器人，能够将 UP 主的直播状态和动态更新实时推送到 QQ 群聊。该工具专为 B 站粉丝设计，支持轻量级配置。
部署流程
环境准备
确保系统已安装 Python 3.7+ 和 Git。
项目获取
通过以下命令获取项目源码：
git clone https://gitcode.com/gh_mirrors/ha/HarukaBot
cd HarukaBot
依赖安装
使用 PDM 包管理器一键安装所需依赖：
pdm install
配置与启动
在项目根目录创建 .env 配置文件，填入机器人的 QQ 账号和密码信息。执行启动命令后，机器人将开始运行。可在 QQ 群中测试基础指令确认功能正常。
核心功能
直播监控与推送
持续监控已订阅 UP 主的直播状态，一旦检测到开播信号，立即向指定 QQ 群发送通知。相关功能实现位于 haruka_bot/plugins/live/ 目录。
动态内容抓取
通过内置浏览器内核，机器人能够抓取 UP 主的最新动态并以截图形式推送，还原 B 站网页端的浏览体验。具体技术细节可参考 haruka_bot/libs/dynamic/ 模块。
订阅管理
支持灵活的订阅管理机制，用户可以轻松添加、删除或查询已订阅的 UP 主列表。
高级配置
多账号分流
当需要管理多个 QQ 群时，可以部署多个机器人实例，通过账号分流确保每个群都能及时接收推送信息。
权限控制
通过 haruka_bot/plugins/permission/ 模块，设置不同级别的操作权限，确保机器人稳定运行。
操作指南
订阅 UP 主
在 QQ 群中输入 /添加订阅 指令，按照提示完成 UP 主 ID 输入和推送类型选择即可。
直播提醒设置
对于重要 UP 主，可以开启 @全体提醒功能，确保群内所有成员都能收到开播通知。
权限管理
通过简单的指令即可开启或关闭权限管理功能，有效保护机器人免受误操作影响。
常见问题
连接失败排查
如果机器人提示连接失败，首先检查配置文件中的账号密码是否正确，确认机器人 QQ 号已开启第三方登录权限。
推送延迟优化
当推送延迟超过预期时，建议检查服务器网络状况，优化网络连接质量。