Topics created by cssxsh

Mirai Device Generator

Mirai DeviceInfo 生成器

maven-central

作为插件运行时会检测 mcl/bots/.../device.json, mcl/device.json 是否存在，不存在则生成。

Mirai Hibernate Plugin

Mirai Hibernate 前置插件

Mirai Console 的前置插件，用于 Hibernate ORM 框架的初始化

maven-central

插件自带聊天记录器 MiraiHibernateRecorder,
会记录 群聊/私聊 的内容到数据库方便其他插件使用，默认是 h2database 数据库(since 2.2.0+)
数据库配置在 config/xyz.cssxsh.mirai.plugin.mirai-hibernate-plugin/hibernate.properties
2.2.0 之前的版本的 默认数据库 为 sqlite, 你可以直接删掉 hibernate.properties, 让其重新生成 h2database 配置

数据库支持

本插件打包了以下版本的数据库驱动和连接池

mysql:mysql-connector-java:8.0.29 org.xerial:sqlite-jdbc:3.36.0.3 org.postgresql:postgresql:42.3.5 com.h2database:h2:2.1.212 com.zaxxer:HikariCP:5.0.1

需要其他数据库驱动支持请将 数据库驱动Jar包 放到 plugins 目录中一同被 mirai-console 加载

在插件项目中引用 repositories { mavenCentral() } dependencies { compileOnly("xyz.cssxsh.mirai:mirai-hibernate-plugin:${version}") } 一些方法和类说明

MiraiHibernateConfiguration
配置的，对应于 JvmPlugin 的 SessionFactory
默认将会读取(生成)在 configFolder 目录下的 hibernate.properties 作为配置文件
并且自动扫描加载 JvmPlugin 所在类包下的被 javax.persistence.Entity 标记的实体类

MiraiHibernateRecorder
是本插件自带的消息记录器，通过对 MessageEvent 和 MessagePostSendEvent 记录，保存消息历史到数据库

CriteriaBuilder.rand
MiraiHibernateConfiguration 中会对 Sqlite 的 random 进行别名注册为 rand 统一SQL语句的中的随机函数名

示例代码 kotlin 安装 MCL 指令安装

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

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中

我觉得应该有

场景（对应mirai里的事件）
（群聊、私聊、加群、加好友...） 功能
（发消息、禁言、处理加群....） 用户/受用对象
（群员、好友...） 可配置项
（权限....） 触发方式
（指令、内容解析、定时...） 给开发者付款的方式

Mirai Selenium Plugin

Mirai Selenium 前置插件

Mirai-Console的前置插件，用于使用Selenium调用浏览器进行截图等

maven-central

运行平台支持 OS Browser Support Windows Chrome Yes Windows Firefox Yes Windows Edge Yes Linux Chrome Yes Linux Firefox Yes MacOS Chrome Test MacOS Firefox Test 在插件项目中引用 repositories { mavenCentral() } dependencies { compileOnly("xyz.cssxsh.mirai:mirai-selenium-plugin:${version}") } 示例代码 kotlin 使用本前置插件的项目 BiliBili Helper 配置 MiraiSeleniumConfig.yml user_agent 截图UA width 截图宽度 height 截图高度 pixel_ratio 截图像素比 headless 无头模式（后台模式） proxy 代理地址 log 启用日志文件 browser 指定使用的浏览器: Chrome,Firefox,Edge factory 指定使用的Factory: ktor,netty 安装 MCL 指令安装

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

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中

非官方的Mirai开发者交流群
天网开发组: 634148065

加群问题请提交github id
例如：
https://github.com/cssxsh 的 cssxsh
https://github.com/mzdluo123的 mzdluo123

请使用自己的GitHub ID 不要填cssxsh、mzdluo123

另外还有个
QQ频道：https://qun.qq.com/qqweb/qunpro/share?_wv=3&_wwv=128&inviteCode=2bR5WD&from=246610&biz=ka
这频道没有限制，都可以加

