# 口头警告

该 `/verbal` command 组是机器人核心。用它来记录、浏览和管理向服务器成员发出的口头警告。

***

## /verbal add

记录一条新的口头警告。

| 选项              | 必填 | 描述                  |
| --------------- | -- | ------------------- |
| `用户`            | 是  | 被警告的 Discord 用户     |
| `reason`        | 是  | 警告原因                |
| `evidence_link` | 是  | 一条 Discord 消息链接作为证据 |
| `mod`           | 否  | 发出警告的版主（默认为你）       |

机器人会回复一个私密确认嵌入，并向已配置的日志频道发送一条完整的日志嵌入。

***

## /verbal list

以分页嵌入形式显示所有警告（每页 10 条）。

使用 **上一页** / **下一页** 按钮来翻页。按 **关闭** 以关闭。该视图在 3 分钟无操作后超时。

***

## /verbal search

将警告列表筛选为单个用户。

| 选项   | 必填 | 描述              |
| ---- | -- | --------------- |
| `用户` | 是  | 要搜索的 Discord 用户 |

返回该用户被记录的每条警告的分页嵌入。

***

## /verbal delete

根据 ID 永久移除一条警告。

| 选项   | 必填 | 描述      |
| ---- | -- | ------- |
| `id` | 是  | 数字警告 ID |

> **此操作不可逆。** 删除操作会记录到日志频道。

***

## /verbal edit

通过模态弹窗编辑现有警告的字段。

| 选项   | 必填 | 描述          |
| ---- | -- | ----------- |
| `id` | 是  | 要编辑的数字警告 ID |

会打开一个模态窗口，其中已预填当前值。你可以更新：

* 用户（Discord ID）
* 版主（Discord ID）
* 证据链接
* 原因

更改会记录到日志频道。

***

## /verbal lb

查看按警告数量排名的排行榜。

| 选项   | 必填 | 描述                                    |
| ---- | -- | ------------------------------------- |
| `类型` | 是  | `offender` — 警告最多的用户，或 `mod` — 最活跃的版主 |

返回一个前 10 名的嵌入，包含用户提及和数量。


---

# 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/verbal-warnings.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.