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

# 成员管理命令

> 封禁、踢出、静音、超时、警告、积分和角色管理——24 个对成员操作的命令。

二十三个作用于成员的命令。每一个都需要 Discord 权限。

<Warning>
  **Vetox 角色必须位于目标最高角色之上**，否则无论权限如何，Discord 都会拒绝该操作。这是 "命令没反应" 最常见的原因。
</Warning>

## 封禁与踢出

| 命令           | 您需要     | Vetox 需要 | 冷却   |
| ------------ | ------- | -------- | ---- |
| `/ban`       | 封禁成员    | 封禁成员     | 10 秒 |
| `/unban`     | 封禁成员    | 封禁成员     | 5 秒  |
| `/unban-all` | **管理员** | 封禁成员     | 20 秒 |
| `/kick`      | 踢出成员    | 踢出成员     | 10 秒 |

<AccordionGroup>
  <Accordion title="/ban 选项" icon="hammer">
    | 选项                | 必需    | 说明                                |
    | ----------------- | ----- | --------------------------------- |
    | `user`            | **是** |                                   |
    | `duration`        | 否     | `7d`、`2h30m`、`permanent`。**默认永久** |
    | `reason`          | 否     |                                   |
    | `delete_messages` | 否     | 删除 0、1、3 或 7 天的消息历史               |

    指定时长使其变为临时封禁，自动解除。
  </Accordion>

  <Accordion title="/unban" icon="unlock">
    `user` 必需，接受提及、选择器或原始 ID —— 因为被封禁成员通常无法被正常提及。`reason` 可选。
  </Accordion>

  <Accordion title="/unban-all" icon="triangle-exclamation">
    无选项。**解封服务器中所有被封禁的用户。** 仅管理员，冷却 20 秒，没有确认提示或撤销。
  </Accordion>
</AccordionGroup>

## 超时与静音

三种不同机制 —— 请勿混淆。

| 命令                            | 机制           | 您需要  | Vetox 需要 |
| ----------------------------- | ------------ | ---- | -------- |
| `/timeout`、`/untimeout`       | Discord 原生超时 | 管理成员 | 管理成员     |
| `/mute-text`、`/unmute-text`   | 一个静音 **角色**  | 管理成员 | **管理角色** |
| `/mute-voice`、`/unmute-voice` | 服务器语音静音      | 静音成员 | 静音成员     |

均需 `user`（必需），以及可选的 `duration` 和 `reason`。冷却 5–10 秒。

<Note>
  **`/mute-text` 应用的是一个角色**，因此需要管理角色权限，并依赖该角色频道覆写的正确性。`/timeout` 使用 Discord 内置超时，完全不需要角色。
</Note>

<AccordionGroup>
  <Accordion title="/mute-check — 谁被静音了" icon="magnifying-glass">
    需要 **管理消息** 权限。`user` 可选 —— 省略则列出所有文字静音成员。冷却 5 秒。
  </Accordion>
</AccordionGroup>

## 语音

| 命令       | 您需要  | Vetox 需要 | 说明       |
| -------- | ---- | -------- | -------- |
| `/vkick` | 移动成员 | 移动成员     | 从语音断开    |
| `/move`  | 移动成员 | 移动成员     | 在语音频道间移动 |

<Warning>
  **不带 `user` 的 `/move` 会移动您自己。** 每个选项都可选，省略目标会默认为运行命令的人。请始终指定 `user`。
</Warning>

`/move` 接受 `user`、`to-user`（移动到此人所在的频道）和 `to-channel`。

## 警告与积分

| 命令              | 您需要   | 冷却  |
| --------------- | ----- | --- |
| `/warn-add`     | 管理消息  | 5 秒 |
| `/warn-remove`  | 管理消息  | 5 秒 |
| `/warnings`     | 管理消息  | 5 秒 |
| `/points`       | 管理服务器 | 5 秒 |
| `/points-reset` | 管理服务器 | 5 秒 |

