QSign

通过 Unidbg 获取 QQSign 参数，基于 fuqiuluo/unidbg-fetch-qsign 修改，仅适用于 mirai。unidbg-fetch-sign 最低从 QQ8.9.33 (不囊括) 开始支持，TIM 不支持。

本插件自带协议信息，在加载时将会应用与签名服务版本相同的设备信息文件。

不支持 Termux

Termux 请使用 cssxsh/fix-protocol-version，并在电脑上搭建签名服务，通过局域网连接签名服务。

(可能未适配)或者使用 旧版本的 cssxsh/fix-protocol-version + fuqiuluo/SignFaker

切记

• 请使用与协议对应版本的 libfekit.so 文件
• QSign 基于 Android 平台，其它平台 Sign 计算的参数不同，不互通（例如：iPad）。
• 不支持载入 Tim.apk 的 so 文件。

利弊

优点：内置签名服务无需开放端口，配置方便，即装即用，适合只开一个 mirai 的大部分轻度用户使用。自带协议信息，更换版本时无需反复下载。

缺点：服务崩溃时会连带 mirai 一起崩溃，支持多 bot 但不支持多 mirai 实例，在开启多个 mirai 的情况下每个 mirai 一个签名服务，会比外置签名服务占用更多运行内存。

开发

由于双方项目接口差异，本项目 commit message 以 [sync] 开头的提交均为同步源仓库中相应的提交。

你可以在 Actions 找到最新构建。

有别的项目要做，本项目进度暂缓，不定期同步 unidbg-fetch-qsign 的变更。

部署方法

请在 mirai 版本大于或等于 2.15.0 正式版的环境下操作。

在操作之前，请先删除原有的所有可能带有签名服务的插件，以免产生冲突。

文件很大，下载可能较慢，可以尝试使用以下工具站进行加速
https://ghproxy.com/
https://github.moeyy.cn/

到 Releases 下载 qsign-x.x.x-all.zip，将 plugins 和 txlib 文件夹解压到 mirai 所在目录。解压后文件夹结构大致情况如下

|-bots
|-config
|-data
|-plugins
  |-qsign-x.x.x.mirai2.jar
|-txlib
  |-8.9.58
  |-8.9.63
    |-android_phone.json
    |-android_pad.json
    |-config.json
    |-dtconfig.json
    |-libfekit.so
    |-libQSec.so
  |-8.9.68
  |-8.9.70
  |-8.9.71
  |-8.9.73

通常来说，到这步就完成了，你可以无脑使用 ANDROID_PHONE 或 ANDROID_PAD 协议登录了。

如果需要详细配置，请往下看。

详细配置(非必要)

首次加载插件会新建配置文件 config/top.mrxiaom.qsign/config.yml

目前配置文件里面仅有配置项 base-path，即使用的签名服务路径，默认值为 txlib/8.9.63，按自己所需进行修改。
推荐使用默认值，目前本人测试 8.9.63 运行稳定，8.9.58、8.9.68、8.9.70、8.9.71、8.9.73 未测试，风险自担。

配置文件的修改在重启 mirai 后生效。

本仓库提供的包已自带协议，本插件加载时将会把协议信息应用到 mirai。
启动 mirai 后检查一下日志输出的协议版本与签名版本是否一致，
然后使用 ANDROID_PHONE 协议登录即可。

更改协议信息

插件加载时，会扫描 base-path 目录下以协议名命名的文件，并加载协议变更。如 android_phone.json。
本插件的签名服务仅支持加载了协议变更的协议使用。

升级插件

如果你要升级 qsign 插件，通常只需要更换 plugins 文件夹内的 qsign-x.x.x.mirai2.jar 即可。
有时 txlib 内的签名服务相关文件会变动，可按需决定是否更新。

命令

/qsign          # 查看可用的签名服务版本列表
/qsign [版本号]  # 更改签名服务版本(重启生效)

屏蔽/减少日志

仅限 mirai-console，如果你在使用 mirai-core 并且没有使用 MiraiLogger 作为日志框架，请根据自己使用的日志框架自行想办法解决。

通常我们会看到日志的输出格式如下

年-月-日 时:分:秒 I/名称: 内容
例如
2023-07-16 11:45:14 I/QSign: Hello World!

在 mirai关闭的情况下 编辑配置文件 config/Console/Logger.yml，
在 loggers 下增加一句 名称: NONE 即可将该名称的日志等级改为 无，即不输出日志。
举个例子：

# 特定日志记录器输出等级
loggers:
  com.github.unidbg.linux.ARM64SyscallHandler: NONE
  com.github.unidbg.linux.AndroidSyscallHandler: NONE
  stderr: NONE

在 mirai-core 中使用

需要 Java 8，不支持 Android。
Android 请参见 fuqiuluo/SignFaker

先引用本插件为依赖

// Gradle: build.gradle(.kts)
repositories {
  mavenCentral()
}
dependencies {
  implementation("top.mrxiaom:qsign:$QSIGN_VERSION")
}

<!-- Maven: pom.xml -->
<dependencies>
  <dependency>
    <groupId>top.mrxiaom</groupId>
    <artifactId>qsign</artifactId>
    <version>$QSIGN_VERSION</version>
    <scope>provided</scope>
  </dependency>
</dependencies>

在登录前执行以下代码即可，最好在程序初始化时执行

kotlin 用法 | java 用法

编译

编译插件

./gradlew buildPlugin

打包发布 (将会在项目目录生成 qsign-x.x.x-all.zip)

./gradlew deploy