asbot_plugin_furry-API 趣绮梦云黑查询插件
一个用于 AstrBot 的插件,通过调用趣绮梦云黑 API 查询用户的云黑信息。
功能介绍
该插件可以查询用户在趣绮梦云黑系统中的信息,包括:
- 用户基础信息(ID、绑定状态等)
- 用户发送统计(加群数、活跃度等)
- 云黑记录(是否被云黑、原因、等级等)
安装方法
- 在 AstrBot 管理面板中进入插件管理
- 选择"安装插件"
- 通过插件仓库搜索"asbot_plugin_furry-API"并安装
- 或者下载源码包放置于 plugins 目录下
配置说明
在使用插件前,需要配置 API Key:
- 前往趣绮梦平台申请 API Key
- 在 AstrBot 的插件管理界面中配置。
使用方法
在聊天界面中使用以下命令:
/云黑 # 查询自己的信息
/云黑 @某人 # 查询被@用户的信息
/云黑 <用户ID> # 查询指定用户ID的信息
/云黑查询 <用户ID> # 查询指定用户ID的信息(兼容旧指令)
/查云黑 @某人 # 查询被@用户的信息(别名)
例如:
/云黑 123456
/云黑 @小明
/云黑查询 123456
返回信息说明
查询结果包含以下信息:
📌 用户基础信息
- 用户ID:被查询的用户ID
- 手机号绑定:是否绑定了手机号
- 微信绑定:是否绑定了微信
- 支付宝绑定:是否绑定了支付宝
- 实名认证:是否完成了实名认证
📊 发送统计信息
- 加群数:加入的群数量
- 月活数量:每月消息发送数量
- 累计发送:总消息发送数量
- 首次发送:第一次发送消息的时间
- 末次发送:最后一次发送消息的时间
🔍 云黑记录
- 是否云黑:用户是否在云黑列表中
- 类型:云黑类型
- 原因:被列入云黑的原因
- 上黑管理:添加云黑记录的管理员
- 云黑等级:云黑严重等级
- 记录日期:被添加到云黑列表的日期
注意事项
- 必须配置有效的 API Key 才能使用此插件
- 查询结果依赖于趣绮梦云黑数据库的数据
- 如果查询不到用户信息,将提示"未查询到该用户的信息"
- 网络异常或API服务异常时会显示相应错误信息
更新日志
[2.3.0] - 2025-09-21
新增
- 新增AT查询功能,支持通过@用户来查询云黑信息
- 指令合并,统一使用
/云黑命令,支持多个别名(云黑查询、查云黑) - 支持多种查询方式:AT查询、ID查询、查询自己
修复
- 修复@查询时可能出现的"API返回空响应"问题
- 优化错误提示信息,便于问题排查
[2.2.0]
修复
- 修复了图片发送方法
- 修复了api改进无法充分检查响应内容就直接尝试解析JSON
[2.1.0] - 2025-08-29
修复
- 修复了消息发送方法,使用
event.chain_result()替代已废弃的event.result()方法 - 遵循 AstrBot 框架的消息组件使用规范,确保插件与框架兼容性
改进
- 保持了图片和文本合并发送的功能,同时增强了错误处理机制
- 当合并发送失败时,仍然可以分别发送图片和文本内容
版本信息
- 当前版本:v2.3.0
- 作者:furryhm
- 仓库地址:GitHub 仓库
许可证
本项目基于 LICENSE 文件中的条款进行许可。