84 lines
3.9 KiB
Markdown
84 lines
3.9 KiB
Markdown
# --- Astral-QSignigngnn ---
|
||
|
||
## Fork版本 Started at 9.0.56
|
||
|
||
获取QQSign参数通过Unidbg，开放HTTP API。unidbg-fetch-sign最低从QQ8.9.33（不囊括）开始支持，TIM不支持。
|
||
|
||
从qsign删库跑路开始（9.0）不支持，俺懒得适配旧版本。
|
||
|
||
**从9.0.56开始支持。**
|
||
|
||
## 切记
|
||
|
||
- 公共API具有高风险可能
|
||
- 请使用与协议对应版本的libfekit.so文件
|
||
- QSign基于Android平台，其它平台Sign计算的参数不同，不互通（例如：IPad）。
|
||
- 不支持载入Tim.apk的so文件。
|
||
- 为了保证作者的人身**氨醛**，作者绕过了一些致命性检测，但是`故意保留`了一部分，使用本签名将会被腾讯精准检测，具体表现是：4小时内出现冻结，每15天扫脸解封一次，请确认你的账号具有扫脸解封条件，否则请不要使用。
|
||
|
||
## 使用限制
|
||
本签名程序禁止由木落开发的SealDice（简称海豹骰）及其开发分支，通过gocq或包括但不限于在其他协议端进行直接调用或间接调用，整合和使用。
|
||
当您使用本程序默认你同意了上述限制。
|
||
|
||
## 部署方法
|
||
(编写中！)
|
||
|
||
## 你可能需要的项目
|
||
|
||
- [fix-protocol-version](https://github.com/cssxsh/fix-protocol-version)：基于**mirai**的qsign api对接。
|
||
|
||
## 使用API
|
||
|
||
### [初始化QSign&刷新token](https://github.com/fuqiuluo/unidbg-fetch-qsign/blob/master/refresh_token/README.md)
|
||
|
||
#### 原始energy
|
||
|
||
```kotlin
|
||
# http://host:port/custom_energy?uin=[QQ]&salt=[SALT HEX]&data=[DATA]
|
||
```
|
||
| 参数名 | 意义 | 例子 |
|
||
|-----|---------|--------|
|
||
| UIN | Bot的QQ号 | 114514 |
|
||
|
||
> 非专业人员勿用。
|
||
|
||
#### sign
|
||
|
||
```kotlin
|
||
# http://host:port/sign?uin=[UIN]&qua=[QUA]&cmd=[CMD]&seq=[SEQ]&buffer=[BUFFER]
|
||
```
|
||
| 参数名 | 意义 | 例子 |
|
||
|--------|---------------------------------------------------|-----------------------------|
|
||
| UIN | Bot的QQ号 | 114514 |
|
||
| QUA | QQ User-Agent，与QQ版本有关 | V1_AND_SQ_8.9.68_4264_YYB_D |
|
||
| CMD | 指令类型，CMD有很多种，目前登录、发信息均需要sign | wtlogin.login |
|
||
| SEQ | 数据包序列号，用于指示请求的序列或顺序。它是一个用于跟踪请求的顺序的数值，确保请求按正确的顺序处理 | 2333 |
|
||
| BUFFER | 数据包包体，不需要长度，将byte数组转换为HEX发送 | 020348010203040506 |
|
||
|
||
<details>
|
||
<summary>POST的支持</summary>
|
||
|
||
如果buffer过长，会超出get请求方式的长度上限，因此sign的请求也支持POST的方式。
|
||
|
||
请求头 `Content-Type: application/x-www-form-urlencoded`
|
||
|
||
POST的内容："uin=" + uin + "&qua=" + qua + "&cmd=" + cmd + "&seq=" + seq + "&buffer=" + buffer
|
||
</details>
|
||
|
||
#### 登录包energy(tlv544)
|
||
|
||
下面这个只是个例子
|
||
|
||
```kotlin
|
||
# http://host:port/energy?version=[VERSION]&uin=[UIN]&guid=[GUID]&data=[DATA]
|
||
```
|
||
|
||
| 参数名 | 意义 | 例子 |
|
||
|---------|--------------------------------------------------------------|----------------------------------|
|
||
| VERSION | **注意！**这里的VERSION指的**不是QQ的版本号，而是SDK Version**，可以在QQ安装包中找到此信息 | 6.0.0.2549 |
|
||
| UIN | Bot的QQ号 | 114514 |
|
||
| GUID | 登录设备的GUID，将byte数组转换为HEX发送，必须是32长度的HEX字符串 | ABCDABCDABCDABCDABCDABCDABCDABCD |
|
||
| DATA | QQ发送登录包的CmdId和SubCmdId，例子中810是登陆CmdId，9是SubCmdId | 810_9 |
|
||
|
||
## 其他
|
||
- 由于项目的特殊性，我们可能~~随时删除本项目~~且不会做出任何声明 |