蔚蓝档案额外功能插件

Github

指令

目前共四个指令

已接入 Mirai Console 指令系统

指令 功能 作用域 /今日运势 查看今日运势 所有 /今日人品 查看今日人品值 所有 /监控 查看服务器资源占用 所有 /随机柴郡 获取随机柴郡表情包 所有 /生成后缀 [名称] [后缀] 使用unicode码生成名字后缀 所有 /语音生成 [角色] [文本] 调用蔚蓝档案语音生成 所有 /语音生成 [角色] [文本] <中/日/英> 调用蔚蓝档案语音生成，自定义语言 所有 /aronabot reload 重载配置文件 所有 权限节点

指令系统权限节点如下

指令 权限节点 今日运势 cn.travellerr.aronabot:command.jrys 今日人品 cn.travellerr.aronabot:command.jrrp 监控 cn.travellerr.aronabot:command.securityimage 随机柴郡 cn.travellerr.aronabot:command.random-chaiq 生成后缀 cn.travellerr.aronabot:command.generatename 语音生成 cn.travellerr.aronabot:command.voice-gen 重载配置 cn.travellerr.aronabot:command.aronabot 配置 # 是否启用文字输出运势 isText: false # 本地字体目录,以mcl为主目录填写相对路径 useLocalFont: '' # 是否启用语音合成 useVoice: true # 语音合成模型地址 url: 'travellerr11-ba-voice-models.hf.space' # 是否使用SilkConverter useSilk: false # ffmpeg地址,以mcl为主目录填写相对路径,若启用语音合成且不使用SilkConverter则必须填写ffmpeg路径 ffmpegPath: '' 关于 /今日人品 指令

该指令与 /今日运势 指令 使用同一数据库，所以获取到的人品值应该是和运势挂钩的

如果当天已经使用过了 /今日运势 指令，那么 /今日人品 不会重新生成，而是直接获取之前的运势id，向101取余计算人品值
例如:

ID QQ FortuneID Date 1 123456789 348 2024-05-14 21:51:30 2 114514123 200 2024-03-23 18:13:27 3 191981011 126 2024-07-02 19:36:03

分别将计算为

QQ jrrpValue 123456789 48 114514123 100 191981011 26 展示 ...

9fd3cf4d-5783-442b-ae59-3f8395a2a6ad-8d995b6ff2f98c1658666b9ee1fda302.png

版本

Version = 1.1.1

推广

我做的可自定义的好感度插件

rt
还有现在主流的qq机器人都用什么框架？

由于腾讯的神必操作，导致现在mirai大不如从前，但是仍然有一部分用户还使用着mirai，现在想收集一点信息，为之后的开发做打算。

收集信息如下：

还在使用mirai吗：是/否 通过那种登录方式使用的mirai： 1.签名服务 2.Overflow 3.其他 mirai登录情况稳定吗:稳定/不稳定 mirai的相关功能使用方式： 1.mirai插件 2.mirai-http外接 3.mirai-core原生开发 使用mirai的相关平台：win/linux/Android

目前就征集这些信息，谢谢大家反馈！

ChatGPT Mirai QQ Bot

一款使用 OpenAI 的 ChatGPT 进行聊天的 QQ 机器人！

基于：

Ariadne mirai-api-http Reverse Engineered ChatGPT by OpenAI.

支持：

文字转图片发送

群聊回复引用

关键词触发回复

正向代理

无需浏览器登录

支持 ChatGPT Plus

预设人格初始化

交流群 会发布最新的项目动态。
加群之前先看这里的内容能不能解决你的问题。
如果不能解决，把遇到的问题、日志和配置文件准备好后再提问。

调试群 这个群里有很多 ChatGPT QQ 机器人，不解答技术问题。

Preview

🔧 使用与配置

请移步至GitHub。

加载预设

如果你想让机器人自动带上某种聊天风格，可以使用预设功能。

我们自带了 猫娘 和 正常 两种预设，你可以在 presets 文件夹下了解预设的写法。

使用 加载预设 猫娘 来加载猫娘预设。

你可以参考 Awesome-ChatGPT-prompts-ZH_CN 来调教你的 ChatGPT。

📷 图片转文字

向 QQ 群发送消息失败时，自动将消息转为图片发送。

字体文件存放于 fonts/ 目录中。

默认使用的字体是 更纱黑体。

Star History

如果你觉得本项目对你有帮助的话，欢迎点一个 Star!

Star History Chart

默认基于模型gpt-3.5-turbo，可自行更改
支持预设和自定义预设（暂时不能通过qq对话上传新预设）
默认开启对话模式，基于预设和以前的对话记录与你聊天（聊天内容过多时会自动删除最开始的对话，防止超过tokens的大小）
https://github.com/Euyug/Mirai-Gpt-Plugin
ed11b87a-e2cd-458d-8abe-b47f59ec6a97-image.png

更新(7.25)

对接腾讯智能体api

对接讯飞星火+文心一言(免费)

