Skip to content

Commit

Permalink
docs(qq): 增加qq官方机器人接入 (#56)
Browse files Browse the repository at this point in the history
  • Loading branch information
JustAnotherID committed Dec 2, 2023
1 parent 0ffbd92 commit f033c81
Show file tree
Hide file tree
Showing 6 changed files with 59 additions and 8 deletions.
5 changes: 4 additions & 1 deletion docs/deploy/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,5 +8,8 @@ index: false
- 平台
- [QQ](./platform-qq.md)
- [KOOK](./platform-kook.md)
- [DODO](./platform-dodo.md)
- [DoDo](./platform-dodo.md)
- [Discord](./platform-discord.md)
- [Telegram](./platform-telegram.md)
- [Slack](./platform-slack.md)
- ……
Binary file added docs/deploy/images/platform-qq-bot-qrcode.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deploy/images/platform-qq-official-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deploy/images/platform-qq-official-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deploy/images/platform-qq-official-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
62 changes: 55 additions & 7 deletions docs/deploy/platform-qq.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,19 +11,67 @@ title: QQ

:::

::: danger 不被 QQ 官方欢迎的机器人功能
## 官方机器人服务 <Badge type="tip" text="v1.4.2" vertical="middle" />

直至目前,群聊中的 QQ 机器人普遍采用「**假用户**」方式,即通过第三方软件接入注册的另一个 QQ 。**QQ 官方并未提供正规的群聊机器人支持,并且一直在对第三方实现进行技术与非技术层面的多重打击。**
::: warning QQ 机器人

QQ 官方目前已开放了机器人功能,可进入 [QQ 开放平台](https://q.qq.com/#/) 进行申请。

但截止到目前,**QQ 官方机器人的群聊权限并未对所有人开放**。我们也希望在未来,每个人都能轻松地对接上官方提供的机器人服务。

同时,由于 QQ 官方对机器人能力的严格限制(包括获取 QQ 号、昵称,非 @ 时响应,私聊,群控等大量功能目前不支持),目前**对接官方接口的骰子很多功能无法支持**(如跑团 Log,暗骰,对抗等)。

:::

海豹从 `v1.4.2` 开始支持对接 QQ 官方的机器人服务。

### 尝试一下

如果你想尝试一下这样的机器人,非常欢迎你使用海豹官方的骰子:

![海豹机器人二维码](./images/platform-qq-bot-qrcode.jpg =65%x65%)

### 获取连接所需信息

要获取用于连接海豹的信息之前,你需要建立好一个 QQ 机器人应用。可前往 [QQ 开放平台](https://q.qq.com/#/) 进行申请,进行**实名**注册后,创建一个机器人应用。

创建完成后,进入机器人管理后台,切换到「开发设置」页面:

![切换到开发设置](./images/platform-qq-official-1.png =40%x40%)

在页面中你可以看到这样的信息,其中「机器人ID」「机器人令牌」「机器人密钥」这三项是海豹进行连接所需要的。

![开发设置](./images/platform-qq-official-2.png)

### 连接海豹

登录海豹并添加账号,选择「QQ(官方bot)」。填写对应的信息点击连接。你的海豹应该可以正常连接官方机器人运作了!

![连接官方Bot](./images/platform-qq-official-3.png =80%x80%)

### 使用海豹

::: warning 注意

目前官方机器人只响应包含 `@` 的消息,操作时请注意。

:::

## Go-cqhttp / Mirai

::: danger 不被 QQ 官方欢迎的第三方机器人

直至目前,绝大部分群聊中的 QQ 机器人采用「**假用户**」方式,即通过第三方软件接入注册的另一个 QQ 。**QQ 官方一直在对第三方实现进行技术与非技术层面的多重打击。**

从目前的表现看来,QQ 官方会对账号行为进行检测,来区分出账号是否是正常用户(如不正常的登录方式,以不合理的速度在多地区登录等等)。我们无法得知具体的检测细节,但已证实的是,当 QQ 账号用作机器人并被检测到时,该 QQ 会视为风险账号,被官方予以警告,封禁,甚至 **永久冻结** 的惩罚。

因此,*是否在 QQ 平台搭建骰子取决于你的慎重考虑*海豹官方无法做出任何保证。倘若出现账号被封禁等情况时,海豹官方无力解决此类问题,也不对相应后果负责。
因此,*是否在 QQ 平台搭建这样的非官方机器人取决于你的慎重考虑*,复杂的部署方式是**现状下几乎唯一的选择**海豹官方无法做出任何保证。倘若出现账号被封禁等情况,海豹官方无力解决此类问题,也不对相应后果负责。

来自官方的围追堵截让 QQ 平台的部署门槛不断拉高。目前的军备竞赛下,如此复杂的部署方式是**现状下几乎唯一的选择**。对此我们也十分无奈,只能希望并期待 QQ 官方提供正式的群聊机器人支持,让合理的需求得到合法的解
如果有可能,建议迁移到其它平台,或者使用 [QQ 官方提供的机器人服务](#官方机器人服务)

:::

## 使用签名服务
### 使用签名服务

::: danger qsign 已停止维护

Expand All @@ -33,7 +81,7 @@ title: QQ

部署签名服务,即使用开源签名服务 [qsign](https://github.com/fuqiuluo/unidbg-fetch-qsign),是目前用来绕过检测的最有效手段。

### 怎么使用签名服务?
#### 怎么使用签名服务?

你可以自己在本地搭一个 qsign 服务,也可以使用别人搭好的。

Expand Down Expand Up @@ -76,7 +124,7 @@ title: QQ

:::

### 如何搭建签名服务
#### 如何搭建签名服务

::: tip 有能力的用户可以自行搭建服务。
:::
Expand Down

0 comments on commit f033c81

Please sign in to comment.