Metadata-Version: 2.4
Name: nonebot-plugin-roblox-search
Version: 1.3.5
Summary: Roblox平台综合查询插件，支持用户/游戏/群组/好友粉丝列表查询
Author-email: MrMao <admin@maoyyds.cn>
License-Expression: MIT
Project-URL: Homepage, https://github.com/maoyyds-cn/nonebot-plugin-roblox-search
Project-URL: Repository, https://github.com/maoyyds-cn/nonebot-plugin-roblox-search.git
Keywords: nonebot2,roblox,onebot-v11,查询,游戏
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nonebot2>=2.2.0
Requires-Dist: nonebot-adapter-onebot>=2.4.0
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: Pillow>=9.0.0
Requires-Dist: requests>=2.20.0
Dynamic: license-file

# nonebot-plugin-roblox-search

NoneBot2 Roblox 全功能查询插件，基于系统curl请求，无需aiohttp，低环境依赖

## 功能清单

- `/菜单`：查看全部指令（图片形式）
- `/用户名搜索 [用户名]`：通过用户名查询用户完整资料、头像、虚拟形象
- `/用户ID搜索 [数字ID]`：直接UID查询用户，包含头像和虚拟形象
- `/群组名搜索 [群组名]`：模糊搜索群组并展示详情
- `/群组ID搜索 [数字ID]`：群组ID精准查询、职位列表
- `/游戏名搜索 [游戏名]`：搜索游戏、在线人数、访问量
- `/游戏ID搜索 [数字ID]`：游戏详情+公开服务器列表
- `/获取好友列表 [用户ID]`：读取用户前10位好友
- `/获取粉丝列表 [用户ID]`：读取前10位粉丝
- `/获取关注列表 [用户ID]`：读取前10位关注

## 特性

1. 使用系统curl异步调用，规避服务器Python环境冲突
2. 多层异常捕获，单个接口失效不崩溃整条查询
3. 自动截断超长文本，适配QQ消息长度限制
4. 自带查询耗时日志，方便排错
5. 兼容Linux/Windows/Mac（需系统内置curl）
6. 自动检测系统中文字体，无需手动安装
7. 菜单以精美图片形式展示
8. 用户查询自动获取头像和虚拟形象

## 前置依赖

1. Python >=3.10
2. NoneBot2 + OneBot V11适配器
3. 系统安装curl（Linux默认自带，Windows需安装Git Bash或单独curl）

## 安装方式

### 使用nb-cli安装（推荐）

```bash
nb plugin install nonebot-plugin-roblox-search
```

### 使用pip安装

```bash
pip install nonebot-plugin-roblox-search
```

## 使用说明

安装后，发送 `/菜单` 即可查看所有可用指令。

## 白名单功能

插件支持群号白名单功能，只有在白名单中的群才能使用查询功能。

### 配置方法

在 `.env`、`.env.dev` 或 `.env.prod` 文件中添加如下配置：

```bash
SEARCHWHITE=["群号1","群号2","群号3"]
```

**示例**：
```bash
SEARCHWHITE=["123456789","987654321"]
```

### 功能逻辑

| 场景 | 结果 |
|------|------|
| 群号在白名单中 | 开放所有查询功能 |
| 群号不在白名单中 | 仅 `/菜单` 功能可用，其他功能提示未授权 |
| 未配置白名单 | 日志显示错误信息，所有查询功能禁用 |

### 未授权提示

当群未在白名单中时，使用查询功能会收到以下提示：

> 此群未获得账号所有者的允许，未开放此群白名单，暂时不开使用，请联系账号所有者

## 输出效果

用户查询会同时显示：

- 用户头像（Headshot）
- 用户虚拟形象（Avatar）
- 用户详细信息（文字）