Gemini模型可以在对话中识别图片了

bangumi查询

星穹铁道数据查询

使用免费的bing-image-creator(dalle3)，获取cookie

项目地址

项目地址

如果你不想折腾，只想用ai对话+绘画+语音，请移步Petunia (暂不推荐，很久没有更新了，目前的Manyana启动器已经是一键安装，很方便)

功能

请查看readme菜单图片

求助,安装时,java下载好后到444d6d63-be38-4161-bc74-2c2db8a6d583-image.png 这里直接闪退了

Kookie

基于 Mirai 框架的群聊机器人，还在开发中...

kookie的诞生起源于写代码时的无聊，就像写一个玩一下，并且在新建文件夹的时候恰巧正在吃饼干，遂诞生了Kookie，希望各位喜欢她。

本次开源一部分插件功能。

仓库地址： https://github.com/GeneralK1ng/Kookies

欢迎各位PR，欢迎一起交流。

Features 答案之书 群聊内发送 答案之书 <询问内容> 今日运势 群聊内发送 今日运势 评价一下 群聊内发送 评价一下 <@想要评价的目标> 吃什么 群聊内发送 吃什么 <具体地址> <city> （如果地址非常具体可以不加city） 说一下 群聊内发送 说一下 <需要说的文字>，会发送语音，语音模块需要自己部署推理服务器。 今日老婆 群聊内发送 今日老婆 代码运行 群聊内发送 代码运行 <语言> <代码> 此部分用的runoob的API，自己去拿一个token即可使用。 今日词云 群聊内发送 今日词云 昨日词云 群聊内发送 昨日词云 地狱笑话 群聊内发送 地狱笑话 目前是英文的，后面考虑能不能翻译，但是其实很多笑话是欧美梗，如果翻译过来的话，可能就没内味了。

后面的功能还在想，语音功能部分比较的复杂，需要另外自己部署推理服务器，并且自己使用模型，而且还需要自己编译ffmpeg，这部分代码写的比较死，这部分需要一个详细的文档，但是本人学生空余时间并不是很多，所以后续会不定期开发。

需要填写的API 百度

大模型采用的是百度的 Yi-34B-Chat 的中文模型，选择这个的理由是首先中文识别以及短回复比较适合群聊场景，其次是调用它不要钱（bushi，对学生党比较友好。

去 百度智能云控制台 新建一个应用，获取 API key 和 Secret Key 填入 config.json 即可

高德地图

主要是吃什么功能，需要用到高德的周边搜索以及地理坐标转换。\

去 高德开放平台 建立一个应用，然后复制 API Key 填入即可，注意周边搜索免费额度只能每天免费100次数，所以建议节省一些，后续会开发一个缓存池来延长每天的时间，咕咕。

语音功能

这部分需要自己搭建推理服务器并且还涉及本地的ffmpeg的编译，比较的麻烦，所以因为时间限制暂且不表。

Runoob

需要去菜鸟教程的在线编译器抓包拿一下token，这里感谢菜鸟教程的无私奉献（）

Config

在kookie插件加载成功后会在 ./kookie/ 目录下生成 config.json 文件，需要手动填写一些相关参数：

{ "botInfo": { "birthday": "2024-05-20", "name": "Kookie", "owner": "your owner", "age": 16, "baiduApiConfig": { "apiKey": "your apiKey", "secretKey": "your secretKey" }, "gaodeApiConfig": { "apiKey": "your apiKey" }, "voiceApiConfig": { "apiUrl": "your apiUrl", "ref_audio_path": "your ref_audio_path", "gpt_weights_path": "your gpt_weights_path", "sovits_weights_path": "your sovits_weights_path" }, "runoobToken": "your runoobToken" }, "maxTodayGirlTimes": 3, "adminList": [ 123456789, 987654321 ], "userBlackList": [ 11111111, 22222222 ], "enableGroupList": [ { "id": 666666, "tag": [ "test1", "test2" ] }, { "id": 777777, "tag": [ "test3", "test4" ] } ] }

voiceApiConfig 目前可以先不填写，在后续文档跟进后再使用，这部分只是关于语音推理的。

然后黑名单和允许的群聊这两部分是权限管理必须需要的，所以一定要填写！

请注意如果词云采用的字体是宋体，如果服务端没有安装会导致图片生成失败！！！

字体下载请到 fonts 这个文件夹下下载然后安装，目前还在研究java的字体安装，如果无法自动安装就手动下载安装吧。

如果可以的话，请点一个star，非常感谢 >_<

壶言会话3

好久不见，我是鸽了快一年的放空
新版本已经完成基本的底层搭建，剩下的就是慢慢不全各功能模块就行。
现在在这里征集好的注意！

仓库地址：HuYanSession3

现有功能

鉴于前车之鉴，本次升级对上版本插件做减法，对插件进行分离，自定义回复独立提取出来，群管功能以后成为一个单独的插件。

