# 实用命令

这些命令可帮助完成服务器管理任务，例如批量获取 ID 和机器人诊断。

***

## /ping

检查机器人的当前网关延迟。响应仅对你可见。

***

## /about

显示机器人版本信息、作者详情和简短描述。

***

## /help

打开交互式帮助菜单。一组分类按钮可让你在不离开 Discord 的情况下浏览命令文档。

帮助菜单中可用的分类：

* 口头警告
* Auttaja
* 实用工具
* 投票
* 投票模板

***

## /retrieveids channels

获取某个分类内所有频道 ID 的列表。

| 选项   | 必填 | 描述       |
| ---- | -- | -------- |
| `分类` | 是  | 要扫描的分类频道 |

返回一个格式化列表： `频道名称: ID` 键值对。适用于批量配置或脚本编写。

> 需要 **管理频道** 权限。

***

## /retrieveids users

获取具有特定角色的所有成员 ID 列表。

| 选项   | 必填 | 描述     |
| ---- | -- | ------ |
| `角色` | 是  | 要扫描的角色 |

返回一个列表： `用户名: ID` 该角色下每个成员的键值对。

> 需要 **管理角色** 权限。

***

## /retrieveids leaderboard

获取口头警告排行榜前列条目的用户 ID。

| 选项   | 必填 | 描述                 |
| ---- | -- | ------------------ |
| `类型` | 是  | `offender` 或 `mod` |

按排名顺序返回原始 Discord 用户 ID。

***

## /retrieveids searchusers

按用户名或显示名称搜索服务器成员。

| 选项   | 必填 | 描述    |
| ---- | -- | ----- |
| `文本` | 是  | 搜索字符串 |

返回匹配成员及其 ID 的列表。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vigila.augystudios.com/zh/shi-yong-fang-fa/utility.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.