diff --git a/docs/deploy/README.md b/docs/deploy/README.md index 6fee3ee98..5c2fd964a 100644 --- a/docs/deploy/README.md +++ b/docs/deploy/README.md @@ -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) - …… \ No newline at end of file diff --git a/docs/deploy/images/platform-qq-bot-qrcode.jpg b/docs/deploy/images/platform-qq-bot-qrcode.jpg new file mode 100644 index 000000000..133d4b5e8 Binary files /dev/null and b/docs/deploy/images/platform-qq-bot-qrcode.jpg differ diff --git a/docs/deploy/images/platform-qq-official-1.png b/docs/deploy/images/platform-qq-official-1.png new file mode 100644 index 000000000..6d4070b59 Binary files /dev/null and b/docs/deploy/images/platform-qq-official-1.png differ diff --git a/docs/deploy/images/platform-qq-official-2.png b/docs/deploy/images/platform-qq-official-2.png new file mode 100644 index 000000000..a5700aa96 Binary files /dev/null and b/docs/deploy/images/platform-qq-official-2.png differ diff --git a/docs/deploy/images/platform-qq-official-3.png b/docs/deploy/images/platform-qq-official-3.png new file mode 100644 index 000000000..2d71ea716 Binary files /dev/null and b/docs/deploy/images/platform-qq-official-3.png differ diff --git a/docs/deploy/platform-qq.md b/docs/deploy/platform-qq.md index 5dda09f54..47db307f6 100644 --- a/docs/deploy/platform-qq.md +++ b/docs/deploy/platform-qq.md @@ -11,19 +11,67 @@ title: QQ ::: -::: danger 不被 QQ 官方欢迎的机器人功能 +## 官方机器人服务 -直至目前,群聊中的 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 已停止维护 @@ -33,7 +81,7 @@ title: QQ 部署签名服务,即使用开源签名服务 [qsign](https://github.com/fuqiuluo/unidbg-fetch-qsign),是目前用来绕过检测的最有效手段。 -### 怎么使用签名服务? +#### 怎么使用签名服务? 你可以自己在本地搭一个 qsign 服务,也可以使用别人搭好的。 @@ -76,7 +124,7 @@ title: QQ ::: -### 如何搭建签名服务 +#### 如何搭建签名服务 ::: tip 有能力的用户可以自行搭建服务。 :::