自定义数据库接入：目前支持(sqlite,h2,mysql) 自定义缓存位置：目前支持(内存),预留(redis) 自定义权限：目前支持(内置),预留接入HuYanAuthorize未来可能会接入lp 分组支持多种类型：对以前的群分组进行了升级，现在分组不仅可以对群分组，还能对人分组和对群成员分组！ 高度定义的作用域匹配：7种作用域匹配，满足的需求 ...

4c8c0423-f828-43fa-ab8a-e2336525c77d-图片.png

重新设计的单一消息，更加简洁，新增了概率回复功能，保留了壶言会话2.4.x的本地缓存功能 使用

现阶段版本已经可以进行测试使用
如果你想使用，可以去群里获取测试版本的插件，放入plugins文件夹启动即可使用。

由于当前版本为壶言会话2的拆分版，你可以与壶言会话2一起使用，但是会触发两个插件的命令，解决方式就是使用壶言会话2的过滤消息功能将壶言会话2的指令暂时过滤掉！

对于现阶段mirai的半死状态，这边目前可以总计一下目前可能能行的登录方案：

签名服务-非常的不稳定(及其容易封号)，但是能用 通过Overflow插件接入其他平台的OneBot转生 蕉流与学习

目前就这完成了这么多，后续会慢慢完善，如果你有好的意见，可以在本帖子种回复。也可以加群直接at我，不是云的茶壶云(390444068)

如果你想学习编写mirai插件，或者刚学java，欢迎来对本项目进行编写和pr，结构简单易上手！

以下是本插件部分文档，会持续更新。 参数

对于部分参数，有默认值，可省略不填。

| 指可选，左边或右边选择一个即可
+ 指可填写多个，一般中间用 隔开。
(xx) 指必填，括号内内容必须填写。
[xxx]指可选填写。

匹配方式 1|精准 精准匹配(默认) 2|模糊 模糊匹配，包含触发词即匹配成功。 3|头部 头部匹配，从前往后匹配触发词即匹配成功。 4|尾部 尾部匹配，从后往前匹配触发词即匹配成功。 5|正则 正则匹配，按照正则匹配结果。 重写

对于部分只能存在一条的信息，在参数集里面添加重写状态即可重写写入该信息。

%|rewrite 启用重写。 动态消息

不同于壶言会话2的自动识别动态消息，壶言会话3这边需要手动指定是否启用动态消息。

dt|动态|dynamic 启用动态消息。 本地缓存

由于腾讯服务器储存图片有概率过期，因此设计本地缓存功能，在config中有默认开启配置，默认不开启。
也可以根据单个消息默认设定开启与否。

ca|缓存|cache 启用本地缓存。 转换方式

消息在匹配时的转换方式

MIRAICODE miraiCode(默认)。 STRING String。 CONTENT content。 JSON json。 作用域 global 全局。 global-(id)|global-(at) 全局的某个用户，可填号码，可at人。 group 当前群(默认)。 member-(id)|member-(at) 某个群友。 list-(id) 自定义群列表。 users-(id) 自定义用户列表。 members-(id) 自定义某个群的群用户列表。 触发概率 probability-(0.0~1.0) 消息的触发概率。 是否随机 random 用于多词条的开启随机触发功能 动态消息类型

针对上一代的动态消息使用体验，这个版本也进行了一次优化

现格式为：

${prefix.suffix}

前缀 后缀 含义 案例 at this at当前发消息的这个人 ${at.this} all at全体(慎用!) ${at.all} (qq) at这个qq用户 ${at.572490972} user id 获取发送者的QQ号 ${user.id} name 发送者的名称 ${user.name} avatar 发送者的头像 ${user.avatar} title 发送者的头衔(仅限群) ${user.title} group id 群号(仅限群) ${group.id} name 群名称(仅限群) ${group.name} avatar 群头像(仅限群) ${group.avatar} owner 群主名称(仅限群) ${group.owner} time now 当前时间(默认格式) ${time.now} timer 当前的时间戳 ${time.timer} (format) 当前时间的自定义格式 ${time.HH:mm:ss.SSS} mate (number) 正则回流编号<br/>(仅限正则匹配中包含匹配块) ${mate.1} message this 当前的消息 ${message.this} reverse 反转的消息(按照消息顺序反转) ${message.reverse} owner id 主人的id(得与机器人是好友) ${owner.id} name 主人的名称(得与机器人是好友) ${owner.name} avatar 主人的头像(得与机器人是好友) ${owner.avatar}

对于一对一消息回复，如果想启用动态消息的匹配，得才参数中添加dt来启用动态消息识别！

指令 消息功能

权限id：session

一对一消息

权限id：hh

指令 含义 案例 %xx (a) (b) [params]+ 学习一个一对一回复 %xx a b %xx [a] 对话的方式学习 %xx,%xx a 学习 (a) (b) [params]+ 同上 学习 啊啊啊 哦哦哦 -xx (a) [scope\|id] 删除一个一对一回复^1 -xx a,-xx a 5 删除 (啊啊啊) [scope\|id] 同上 删除 啊啊啊 %%xx 刷新单一消息缓存 %%xx

