astrbot_plugin_bilibili
这是一个为 AstrBot 设计的多功能 Bilibili 插件。
✨ 功能特性
- Bilibili 视频解析:自动识别消息中的
BV号,并返回视频的详细信息。 - UP 主动态订阅:
- 支持订阅
视频动态、图文动态和直播。 - 提供灵活的关键词和类型过滤。
- 默认轮询时间为
5分钟,可根据需要在插件配置中修改。
- 支持订阅
- 推荐番剧
- 试着对 LLM 说
推荐一些催泪的番剧,2016年之后的。 - 支持类别、番剧起始年份、番剧结束年份、番剧季度(一月番等)
- 需要支持函数调用的 LLM。如 gpt-4o-mini
- 试着对 LLM 说
- QQ 小程序解析:自动识别并解析 QQ 聊天中分享的 Bilibili 小程序,提取并返回直链。
- 后续还会增加更多功能!!
🚀 安装
- 在插件市场下载
- 通过以下指令进行安装:
plugin i https://github.com/Soulter/astrbot_plugin_bilibili
⚙️ 配置
插件需要配置 sessdata 才能正常获取 Bilibili 数据。
参考 此指南 获取你的 sessdata。
📖 使用说明
动态订阅指令
| 指令 | 参数 | 说明 | 别名 |
|---|---|---|---|
| bili_sub | <B站UID> [过滤器...] |
订阅指定 UP 主的动态。可以添加多个过滤器(以空格分隔)以排除不感兴趣的内容。 | 订阅动态 |
| bili_sub_list | (无) | 显示当前会话的所有订阅。 | 订阅列表 |
| bili_sub_del | <B站UID> |
删除当前会话中对指定 UP 主的订阅。 | 订阅删除 |
| bili_global_del | <SID> |
[管理员] 删除指定会话的所有订阅。使用 /sid 指令可查看会话 UMO。 |
全局删除 |
| bili_global_list | (无) | [管理员] 查看所有会话的订阅情况。 | 全局列表 |
| bili_global_sub | <SID> <B站UID> [过滤器...] |
[管理员] 为指定会话(UMO)添加对 UP 主的订阅。 | 全局订阅 |
| bili_sub_test | <B站UID> |
测试订阅功能。仅测试获取动态与渲染图片功能,不保存订阅信息。 | 订阅测试 |
| bili_card_style | [样式名] |
[管理员] 切换动态卡片渲染样式。不带参数查看可用样式列表。 | 卡片样式 |
过滤器说明
过滤器可以是以下几种类型:
forward:过滤掉转发动态。lottery:过滤掉互动抽奖动态。video:过滤掉视频发布动态。article:过滤掉专栏动态。draw:过滤掉图文动态。live:过滤掉直播动态。- 正则表达式:任何不属于上述关键字的字符串都将被视为正则表达式,用于过滤动态文本内容。
示例:/订阅动态 123456 lottery 关注/bili_sub 123456 lottery 关注
这条指令会订阅 UID 为 123456 的 UP 主,但会过滤掉抽奖动态以及动态内容中包含“关注”二字的动态。
提示:该指令也用于更新已订阅 UP 主的过滤条件。
适用平台/适配器
- aiocqhttp
- nakuru
常见问题
渲染图片失败 (尝试次数: 1): 500, message='Internal Server Error'
一般是公共接口不稳定性导致,详见issue43错误代码-352
尝试issue34中方法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.py
Contributors
更新日志
v1.4.19
- 交换指令名与指令别名,更好地用于更多平台适配器,对用户无实际影响
- 相同动态对应图片不再重复渲染
- 修复小程序解析错误
- 图片质量提升等小改动
‼️astrbot_plugin_bilibili >= v1.4.14 需要 Astrbot >= 4.5.2;原因是使用了Astrbot >= 4.5.2推荐的函数调用写法,而Astrbot >= 4.5.3修复了webui工具显示错误,推荐升级到Astrbot >= 4.5.3
历史日志见 CHANGELOG.md