📖 介绍
BiliLive 是一个基于 NoneBot2 的 B 站推送插件，支持将 UP 主的直播与动态消息推送到 QQ 群或私聊场景。
目前支持的适配器：OneBot V11。
特性
- 支持按 UP 主维度分别开启或关闭动态、直播推送。
- 支持群内管理员权限控制，限制机器人使用范围。
- 支持直播或动态推送时尝试 @全体成员。
- 支持多 Bot 推送失败回退与基础异常清理。
- 支持 Playwright 截图与验证码服务接入。
💿 安装
使用 nb-cli 安装
在 NoneBot2 项目根目录执行：
nb plugin install nonebot-plugin-bililive
使用包管理器安装
在 NoneBot2 项目虚拟环境中安装：
pip install nonebot-plugin-bililive
然后在 NoneBot2 项目根目录的 pyproject.toml 中加载插件：
[tool.nonebot]
plugins = ["nonebot_plugin_bililive"]
首次使用动态截图功能时，插件会自动检查并安装 Chromium。插件数据目录统一由 nonebot-plugin-localstore 提供，无需再单独配置数据目录。
⚙️ 配置
在 NoneBot2 项目的 .env 文件中按需添加配置项：
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| BILILIVE_TO_ME | 否 | true | 是否需要 @机器人 或命令前缀触发 |
| BILILIVE_PROXY | 否 | 无 | HTTP 代理地址，用于 B 站请求和 Playwright 下载 |
| BILILIVE_INTERVAL | 否 | 10 | 默认轮询间隔，单位秒 |
| BILILIVE_LIVE_INTERVAL | 否 | 10 | 直播轮询间隔，单位秒 |
| BILILIVE_DYNAMIC_INTERVAL | 否 | 0 | 动态轮询间隔，单位秒，0 表示使用默认逻辑 |
| BILILIVE_DYNAMIC_AT | 否 | false | 动态推送时是否尝试 @全体 |
| BILILIVE_LIVE_OFF_NOTIFY | 否 | false | 是否推送下播通知 |
| BILILIVE_CAPTCHA_ADDRESS | 否 | https://captcha-cd.ngworks.cn | 验证码识别服务地址 |
| BILILIVE_CAPTCHA_TOKEN | 否 | bililive | 验证码服务 token |
| BILILIVE_DYNAMIC_TIMEOUT | 否 | 30 | 动态截图超时时间，单位秒 |
| BILILIVE_DYNAMIC_FONT_SOURCE | 否 | system | 截图字体来源 |
| BILILIVE_DYNAMIC_FONT | 否 | Noto Sans CJK SC | 截图字体 |
| BILILIVE_DYNAMIC_BIG_IMAGE | 否 | false | 是否优先展示大图 |
| BILILIVE_COMMAND_PREFIX | 否 | 空字符串 | 命令额外前缀 |
| BILILIVE_CHROMIUM_ENDPOINT | 否 | 无 | 外部 Chromium CDP 地址，如 http://127.0.0.1:9222 |
动态抓取优先使用 BILILIVE_CHROMIUM_ENDPOINT 连接的外部 Chromium；未配置时使用 Playwright 持久化浏览器中的 cookies 请求网页动态接口。若某些 UID 持续抓取失败，建议在外部 Chromium 或插件浏览器数据目录中登录常用 B 站账号，以降低风控概率。
🎉 使用
指令表
| 指令 | 权限 | 需要@ | 范围 | 说明 |
|---|---|---|---|---|
| 帮助 | 群员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 查看帮助信息 |
| 关注 UID | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 订阅指定 UP |
| 取关 UID | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 取消订阅 |
| 关注列表 | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 查看当前订阅 |
| 开启直播 UID | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 开启某 UP 的直播推送 |
| 关闭直播 UID | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 关闭某 UP 的直播推送 |
| 开启动态 UID | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 开启某 UP 的动态推送 |
| 关闭动态 UID | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 关闭某 UP 的动态推送 |
| 开启全体 UID | 管理员 | 视 BILILIVE_TO_ME 而定 | 群聊 | 开启直播推送 @全体 |
| 关闭全体 UID | 管理员 | 视 BILILIVE_TO_ME 而定 | 群聊 | 关闭直播推送 @全体 |
| 开启权限 | 管理员 | 视 BILILIVE_TO_ME 而定 | 群聊 | 限制仅管理员可使用 |
| 关闭权限 | 管理员 | 视 BILILIVE_TO_ME 而定 | 群聊 | 关闭管理员权限限制 |
| 已开播 | 群员/管理员 | 视 BILILIVE_TO_ME 而定 | 群聊/私聊 | 查看已开播关注列表 |
效果图
开发
本仓库保留了本地开发启动方式：
python bot.py
用于发布的插件入口模块为：
nonebot_plugin_bililive
致谢
许可证
本项目使用 GNU AGPLv3 作为开源许可证。
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-bililive 2.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nonebot_plugin_bililive-2.2.0.tar.gz | 50.7 kB | Without provenance | Details for nonebot_plugin_bililive-2.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nonebot_plugin_bililive-2.2.0-py3-none-any.whl | Python 3 | none | any | Details for nonebot_plugin_bililive-2.2.0-py3-none-any.whl |
Total release size: 112.8 kB
Release files / nonebot_plugin_bililive-2.2.0.tar.gz
| Download URL | nonebot_plugin_bililive-2.2.0.tar.gz |
|---|---|
| Size | 50.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
513fc126e4f6a1c9844a8c50103aa353b60c8814fe4af6051a1688fefbc22cb0
|
|
BLAKE2b-256 checksum How to use checksums |
b85811cfef987d250721cdb21a08855073e3978d2d9b1e066d6c4102510879c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
pdm/2.27.0 CPython/3.11.15 Linux/6.17.0-1018-azure
|
Release files / nonebot_plugin_bililive-2.2.0-py3-none-any.whl
| Download URL | nonebot_plugin_bililive-2.2.0-py3-none-any.whl |
|---|---|
| Size | 62.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c5344f63804e31612a07f10d5dab877f44f030cfd9e8f2f3fc5701a7448148f
|
|
BLAKE2b-256 checksum How to use checksums |
82e04f3c3a9eea7e44effcf6df1acd412bf9011b2960b8f434139b2498b9c0b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
pdm/2.27.0 CPython/3.11.15 Linux/6.17.0-1018-azure
|
Security for nonebot-plugin-bililive 2.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