第二类删除

对于一个短时间内响应的回复消息，如果你有权限，即可引用该消息并发送删除或sc即可删除!

参数

params 支持列表：

匹配方式 重写 动态消息 本地缓存 转换方式 作用域 触发概率

动态消息支持列表：

全部 一对多消息

权限id：dct

指令 含义 案例 %dct [trigger] 进入多词条学习状态(3分钟超时) %dct,%dct nova的错 学习多词条 同上 学习多词条 -dct (trigger\|id-(id)) [id] 删除多词条 -dct 群典,-dct id-2 5 删除多词条 (trigger\|id-(id)) [id] 同上 删除多词条 群典,删除多词条 id-2 5 %%dct 刷新多词条缓存 %%dct

第二类删除

对于一个短时间内响应的回复消息，如果你有权限，即可引用该消息并发送删除或sc即可删除!

params 支持列表：

匹配方式 重写 本地缓存 作用域 触发概率

多词条默认自动识别动态消息！

动态消息支持列表：

全部 群典功能

这是一个非常有意思的功能！

在配置中启动该功能后，对着机器人在线期间的消息回复一个批准入典， 将会默认生成一个触发词为群典(在配置中自定义)的多词条集

这个群典只属于当前群，意味着对于不同的群，可以有不同的群典！

记录群友的丢人瞬间！

定时消息

权限id：ds

权限功能

权限id：admin

指令 含义 案例 +(scope)-(at\|qq) (权限id) [权限id] 为该作用域添加一个权限 +global-@572490972 admin 添加权限(scope)-(at\|qq) (权限id) [权限id] 同上 添加权限@572490972 amind -(scope)-(at\|qq) (权限id) [权限id] 为该作用域删除一个权限 -global-@572490972 admin 删除权限(scope)-(at\|qq) (权限id) [权限id] 同上 删除权限@572490972 admin 分组功能 插件指令 hys v 查询当前壶言会话3的版本。

String imageUrl = Image.queryUrl(image);

System.out.println(imageUrl);
输出的链接打开显示找不到页面。上周同样的代码获取到的链接打开可以看到我想要获取的图片。
具体链接如下
http://gchat.qpic.cn/gchatpic_new/2937718557/0-0-9857B3036B0AAFACC984B103F9A38186/0?term=2
具体代码如下
acbbf4af-891c-4b62-9cfb-f436b5ae8288-7a996b51a45c44d883565e45f9cde27e.png

本人研究生，这几天心血来潮开IDA逆向了 libfekit，分析了很多的检测点，最后复活了qsign（基于unidbg重新写了一份，虽然API一致但是内容几乎不一样了）

但是为了防止重蹈覆辙所以不敢进行公开（包括但不限于源码和二进制以及过检测等逆向细节）

但是我又不希望最终安卓端协议没落，所以取了2个折中的方式:

开源

开源了一个没有完全过检测的版本，可以正常运行高版本的so文件，希望起到抛砖引玉，促进研究的作用 https://github.com/zhaodice/Astral-QSignigngnn

服务器

搭建了一个公益的qsign服务器，希望大家依然能够有机会参与mirai协议库的开发。

协议版本：9.0.56
服务器地址：http://ddns.trpgbot.com:14531

——主服务器，无key，稳定，可能有墙——

服务器地址(主要A，cloudflare)：https://qsign.trpgbot.com
服务器地址(主要B，cloudflare)：https://qsign-v4.trpgbot.com

——副服务器，有key，可能不稳定，无墙——

服务器地址(CDN线路)：http://qsign-v3.trpgbot.com
服务器地址(端口转发，感谢 @MirlKoi233 )：http://sbtx.f3.ttvt.cc
服务器地址(端口转发，感谢 @Moyuyanli ): https://qsign.chahuyun.cn

新的key：miraibbs
对本贴内容做了门户：https://qsign-guide.trpgbot.com/

1.注意只有两类服务器：
主服务器：主服务器有2个，一个高配一个低配
副服务器，副服务器列表只是一些cdn，其实是同一个服务器（我家里）

2.主服务器原则上不会停机和断电（除非我上传更新）

3.副服务器可能会出现中断服务的情况（比如家里断电断网，IP变化）

协议配置文件

ANDROID_PAD

{ "apk_id": "com.tencent.mobileqq", "app_id": 537220362, "sub_app_id": 537220362, "app_key": "0S200MNJT807V3GE", "sort_version_name": "9.0.56.16830", "build_time": 1713424357, "apk_sign": "a6b745bf24a2c277527716f6f36eb68d", "sdk_version": "6.0.0.2560", "sso_version": 21, "misc_bitmap": 150470524, "main_sig_map": 34869472, "sub_sig_map": 66560, "dump_time": 1713424357, "qua": "V1_AND_SQ_9.0.56_6372_YYB_D", "protocol_type": 6 } Mirai - 傻瓜式插件