<AccordionGroup>
  <Accordion title="/warn-add" icon="triangle-exclamation">
    `user` 必需，`reason` 可选。

    <Warning>
      **原因限制为 250 个字符，但 Discord 允许您输入更多。** 较长的原因会被输入框接受，但在提交时被拒绝。请保持在 250 字符以内。
    </Warning>
  </Accordion>

  <Accordion title="/warn-remove" icon="eraser">
    `user` 必需。`warning-code` 可选 —— **省略将移除该成员的所有警告**。
  </Accordion>

  <Accordion title="/warnings" icon="list">
    `user` 可选 —— 省略则列出所有被警告的成员。分页显示，带删除控件。
  </Accordion>

  <Accordion title="/points 与 /points-reset" icon="hashtag">
    `/points` 接受 `user` 和 `amount`，amount 支持 `+5`、`-5` 或 `5`。`/points-reset` 接受可选 `user` —— **省略即重置所有人**。
  </Accordion>
</AccordionGroup>

## 角色

| 命令               | 您需要     | Vetox 需要 | 冷却   |
| ---------------- | ------- | -------- | ---- |
| `/role`          | 管理角色    | 管理角色     | 3 秒  |
| `/temprole`      | 管理角色    | 管理角色     | 5 秒  |
| `/rar`           | 管理角色    | 管理角色     | 10 秒 |
| `/role-multiple` | **管理员** | 管理角色     | 30 秒 |
| `/setnick`       | 管理昵称    | 管理昵称     | 5 秒  |
| `/inrole`        | 管理服务器   | —        | 10 秒 |

<AccordionGroup>
  <Accordion title="/role — 切换角色" icon="user-tag">
    `member` 和 `role` 均必需。若不存在则添加，若存在则移除。
  </Accordion>

  <Accordion title="/temprole — 限时角色" icon="clock">
    `member`、`role` 和 `duration` 均必需。到期时角色自动移除。
  </Accordion>

  <Accordion title="/rar — 移除全部角色" icon="user-minus">
    `user` 必需。剥离 Vetox 可移除的所有角色。
  </Accordion>

  <Accordion title="/role-multiple — 批量修改角色" icon="users">
    仅管理员，冷却 30 秒。

    | 选项              | 必需    | 说明                                         |
    | --------------- | ----- | ------------------------------------------ |
    | `type`          | **是** | `give` 或 `remove`                          |
    | `role`          | **是** |                                            |
    | `pick_type`     | **是** | `all`、`bots`、`humans` 或 `role`             |
    | `required_role` | 否     | **仅当 `pick_type` 为 `role` 时使用** —— 否则被静默忽略 |

    <Warning>
      此操作会同时影响所有匹配的成员，无法批量撤销。
    </Warning>
  </Accordion>

  <Accordion title="/setnick" icon="pen">
    `user` 必需，`nickname` 可选 —— 省略则重置。**Vetox 无法重命名服务器所有者**；这是 Discord 的限制。
  </Accordion>

  <Accordion title="/inrole" icon="list">
    `role` 必需。列出拥有该角色的所有人。
  </Accordion>
</AccordionGroup>

## 疑难解答

<AccordionGroup>
  <Accordion title="Vetox 说无法对该成员操作">
    角色层级问题 —— 将 Vetox 角色移到他们之上。服务器所有者永远无法被操作。
  </Accordion>

  <Accordion title="/mute-text 没有可见效果">
    它应用的是一个角色。若该角色没有拒绝 "发送消息" 的频道覆写，成员实际并未被静音。
  </Accordion>

  <Accordion title="我运行了 /move 结果移动了自己">
    省略了 `user`，默认为您。
  </Accordion>

  <Accordion title="我的警告理由被拒绝了">
    超过 250 字符。输入框不会阻止您继续输入。
  </Accordion>

  <Accordion title="/warn-remove 移除了所有警告">
    省略了 `warning-code`，会清空全部。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="服务器管理" icon="shield-halved" href="/zh-CN/commands/server-moderation">
    频道、清理、抽奖和工单。
  </Card>

  <Card title="管理工具" icon="wrench" href="/zh-CN/moderation/moderation-tools">
    仪表盘等效项。
  </Card>
</CardGroup>