这是一个为 AstrBot 设计的多功能 Bilibili 插件。
- Bilibili 视频解析：自动识别消息中的
BV号，并返回视频的详细信息。 - UP 主动态订阅：
- 支持订阅
视频动态、图文动态和直播。 - 提供灵活的关键词和类型过滤。
- 默认每个 UP 主检测周期为
300秒（5 分钟），任务间最小间隔为20秒，可根据需要在插件配置中修改。
- 支持订阅
- 推荐番剧
- 试着对 LLM 说
推荐一些催泪的番剧，2016年之后的。 - 支持类别、番剧起始年份、番剧结束年份、番剧季度（一月番等）
- 需要支持函数调用的 LLM。如 gpt-4o-mini
- 试着对 LLM 说
- QQ 小程序解析：自动识别并解析 QQ 聊天中分享的 Bilibili 小程序，提取并返回直链。
- 后续还会增加更多功能！！
- 在插件市场下载
- 通过以下指令进行安装：
plugin i https://github.com/Soulter/astrbot_plugin_bilibili插件至少需要配置 sessdata 才能正常获取 Bilibili 数据。
以下是两种配置方式：
- 参考 此指南 获取你的
sessdata。
- 使用
/bili_login指令获取登录二维码，扫码登录后插件会自动获取并保存凭据。 此方式有利于解决issue #58所述412问题。不推荐使用主账号登录。
AstrBot >= 4.26.0 可在 WebUI 的「插件详情 → 订阅管理」打开 Plugin Page，集中管理会话订阅。页面还支持上传自定义渲染头像，图片会保存到插件数据目录并替换订阅成功、直播和视频信息卡片中的默认头像；可随时恢复默认图片。
新增 Page 目录后请重载插件；UP 主公开资料会在页面中按需查询。
| 指令 | 参数 | 说明 | 别名 |
|---|---|---|---|
| bili_sub | <B站UID> [过滤器...] |
订阅指定 UP 主的动态。可以添加多个过滤器（以空格分隔）以排除不感兴趣的内容。 | 订阅动态 |
| bili_sub_list | (无) | 显示当前会话的所有订阅。 | 订阅列表 |
| bili_sub_del | <B站UID> |
删除当前会话中对指定 UP 主的订阅。 | 订阅删除 |
| bili_global_del | <SID> |
[管理员] 删除指定会话的所有订阅。使用 /sid 指令可查看会话 UMO。建议以「」包裹SID，形如/bili_global_del 「QQ 12345:FriendMessage:67890」 |
全局删除 |
| bili_global_list | (无) | [管理员] 查看所有会话的订阅情况。 | 全局列表 |
| bili_global_sub | <SID> <B站UID> [过滤器...] |
[管理员] 为指定会话（UMO）添加对 UP 主的订阅。建议以「」包裹SID，形如/bili_global_sub 「QQ 12345:FriendMessage:67890」 123456 |
全局订阅 |
| bili_sub_test | <B站UID> |
测试订阅功能。仅测试获取动态与渲染图片功能，不保存订阅信息。 | 订阅测试 |
| bili_card_style | [样式名] |
[管理员] 切换动态卡片渲染样式。不带参数查看可用样式列表。 | 卡片样式 |
| bili_login | (无) | [管理员] 获取二维码以登录。仅支持在私聊中触发。 | (无) |
| bili_logout | (无) | [管理员] 注销服务端登录态，并删除已保存的登录凭据，转而采用配置项中的sessdata（如果有） | (无) |
1. 过滤器（过滤不感兴趣的内容）
forward：过滤掉转发动态。lottery：过滤掉互动抽奖动态。video：过滤掉视频发布动态。article：过滤掉专栏动态。draw：过滤掉图文动态。live：过滤掉开播和下播提醒。live_end：仅过滤掉下播提醒，保留开播提醒。forward_lottery：过滤掉转发的互动抽奖动态。- 正则表达式：任何不属于上述保留关键字的字符串都将被视为正则表达式，用于过滤动态文本内容。
2. 提醒选项（控制群聊 @ 提醒）
at_all：开启后，在群聊中检测到该 UP 主发布动态或开播时，将尝试@全体成员。live_atall：开启后，仅在检测到该 UP 主开播时尝试@全体成员（发布普通动态时不会）。at_sub：设置后，会将当前发送指令的用户加入特定提醒列表。UP 主推送动态或开播时会专门@该用户。unat_sub：取消当前用户对该 UP 主的特定@提醒。
⚠️ 注意：
- 使用
@全体成员相关的配置（at_all和live_atall）需要发送指令的用户拥有群管理员及以上权限，且机器人自身也必须具备群管理员权限，否则将降级为普通推送。- 为避免打扰群友，在检测到 UP 主下播时，不会触发任何形式的
@提醒。
示例：
/订阅动态 123456 lottery 关注
/bili_sub 123456 lottery 关注
这条指令会订阅 UID 为 123456 的 UP 主，但会过滤掉抽奖动态以及动态内容中包含“关注”二字的动态。
提示：该指令也用于更新已订阅 UP 主的过滤条件。
- aiocqhttp
- nakuru
-
渲染图片失败
一般是公共接口不稳定性导致，详见issue43 -
AstrBot更新到4.0版本后订阅失效
UMO结构发生了变化，已为"全局列表"指令添加了具体订阅信息，使用该指令查看后重新订阅即可。
简便的方法是进入data/plugin_data/astrbot_plugin_bilibili文件夹修改UMO的第一部分（使用"/sid"指令了解区别）。 -
使用新渲染模板发不出图片
由于图文动态布局采用了纵向布局，如果图片过长，受限于qq本身机制，需以文件形式发送。
你很可能需要在AstrBot"配置文件-系统配置"配置"对外可达的回调接口地址" -
生成的图片被错误裁剪或有多余区域
始终推荐自部署，并且由于t2i服务更新，推荐及时更新到最新的镜像。
本插件会始终在合适时支持更新的版本。
详见PR#53
# 启动UI开发模式
cd astrbot_plugin_bilibili
python dev_ui.pyastrbot-t2i-playground 也可以帮助开发和调试模板。