From 7ad431b38b8ce61d91bc2ff4256cda18e67ea6a5 Mon Sep 17 00:00:00 2001 From: GardenHumster Date: Tue, 27 Feb 2024 12:02:56 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/_sidebar.md | 4 +- docs/install.md | 22 +++------ docs/miraiInstall.md | 112 ------------------------------------------- docs/mysqlInstall.md | 57 ---------------------- 4 files changed, 8 insertions(+), 187 deletions(-) delete mode 100644 docs/miraiInstall.md delete mode 100644 docs/mysqlInstall.md diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 65a833d1..a4cf443b 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -6,9 +6,7 @@ * [词云指令](wordCloud.md) * [管理指令](manage.md) * [cookie指令](cookie.md) -* [小游戏(谁是卧底)](undercover.md) * [其他指令](other.md) -* [安装Mysql](mysqlInstall.md) -* [安装Mirai](miraiInstall.md) +* [谁是卧底](undercover.md) * [常见问题](problem.md) * [搭建图片代理](imgProxy.md) \ No newline at end of file diff --git a/docs/install.md b/docs/install.md index c221b8bf..b3893f55 100644 --- a/docs/install.md +++ b/docs/install.md @@ -5,12 +5,12 @@ ?> 不推荐你将文件解压到非英文目录和路径下，避免出现不必要的错误和问题 ## 安装数据库 -数据库为Mysql，需要自行安装，推荐安装 [v8.0.31](https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.31.0.msi) 及以上，[点击查看新手教程](mysqlInstall.md) +数据库为Mysql，需要自行安装，推荐安装 [v8.0.31](https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.31.0.msi) 及以上，新手可以百度[mysql8.0免安装教程](https://www.baidu.com/s?wd=mysql8.0%E5%85%8D%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE%E6%95%99%E7%A8%8B) ## 安装机器人库 在下面两个机器人库中选择一个安装，你可以两个都安装，但是同一时间只能运行其中一个，**推荐安装Mirai** -- **安装Mirai(二选一)：**参照 [mirai-console-loader](https://github.com/iTXTech/mirai-console-loader) 文档进行安装，然后参考 [mirai-api-http](https://github.com/project-mirai/mirai-api-http) 文档配置`mirai-api-http`插件，然后配置bot账号密码，你可以 [点击这里查看新手教程](miraiInstall.md) +- **安装Mirai(二选一)：**参照 [mirai-console-loader](https://github.com/iTXTech/mirai-console-loader) 文档安装，参考 [mirai-api-http](https://github.com/project-mirai/mirai-api-http) 文档配置`mirai-api-http`插件，参考 [登录方案](https://mirai.mamoe.net/topic/223/%E6%97%A0%E6%B3%95%E7%99%BB%E5%BD%95%E7%9A%84%E4%B8%B4%E6%97%B6%E5%A4%84%E7%90%86%E6%96%B9%E6%A1%88) 登录Bot - **安装GoCQ(二选一)：**参照 [go-cqhttp 帮助中心](https://docs.go-cqhttp.org/guide/quick_start.html#%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B) 进行安装，并配置bot账号密码。如果你需要使用私聊相关功能，记得把配置 `allow-temp-session` 设置为true @@ -47,16 +47,6 @@ GoCQ正常启动结果如下 [2023-08-05 22:52:13] [INFO]: 网络诊断完成. 未发现问题 ``` -## 部署签名服务(可选) - -如果你在登录bot账号的过程中出现了 `code=45` 等无法登录的问题，可以考虑部署签名服务，但是由于使用签名服务可能会存在账号被 `冻结/封号`的风险，请在考虑清楚后再决定是否使用，**你在使用该服务过程中出现的任何风险和问题都和本人无关，** - -你可以参考 [unidbg-fetch-qsign/wiki](https://github.com/fuqiuluo/unidbg-fetch-qsign/wiki) 自行搭建签名服务 - -Mirai库 参考 [fix-protocol-version](https://github.com/cssxsh/fix-protocol-version#mirai-console-%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95) 文档接入签名服务 - -Gocq库 参考 [签名服务器相关问题](https://github.com/Mrs4s/go-cqhttp/discussions/2245) 接入签名服务 - ## 下载插件 从 [Releases](https://github.com/GardenHamster/Theresa3rd-Bot/releases) 中下载最新版本的`Theresa3rd-Bot.zip`压缩包，然后解压到某个英文 目录/路径 下，并不需要放到mcl目录下 @@ -105,7 +95,7 @@ yum update ca-certificates -y cd TheresaBot.MiraiHttpApi.dll所在目录 ``` -4. 后台运行dll，这里的端口为前端页面端口，可以随意填，但是不要使用 mirai-http-api 或 go-cqhttp 的端口 +4. 后台运行dll，这里的端口为**前端页面端口**，可以随意填，但是不要使用 mirai-http-api 或 go-cqhttp 的端口 - 使用Mirai @@ -203,9 +193,11 @@ info: Microsoft.Hosting.Lifetime[0] ``` ## 配置Bot -访问插件启动后列出的后台地址，比如上面列出的地址：http://127.0.0.1:8088，根据自己的需要修改配置，配置保存后将会立即生效 +- 访问插件启动后列出的后台地址，比如上面列出的地址：http://127.0.0.1:8088 + +- 根据自己的需要修改配置，配置保存后将会立即生效 -你也可以手动修改[插件目录/Config]目录下的配置文件，但是这种方式修改后需要手动重启插件 +- 你也可以手动修改[插件目录/Config]目录下的配置文件，但是这种方式修改后需要手动重启插件 ## 开启VPN Pixiv需要一个可以访问外网的环境，你需要自行购买机场。 diff --git a/docs/miraiInstall.md b/docs/miraiInstall.md deleted file mode 100644 index 17afaef4..00000000 --- a/docs/miraiInstall.md +++ /dev/null @@ -1,112 +0,0 @@ -?> mirai 的相关问题，请自行到 [mirai issues](https://github.com/mamoe/mirai/issues) 或者 [mirai社区](https://mirai.mamoe.net) 中查找解决办法，这里只演示Windows下基本的安装流程，并不帮忙解决相关问题 - -?> 账号无法登录登录的问题，你可以参考 [无法登录的临时处理方案](https://mirai.mamoe.net/topic/223/%E6%97%A0%E6%B3%95%E7%99%BB%E5%BD%95%E7%9A%84%E4%B8%B4%E6%97%B6%E5%A4%84%E7%90%86%E6%96%B9%E6%A1%88) 自行解决 - -### 安装JDK17 -确保你已经安装好JDK17或者更高的版本，并且已经配置好了[环境变量](https://www.baidu.com/s?wd=jdk%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E9%85%8D%E7%BD%AE)，具体安装方法请自行[百度](https://www.baidu.com/s?wd=jdk17%E5%AE%89%E8%A3%85%E5%92%8C%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE) - -![image](/img/mirai/20230214183859.jpg) - -### 下载MCL -从[https://github.com/iTXTech/mirai-console-loader/releases](https://github.com/iTXTech/mirai-console-loader/releases) 处下载最新的mcl压缩包，然后解压到某个英文路径下 - -### 运行mcl -运行解压目录中的`mcl.cmd`，等待加载完毕，然后关闭 - -![image](/img/mirai/20230214185810.jpg) - -### 配置bot账号 -修改 `mcl目录/config/Console/AutoLogin.yml`，这里的账号和密码建议填自己的小号 - -![image](/img/mirai/20230214190430.jpg) - -### 安装mirai-api-http插件 -在`mcl目录`空白位置处按住`Shift`点击右键，在此处打开Powershell窗口，然后执行命令 - -如果没有这个选项，需要手动打开PowerShell，然后将路径切换到mcl目录下再执行命令 - -```shell -./mcl --update-package net.mamoe:mirai-api-http --channel stable-v2 --type plugin -``` - -![image](/img/mirai/20230214191133.jpg) - -![image](/img/mirai/20230214191428.jpg) - -### 配置mirai-api-http插件 -在`mcl目录/config/net.mamoe.mirai-api-http`路径下，创建`setting.yml`文件，然后将下面的配置复制到里面保存 - -!> 注意：这一个步骤很重要，有不少人因为缺少这一部分内容，导致插件连接不上MCL - -``` yaml -## 配置文件中的值，全为默认值 -## 启用的 adapter, 内置有 http, ws, reverse-ws, webhook -adapters: - - http - - ws - -## 是否开启认证流程, 若为 true 则建立连接时需要验证 verifyKey -## 建议公网连接时开启 -enableVerify: true -verifyKey: theresa3rd - -## 开启一些调式信息 -debug: false - -## 是否开启单 session 模式, 若为 true，则自动创建 session 绑定 console 中登录的 bot -## 开启后，接口中任何 sessionKey 不需要传递参数 -## 若 console 中有多个 bot 登录，则行为未定义 -## 确保 console 中只有一个 bot 登陆时启用 -singleMode: false - -## 历史消息的缓存大小 -## 同时，也是 http adapter 的消息队列容量 -cacheSize: 4096 - -## adapter 的单独配置，键名与 adapters 项配置相同 -adapterSettings: - ## 详情看 http adapter 使用说明 配置 - http: - host: localhost - port: 8100 - cors: ["*"] - - ## 详情看 websocket adapter 使用说明 配置 - ws: - host: localhost - port: 8100 - reservedSyncId: -1 -``` - -确保`verifyKey`和`port`两个值与插件中`appsettings.Production.json`的值保持一致 - -![image](/img/mirai/20230214220550.jpg) - -### 验证并登录mcl -重新启动`mcl.cmd`，等待加载完毕后出现如下界面，将下面的网址用鼠标点击选中，然后点击右键复制出来，放到浏览器中打开 - -![image](/img/mirai/20230214221934.jpg) - -浏览器打开页面后，先按下`F12`打开控制台，切换到网络选项卡，接着选中`XHR`，最后拖动滑块完成验证 - -![image](/img/mirai/20230214224403.jpg) - -点击`Preview`选项卡，然后将ticket的值全部复制出来，注意不要复制双引号 - -![image](/img/mirai/20230214230703.jpg) - -鼠标右键将复制出来的ticket值粘贴到刚才的MCL控制台中，回车提交 - -![image](/img/mirai/20230214231215.jpg) - -接下来需要验证码，先输入yes，然后再输入手机接收到的验证码，回车提交，最后看到`Bot login successful` 表示登陆成功了 - -![image](/img/mirai/20230214231901.jpg) - - -### 修改配置文件中bot账号 -打开`appsettings.Production.json` - -将`botQQ`的值，改为刚才MCL控制台中登录的QQ号，然后保存 - -![image](/img/mirai/20230214233740.jpg) diff --git a/docs/mysqlInstall.md b/docs/mysqlInstall.md deleted file mode 100644 index 9dcec981..00000000 --- a/docs/mysqlInstall.md +++ /dev/null @@ -1,57 +0,0 @@ -?> 以下教程为本人在安装某个`8.0.**`版本时记录下来的教程，并不保证和新版本的安装流程完全一致 - -?> 如果安装过程中出现问题，你可以自行百度 [mysql8.0.31安装教程](https://www.baidu.com/s?wd=mysql8.0.31%E5%AE%89%E8%A3%85%E6%95%99%E7%A8%8B)，或者 [mysql8.0.31免安装教程](https://www.baidu.com/s?wd=mysql8.0.31%E5%85%8D%E5%AE%89%E8%A3%85%E6%95%99%E7%A8%8B) - -# Mysql安装 - -### 下载安装包 -从 [mysql官网](https://dev.mysql.com/downloads/installer) 中下载最新版本，或者点击直接下载 [MySQL Installer 8.0.31](https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.31.0.msi) - -### 打开刚下载的安装包 -![image](/img/mysql/161034492-b420439a-f5fb-4bfd-bc3a-d43e63ac9bb5.png) - -### 选择Full(完全安装)，然后一直Next -![image](/img/mysql/161034853-96cc6e51-3a71-4621-8b22-1e066ba3b4c1.png) - -### 选择Yes -![image](/img/mysql/161035483-5c07bc2a-2b0c-4839-97a0-77872064cb50.png) - -### 接着Execute等待执行完毕，然后保持默认一直Next -![image](/img/mysql/161036291-05d4f84d-7d61-470c-b12d-be219bd8e85c.png) - -### 这里选择第二项 -![image](/img/mysql/161036600-0c7eb97c-5c65-4c9f-880f-09f8a8283869.png) - -### 这里设置一下数据库密码 -![image](/img/mysql/161037041-b2891423-b1ec-4705-9deb-c94785645760.png) - -### 接着一路Next、Execute、Finish -![image](/img/mysql/161037448-f0ff8f57-68a0-4a56-9d40-aef87be72f02.png) - -### 将刚才设置的数据库密码填入Password中，然后点check，显示Connection successded后点一路Next、Execute、Finish -![image](/img/mysql/161037965-01a850d5-cc5f-484f-b60f-f8e4cb07a7ed.png) - -### 完成后会打开一个Mysql Workbench，点一下下面这个连接 -![image](/img/mysql/161039046-bbf3b5de-0d7a-44df-a178-8a4ac53396e7.png) - -### 输入数据库密码 -![image](/img/mysql/161039376-873eac51-2a37-45a2-ad68-91418f1914b2.png) - -### 能进来表示安装成功了 -![image](/img/mysql/161039540-72f1b007-4266-40e8-8ab0-8e0df30ef04f.png) - -### 如果打开失败，检查一下mysql服务有没有打开 - -搜索 服务 或者 services.msc - -![image](/img/mysql/161040329-7fde87a3-4268-47dd-92e4-88059add0170.png) - -找到Mysql，如果没有正在运行的话，点击右键启动 - -![image](/img/mysql/161040800-bc413e1d-02e2-4b69-9e78-b823d349b75e.png) - -### 将数据库密码写入到bot配置文件中 - -打开`appsettings.Production.json`，将配置文件中pwd的值(这里是123456)，改为刚才设置的数据库密码，然后保存 - -![image](/img/mysql/161043245-510c6c00-a2f1-4ed1-864c-f420c4795635.png) \ No newline at end of file