Netdisk FileSync Plugin

基于 Mirai Console 的 文件同步/备份 插件

Release
Downloads
MiraiForum
maven-central

本插件可以将接收到的群文件消息同步到百度网盘
备份的文件在 /apps/${app_name}/${group_id}/

本插件也可作为前置插件为其他插件提供百度云上传的API

指令 OAUTH指令 指令 描述 /<baidu-oauth> 按照指令完成百度账户的登陆 设置 oauth.yml

插件上传文件功能需要百度网盘API支持。
请到 https://pan.baidu.com/union/main/application/personal 申请应用，并将获得的APP信息填入
信息只在启动时读取，修改后需重启，并使用 /baidu-oauth 认证百度账号

upload.yml https 使用Https协议下载文件 在插件项目中引用 repositories { mavenCentral() } dependencies { compileOnly("io.github.gnuf0rce:netdisk-filesync-plugin:${version}") } 示例代码 try { io.github.gnuf0rce.mirai.NetDisk.getUserInfo() } catch (exception: NoClassDefFoundError) { logger.warning { "相关类加载失败，请安装 https://github.com/gnuf0rce/Netdisk-FileSync-Plugin $exception" } throw exception } 安装 MCL 指令安装

./mcl --update-package io.github.gnuf0rce:netdisk-filesync-plugin --channel stable --type plugin

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中

大佬, 大神 等等称呼并不会给开发者带来实际的收益,
你口中的大佬一天也是只有24小时的时间，
并且已经因为写代码消耗了不少，
所以请尽可能详细的描述你的问题和需求，减少时间的浪费。

良好的代码/日志排版 阅读会更舒服

日志最好能是复制文本，而不是截图。方便把关键信息复制出来检索。

使用 插件/软件 前，要通读 readme

不推荐开启的功能 可能是实验性或者不可控的 所以开启之后不一定能带来更好的效果

影响下载速度的原因有 网络带宽，运营商(电信、移动，联通), Dns/Hosts, 丢包率, 代理 等等，只有一句下载很慢，开发者只能对着空气分析

GitHub Helper

基于 Mirai Console 的 GitHub Notice 订阅插件

Release
Downloads
MiraiForum
GitHub Client Test

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

User Manual Permission Command Chat Command 指令

注意: 使用前请确保可以 在聊天环境执行指令
<...>中的是指令名，例如/repo-issue add mamoe/mirai
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 io.github.gnuf0rce.github-helper:command.*, * 是指令的第一指令名
例如 /repo-issue add mamoe/mirai 的权限ID为 io.github.gnuf0rce.github-helper:command.repo-issue

[repo] 格式为 {owner}/{repo}, 举例 mamoe/mirai
[contact]?是可选的参数，会自动由当前环境填充，例如群聊填充群号，私聊填充QQ号
[type] 消息的格式，可选值为 OLD, TEXT, FORWARD, GRAPH

GitHubIssuesCommand 指令 描述 /<issues> <add> [contact]? 添加订阅 /<issues> <remove> [contact]? 移除订阅 /<issues> <interval> [millis] 设置订阅轮询间隔 /<issues> <format> [type] 设置订阅消息格式 /<issues> <list> [contact]? 查看订阅列表 /<issues> <test> [type] [contact]? 测试订阅

这个指令用于获取当前用户的issues，所以需要有效 token

