> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 命令参考

> Vetox 命令如何工作——权限、冷却、限制——以及全部 66 个命令的索引。

Vetox 注册了 **66 个命令**。其中两个是包含子命令的容器，因此实际上有 **84 项可运行的操作**。

<CardGroup cols={2}>
  <Card title="常规" icon="message" href="/zh-CN/commands/general">
    **13** —— Vito、声望、颜色、建议、翻译、掷骰、帮助。
  </Card>

  <Card title="信息" icon="circle-info" href="/zh-CN/commands/information">
    **9** —— 头像、横幅、个人资料、邀请、角色、服务器详情。
  </Card>

  <Card title="等级" icon="chart-line" href="/zh-CN/commands/leveling">
    **5** —— 等级卡、服务器排行榜、经验值管理。
  </Card>

  <Card title="管理" icon="gavel" href="/zh-CN/commands/moderation">
    分两页共 **39** 项 —— [成员管理](/zh-CN/commands/moderation) 和 [服务器管理](/zh-CN/commands/server-moderation)。
  </Card>
</CardGroup>

## 所有命令仅限公会

<Warning>
  **没有一个 Vetox 命令在私信中可用。** 全部 66 个都仅限在服务器中使用。在与机器人的私信中键入的命令不会出现。
</Warning>

## 权限

每个命令都会进行两项独立检查。

<Steps>
  <Step title="您的权限">
    某些命令需要 Discord 权限 —— `管理服务器`、`封禁成员`、`管理角色` 等等。每个命令都会列出。
  </Step>

  <Step title="机器人的权限">
    Vetox 必须自己拥有相应权限才能执行操作。持有 `封禁成员` 权限的管理员，如果 Vetox 没有 `封禁成员` 权限，也无法通过 Vetox 封禁。
  </Step>
</Steps>

<Warning>
  对于涉及角色或成员的任何操作 —— 封禁、踢出、静音、角色修改、昵称 —— **Vetox 角色必须位于目标最高角色之上**。否则无论授予何种权限，Discord 都会拒绝。

  请参见 [权限](/zh-CN/permissions)。
</Warning>

## 冷却

按用户按命令计。大多数为 3–15 秒；少数重型命令更长。

| 冷却      | 命令                                                                        |
| ------- | ------------------------------------------------------------------------- |
| **0 秒** | `/avatar`、`/banner`、`/invites`、`/roles`、`/server-avatar`、`/server-banner` |
| 2–5 秒   | 多数管理和配置命令                                                                 |
| 10–15 秒 | `/profile`、`/rank`、`/top`，以及多数常规命令                                        |
| 20–30 秒 | `/unban-all`、`/role-multiple`、`/add-emoji`                                |

## 限制命令

在 [Commands](/zh-CN/server-management/command-management) 页面上，您可以为服务器禁用任何命令、将其限制到特定角色或频道，并设置每服务器的别名。

<Note>
  别名是每个服务器独立的设置。没有命令自带别名。
</Note>

## 没有命令受高级会员限制

<Note>
  **全部 66 个命令在每个等级都可用**，包括 Starter。高级会员限制适用于仪表盘功能和限额，而非命令访问。

  唯一的细节是 `/rep`，其每日额度取决于用户的个人 [会员](/zh-CN/premium/membership) —— 命令本身运行免费。
</Note>

## 模块开关

四个命令在其模块于 [服务器设置](/zh-CN/server-management/setup) 中关闭时会停止工作：

| 命令                                 | 模块          |
| ---------------------------------- | ----------- |
| `/colors`、`/color-set`             | Colors      |
| `/suggest`、`/suggestion`           | Suggestions |
| `/starboard`、`⭐ Send to Starboard` | 精华榜         |

<Warning>
  **`/ticket` 不受 Tickets 开关的影响。** 在服务器设置中关闭 Tickets 不会禁用 `/ticket` 命令 —— 它在已有的工单频道中会继续工作。
</Warning>

## 上下文菜单命令

一个条目不是斜杠命令：**⭐ Send to Starboard**，可通过右键点击消息 → Apps 访问。

<Note>
  由于它是上下文菜单条目而非斜杠命令，它不会出现在仪表盘的 Commands 页面上，也无法在那里更改其每服务器的设置。
</Note>

## 疑难解答

<AccordionGroup>
  <Accordion title="我输入 / 时命令没出现">
    该命令在您的服务器上被禁用、被限制到您不在的角色或频道，或 Discord 尚未刷新其命令列表 —— 尝试重启客户端。
  </Accordion>

  <Accordion title="Vetox 说无法对某成员执行操作">
    角色层级。Vetox 角色必须位于目标最高角色之上。
  </Accordion>

  <Accordion title="私信中没有任何反应">
    这是预期行为 —— 每个命令都仅限公会。
  </Accordion>

  <Accordion title="缺少某个工单子命令">
    仪表盘列出了一个 `tag` 子命令，但机器人没有注册。它无法运行。其他所有子命令均可用。
  </Accordion>
</AccordionGroup>
