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

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

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

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

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

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

本贴只接受补充建议，不接受提问

Mirai 与 MCL

MCL 是指 mirai-console-loader
项目地址 https://github.com/iTXTech/mirai-console-loader

Mirai 是指 mirai-core 或者 mirai-console
项目地址 https://github.com/mamoe/mirai

MCL 名字的意思是 mirai-console 启动器/加载器
是用来管理 mirai-console 及 mirai-console插件的
管理是指自动下载和版本检查之类的功能
目前只支持从maven下载插件（本来有规划插件中心的，但是鸽了）

提供 QQ Bot 功能的是 mirai-console ，MCL本身不提供功能
而且两种本身相互独立，即 MCL 的版本不影响 mirai 的功能，反之 mirai 的版本不影响 MCL 的功能

不要把 MCL 和 mirai 划等号，这会带来一些问题，
比如提交 issue 时要求提交 mirai 版本，却有人提交了 MCL 的版本

MCL 启动之后先出现的是 MCL 的日志，他会显示 mirai 及 mirai 插件的加载情况
然后从 I/main: Starting mirai-console... 开始就是 mirai 的日志

有时候 MCL 更新插件不及时
原因是 MCL 默认使用 阿里云的 maven伪镜像, 伪镜像 更新不及时导致的

MCL 的目录结构一般是这样的

MCL
├───mcl.jar
├───mcl.cmd (WIN启动脚本)
├───mcl.sh (Linux/MACOS启动脚本)
├───bots (bot数据目录)
│   ├───123456
│   │   ├───device.json
│   │   ├───cache
│   │   └───logs
│   └───114514
│       ├───device.json
│       ├───cache
│       └───logs
├───config (配置目录)
│   ├───Console
│   │   ├───AutoLogin.yml
│   │   ├───Command.yml
│   │   ├───ExtensionSelector.yml
│   │   ├───Logger.yml
│   │   ├───PermissionService.yml
│   │   └───PluginDependencies.yml
│   └───net.mamoe.mirai-api-http
│       └───setting.yml
├───data (数据目录)
├───libs (库目录，里面有mirai本体)
├───logs (日志目录，里面有日志文件)
├───plugins (插件目录)
├───plugin-libraries (插件库目录)
└───plugin-shared-libraries (插件共享库目录)
    └───libraries.txt

Mirai API HTTP

项目地址 https://github.com/project-mirai/mirai-api-http

提供HTTP API的中间件
配置文件 setting.yml 所在请查阅上面的 MCL 文件树

Mirai Native

项目地址 https://github.com/iTXTech/mirai-native

兼容酷Q插件的中间件, 需要 32位 Java
但作者很忙没空管理

2.14 之后 要正常使用要到
https://github.com/cssxsh/mirai-native/suites/10378553865/artifacts/512083102
里下载CI最新构建的版本
CI 已过期

备份👇
mirai-native-2.0.1.mirai2.jar

MiraiAndroid

项目地址：https://github.com/mzdluo123/MiraiAndroid

mirai-console 在 Android 中的实现
作者已经不再维护此项目，无法保证可用性
可用性自己试，别TM到处问能不能用，自己试一试不就知道了吗

TxCaptchaHelper

项目地址：https://github.com/mzdluo123/TxCaptchaHelper

已不再维护

Mirai Compose

项目地址：https://github.com/sonder-joker/mirai-compose

mirai-console 的图形化实现
作者已经不再维护此项目，无法保证可用性
可用性自己试，别TM到处问能不能用，自己试一试不就知道了吗

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 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 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

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

这里使用的 mcl 版本是 2.1.2
打开 mcl 工作目录 下的 config.json
编辑 packages
将
net.mamoe:mirai-console,
net.mamoe:mirai-console-terminal,
net.mamoe:mirai-core-all
中的 channel 从 stable 改为 maven-stable 或者 maven
maven-stable 将会更新到 最新标准版 2.13.3
maven 将会更新到 最新测试版 2.14.0-RC

例如

    "net.mamoe:mirai-console": {
      "channel": "maven-stable",
      "version": "2.13.3",
      "type": "libs",
      "versionLocked": false
    },

然后使用
./mcl -u
启动 mcl 并触发更新