GitHubRepoCommitCommand 指令 描述 /<repo-commit> <add> [repo] [contact]? 添加订阅 /<repo-commit> <remove> [repo] [contact]? 移除订阅 /<repo-commit> <interval> [repo] [millis] 设置订阅轮询间隔 /<repo-commit> <format> [repo] [type] 设置订阅消息格式 /<repo-commit> <list> [contact]? 查看订阅列表 /<repo-commit> <test> [repo] [type] [contact]? 测试订阅 GitHubRepoIssueCommand 指令 描述 /<repo-issue> <add> [repo] [contact]? 添加订阅 /<repo-issue> <remove> [repo] [contact]? 移除订阅 /<repo-issue> <interval> [repo] [millis]? 设置订阅轮询间隔 /<repo-issue> <format> [repo] [type] 设置订阅消息格式 /<repo-issue> <list> [contact]? 查看订阅列表 /<repo-issue> <test> [repo] [type] [contact]? 测试订阅 GitHubRepoPullCommand 指令 描述 /<repo-pull> <add> [repo] [contact]? 添加订阅 /<repo-pull> <remove> [repo] [contact]? 移除订阅 /<repo-pull> <interval> [repo] [millis]? 设置订阅轮询间隔 /<repo-pull> <format> [repo] [type] 设置订阅消息格式 /<repo-pull> <list> [contact]? 查看订阅列表 /<repo-pull> <test> [repo] [type] [contact]? 测试订阅 GitHubRepoReleaseCommand 指令 描述 /<repo-release> <add> [repo] [contact]? 添加订阅 /<repo-release> <remove> [repo] [contact]? 移除订阅 /<repo-release> <interval> [repo] [millis]? 设置订阅轮询间隔 /<repo-release> <format> [repo] [type] 设置订阅消息格式 /<repo-release> <list> [contact]? 查看订阅列表 /<repo-release> <test> [repo] [type] [contact]? 测试订阅 GitHubStatsCommand 指令 描述 /<stats> <card> [name] 查看状态 /<stats> <contribution> [name] 查看贡献 /<stats> <trophy> [name] 查看奖杯 设置 GithubConfig proxy Format http://127.0.0.1:8080 or socks://127.0.0.1:1080 doh Dns Over Https Url github_token Personal Access Tokens reply_type URL解析回复的消息格式 timeout Http 访问超时时间，单位秒 percentage_member_join 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能 percentages 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能 sign_member_join 加群放行提示信息 github_readme_stats stats card 绘制参数 安装 MCL 指令安装

请确认 mcl.jar 的版本是 2.1.0+
./mcl --update-package io.github.gnuf0rce:github-helper --channel maven-stable --type plugins

手动安装 从 Releases 或者 Maven 下载 mirai2.jar 将其放入 plugins 文件夹中

Debug Helper

基于 Mirai Console 的 调试小工具 插件

Release
Downloads
MiraiForum

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

User Manual Permission Command Chat Command

1.2.2 起
本插件中机器人管理的相关功能已经拆分至 mirai-administrator
请注意相关权限的重新处理。

指令

注意: 使用前请确保可以 在聊天环境执行指令
<...>中的是指令名
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 io.gnuf0rce.mirai.plugin.debug-helper:command.*, * 是指令的第一指令名
例如 /device 的权限ID为 io.gnuf0rce.mirai.plugin.debug-helper:command.device

DebugCommands 指令 描述 /<at-all> [text] [group]? 向指定群发送 AtAll /<gc> 主动触发 JVM GC /<random-image> [contact]? 随机发送一张图片 /<forward> [contact] [title]? 转发消息，句号结束 /<fork> [contact] {codes} 从mirai-code构造消息 /<rich> [content] 构造卡片消息 /<device> 查看 Bot 设备信息 /<backup-data> 备份数据 /<reload> [id] 热重载插件 /<system-property> [key] [value] 设置 system-property DebugSetting auto_download_message 自动保存特殊消息内容，比如闪照 random_image_api 随机图片API by https://rainchan.win/projects/pximg 修改协议内容

这是 1.3.5 新增的功能
在 data/io.github.gnuf0rce.debug-helper/ 下新建文本文件 ANDROID_PHONE.txt (可根据需要修改的协议名更改文件名)

填入例如 (注意这是 ANDROID_PHONE 的协议内容，如果需要其他协议，请自行解决)

