BiliBili Helper

基于 Mirai Console 的 哔哩哔哩 订阅插件

使用前应该查阅的相关文档或项目

• User Manual
• Permission Command
• Chat Command

从 1.2.5 版本开始 将截图部分功能的转移至 mirai-selenium-plugin
截图功能的启用需要其作为前置插件
关于截图支持的环境请浏览 运行平台支持
直播 @全体成员 详见配置 此设置 1.5.0 废除
自动触发URL解析 详见 信息解析 指令
消息 模板 详见配置(自 1.4.0 起截图功能由模板内容来配置)

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/B视频 添加 11783021
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.bilibili-helper:command.*, * 是指令的第一指令名
例如 /B动态 添加 496371957 的权限ID为 xyz.cssxsh.mirai.plugin.bilibili-helper:command.bili-dynamic

参数 uid 例如 https://space.bilibili.com/508963009/ 的数字 508963009
参数 contact 为QQ号或者群号，可以省略，会从当前聊天环境获取，
比如群聊中会自动填充为当前群号, 但控制台中必须填充

子指令 sleep/at 的 target 是 被许可人 ID
处于休眠时间的订阅将不会推送，举例

• /bili-dynamic g12345 00:00 06:00, 00:00~06:00 时间段内将不会推送

处于艾特时间的订阅将会添加艾特，举例

• /bili-live g12345 19:00 23:00, 19:00 23:00 时间段内将会艾特全体
• /bili-live u456789 19:00 23:00, 19:00 23:00 时间段内将会艾特用户456789

子指令 cron 的 cron 参数是 CRON 表达式, 由 秒 分钟 小时 日 月 周 组成
例如：

• 0 0 14 * * ? 表示每天 14:00 都执行一次
• 0 0 18 ? * 2-6 表示星期一至星期五 每天 18:00 执行一次
  可以使用在线编辑器生成 https://www.bejson.com/othertools/cron/
  为防止被 空格 分成多个参数，请使用 " 包裹参数

动态订阅指令

/bili-dynamic forbid 转发抽奖 添加一个正则屏蔽
/bili-dynamic forbid 转发抽奖 false 取消一个正则屏蔽
/bili-dynamic filter 视频 添加一个动态类型过滤
/bili-dynamic filter 视频 false 取消一个动态类型过滤
type 取值 回复, 图片, 文本, 视频, 专栏, 音乐, 剧集, 删除, 番剧, 电视, 直播

直播订阅指令

视频订阅指令

/bili-video forbid 付费 添加一个类型屏蔽
/bili-video forbid 付费 false 取消一个类型屏蔽
/bili-video filter 1 添加一个分区过滤过滤
/bili-video filter 1 false 取消一个分区过滤过滤
type 取值 付费, 联合, 回放
tid 取值请参考 https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/video_zone.md

视频订阅不宜过多，否则会触发b站反爬策略，导致IP被锁定 动态订阅一般会包含视频内容，推荐以此代替

剧集订阅指令

剧集订阅需要 Season ID 例如 https://www.bilibili.com/bangumi/play/ss38353 的 38353
可以通过 搜索指令 搜索番剧 获得链接

信息解析指令

返回结果包含图片，需要在聊天环境执行指令
消息中包含 BV12v411G7dP av2 等等 id 信息时会自动触发解析
目前会触发的正则表达式

// Video
"""(?i)(?<!\w)(?:av(\d+)|(BV[0-9A-z]{10}))"""
// Dynamic
"""(?<=t\.bilibili\.com/(?:h5/dynamic/detail/)?)(\d+)"""
// Live Room
"""(?<=live\.bilibili\.com/)(\d+)"""
// User Space
"""(?<=space\.bilibili\.com/|bilibili\.com/space/)(\d+)"""
// Season
"""(?i)(?<!\w)ss(\d{4,10})"""
// Episode
"""(?i)(?<!\w)eq(\d{4,10})"""
// Media
"""(?i)(?<!\w)md(\d{4,10})"""
// Article
"""(?i)(?<!\w)cv(\d{4,10})"""
"""(?<=bilibili\.com/read/mobile\?id=)(\d+)"""
// Short Link
"""(?<=b23\.tv\\?/)[0-9A-z]+"""

搜索指令

返回结果包含图片，需要在聊天环境执行指令

任务列表指令

模板配置指令