./mcl -u 本身就是启动 mcl 的指令，不是启动 mcl 之后的再输入指令。

即你应该启动一个 powershell 或者 cmd 之类的终端，然后 使用 ./mcl -u 启动 mcl

可以参考↓
https://wiki.mrxiaom.top/zh/mirai/troubleshoot

这样 这样就能升级到具有短信验证的最新 mirai 版本了
目前最新版本是 2.13.3
有短信验证版本是 从 2.13.0-RC 开始
包括

• 2.13.0-RC
• 2.13.0-RC2
• 2.13.0,
• 2.13.1,
• 2.13.2
• 2.13.3
• 2.13.4
• 2.14.0-RC
• 2.14.0
  2.13 之后的 版本关于 mirai-native 有兼容性问题，你可以尝试下载pr中的临时修复版
  https://github.com/iTXTech/mirai-native/pull/173

另外，如果 org.itxtech:mcl-addon 一直卡住没升级到 2.1.1
你可以尝试修改配置文件

    "org.itxtech:mcl-addon": {
      "channel": "maven-stable",
      "version": "2.1.1",
      "type": "plugins",
      "versionLocked": false
    }

注意这里需要先升级 mcl 版本到 2.1.2

如果 maven.aliyun.com 报错，下载失败
可以执行下面这个编辑步骤
编辑 maven_repo 加上 https://repo.huaweicloud.com/repository/maven

  "maven_repo": [
    "https://repo.huaweicloud.com/repository/maven",
    "https://maven.aliyun.com/repository/public"
  ],

注意 LuckPerms-Mirai 需要 最新版 才适配 2.14.0-RC

cssxsh created this issue in iTXTech/mirai-native

closed [ci] build native and jar #173

目前
实现了 OpenAI 中 提供的 Completion 和 Image Generation

详细文档请阅读 readme
https://github.com/cssxsh/mirai-openai-plugin#readme

有功能BUG或者建议请开 issue
https://github.com/cssxsh/mirai-openai-plugin/issues

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

非官方的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
这频道没有限制，都可以加

更详细内容请阅读 https://github.com/cssxsh/meme-helper#readme

v1.1.4+ 版本已解决兼容性问题，不再需要额外配置
termux 和 windows 7 请看
https://github.com/cssxsh/mirai-skia-plugin/issues/2

插件权限ID xyz.cssxsh.mirai.plugin.meme-helper:*，使用前授予权限

插件依赖于 Mirai Skia Plugin (必要)
插件依赖于 Mirai Hibernate Plugin (不必要)

目前插件开发处于实验性阶段

基本功能

PornHub

PornHub Login 生成

示例: #ph Git Hub

PetPet

摸摸头生成

可以发送 图片 或者 @某人 或者 QQ号 确定卡片图片
示例: #pet @群主, #pet 123456

Dear

狂亲表情包生成

可以发送 图片 或者 @某人 或者 QQ号 确定卡片图片
示例: #dear @群主, #dear 123456

5000choyen

5000choyen 表情包生成

示例: #choyen 我想吃 肯德基疯狂星期四套餐

zzkia

诺基亚短信 表情包生成

示例: #pinyin 无内鬼，来点色图

游戏王

游戏王 表情包生成
可以发送 图片 或者 @某人 或者 QQ号 确定卡片图片
可以使用 xxx=yyy, 指定属性，可选属性有：

• 卡片名称: name
• 怪兽属性: attr = dark, divine, earth, fire, light, spell, trap, water, wind
• 怪兽等级: level
• 怪兽种族: race
• 怪兽攻击: atk
• 怪兽防御: def
• 卡片版权：copyright

示例:

#spell @Him188
Welcome PR
你可以PR

#trap @Him188
Useless PR
这个还是由我们自己实现

#monster @LaoLittle
援交JD
五元一次

随机表情包

随机表情包一张（通过 Mirai Hibernate Plugin 插件 从消息中收集得到）

示例: #群友表情

Emoji合成

Google Emoji Kitchen，两个 emoji 合成 一个

示例: 😍+🥵

cssxsh created this issue in cssxsh/mirai-skia-plugin

closed skiko 兼容性问题 #2

用户和开发者都可以加

