Skip to content

Commit 4fc4030

Browse files
docs(qq): 增加qq官方机器人接入 (#56)
1 parent 0ffbd92 commit 4fc4030

File tree

6 files changed

+59
-8
lines changed

6 files changed

+59
-8
lines changed

docs/deploy/README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,8 @@ index: false
88
- 平台
99
- [QQ](./platform-qq.md)
1010
- [KOOK](./platform-kook.md)
11-
- [DODO](./platform-dodo.md)
11+
- [DoDo](./platform-dodo.md)
12+
- [Discord](./platform-discord.md)
13+
- [Telegram](./platform-telegram.md)
14+
- [Slack](./platform-slack.md)
1215
- ……
79.4 KB
Loading
49.5 KB
Loading
59.7 KB
Loading
140 KB
Loading

docs/deploy/platform-qq.md

Lines changed: 55 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,19 +11,67 @@ title: QQ
1111

1212
:::
1313

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

16-
直至目前,群聊中的 QQ 机器人普遍采用「**假用户**」方式,即通过第三方软件接入注册的另一个 QQ 。**QQ 官方并未提供正规的群聊机器人支持,并且一直在对第三方实现进行技术与非技术层面的多重打击。**
16+
::: warning QQ 机器人
17+
18+
QQ 官方目前已开放了机器人功能,可进入 [QQ 开放平台](https://q.qq.com/#/) 进行申请。
19+
20+
但截止到目前,**QQ 官方机器人的群聊权限并未对所有人开放**。我们也希望在未来,每个人都能轻松地对接上官方提供的机器人服务。
21+
22+
同时,由于 QQ 官方对机器人能力的严格限制(包括获取 QQ 号、昵称,非 @ 时响应,私聊,群控等大量功能目前不支持),目前**对接官方接口的骰子很多功能无法支持**(如跑团 Log,暗骰,对抗等)。
23+
24+
:::
25+
26+
海豹从 `v1.4.2` 开始,海豹支持对接 QQ 官方的机器人服务。
27+
28+
### 尝试一下
29+
30+
如果你想尝试一下这样的机器人,非常欢迎你使用海豹官方的骰子:
31+
32+
![海豹机器人二维码](./images/platform-qq-bot-qrcode.jpg =65%x65%)
33+
34+
### 获取连接所需信息
35+
36+
要获取用于连接海豹的信息之前,你需要建立好一个 QQ 机器人应用。可前往 [QQ 开放平台](https://q.qq.com/#/) 进行申请,进行**实名**注册后,创建一个机器人应用。
37+
38+
创建完成后,进入机器人管理后台,切换到「开发设置」页面:
39+
40+
![切换到开发设置](./images/platform-qq-official-1.png =40%x40%)
41+
42+
在页面中你可以看到这样的信息,其中「机器人ID」「机器人令牌」「机器人密钥」这三项是海豹进行连接所需要的。
43+
44+
![开发设置](./images/platform-qq-official-2.png)
45+
46+
### 连接海豹
47+
48+
登录海豹并添加账号,选择「QQ(官方bot)」。填写对应的信息点击连接。你的海豹应该可以正常连接官方机器人运作了!
49+
50+
![连接官方Bot](./images/platform-qq-official-3.png =80%x80%)
51+
52+
### 使用海豹
53+
54+
::: warning 注意
55+
56+
目前官方机器人只响应包含 `@` 的消息,操作时请注意。
57+
58+
:::
59+
60+
## Go-cqhttp / Mirai
61+
62+
::: danger 不被 QQ 官方欢迎的第三方机器人
63+
64+
直至目前,绝大部分群聊中的 QQ 机器人采用「**假用户**」方式,即通过第三方软件接入注册的另一个 QQ 。**QQ 官方一直在对第三方实现进行技术与非技术层面的多重打击。**
1765

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

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

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

2472
:::
2573

26-
## 使用签名服务
74+
### 使用签名服务
2775

2876
::: danger qsign 已停止维护
2977

@@ -33,7 +81,7 @@ title: QQ
3381

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

36-
### 怎么使用签名服务?
84+
#### 怎么使用签名服务?
3785

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

@@ -76,7 +124,7 @@ title: QQ
76124

77125
:::
78126

79-
### 如何搭建签名服务
127+
#### 如何搭建签名服务
80128

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

0 commit comments

Comments
 (0)