perf: 优化部署教程

2026-11-03 22:32:27 +08:00 · 2024-06-29 16:47:23 +08:00
parent 4fe45d164c
commit 2b8911ad25
12 changed files with 163 additions and 130 deletions
@@ -14,15 +14,19 @@ index: false
 [[toc]]
 :::

-## 可选的平台
+## 可选的平台适配器

+QChatGPT 需要一个中间程序，处理 QQ 等 IM 的协议（大部分是逆向工程）。  
 以下平台任选，也可以配置多个，QChatGPT支持同时接入一个或多个平台：

- aiocqhttp（QQ）：[aiocqhttp适配器教程](aiocqhttp/)（支持[Shamrock](aiocqhttp/shamrock.md)、[Lagrange](aiocqhttp/lagrange.md)、[LiteLoaderQQNT](aiocqhttp/llonebot.md)、[NapCat](aiocqhttp/napcat.md)）
- QQ官方机器人（QQ频道）：[QQ 官方 API 部署教程](official.md)
- ~~Mirai（QQ）：[Mirai部署教程](mirai.md)~~（被严重针对，大概率登不上，也不稳定）
- ~~go-cqhttp（QQ）：[go-cqhttp部署教程](gocq.md)~~（[官方停止维护](https://github.com/Mrs4s/go-cqhttp?tab=readme-ov-file#%E9%87%8D%E8%A6%81%E4%BF%A1%E6%81%AF)）
+### 推荐

+- aiocqhttp（QQ）：[aiocqhttp适配器教程](aiocqhttp/)
+- QQ官方API（QQ群、QQ频道）：[QQ 官方 API 部署教程](official.md)

+### 不推荐

-![QChatGPT platform.json](https://cos.thelazy.cn/pictures/202405292250017.jpeg)
+以前流行的框架，现在长期不再维护或被腾讯严重围追堵截，不推荐使用：
+
+- Mirai（QQ）：[Mirai部署教程](mirai.md) (使用旧版协议，风控严重)
+- go-cqhttp（QQ）：[go-cqhttp部署教程](gocq.md)（使用旧版协议，[官方停止维护](https://github.com/Mrs4s/go-cqhttp?tab=readme-ov-file#%E9%87%8D%E8%A6%81%E4%BF%A1%E6%81%AF)）
@@ -12,17 +12,25 @@ date: 2024-05-05

 ## OneBot 11 协议

-**OneBot：统一的聊天机器人应用接口标准**
+OneBot 是用于接入多种消息平台的标准化协议，详细介绍：[https://onebot.dev/](https://onebot.dev/)

-onebot介绍：[https://onebot.dev/](https://onebot.dev/)
+以下消息框架可以通过 OneBot 11 协议接入，需选择使用`aiocqhttp`作为适配器，修改`data/platform.json`配置文件，在`platform-adapters`字段中添加以下内容（如果已经有aiocqhttp的适配器，可以直接将其enable改为true）：

-以下消息框架可以通过 OneBot 11 协议接入，需选择使用`aiocqhttp`作为适配器，修改data下的platform.json文件
+```json
+{
+    "adapter": "aiocqhttp",
+    "enable": true,
+    "host": "0.0.0.0",
+    "port": 8080,
+    "access-token": ""
+}
+```

 ![data/platform.json](https://cos.thelazy.cn/pictures/202405292250017.jpeg)

 当前可用的OneBot 11标准消息平台，你可以选择下方任意

- [shamrock的教程](shamrock.md)
 - [Lagrange.OneBot的教程](lagrange.md)
 - [LiteLoaderQQNT的教程](llonebot.md)
- [NapCat的教程](napcat.md)
+- [NapCat的教程](napcat.md)
+- [shamrock的教程](shamrock.md)
@@ -5,7 +5,7 @@ head:
      content: Lagrange的部署教程
 title: 部署消息平台Lagrange的教程
 icon: support
-order: 4
+order: 1
 author: RockChinQ，ikun0014
 date: 2024-05-05
 ---
@@ -20,7 +20,11 @@ Lagrange 是一个 QQNT 协议逆向工程框架，比 Shamrock 或 Mirai 更加
 - Linux Ubuntu 22.04，Debian 12应该都可以
 - Windows 10,11,Server2019及以上

-## 步骤（Windows）
+
+
+## 部署步骤
+
+以下仅提供 Windows 上的大致步骤，详细步骤或其他平台请参考 [Lagrange官方文档](https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/)

 ### 环境配置

@@ -43,13 +47,21 @@ Lagrange 是一个 QQNT 协议逆向工程框架，比 Shamrock 或 Mirai 更加
 ### 尾声

 解压你所下载的zip，打开到有Lagrange.OneBot.exe的目录，在此目录下打开cmd命令提示符，输入
+
 ```bash
 .\Lagrange.OneBot
 ```
-此时如果你的环境已配置好，应该会出现填写配置文件后按任意键进入Qrcode登录，否则按输出的文字重新安装.NET 8

-配置文件填写示例：
+运行一次，如果输出了一个二维码，即可直接用机器人号扫码登录（若二维码显示不清楚，可以到lagrange的data目录下寻找图片文件）。  

-![data/platform.json](https://cos.thelazy.cn/pictures/202405292250017.jpeg)
+若无法登录，请检查是否正常填写了lagrange配置文件appsettings.json中的签名地址 SignServerUrl ，签名地址请到lagrange文档中寻找。  
+
+## 修改配置
+
+需要配置 Lagrange 以让其连接上 QChatGPT，请编辑 Lagrange 的配置文件 appsettings.json，确保 Implementations 中的连接配置符合下图内容：

 ![Lagrange.OneBot的配置文件](https://cos.thelazy.cn/pictures/202405030020679.png)
+
+其中 Type 必须为 `ReverseWebSocket`;  
+Host 为 QChatGPT 运行的主机 IP，若在同一主机上，可以写 `127.0.0.1`;  
+Suffix 必须为 `/ws`
@@ -5,7 +5,7 @@ head:
      content: 其他消息平台
 title: 部署消息平台LiteLoaderQQNT的教程
 icon: more
-order: 6
+order: 2
 author: RockChinQ
 date: 2024-03-02
 ---
@@ -17,7 +17,3 @@ date: 2024-03-02
 安装LiteLoaderQQNT的教程：https://llonebot.github.io/zh-CN/guide/getting-started

 ![image-20240515185909108](https://cos.thelazy.cn/pictures/202405151859206.png)
-
-QChatGPT platform.json
-
-![img](https://cos.thelazy.cn/pictures/202405292250017.jpeg)
@@ -5,14 +5,14 @@ head:
      content: NapCat的部署教程
 title: 部署消息平台NapCat的教程
 icon: software
-order: 5
+order: 3
 author: Lazy
 date: 2024-05-13
 ---

 ## NapCat介绍

-Lagrange 是一个 QQNT 协议逆向工程框架，比 Shamrock 或 Mirai 更加轻便，而且不需要图形环境，在Linux表现优异，与现有Hook框架有着本质区别，在性能与内存占用方面远远优于基于Hook的框架，现在目前也较为稳定。通过 OneBot 11 协议接入，需选择使用`aiocqhttp`作为适配器，填写配置时可参考 Shamrock 的方式。
+NapCat 是一个 QQNT 协议逆向工程框架。

 可选平台：

@@ -22,19 +22,15 @@ Lagrange 是一个 QQNT 协议逆向工程框架，比 Shamrock 或 Mirai 更加

 ## NapCat安装教程

-https://napneko.github.io/zh-CN/guide/getting-started
+按照 [NapCat 官方文档安装](https://napneko.github.io/zh-CN/guide/getting-started)

 运行后扫码登录

 ## NapCat配置教程

-通过 OneBot 11 协议接入，需选择使用`aiocqhttp`作为适配器，填写配置时可参考 Shamrock 和 Lagrange 的方式。
-
-![data/platform.json](https://cos.thelazy.cn/pictures/202405292250017.jpeg)
-
 登录后，可以在config文件夹中，找到并修改文件（数字对应机器人QQ号）：![image-20240514231529613](https://cos.thelazy.cn/pictures/image-20240514231529613.png)

-参考下图红框修改内容：
+参考下图红框修改内容，确保地址中 IP地址 是 QChatGPT 运行的主机的地址（若在同一网络内运行则为 127.0.0.1），后缀须为`/ws`：

 ![image-20240514231932514](https://cos.thelazy.cn/pictures/202405142319592.png)

@@ -5,7 +5,7 @@ head:
      content: OpenShamrock的部署教程
 title: 部署消息平台shamrock的教程
 icon: mobile
-order: 3
+order: 4
 author: ikun
 date: 2023-12-21
 ---
@@ -14,7 +14,7 @@ date: 2023-12-21

 ::: warning 

-OpenShamrock已归档
+OpenShamrock已归档，停止维护。

 :::