点击链接加入QQ频道【天网开发组】：https://qun.qq.com/qqweb/qunpro/share?_wv=3&_wwv=128&inviteCode=2bR5WD&from=246610&biz=ka

NovelAi Helper

基于 NovelAi 的 AI图片生成插件

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

• User Manual
• Permission Command
• Chat Command

会自动下载 EhTagTranslation 翻译词库
可以对接 NaiFu 本地搭建
或者你可以 利用 colab 进行在线搭建
将搭建得到的 url 例如 https://express-disco-environmental-friends.trycloudflare.com/ 填入 config.yml 的 naifu_api 配置项

如果你是用 Stable Diffusion web UI 搭建的API 请移步 https://github.com/cssxsh/stable-diffusion-helper

指令

• /nai <word> 生成一张图片 官方API需要登录
  例如 /nai 连裤袜 双马尾 (只有部分词条会自动翻译)
  例如 /nai swimsuit #seed=12346 (设置种子)
  例如 /nai swimsuit #steps=3 (AI迭代次数)
  例如 /nai "swimsuit, ahegao" (如果需要以 , 分割词条, 请用 " 包裹)
  例如 /nai 连裤袜 [图片] (以图生图, [图片] 是指指令消息中包含有图片)
  可用的配置项有
  seed 种子
  steps 迭代次数
  width 宽度
  height 高度
  scale 比例
  sampler 采样器 可选值 k_euler_ancestral, k_euler, k_lms, plms, ddim
strength 以图出图中对原图的更改程度 可选值 [0.00, 0.99]
  noise 以图出图中的噪声 可选值 [0.00, 0.99]

• /nai-fu <word> 生成一张图片 自建API需要配置 naifu_api
  对接 naifu, naifu 是基于 novelai 官方 web 端的修改版，所以指令用法 和 nai 一致

• /nai-login <mail> <password> 登录账号
  例如 /nai-login 114514@gmail.com 1919810

• /nai-reload 重新载入 config.yml 配置文件

配置

• config.yml 配置文件 包括 proxy, doh, ipv6, naifu_api 等配置

  • proxy 代理
  • doh DNS
  • ipv6 是否使用ipv6
  • naifu_api 自建 naifu 地址
  • command_interval 命令间隔延迟时间 单位毫秒

• ban.txt 屏蔽的词条，可热编辑，保存后一段时间会自动启用

NaiFu

naifu 是基于 novelai 官方 web 端的修改版
相关信息可以看这 https://colab.research.google.com/drive/1_Ma71L6uGbtt6UQyA3FjqW2lcZ5Bjck-#scrollTo=KZ88G-iWCTs7

TODO

• 更好的翻译
• 更多配置项

@w211691

https://raw.githubusercontent.com/Kengxxiao/ArknightsGameData/master/zh_CN/gamedata/excel/character_table.json

@frankcwl 在 简单的Rss订阅插件 已添加RssHub支持 番剧订阅Bt种子自动上传 中说：

java.net.UnknownHostException

更换 HttpClientConfig.yml 中的 doh 配置
或者将其置空

@w211691

理论上会自动下载，你这种情况可能是下载失败

@sjxkfnskdd 在 协议问题汇报 中说：

unidbg-fetch-qsign 服务异常, 请检查其日志, 'Uin is not registered.'

签名服务的问题

https://github.com/fuqiuluo/unidbg-fetch-qsign/blob/master/refresh_token/README.md#初始化sign

@gitZeoi

我说过置空是特殊处理，那从来不是代理
你们总喜欢给我造谣

@gitZeoi

默认没有代理

java.lang.UnsupportedOperationException: repeated create EncryptService

签名服务类被重复创建
请检查是否对同一个 bot 账号进行了 二次登录，并且上一次登录的 Bot 实例还没有关闭

java -Dxyz.cssxsh.mirai.tool.ViVo50.Session.timeout=600000 -jar mcl.jar

@guizaipiao

1. 我已经说了问题的原因
   重复创建 bot 实例，并且先前的实例没有关闭以释放资源

2. 不要张嘴就来，没有切实的证据不要说是某个依赖的问题
   并且报错栈堆明确指出触发的位置。和 async-http-client 无关

3. 检测是否重复登录不是一开始就有的，是后面加的