astrbot_plugin_bilibili

这是一个为 AstrBot 设计的多功能 Bilibili 插件。

✨ 功能特性

• Bilibili 视频解析：自动识别消息中的 BV 号，并返回视频的详细信息。
• UP 主动态订阅：
  • 支持订阅 视频动态、图文动态 和 直播。
  • 提供灵活的关键词和类型过滤。
  • 默认每个 UP 主检测周期为 300 秒（5 分钟），任务间最小间隔为 20 秒，可根据需要在插件配置中修改。
• 推荐番剧
  • 试着对 LLM 说 推荐一些催泪的番剧，2016年之后的。
  • 支持类别、番剧起始年份、番剧结束年份、番剧季度（一月番等）
  • 需要支持函数调用的 LLM。如 gpt-4o-mini
• QQ 小程序解析：自动识别并解析 QQ 聊天中分享的 Bilibili 小程序，提取并返回直链。
• 后续还会增加更多功能！！

🚀 安装

• 在插件市场下载
• 通过以下指令进行安装：

plugin i https://github.com/Soulter/astrbot_plugin_bilibili

⚙️ 配置

插件至少需要配置 sessdata 才能正常获取 Bilibili 数据。 以下是两种配置方式：

1. 参考 此指南 获取你的 sessdata。

2. 使用/bili_login指令获取登录二维码，扫码登录后插件会自动获取并保存凭据。 此方式有利于解决issue #58所述412问题。不推荐使用主账号登录。

📖 使用说明

动态订阅指令

指令	参数	说明	别名
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	[样式名]	[管理员] 切换动态卡片渲染样式。不带参数查看可用样式列表。	卡片样式
bili_login	(无)	[管理员] 获取二维码以登录。仅支持在私聊中触发。	(无)
bili_logout	(无)	[管理员] 删除已保存的登录凭据，转而采用配置项中的sessdata（如果有）	(无)

过滤器说明

过滤器可以是以下几种类型：

• forward：过滤掉转发动态。
• lottery：过滤掉互动抽奖动态。
• video：过滤掉视频发布动态。
• article：过滤掉专栏动态。
• draw：过滤掉图文动态。
• live：过滤掉直播动态。
• forward_lottery：过滤掉转发的互动抽奖动态。
• live_atall：可选项。开启后，在群聊中检测到“开播”通知时会尝试 @全体成员。
• 正则表达式：任何不属于上述关键字的字符串都将被视为正则表达式，用于过滤动态文本内容。

示例： /订阅动态 123456 lottery 关注 /bili_sub 123456 lottery 关注 这条指令会订阅 UID 为 123456 的 UP 主，但会过滤掉抽奖动态以及动态内容中包含“关注”二字的动态。

提示：该指令也用于更新已订阅 UP 主的过滤条件。

适用平台/适配器

• aiocqhttp
• nakuru

常见问题

1. 渲染图片失败
   一般是公共接口不稳定性导致，详见issue43

2. 错误代码-352 / 412
   先查看以下issue中解决方案issue34、issue58、issue72

3. AstrBot更新到4.0版本后订阅失效
   UMO结构发生了变化，已为"全局列表"指令添加了具体订阅信息，使用该指令查看后重新订阅即可。
   简便的方法是进入data/plugin_data/astrbot_plugin_bilibili文件夹修改UMO的第一部分（使用"/sid"指令了解区别）。

4. 使用新渲染模板发不出图片
   由于图文动态布局采用了纵向布局，如果图片过长，受限于qq本身机制，需以文件形式发送。
   你很可能需要在AstrBot"配置文件-系统配置"配置"对外可达的回调接口地址"

5. 生成的图片被错误裁剪或有多余区域
   始终推荐自部署，并且由于t2i服务更新，推荐及时更新到最新的镜像。
   本插件会始终在合适时支持更新的版本。

模板开发

详见PR#53

# 启动UI开发模式
cd astrbot_plugin_bilibili
python dev_ui.py

astrbot-t2i-playground 也可以帮助开发和调试模板。

Contributors

更新日志

见 CHANGELOG.md