适用于nonebot2 v11的基于trace.moe的动画截图场景追溯插件
调用的相关API源自:https://soruly.github.io/trace.moe-api/#/
ps:查询结果可能会有H，请自行注意
## 🔧 开发环境
Nonebot2：2.0.0b5
python：3.8.13
操作系统：Windows10（Linux兼容性问题不大）
编辑器：pycharm
## 💿 安装
环境依赖`aiohttp`库
### 1. nb-cli安装（推荐）
在你bot工程的文件夹下，运行cmd（运行路径要对啊），执行nb命令安装插件，插件配置会自动添加至配置文件
```
nb plugin install nonebot_plugin_trace_moe
```
### 2. 本地安装
先安装下 `aiohttp`
```
pip install aiohttp
```
将项目clone到你的机器人插件下的对应插件目录内（一般为机器人文件夹下的`src/plugins`），然后把`nonebot_plugin_trace_moe`文件夹里的内容拷贝至上一级目录即可。
clone命令参考（得先装`git`，懂的都懂）：
```
git clone https://github.com/Ikaros-521/nonebot_plugin_trace_moe.git
```
也可以直接下载压缩包到插件目录解压，然后同样提取`nonebot_plugin_trace_moe`至上一级目录。
目录结构： ```你的bot/src/plugins/nonebot_plugin_trace_moe/__init__.py```
### 3. pip安装
```
pip install nonebot_plugin_trace_moe
```
打开 nonebot2 项目的 ```bot.py``` 文件, 在其中写入
```nonebot.load_plugin('nonebot_plugin_trace_moe')```
当然，如果是默认nb-cli创建的nonebot2的话，在bot路径```pyproject.toml```的```[tool.nonebot]```的```plugins```中添加```nonebot_plugin_trace_moe```即可
pyproject.toml配置例如：
```
[tool.nonebot]
plugin_dirs = ["src/plugins"]
plugins = ["nonebot_plugin_trace_moe"]
```
### 更新版本
```
nb plugin update nonebot_plugin_trace_moe
```
## 🔧 配置
### env配置
```
# nonebot_plugin_trace_moe
# 最大返回查询结果数
TRACE_MOE_MAX_RET=3
```
| 配置项 | 必填 | 默认值 | 说明 |
|:----------------:|:----:|:----:|:----------------------------:|
| `TRACE_MOE_MAX_RET` | 否 | `3` | 最大返回查询结果数 |
## 🎉 功能
调用trace.moe的API查询动画截图源自的作品名和时间段
## 👉 命令
### 1、先发送命令，再发送图片（命令前缀请自行替换）
先发送`/图片来源`或`/trace`或`/图片定位`，等bot返回`请发送需要识别的图片喵~`后，发送需要识别的图片即可。
### 2、命令+图片
编辑消息`/图片来源[待识别的图片]`或`/trace[待识别的图片]`或`/图片定位[待识别的图片]`发送即可。
bot返回内容：
### 3、回复图片+命令
回复需要处理的图片，发送`/图片来源`或`/trace`或`/图片定位`即可。
## ⚙ 拓展
修改`__init__.py`中的`catch_str = on_command("图片来源", aliases={"trace", "图片定位"})`来自定义命令触发关键词。
## 📝 更新日志