直接安装插件即可正常登录 https://github.com/MrXiaoM/fpv/releases/tag/v1.13.1
（它属于 fix-protocol-version 插件的开发分支，因为功能相同所以可能冲突，一山不容二虎哦，使用时请注意禁用相关插件）

Mirai - fix-protocol-version 插件

mirai KFCFactory.json 使用配置：

{ "9.0.56": { "base_url": "https://qsign.trpgbot.com", "type": "fuqiuluo/unidbg-fetch-qsign", "key": "miraibbs" } }

同时请另存为 协议配置文件（ANDROID_PAD）的数据内容到 ANDROID_PAD.json ，数据内容上文已给出
控制台输入 protocol load ANDROID_PAD
即可用ANDROID_PAD协议登录你的QQ

GOCQ

gocq config.yml使用配置：

sign-servers: - url: 'http://sbtx.f3.ttvt.cc/' key: 'miraibbs' authorization: '-' - url: https://qsign.trpgbot.com/' key: 'miraibbs' authorization: '-' auto-register: true

同时请另存为 协议配置文件（ANDROID_PAD）的数据内容到 /data/versions/6.json ，数据内容上文已给出

测试结果

607af2d3-ed77-49ea-a9b5-b3ac8adb98c4.png
新注册的账号使用本sign，在24小时后仍未出现冻结现象，证明已经通关。

有任何问题欢迎进行交流讨论，最后感谢fuqiuluo提供的unidbg调用思路以及各位逆向工作者的支持。

