nonebot-plugin-vvquest

通过API获取维维语录图片的NoneBot2插件

功能介绍

通过API获取维维语录图片，支持直接搜索和引用消息搜索，可配置返回图片数量和使用合并转发消息。

安装方式

使用 nb-cli 安装（推荐）

nb plugin install nonebot-plugin-vvquest

使用 pip 安装

pip install nonebot-plugin-vvquest

手动安装

1. 克隆本仓库

git clone https://github.com/webjoin111/nonebot-plugin-vvquest.git

2. 将nonebot_plugin_vvquest文件夹复制到你的插件目录下

3. 在pyproject.toml中添加插件

[tool.nonebot]
plugins = ["nonebot_plugin_vvquest"]

配置项

在.env文件中添加以下配置：

# 最大返回图片数量限制 (1-50)
VVQUEST_MAX_NUM=10

# 是否使用合并转发消息
VVQUEST_USE_FORWARD=true

# 本地API完整地址（如 http://localhost:8000/search），留空使用默认在线API
VVQUEST_API_BASE=""

# API请求冷却时间（秒），防止频繁请求 (1-300)
VVQUEST_COOLDOWN=30

使用方法

直接搜索

/vv语录 <标题> [数量/参数]

引用消息搜索

引用某条消息 + /vv语录 [数量/参数]

支持本地API

在配置中设置 VVQUEST_API_BASE 项，填写完整API地址（如 http://localhost:8000/search）

示例

/vv语录 你好
/vv语录 你好 5
/vv语录 你好 n=5

注意事项

• 默认返回5条结果，最大返回数量受配置限制
• 请求有冷却时间，防止频繁请求
• 本地API失败时会自动回退到在线API
• 插件内置API请求失败重试机制，提高稳定性

API 来源

本插件使用的 API 基于 MemeMeow 项目，在此对该项目的开发者表示衷心的感谢！

如果网络连接有问题，建议开启代理工具，并将 api.zvv.quest 加入规则列表，以确保 API 请求能够正常进行。

开源协议

本项目使用 MIT 许可证开源。