com.tencent.mobileqq 537066978 0.9.15.9425 6.0.0.2463 150470524 66560 16724722 A6 B7 45 BF 24 A2 C2 77 52 77 16 F6 F3 6E B6 8D 1640921786 16 安装 MCL 指令安装

./mcl --update-package io.github.gnuf0rce:debug-helper --channel stable --type plugin

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中

Twitter Helper

基于 Mirai Console 的 Twitter 转发插件

Release
Downloads
MiraiForum

插件基于PC网页版 Twitter API，插件初始化时，会读取 Cookie文件 或 尝试模拟游客
API部分需要代理, 请修改配置文件中的 proxy 的键值对(host-proxy)
图片部分不在默认不在代理之中, 如需要请添加针对域名 pbs.twimg.com 的代理，
或设置全局代理(对域名 127.0.0.1 设置代理)

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/微博用户 订阅
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数
轮询间隔 默认是 (5 * 60 * 1000L)..(10 * 60 * 1000L) 5分钟到10中之间随机

用户订阅指令 指令 描述 /<tuser 推特用户> <add task 订阅> [id] 订阅一个推特账号 /<tuser 推特用户> <stop 停止> [id] 取消订阅一个推特账号 /<tuser 推特用户> <name 名字> [screen] name 到 id /<tuser 推特用户> <detail 详情> 查看订阅详情 /<tuser 推特用户> <interval> [fast] [slow] 设置轮询间隔，毫秒

关于推特用户的ID 可以 通过 推特用户主页的封面图片链接提取
例如 cococo_neko 的 图片链接
https://pbs.twimg.com/profile_banners/3064765422/1620052556/1500x500 的 3064765422
或者使用 https://tweeterid.com/ 进行查询
/tuser name 是实验性指令

列表订阅指令 指令 描述 /<tlist 推特列表> <add task 订阅> [id] 订阅一个推特列表 /<tlist 推特列表> <stop 停止> [id] 取消订阅一个推特列表 /<tlist 推特列表> <detail 详情> 查看订阅详情 /<tlist 推特用户> <interval> [fast] [slow] 设置轮询间隔，毫秒

关于推特列表的ID 可以 通过 列表的链接获取 例如 https://twitter.com/i/lists/1331511892083236865 的 1331511892083236865

推文详情指令 指令 描述 /<tweet 推文> [id] 查看一个推文

发送 推文链接如 https://twitter.com/sakula_yuki/status/1270623193674346501 也会出触发指令

配置

位于Mirai-Console运行目录下的config/twitter-helper文件夹下的TwitterHelperConfig文件

cookies Cookie 文件位置 total 简单的推特过滤， favorite + retweet * 2 + reply * 4 + quote * 8 >= total 时会被转发 source 只要原创 user 订阅排除的用户 (since 1.0.2) exclude 订阅排除的关键词正则表达式 (since 1.0.2) sensitive 敏感内容 (since 1.0.2) link 是否显示推文链接 (since 1.0.2) interval 两次推文发送的时间间隔 (since 1.0.2) count 每次轮询拉取的推文数 (since 1.0.2) cache 缓存目录 clear 图片缓存清理时间，单位小时，默认3天 (since 1.0.2) accessToken AccessToken doh Dns Over Https cname Dns CNAME proxy 代理选择器, 全局代理请对 域名 127.0.0.1 进行设置 安装 手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中

