perf: 优化消息平台的文档指引

This commit is contained in:
RockChinQ
2024-02-19 20:09:55 +08:00
parent e016846480
commit ea3c2da487
4 changed files with 23 additions and 41 deletions
+8 -7
View File
@@ -12,13 +12,9 @@ category:
- 部署教程
---
# 配置go-cqhttp用于登录QQ
> 本文档仅为基本步骤,详细操作、答疑解惑及最新信息请前往[go-cqhttp官方文档](https://docs.go-cqhttp.org/)。
> 若您是从旧版本升级到此版本以使用go-cqhttp的用户,请您按照`config-template.py`的内容修改`config.py`,添加`msg_source_adapter`配置项并将其设为`nakuru`,同时添加`nakuru_config`字段按照说明配置。
## 步骤
### 下载go-cqhttp
## 下载go-cqhttp
从[go-cqhttp的Release](https://github.com/Mrs4s/go-cqhttp/releases/latest)下载最新的go-cqhttp可执行文件(建议直接下载可执行文件压缩包,而不是安装器)
@@ -127,4 +123,9 @@ ticket 后那一坨就是要输入回 mirai 的内容,但不包括首尾的双
![image-20231220211712572](https://cos.thelazy.cn/pictures/qchatgpt%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2202312202117600.png)
> 若启动后登录不成功,请尝试根据[此文档](https://docs.go-cqhttp.org/guide/config.html#%E8%AE%BE%E5%A4%87%E4%BF%A1%E6%81%AF)修改`device.json`的协议编号。
> 若启动后登录不成功,请尝试根据[此文档](https://docs.go-cqhttp.org/guide/config.html#%E8%AE%BE%E5%A4%87%E4%BF%A1%E6%81%AF)修改`device.json`的协议编号。
## 后续步骤
查看填写配置信息页,通过 Nakuru 或 aiocqhttp 适配器接入。
+11 -5
View File
@@ -12,7 +12,9 @@ category:
- 部署教程
---
## 第一步:准备工作
> 本文档仅为基本步骤,详细操作、答疑解惑及最新信息请前往[Mirai官方代码库](https://github.com/mamoe/mirai)、[Mirai官方论坛](https://mirai.mamoe.net/)
## 准备工作
> 注意:由于网络环境多样复杂,很多步骤中,有可能需要使用网络魔法,懂的都懂
@@ -28,7 +30,7 @@ category:
![image-20231218170346542](https://cos.thelazy.cn/pictures/qchatgpt%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2202312181703568.png)
## 第二步:安装 mirai-console
## 安装 mirai-console
在 [mcl-installer 的 releases 页面](https://github.com/iTXTech/mcl-installer/releases)下载对应版本的安装包,找到最新的安装包,即有“Latest”标志的安装包,点击`show all 14 assets`,下载 mcl-installer-X.X.X-windows-amd64.exe,如图,则下载`mcl-installer-1.0.7-windows-amd64.exe`,保存在刚才创建的`mirai文件夹`中
![屏幕截图 2023-11-23 223909.png](https://cos.thelazy.cn/pictures/mirai-console%E7%9A%84%E6%95%99%E7%A8%8B202312181655031.png)
@@ -46,7 +48,7 @@ category:
![屏幕截图 2023-11-24 174015.png](https://cos.thelazy.cn/pictures/qchatgpt%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2202312181714763.png)![屏幕截图 2023-11-24 174650.png](https://cos.thelazy.cn/pictures/qchatgpt%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2202312181714650.png)
当出现上面的一行绿字时,说明安装完成,到这里输入 exit,回车退出
## 第三步:安装 mirai-api-http
## 安装 mirai-api-http
打开 `mcl.cmd`,输入`mcl --update-package net.mamoe:mirai-api-http --channel stable-v2 --type plugin` ,回车
@@ -80,7 +82,7 @@ adapterSettings:
![image-20231218174112536](https://cos.thelazy.cn/pictures/qchatgpt%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2202312181741769.png)
则 mirai-api-http 安装成功。
## 第四步:配置签名服务
## 配置签名服务
在这个链接下载qsign一键签名包,点击下载最新的那个zip压缩包,如下图的`qsign-1.2.1-beta-dev-d62ddce-all.zip`【写于2023年12月19日】,[点我跳转下载页面](https://github.com/MrXiaoM/qsign/releases)
@@ -112,7 +114,7 @@ adapterSettings:
![image-20231219214603122](https://cos.thelazy.cn/pictures/qchatgpt%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2202312192146161.png)
## 第五步:运行mirai
## 运行mirai
到这里,你已经安装并配置成功了,接下来,你就可以登录机器人QQ了
@@ -151,3 +153,7 @@ ticket 后那一坨就是要输入回 mirai 的内容,但不包括首尾的双
然后回车,如果运气好的话,会提示你要收验证码,输入yes并回车,之后把验证码输入上去,然后回车即可成功登录了
如果运气不好,报错code=237了,建议换号
## 后续步骤
查看填写配置信息页,通过 YiriMirai 适配器接入。
+1 -1
View File
@@ -20,4 +20,4 @@ QQ 官方 API 可以将机器人接入 QQ 频道 和 QQ 群,QQ 群 API 只有
## 获取凭证
注册完成后,前往机器人控制台,找到 开发设置,获取 `AppId(机器人ID)` 和 `AppSecret(机器人密钥)`,进入配置步骤。
注册完成后,前往机器人控制台,找到 开发设置,获取 `AppId(机器人ID)` 和 `AppSecret(机器人密钥)`,接下来进入填写配置信息步骤。
+3 -28
View File
@@ -10,16 +10,12 @@ author: ikun
date: 2023-12-21
---
# OpenShamrock(未来可能的方向)
暂时只支持私聊回复,群聊正在适配中...
> 本文档仅为基本步骤,详细操作、答疑解惑及最新信息请前往[OpenShamrock官方文档](https://whitechi73.github.io/OpenShamrock/)。
## OpenShamrock简介
Mirai、go-cqhttp 之类的是模拟 QQ 的协议进行通信,而 Shamrock 使用的是 安卓的 Hook 来操作 QQ 模拟点击,稳定性较高。
官方文档:https://whitechi73.github.io/OpenShamrock/
可选平台(or设备):
- 模拟器
@@ -82,27 +78,6 @@ adb.exe -s 127.0.0.1:16384 forward tcp:5800 tcp:5800
adb.exe -s 127.0.0.1:16384 forward tcp:5700 tcp:5700
```
### 配置QChatGPT
### 后续步骤
修改 `config.py`中对应的设置。
```python
msg_source_adapter = "nakuru"
# [必需(与mirai二选一,取决于msg_source_adapter)]
# 使用nakuru-project框架连接go-cqhttp的配置
nakuru_config = {
"host": "localhost", # go-cqhttp的地址
"port": 5800, # go-cqhttp的正向websocket端口
"http_port": 5700, # go-cqhttp的正向http端口
"token": "" # 若在go-cqhttp的config.yml设置了access_token, 则填写此处
}
```
### 回到刚刚的手动部署文档查看后续步骤
### 测试
稍等片刻,运行QChatGPT主程序,如图,运行成功
![image-20240119085405838](https://cos.thelazy.cn/pictures/shamrock202401190854875.png)
查看填写配置信息页,通过 aiocqhttp 适配器接入。