# 权限

Verbal Warning Logger 使用 Discord 的角色层级来确定谁可以运行命令，而不是基于每个用户硬编码权限授予。

***

## 谁可以使用 /verbal 命令？

如果满足以下任一条件，则授予访问权限： **任一** 符合以下任一条件：

1. 成员拥有服务器上的 **管理员** 权限。
2. 成员拥有配置为 `STAFF_ROLE_ID`.
3. 成员拥有任何 **位置高于** 服务器角色列表中 staff 角色的角色。

这意味着你不需要把准确的 staff 角色授予每一位单独的版主——任何拥有更高角色的人（例如高级版主、首席管理员）都会自动包含在内。

### 角色层级示例

```
Owner           ← 可使用 /verbal ✓（高于 staff 角色）
Head Admin      ← 可使用 /verbal ✓（高于 staff 角色）
Moderator       ← STAFF_ROLE_ID — 可使用 /verbal ✓
Trial Mod       ← 不能使用 /verbal ✗（低于 staff 角色）
Member          ← 不能使用 /verbal ✗
```

***

## /retrieveids 权限

这些命令检查的是特定的 Discord 权限，而不是 staff 角色：

| 命令                         | 所需权限        |
| -------------------------- | ----------- |
| `/retrieveids channels`    | 管理频道        |
| `/retrieveids users`       | 管理角色        |
| `/retrieveids leaderboard` | staff 角色或更高 |
| `/retrieveids searchusers` | staff 角色或更高 |

***

## 更改 staff 角色

staff 角色通过 `STAFF_ROLE_ID` 环境变量设置。详情见 [配置](/zh/zi-tuo-guan/configuration.md) 。更改此值需要重启机器人。


---

# 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/permissions.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.