val thread = Thread.currentThread() val oc = thread.contextClassLoader try { thread.contextClassLoader = XXXPlugin::class.java.classLoader // 需要切换上下文的代码 } finally { thread.contextClassLoader = oc }

Rss Helper

基于 Mirai Console 的RSS订阅插件

Release
Downloads
MiraiForum

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/rss add https://github.com/cssxsh.atom
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数 下列指令的 URL 参数可以使用 base64 编码 后的形式

RssBaseCommand 指令 描述 /<rss> <add> [url] 添加一个订阅 /<rss> <list> 列出订阅列表 /<rss> <interval> [url] [duration] 设置订阅间隔, 单位分钟 /<rss> <stop> [url] 取消一个订阅 RssGithubCommand 指令 描述 /<rss-github> <releases> [owner] [repo] 添加一个Releases订阅 /<rss-github> <commits> [owner] [repo] 添加一个Commits订阅 /<rss-github> <tags> [owner] [repo] 添加一个Tags订阅 /<rss-github> <activity> [user] 添加一个Activity订阅 /<rss-github> <private> [user] [secret] 添加一个Private订阅 RssMikanCommand 指令 描述 /<rss-mikan mikan> <my> [token] 添加一个MyBangumi订阅 /<rss-mikan mikan> <classic> 添加一个Classic订阅 /<rss-mikan mikan> <bangumi> [id] [sub]? 添加一个Bangumi订阅 /<rss-mikan mikan> <search> [word] 添加一个Search订阅

指令基于 蜜柑计划

RssMoeCommand 指令 描述 /<rss-moe> <recent> 查看当季番剧TAG /<rss-moe> <search> [name] 搜索TAG /<rss-moe> <tags> {ids} 添加一个Tag订阅

指令基于 萌番组

RssTestCommand 指令 描述 /<rss-test> <build> [url] 测试一个订阅 /<rss-test> <ssl> 测试SSL /<rss-test> <clear> 清空种子文件 RssMiraiCommand 指令 描述 /<rss-mirai mirai> <category> [value] 添加标签订阅 /<rss-mirai mirai> <plugin> 添加插件发布订阅 /<rss-mirai mirai> <other> 添加其他项目发布订阅 RssHubCommand 指令 描述 /<rss-hub rsshub> <add> 交互添加RssHub订阅

交互过程举例

1748(1438159989) 23:29:58 /rsshub add QQBot(3337342367) 23:30:02 request returned 1899 routes QQBot(3337342367) 23:30:03 请输入路由名 1748(1438159989) 23:30:07 755 QQBot(3337342367) 23:30:07 (0, /755/user/:username) QQBot(3337342367) 23:30:08 /755/user/:username, 输入:username (置空可以输入#) 1748(1438159989) 23:30:21 akimoto-manatsu QQBot(3337342367) 23:30:26 1748 /rsshub add RSS订阅任务[秋元真夏(乃木坂46) - 755]已添加

配置文件 RssHubConfig.yml 可以配置rsshub的域名，即可以配置rsshub的源
此配置只对新的rsshub订阅订阅行为有效

配置 RssHubConfig domain rsshub 服务器的域名，默认为官方的 rsshub.app HttpClientConfig doh Dns Over Https Url (为空时关闭Doh，使用系统DNS since 1.0.0-dev-6) sni 需要移除 SNI HostName 的域名的正则表达式列表 proxy 代理列表 host: proxy, host=127.0.0.1时是全局代理 ipv6 doh 开启ipv6 支持 (since 1.0.3) RssContentConfig limit 订阅内容输出到QQ消息的最大长度，超过则只会输出 内容过长 TODO 翻译功能 代理支持 Doh支持 将Html转化为Mirai的MessageChain(主要目的是显示图片) 安装 MCL 指令安装

./mcl --update-package io.github.gnuf0rce:rss-helper --channel stable --type plugin

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中

Mirai Content Censor

基于 Mirai Console 和 百度AI内容审核 的自动禁言助手

Release
Downloads
MiraiForum

本插件原命名 Mirai-AntiPorn-Plugin

设置 百度AI

使用前请根据 https://ai.baidu.com/ai-doc/ANTIPORN/Wkhu9d5iy 的步骤申请APP 获取APP_ID API_KEY SECRET_KEY
在安装插件，并启动Mirai Console后，config/content-censor目录下会生成ContentCensor.yml
对应修改文件中APP_ID API_KEY SECRET_KEY的值

机器人将会在作为群主或者管理员身份的情况下工作，即群消息内容审核（文本，图片，语音）
机器人的审核规则请到 https://ai.baidu.com/censoring#/strategylist 修改策略

审核内容

位于 config/ContentCensor.yml

mute 禁言时间，单位秒，默认1分钟 plain 是否检查文本，默认 true image 是否检查图片，默认 false audio 是否检查语音，默认 false 避开审查

拥有权限 io.github.gnuf0rce.content-censor:no-censor 的用户将不会被检测

安装 MCL 指令安装

./mcl --update-package io.github.gnuf0rce:mirai-content-censor --channel stable --type plugin

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中 TODO 配置禁言时间 QPS延迟 视频内容审核 转发消息内容审核

Pixiv Client
基于Ktor的 Pixiv Kotlin SDK
常用的API都已经基本完成
目前需要优化和完善部分API

相关项目 Pixiv Helper Mirai Console Plugin 也在预发布状态

BiliBili Helper

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

Release
Downloads
MiraiForum

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

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 sleep g12345 00:00 06:00, 00:00~06:00 时间段内将不会推送

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

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

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

/bili-dynamic time 508963009 "0 0 14 * * ?", 0 0 14 * * ? 表示每天 14:00 都执行一次 /bili-video time 508963009 "0 0 18 ? * 2-6", 0 0 18 ? * 2-6 表示星期一至星期五 每天 18:00 执行一次
可以使用在线编辑器生成 https://www.bejson.com/othertools/cron/
为防止被 空格 分成多个参数，请使用 " 包裹参数 动态订阅指令 指令 描述 /<bili-dynamic B动态> <add 添加> [uid] [contact]? 添加一个b站动态订阅 /<bili-dynamic B动态> <stop 停止> [uid] [contact]? 停止一个b站动态订阅 /<bili-dynamic B动态> <time 定时> [uid] [cron]? 设置任务的定时信息 /<bili-dynamic B动态> <list 列表> [contact]? 列出当前联系人的动态订阅 /<bili-dynamic B动态> <forbid 屏蔽> [pattern] [add]? 添加一个动态正则屏蔽 /<bili-dynamic B动态> <sleep 休眠> [target] [start] [end] 添加一个休眠时间 /<bili-dynamic B动态> <at 艾特> [target] [start] [end] 添加一个艾特时间

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

直播订阅指令 指令 描述 /<bili-live B直播> <add 添加> [uid] [contact]? 添加一个b站直播订阅 /<bili-live B直播> <stop 停止> [uid] [contact]? 停止一个b站直播订阅 /<bili-live B直播> <time 定时> [uid] [cron]? 设置任务的定时信息 /<bili-live B直播> <list 列表> [contact]? 列出当前联系人的直播订阅 /<bili-live B直播> <sleep 休眠> [target] [start] [end] 添加一个休眠时间 /<bili-live B直播> <at 艾特> [target] [start] [end] 添加一个艾特时间 视频订阅指令 指令 描述 /<bili-video B视频> <add 添加> [uid] [contact]? 添加一个b站视频订阅 /<bili-video B视频> <stop 停止> [uid] [contact]? 停止一个b站视频订阅 /<bili-video B视频> <time 定时> [uid] [cron]? 设置任务的定时信息 /<bili-video B视频> <list 列表> [contact]? 列出当前联系人的视频订阅 /<bili-video B视频> <forbid 屏蔽> [type] [add]? 添加一个视频类型屏蔽 /<bili-video B视频> <filter 过滤> [tid] [add]? 添加一个视频分区过滤 /<bili-video B视频> <sleep 休眠> [target] [start] [end] 添加一个休眠时间 /<bili-video B视频> <at 艾特> [target] [start] [end] 添加一个艾特时间

/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被锁定 动态订阅一般会包含视频内容，推荐以此代替

剧集订阅指令 指令 描述 /<bili-season B剧集> <add 添加> [sid] [contact]? 添加一个b站剧集订阅 /<bili-season B剧集> <stop 停止> [sid] [contact]? 停止一个b站剧集频订阅 /<bili-season B剧集> <time 定时> [uid] [cron]? 设置任务的定时信息 /<bili-season B剧集> <list 列表> [contact]? 列出当前联系人的剧集订阅 /<bili-season B剧集> <sleep 休眠> [target] [start] [end] 添加一个休眠时间 /<bili-season B剧集> <at 艾特> [target] [start] [end] 添加一个艾特时间

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

信息解析指令 指令 描述 /<bili-info B信息> <aid> [id] 根据 avid 获取视频信息 /<bili-info B信息> <bvid> [id] 根据 bvid 获取视频信息 /<bili-info B信息> <dynamic> [id] 根据 id 获取动态信息 /<bili-info B信息> <live> [id] 根据 id 获取直播信息 /<bili-info B信息> <user> [id] 根据 id 获取用户信息

返回结果包含图片，需要在聊天环境执行指令
消息中包含 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]+""" 搜索指令 指令 描述 /<bili-search B搜索> <user 用户> [keyword] 搜索用户 /<bili-search B搜索> <bangumi 番剧> [keyword] 搜索番剧 /<bili-search B搜索> <ft 影视> [keyword] 搜索影视

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

任务列表指令 指令 描述 /<bili-task B任务> <all> 全部任务 /<bili-task B任务> <dynamic> 动态任务 /<bili-task B任务> <live> 直播任务 /<bili-task B任务> <season> 剧集任务 /<bili-task B任务> <video> 视频任务 /<bili-task B任务> <config> 屏蔽设置 模板配置指令 指令 描述 /<bili-template B模板> <datetime> [pattern] 日期格式 /<bili-template B模板> <reload> 重新加载

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

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中 截图前置

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

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

Baidu Api Client

百度API的Kotlin SDK，目前实现的有 Oauth认证 和 百度网盘

Baidu Oauth

部分SDK的前置库
有三种验证方式

服务端的方式获取 Token, block 输入 认证网页 Url ，返回认证码
suspend fun authorize(block: suspend (Url) -> String)

移动端的方式获取 Token, block 输入 认证网页 Url ，返回跳转Url
suspend fun implicit(block: suspend (Url) -> Url)

设备认证的方式获取 Token, block 第一个参数是 直接网页认证的Url，第二个是 二维码认证的图片Url
suspend fun device(block: suspend (Url, Url) -> Unit)

刷新 Token
suspend fun refresh()

Baidu Netdisk

需要到 百度网盘开放中心 申请app
作为构建客户端的参数

open class BaiduNetDiskClient( override val appId: Long, override val appName: String, override val appKey: String, override val secretKey: String )

客户端在网盘中的工作目录为/apps/${appName}

已完成的功能

[Oauth](#Baidu Oauth) 验证登录 上传文件 列出文件 搜索文件 秒传链接 获取和解析 Gradle引用包

到 Personal Access Tokens 申请一个token
然后添加repository

repositories { maven { url = uri("https://maven.pkg.github.com/baidu-client") credentials { username = "${github.id}" password = "${github.token}" } } } dependencies { implementation("xyz.cssxsh.baidu:baidu-netdisk:${version}") }

Weibo Helper

基于 Mirai Console 的 微博 转发插件

Release
Downloads
MiraiForum

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

User Manual Permission Command Chat Command

插件基于PC网页版微博API，使用插件需要登录一个微博账号
插件初始化时，如果恢复登录状态失败，则会尝试模拟游客

指令

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

本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.weibo-helper:command.*, * 是指令的第一指令名
例如 /微博用户 订阅 的权限ID为 xyz.cssxsh.mirai.plugin.weibo-helper:command.wuser

[subject]?订阅的接收对象，可选参数, 默认填充当前聊天环境

登录指令 指令 描述 /<wlogin 微博登录> 登录一个微博账号

使用指令后，机器人会发送网页登录的二维码
使用手机微博APP扫描确认登录后
如果成功登录，则会回复 @用户名#ID 登陆成功的消息

用户订阅指令 指令 描述 /<wuser 微博用户> <add, task 订阅> [uid] [subject]? 订阅一个微博账号 /<wuser 微博用户> <stop 停止> [uid] [subject]? 取消订阅一个微博账号 /<wuser 微博用户> <detail 详情> [subject]? 查看订阅详情

uid是用户的ID，可以在用户的主页获得，
例如 https://www.weibo.com/u/1111681197 的1111681197
使用订阅指令后，如果成功找到指定用户，则会回复
对@用户名#ID 的监听任务, 添加完成

分组订阅指令 指令 描述 /<wgroup 微博分组> <list 列表> 列出当前账号的微博分组 /<wgroup 微博分组> <add task 订阅> [id] [subject]? 订阅一个微博分组 /<wgroup 微博分组> <stop 停止> [id] [subject]? 取消订阅一个微博分组 /<wgroup 微博分组> <detail 详情> [subject]? 查看订阅详情

id是分组的GID或者TITLE，GID可以在分组的页面获得，
例如 https://www.weibo.com/mygroups?gid=3893924734832698 的3893924734832698
也可以通过列表指令获得，使用列表指令之后会按行回复title -> gid
使用订阅指令后，如果成功找到指定分组，则会回复
对分组标题#ID的监听任务, 添加完成

分组订阅指令 指令 描述 /<whot 微博热搜> <add task 订阅> [word] [subject]? 订阅一个微博热搜 /<whot 微博热搜> <stop 停止> [word] [subject]? 取消订阅一个微博热搜 /<whot 微博热搜> <detail 详情> [subject]? 查看订阅详情 博文查看指令 指令 描述 /<wdetail blog 微博详情> [mid] 查看指定微博内容 关注指令 指令 描述 /<wfollow 微博关注> [uid] 关注指定用户 解析微博链接

机器人会将群里中的微博链接捕获，并将微博内容回复给发送微博链接的人
这个功能默认开启，通过权限 xyz.cssxsh.mirai.plugin.weibo-helper:quiet.group 设置不开启的群聊

配置

位于Mirai-Console运行目录下的config/weibo-helper文件夹下的WeiboHelperSettings文件

cache 图片缓存位置 expire 图片缓存过期时间，单位小时，默认3天，为0时不会过期 following 是否清理收藏的用户的缓存，默认 true fast 快速轮询间隔，单位分钟 slow 慢速轮询间隔，单位分钟 contact 登录状态失效联系人，当微博的登录状态失效时会向这个QQ号发送消息 repost 微博订阅器，最少转发数过滤器，只对列表订阅生效，默认16 users 微博订阅器，屏蔽用户 regexes 微博订阅器，屏蔽的关键词正则表达式 urls 微博订阅器，屏蔽的URL类型, 屏蔽视频可以尝试填入39 video 发送微博视频文件 emoticon 处理微博表情 picture 图片设置 cover 封面设置 history 历史记录保留时间，单位天，默认 7d timeout Http 超时时间，单位毫秒，默认 60_000 ms forward 以转发消息的方式发送订阅微博 show_url 是否显示url 图片设置

有四种设置方案

{ type: none, value: {} } 一张也不显示 { type: all, value: {} } 全部显示 { type: limit, value: { total: 3 } } 最多显示total张 { type: top, value: { total: 3 } } 超过total张一张也不显示 quiet.group

安静群聊, 不解析URL链接, 通过权限系统配置
/perm add g12345 xyz.cssxsh.mirai.plugin.weibo-helper:quiet.group

安装 MCL 指令安装

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

手动安装 运行 Mirai Console 生成plugins文件夹 从 Releases 下载jar并将其放入plugins文件夹中