如题，我也是今天才发现。想问问大家对于这件事的看法，虽然开放了测试，但是听说权限小很多<3
我也是用了mirai很久，很多插件也都有了感情( 自己也写过几个插件

RT

其实本来我的bot已经因为自己手贱登陆qq nt直接报废了，但是论坛里有佬提供了新的协议库，那这不赶紧复活bot都对不起这个新的协议库。

由于存在下载障碍，所以这里也搞了个存档，本帖中的相关标星*资源无法下载均可以从这里拿走，由于本帖不会进行版本跟进，若年代过于久远请以最新为准，本帖中的一些配置可能需要后续随着引用贴的更新进行调整。
https://orisland.lanzoul.com/b0maqsrkj
密码:53cs
本帖使用xshell+xftp作为ssh连接软件 *。

特别感谢： @zhaodice 相关项目更新感谢 @MrXiaoM 本帖适用于 刚刚接触mirai不知道如何登录的新手 因为安全问题不想使用整合包的选手 已经知晓你的账户登录信息和收发的信息会全部被注册服务器知晓的选手 稍微有一些Linux基础或乐于折腾的选手 对使用协议库登陆bot可能造成的后果有心理承受力的选手 .... 过程中需要使用的项目 必须安装 https://mirai.mamoe.net/topic/2673/试图复活qsign-基于9-0-56版本-再捞一把 @zhaodice https://github.com/iTXTech/mcl-installer https://github.com/cssxsh/fix-protocol-version

https://github.com/MrXiaoM/fpv (平替上面的fix-protocol-version，解决一些登录问题)，本文基于fix-protocol-version官方版本进行配置，如果使用这个版本，可省略导入协议库和配置KFCFactory.json的过程，安装启动后直接进入登陆验证部分。

https://github.com/KasukuSakura/mirai-login-solver-sakura 任意手机模拟器（本教程以雷电为例，海外版没有广告，广告ptsd可以选海外版） .. 可选安装(插件) https://github.com/project-mirai/chat-command https://mirai.mamoe.net/topic/68/luckperms-mirai-高级权限服务插件 https://mirai.mamoe.net/topic/2645/今日运势插件 ... 详细步骤 注册一个qq号

https://ssl.zc.qq.com/v3/index-chs.html

需绑定手机，非常不推荐使用一些批量注册的qq号，或者来源不明的qq号，这些账号被风控的可能性会更高，而且不安全，容易被杀。

准备一台服务器或vps

请注意，为了bot能长期稳定运行考虑，应尽可能避免海外云主机。
阿里云，腾讯云，等等各大云服务厂商提供了各种型号的学生机供你选择。
从省钱划算的角度考虑，推荐考虑的配置为1c或2c配置，内存在1g到2g即可满足bot的运行需要，甚至还能再挂个宝塔，个人推荐最低使用轻量级云服务器即可，ecs或者类似的服务器也可以，这个没有特别大的区别。
我的阿里云学生机
900d+高可用性

当然因为bot本身不需要公网环境，所以如果你自己有闲置的服务器或者低功耗设备（比如nas，软路由等等），也可以在自己的服务器或者设备上进行bot搭建，相同网络环境下，机器人被搞的概率和频率会小的多。

系统选择

使用centos8或者ubuntu/debian等。
本文以目前比较常用的Ubuntu22作为bot的搭建平台，且相同网络环境下进行（HomeLab，结尾有HomeLab相关硬件说明）。
如果你的bot搭建在云服务厂商的设备中，你可能需要使用vpn的方式将自己用来验证的设备链接到目标网络中避免错误代码237等错误。

初始系统配置

本文默认你已经对ubuntu的apt源进行了更换，已经对ubuntu做了基本的初始配置，例如挂载磁盘，update等操作。

如果你是在消费级硬件上进行搭建，请注意ubuntu时区可能有误，需要使用命令进行调整。
timedatectl set-timezone Asia/Shanghai

安装mirai

由于本文在进行编撰的过程中，mirai论坛本身处于被墙状态，mcl安装的必要资源package.json会出现问题，所以本文选择通用的安装方式，不使用mcl一键安装。若之后论坛网络访问恢复，更推荐考虑mcl一键安装更为省事，使用mcl一键安装可以跳转到下一章节--必要插件安装。
这里引用mcl项目提供的安装方案。
https://github.com/iTXTech/mcl-installer

为服务器安装java，不同系统以当前系统为准。

apt install openjdk-17-jre-headless -y

安装完成后检查版本。

java -verison

0856fce7-9fc1-4d87-9337-a4a24e9394dc-image.png

手动下载mcl压缩包
https://maven.aliyun.com/repository/public/org/itxtech/mcl/2.1.2/mcl-2.1.2.zip
解压到需要安装的mirai目录中，省事考虑可以对mirai文件夹整体给777权限。
本文默认mirai目录为/root/mirai，如果懒得对命令进行修改，请创建到相同目录。

chmod -R 777 /root/mirai

启动mcl.jar对mirai进行安装。

java -jar mcl.jar

安装过程中你必须完整的看完mirai的用户须知，不可取消和跳过，这对于之后的排错和处理非常重要。

2024-07-04 07:36:14 I/main: mirai-console started successfully.

mirai本体基本安装完成。
ctrl + c或 exit退出mirai进行后续安装。

必要插件/软件安装

安装手机模拟器（本帖以雷电为例）
前往github，
下载fix-protocol-version *
https://github.com/cssxsh/fix-protocol-version/releases/download/v1.13.0/fix-protocol-version-1.13.0.mirai2.jar
下载mirai-login-solver-sakura *
https://github.com/KasukuSakura/mirai-login-solver-sakura/releases/download/v0.0.12/apk-release.apk

打开雷电模拟器，安装mirai-login-solver-sakura，打开备用。
a7b82986-695a-4625-bd7a-1f92fb0b1d60-image.png
f8671270-d47d-442c-b136-8fd77c0be17c-image.png

将fix-protocol-version上传到mirai目录下的plugins目录内，此时plugins内应包含三个文件。
26d00b95-23bc-47e0-aa8e-dcbb8c1b1fd1-image.png

前往下面的地址，本页后续还需要使用，不要关闭。
https://mirai.mamoe.net/topic/2673/试图复活qsign-基于9-0-56版本-再捞一把
复制协议配置文件
869c1c02-1d25-44bf-bf40-3bcf5d133d55-image.png
在mirai的根目录中输入命令

nano android_pad.json

在控制台中右击屏幕，粘贴配置。
27633478-46bf-4d79-9c30-61d70b594ac6-image.png
进行保存退出。
ctrl + x
y
回车

忘掉之前启动mirai的方式，之后使用./mcl -u进行启动。

协议配置

使用./mcl -u 启动mirai。
等待加载完成后输入命令

protocol load ANDROID_PAD

出现如下提示时协议信息导入完成。
11dcc05d-0e6e-4542-9886-4fbc967824af-image.png
检查当前的协议库中的协议版本。
e48dd4c5-8d25-49ce-a48d-5ba2c91577b0-image.png
退出mirai。

回到刚才的页面，复制该部分。
127c4fa5-e12c-4b49-bf85-4013126e5858-image.png

来到mirai根目录输入命令,

mv KFCFactory.json KFCFactory.json.bak nano KFCFactory.json

将刚才复制的文本在这里粘贴并和之前一样进行保存，注意删除结尾的逗号。
1dbe92c1-5620-4958-bd83-ce7caa2a9824-image.png

使用命令重新启动mirai。
启动完成无报错后，则协议库配置完毕。

登陆账号

./mcl -u
请注意，下面的过程可能需要一些手速，过慢的验证您可能需要反复进行下面的步骤，过多的重试可能会增加账号冻结的风险性，请注意。

若在本阶段登录时出现了一些意料之外的错误和问题，请使用标头提到的1.13.1版本fix-protocol-version代替原本的1.13.0版本

登陆qq。

login botqq号 bot密码 ANDROID_PAD

若之前的配置全部没有问题，在mirai启动后登陆账号密码会提示注册成功。

2024-07-04 16:23:04 I/UnidbgFetchQsign: Bot(1145141919) register, 注册成功了您嘞！

之后可以在屏幕中找到下列类似地址，此时，需要尽可能快的将这串地址https://ti.qq.com/.... 复制到刚才开的模拟器中的框框中,并单击下一步.

[SliderCaptcha] Captcha link:https://ti.qq.com/safe/tools/captcha/sms-verify-login....

b21712e8-98b2-4052-adfe-f01a297bf934-image.png
在经过简单的图形验证后，会弹出ticket，立即复制该ticket
791ef35f-4ae8-485a-8eed-fdb7606143f3-image.png
回到ssh，在ticket栏进行粘贴，并回车，如果一切顺利，你会看到下面图片中的显示，即确认发送手机验证码。
5a1d847f-53de-4377-a429-0ebb7531ea14-image.png
输入yes后回车，将手机上收到的验证码填入对应栏目后回车，登陆完成。

注意本阶段有一次发送短信前的确认步骤，手动输入yes，不要在上面步骤就开始傻等短信。

8317823b-7291-46cd-929c-d15d68a02c1c-image.png

mirai测试登陆过程全部结束。

为bot添加自动登录，让mirai每次启动后自动登录。
退出mirai，下面的步骤必须在退出mirai之后才能进行，下列命令的实际路径以你的本地mirai的为准。

由于miria在退出时会回写配置，故所有的配置需在mirai关闭时进行。

nano /root/mirai/config/Console/AutoLogin.yml

在编辑器中添加你的bot信息，注意箭头这里必须修改为刚才导入的ANDROID_PAD，不能使用默认的ANDROID_PHONE.
6a5da3c1-f4ee-42dd-af98-55cdebd6359d-image.png
保存退出。
重新启动mirai，发现mirai自动登录完成。
3ae9b7a4-eccb-4d9e-b4c4-65ae3b561104-image.png

非必须插件安装

本项目不是必须安装的，只作为安装演示。
有些插件支持使用mcl进行安装，有些只能手动下载jar包上传plugins目录安装。
推荐安装Chat Command，luckperms - Mirai，前者为命令插件，后者为权限管理插件。
在mirai根目录执行此命令后，下次启动后会自动安装下载。

./mcl --update-package net.mamoe:chat-command --channel maven-stable --type plugin ./mcl --update-package io.github.karlatemp:luckperms --channel nightly --type plugin

完成后./mcl -u，启动等待完成即可。

配置启动

本文提供两种后台运行mirai的方式。

screen
screen为多重视窗管理程序
https://www.runoob.com/linux/linux-comm-screen.html

输入命令，创建mirai窗口

screen -S mirai

在这个窗口中启动mirai.
使用这种方式方便随时管理和查看，以及sj（视奸）群友行为。

systemctl
systemctl是 Systemd 的主命令，用于管理系统。
https://www.ruanyifeng.com/blog/2016/03/systemd-tutorial-commands.html

创建启动服务。

nano /etc/systemd/system/mirai.service

将下面的内容写入文件保存，注意对需要的部分进行修改。
如ExecStart，WorkingDirectory的变量。

[Unit] Description=Mirai Bot After=network.target [Service] Type=simple ExecStart=/root/mirai/mcl ExecStop=/bin/kill -9 $MAINPID Restart=on-failure User=root WorkingDirectory=/root/mirai StandardOutput=append:/root/mirai/log.log StandardError=append:/root/mirai/log.log [Install] WantedBy=multi-user.target

重载systemctl。

systemctl daemon-reload

将bot启动设置为开机自启。

systemctl enable mirai.service

启动mirai。

systemctl start mirai.service

检查mirai状态。

systemctl status mirai.service

f33b4fbf-71bb-4054-bee1-0d8df7f07d4d-image.png

HomeLab相关推荐

本章节为彩蛋部分，只为想在自家运行bot的选手提供一些参考。
mirai运行需要的性能很低，当然这个也和你安装的插件数量以及插件的代码效率相关。
所以如果你想在家里配置一台设备运行mirai，配置自然是越低越好，功耗自然是越低越好，最理想的方式是插个网线放窗台，使用免费的核聚变供电。
推荐硬件配置:

树莓派(arm平台) e3 1265lv3 这个带集显tdp45w，可以关闭超线程 e3 1220lv3 不带集显13w，可以配合超微C7Z97-MF板载集显实现超低功耗 i3 6100t 带集显tdp只有35w BV1JY4y117vH epyc系列 j1900 .....

推荐使用纯ECC / Regecc(如果支持，大部分家用设备不支持后者，d5平台消费级主板只能使用消费级内存条)。

电源必须使用一线或准一线品质对于设备本身的稳定性至关重要。

推荐软件配置：
proxmox作为母鸡系统启动虚拟化。
目前测试该系统可以在消费级硬件无故障的情况下实现高负载400d+的使用，下图升级过版本，进行了一次停机，实际在线时间已经将近500d。
349f7c65-f4f0-49b3-811e-18833bbb54b9-image.png

后日谈

2024.7.14 修复链接引用错误，添加其他更新版本的可用插件。
2024.7.26 补充了新版本fpv需要跳过的步骤。

完成

好耶！
猛猛安装插件。
4090ed62-911b-4f6d-b9d2-a7553b13d8aa-image.png
debc154f-a95a-4239-9bc4-e769cc8e10fb-debbafd9be5fa72cce744811a38bbb18.png

没有编程基础 怎么学习插件开发 有什么学习途径和道路吗？
目的很简单 只要能够开发插件即可 该学习什么 怎么学？请教大家了
阿里嘎多！

开源地址：https://github.com/zhaodice/Astral-QSignigngnn
内容说明：
从qsign删库跑路开始（9.0）不支持，俺懒得适配旧版本。

从9.0.56开始支持。

切记 公共API具有高风险可能 请使用与协议对应版本的libfekit.so文件 QSign基于Android平台，其它平台Sign计算的参数不同，不互通（例如：IPad）。 不支持载入Tim.apk的so文件。 为了保证作者的人身氨醛，作者绕过了一些致命性检测，但是故意保留了一部分，使用本签名将会被腾讯精准检测，具体表现是：4小时内出现冻结，每15天扫脸解封一次，请确认你的账号具有扫脸解封条件，否则请不要使用。 使用限制

本签名程序禁止由木落开发的SealDice（简称海豹骰）及其开发分支，通过gocq或包括但不限于在其他协议端进行直接调用或间接调用，整合和使用。
当您使用本程序默认你同意了上述限制。

部署方法

(编写中！，应该和原来的一样吧~)

上一篇相关帖子：https://mirai.mamoe.net/topic/2673/试图复活qsign-基于9-0-56版本-再捞一把

42e58c3a-da2f-49a2-95d3-89a94c8c58b9-image.png
因为有一个configPush超时问题，git上找到的解决方式是下载源码自行修改编译

Hibernate-plus

名字有点张扬了

hibrnate强化集成，用于以最小的程度连接你的数据库，为你带来最舒服的数据持久化。
封装了常用方法，也保留了Session的获取。

内置3种数据库驱动：
H2
MySQL
Sqlit

使用

在你的项目中引用
maven:

<dependency> <groupId>cn.chahuyun</groupId> <artifactId>hibernate-plus</artifactId> <version>1.0.7</version> <type>module</type> </dependency>

gradle:

implementation("cn.chahuyun:hibernate-plus:1.0.7")

然后创建配置文件

//这里是你的启动类 Configuration configuration = HibernatePlusService.createConfiguration(Test.class); configuration.setDriveType(DriveType.MYSQL); configuration.setAddress("localhost:3306/test"); configuration.setAutoReconnect(true); configuration.setUser("root"); configuration.setPassword("123456"); //configuration.setPackageName("cc.cb.entity");

对于驱动类型DriveType，目前只提供了3种类型

H2 MYSQL SQLITE

对于实体映射，可以填写packageName，进行指定包扫描，模板将会自动将带有Entity的实体添加到映射目录中。

当然你也可以不填写，那么我将会根据你的ClassLoader自动扫描"entry", "entity", "entities", "model", "models", "bean", "beans", "dto"几个包名下面的实体。

给定参数之后就可以通过HibernatePlusService来创建hibernate服务了

HibernatePlusService.loadingService(configuration);

成功后即可使用HibernateFactory来进行数据操作，我这里封装了几个常用的简单操作

List<MyUser> myUsers = HibernateFactory.selectList(MyUser.class); log.info("==========list============="); for (MyUser myUser : myUsers) { log.info(myUser.toString()); } log.info("==========================="); MyUser myUser = new MyUser(); myUser.setName("张"); myUser.setSex(123); Integer id = HibernateFactory.merge(myUser).getId(); log.info("==========one============="); MyUser selectOne = HibernateFactory.selectOne(MyUser.class, id); log.info(selectOne.toString()); log.info("===========================");

更复杂的操作请自行获取SessionFactory去创建。

SessionFactory session = HibernateFactory.getSession(); 自定义使用

你也可以不使用我给你的推荐配置，只需要在resources目录下填写hibernate.properties就行，然后通过

HibernatePlusService.loadingService(Test.class);

就可以使用自定义配置进行连接

Github mirai maintain download

获取MC服务器信息并以图片形式展示服务器图标、标题、延迟、玩家数量等信息。如下图所示：
8aebc9ef-cac3-4e58-b29e-374e635af103-image.png

目前仅支持Java版服务器 支持绘制玩家数量历史记录图表 支持HTTP API 支持IPv6服务器

详细命令用法见README。

3f4a3f55-4481-4583-85d9-a90035be7f12-QQ_1721359823187.png
16aa8341-dab7-4ff6-afa2-3c9f398f2f7e-QQ_1721359843881.png 606855a1-1c37-45ae-9694-572d5cf4d363-QQ_1721359855469.png 48ef38c9-a545-4b39-a647-86663bd43d62-QQ_1721359902986.png 41d36921-0e85-4a7a-bb6b-d279e91f2935-QQ_1721359978147.png