pattern 的 取值为 DateTimeFormatter
举例：

• /B模板 datetime ISO_LOCAL_DATE_TIME
• /B模板 datetime yyyy-MM-dd

设置

位于Mirai-Console运行目录下的config/xyz.cssxsh.mirai.plugin.bilibili-helper文件夹下

BiliHelperSettings.yml

• cache 图片缓存位置, 默认为 ImageCache
• limit 动态 订阅 输出图片数量上限, 默认为 16
• api API 访问间隔时间，单位秒, 默认为 10
• video 视频 订阅 访问间隔时间，单位分钟, 默认为 10
• dynamic 动态 订阅 访问间隔时间，单位分钟, 默认为 10
• live 直播 订阅 访问间隔时间，单位分钟, 默认为 30
• season 番剧 订阅 访问间隔时间，单位分钟, 默认为 30
• refresh 启动时刷新 last，订阅最后推送将会重新开始记录，未推送内容将会因此丢弃
• selenium 是否启用截图 此配置项废弃，通过 Template 文件内容来确定是否启用截图
• ban 排除的自动解析内容，可以放一些不希望被解析的AV号之类的
• forward 转发自动解析, 使用转发的形式发送自动解析结果
• max 一次性推送的订阅内容上限, 超过这个上限将会尝试合并为转发消息

BiliCleanerConfig.yml

• interval 图片清理的间隔时间，单位 小时
• expires 图片缓存过期时间，单位 小时

SeleniumConfig.yml

• user_agent 截图设备UA 网页识别设备类型，进而影响截图的效果
  iPad Mozilla/5.0 (iPad; CPU OS 11_0 like Mac OS X) AppleWebKit/604.1.34 (KHTML, like Gecko) Version/11.0 Mobile/15A5341f Safari/604.1 MicroMessenger
  iPhone Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1 MicroMessenger
  Mac Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_8; en-us) AppleWebKit/534.50 (KHTML, like Gecko) Version/5.1 Safari/534.50 MicroMessenger
• width 截图宽度
• height 截图高度
• pixel_ratio 截图像素比 此配置废除
• headless 无头模式(后台模式)
• home 浏览器会保持打开主页，以加快其他页面加载速度 此配置废除
• hide 隐藏的web组件(jQ选择器)
  添加 ".international-header", ".top-bar", ".m-navbar" 可以屏蔽顶边栏

LiveAtAll

此设置 1.5.0 废除
此配置通过权限设置，权限ID为 xyz.cssxsh.mirai.plugin.bilibili-helper:live.atall
配置对象为群，即 g*, g12345
举例，perm add g12345 xyz.cssxsh.mirai.plugin.bilibili-helper:live.atall

Template

位于 config/xyz.cssxsh.mirai.plugin.bilibili-helper/Template 目录下的 template 文件
文件名为对应的配置对象（类名），文件内容的 #... 是替换标记，将会替换为对应的值
值的名称请参考 bilibili/data 中的数据定义
#images, #detail, #screenshot 为特殊的替换标记，将会替换为特殊的处理结果
#images 将会替换为内容图片
在 BiliRoomInfo 中 #detail 将会替换为对应的 Live
在 DynamicCard 中 #detail 将会替换为对应的 card 解析结果
在 DynamicInfo 中 #screenshot 将会替换为截图（需要安装 mirai-selenium-plugin） 在 Article 中 #screenshot 将会替换为截图（需要安装 mirai-selenium-plugin） 例如可以将 VideoStatus.template 改为

👍 #like 💰 #coin ⭐ #favorite
▶️ #view 💬 #reply 🔄 #share

Cookies

位于 data/xyz.cssxsh.mirai.plugin.bilibili-helper/cookies.json
导入 cookies文件 不是必须的，这是实验性功能，主要是防止b站反爬IP锁定
从 浏览器插件 EditThisCookie 导出Json 填入文件
EditThisCookie 安装地址 Chrome Firefox Edge

安装

MCL 指令安装

./mcl --update-package xyz.cssxsh:bilibili-helper --channel stable --type plugin

手动安装

1. 运行 Mirai Console 生成plugins文件夹
2. 从 Releases 下载jar并将其放入plugins文件夹中

截图前置

./mcl --update-package xyz.cssxsh.mirai:mirai-selenium-plugin --channel stable --type plugin

TODO

• 完善剧集订阅
• 自动清理图片缓存