MaiBot插件安装与配置

插件安装目录

MaiBot的插件安装目录位于 <你的麦麦安装目录>/MaiBot/plugins/ 文件夹下

如何安装插件

方式一：手动安装(推荐)

1. (方式1) 在MaiBot网页控制台中找到插件市场，找到你心仪的插件，点击查看详情，跳转到仓库: Github
   (方式2) 打开MaiBot插件市场，找到你心仪的插件查看详情，并跳转到Source Repo
2. 找到<> Code->HTTPS->复制仓库Git地址（例如：https://github.com/SengokuCola/MutePlugin.git）
   
3. (海外服务器跳过此步骤) 国内服务器需要将原始Git地址替换为GitHub加速地址

# 可用加速地址(更多可见https://github.akams.cn/)：
https://gh-proxy.org/
https://hk.gh-proxy.org/
https://cdn.gh-proxy.org/
https://edgeone.gh-proxy.org/
https://gh.llkk.cc/

由以上Github加速地址+原始Git地址（例如：https://github.com/SengokuCola/MutePlugin.git），即可得到Github加速地址 https://hk.gh-proxy.org/https://github.com/SengokuCola/MutePlugin.git
4. 进入插件安装目录，输入git clone <插件的git地址>即可（国内替换为加速地址），即可下载得到插件
5. 输入ls，查看当前目录文件，使用cd <文件夹名>进入刚刚下载好的插件文件夹中

root@RainYun-c3Srwn3w:~/test# git clone https://hk.gh-proxy.org/https://github.com/SengokuCola/MutePlugin.git
Cloning into 'MutePlugin'...
remote: Enumerating objects: 45, done.
remote: Counting objects: 100% (45/45), done.
remote: Compressing objects: 100% (29/29), done.
remote: Total 45 (delta 25), reused 31 (delta 14), pack-reused 0 (from 0)
Receiving objects: 100% (45/45), 28.99 KiB | 1.71 MiB/s, done.
Resolving deltas: 100% (25/25), done.
root@RainYun-c3Srwn3w:~/test# ls
MutePlugin
root@RainYun-c3Srwn3w:~/test# cd MutePlugin/
root@RainYun-c3Srwn3w:~/test/MutePlugin#

6. 安装插件依赖
   a. 首先激活虚拟环境:

# 虚拟环境一般位于插件文件夹的上上级目录
# tip: 使用 `cd ..` 可返回上级目录  
# 当前所在 MaiBot/plugins/
source ../../venv/bin/activate

b. 安装插件依赖：
大部分插件都存在一个requirements.txt依赖需求文件，我们需要安装这些依赖

# 当前所在 MaiBot/plugins/
pip install -r <某个具体的插件文件夹>/requirements.txt

# 示例：
pip install MutePlugin/requirements.txt

不存在requirements.txt文件怎么办？

有两种可能

1. 插件不需要依赖，无需安装
2. 插件需要依赖，但插件并不规范没有放置requirements.txt，一般在插件仓库可以找到依赖需求以及如何安装的说明

7. 重新启动MaiBot本体，即可看到插件生成的config.toml配置文件
8. 使用nano或下载到本地来编辑插件配置文件

# 当前所在 MaiBot/plugins/
nano <某个具体的插件文件夹>/config.toml

9. 重启MaiBot即可生效

方式二：WebUI安装(不推荐)

在MaiBot网页控制台中找到插件市场，找到你心仪的插件即可完成安装

安装失败？

由于MaiBot-WebUI的一堆史山，使用MaiBot插件市场直接安装失败是非常正常的事情，因此推荐使用手动安装