> ## 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 需要 | 冷却  |
| ----------- | ---- | -------- | --- |
| `/lock`     | 管理频道 | 管理频道     | 2 秒 |
| `/unlock`   | 管理频道 | 管理频道     | 2 秒 |
| `/hide`     | 管理频道 | 管理频道     | 2 秒 |
| `/show`     | 管理频道 | 管理频道     | 2 秒 |
| `/slowmode` | 管理频道 | 管理频道     | 2 秒 |

<AccordionGroup>
  <Accordion title="/lock 与 /unlock" icon="lock">
    拒绝或恢复 `@everyone` 的 **发送消息** 权限。`channel` 可选，默认为当前频道。适用于文字和公告频道。
  </Accordion>

  <Accordion title="/hide 与 /show" icon="eye-slash">
    拒绝或恢复 `@everyone` 的 **查看频道** 权限。适用于文字、公告、语音、论坛和舞台频道。
  </Accordion>

  <Accordion title="/slowmode" icon="hourglass">
    `duration` **必需** —— `5s`、`2m`、`1h`，或 `off` 以清除。`channel` 和 `reason` 可选。
  </Accordion>
</AccordionGroup>

<Tip>
  `/lock` 阻止人们发言但仍可阅读。`/hide` 则将频道完全从视图中移除。遭遇突袭时先锁定 —— 隐藏引起的混乱多于避免。
</Tip>

## 清理

<AccordionGroup>
  <Accordion title="/clear — 批量删除" icon="broom">
    双方均需 **管理消息** 权限。冷却 10 秒。

    | 选项      | 必需 | 说明        |
    | ------- | -- | --------- |
    | `count` | 否  | 1 至 500   |
    | `user`  | 否  | 只删除该成员的消息 |

    <Warning>
      Discord 不允许批量删除超过 **14 天** 的消息。较旧的消息将被跳过。
    </Warning>
  </Accordion>
</AccordionGroup>

## 表情

<AccordionGroup>
  <Accordion title="/add-emoji — 批量上传" icon="face-smile">
    双方均需 **管理表情** 权限。冷却 30 秒。

    两个选项 —— `emojis` 和 `message_id` —— 都可选，但 **必须提供其中之一**。传入表情列表，或包含表情的消息 ID。

    <Note>
      上传数量受服务器表情槽位限制，槽位数取决于您 Discord 的加成等级。
    </Note>
  </Accordion>
</AccordionGroup>

## 抽奖

五个全部需要 **管理服务器** 权限，另加 Vetox 的 **发送消息** 和 **嵌入链接**。冷却 5 秒。

<AccordionGroup>
  <Accordion title="/gstart — 开始抽奖" icon="gift">
    | 选项                | 必需    | 说明                     |
    | ----------------- | ----- | ---------------------- |
    | `prize`           | **是** | 最长 256 个字符             |
    | `duration`        | **是** |                        |
    | `channel`         | 否     | 默认为当前频道                |
    | `winners`         | 否     | 1–20                   |
    | `description`     | 否     | 最长 1,024 个字符           |
    | `required-role`   | 否     |                        |
    | `min-account-age` | 否     | 1–365 天                |
    | `min-level`       | 否     | 1–200                  |
    | `excluded-role`   | 否     |                        |
    | `bypass-role`     | 否     | 跳过所有要求                 |
    | `ping-role`       | 否     | **仅可在此处设置 —— 仪表盘无此控件** |
    | `start-time`      | 否     | 延迟开始                   |
  </Accordion>

  <Accordion title="/gdrop — 抢先抽奖" icon="bolt">
    先点击者获胜。`prize` 和 `winners`（1–20）**必需**；`channel`、`description`、`required-role`、`min-account-age` 和 `min-level` 可选。
  </Accordion>

  <Accordion title="/gend、/greroll、/glist" icon="flag-checkered">
    `/gend` 需要 `giveaway-id`。`/greroll` 需要 `message-id` 和可选的 `count`（1–20）。`/glist` 无选项。
  </Accordion>
</AccordionGroup>

<Note>
  `ping-role` 是唯一只以命令选项形式存在的抽奖设置。如果需要 ping 某个角色，请使用 `/gstart` 而不是从仪表盘启动。请参见 [抽奖](/zh-CN/engagement/giveaways)。
</Note>

## 精选留言板

<AccordionGroup>
  <Accordion title="/starboard — 管理条目" icon="star">
    需要 **管理消息** 权限。冷却 3 秒。六个子命令，都需要 `message` 链接（必需）和可选的 `starboard` 名称：

    | 子命令        | 效果           |
    | ---------- | ------------ |
    | `force`    | 无视星数强制添加一条消息 |
    | `unforce`  | 撤销强制添加       |
    | `freeze`   | 停止星数更新       |
    | `unfreeze` | 恢复更新         |
    | `trash`    | 移除并阻止返回      |
    | `untrash`  | 恢复已被丢弃的条目    |

    <Note>
      `starboard` 选项 **不** 自动补全 —— 请按配置的名字精确输入。
    </Note>

    <Tip>
      `untrash` 只在此处存在，无法从仪表盘排行榜访问。此命令是恢复被丢弃条目的唯一方式。
    </Tip>
  </Accordion>

  <Accordion title="⭐ Send to Starboard — 上下文菜单" icon="star">
    右键点击消息 → Apps → **Send to Starboard**。权限与 `/starboard` 相同。

    <Note>
      作为上下文菜单条目，它不会出现在仪表盘的 Commands 页面上，也无法在那里更改每服务器设置。
    </Note>
  </Accordion>
</AccordionGroup>

<Note>
  两者都需要在 [服务器设置](/zh-CN/server-management/setup) 中启用 **精华榜** 模块。
</Note>

## 工单

<AccordionGroup>
  <Accordion title="/ticket — 14 个子命令" icon="ticket">
    Vetox 需要 **管理频道** 和 **管理消息** 权限。冷却 3 秒。

    | 子命令             | 选项                                        | 效果         |
    | --------------- | ----------------------------------------- | ---------- |
    | `close`         | `reason` 可选                               | 关闭工单       |
    | `claim`         | —                                         | 认领         |
    | `unclaim`       | —                                         | 放弃认领       |
    | `reopen`        | —                                         | 重新打开已关闭工单  |
    | `add`           | `user` 必需                                 | 添加某人       |
    | `remove`        | `user` 必需                                 | 移除某人       |
    | `rename`        | `name` 必需，最多 100                          | 重命名频道      |
    | `priority`      | `level` 必需 —— none、low、medium、high、urgent | 设置优先级      |
    | `transfer`      | `category` 必需                             | 移动到另一类别    |
    | `closerequest`  | —                                         | 请求创建者关闭    |
    | `escalate`      | `target` 必需（自动补全）、`reason` 可选             | 升级到另一面板    |
    | `note`          | `content` 必需                              | 添加内部备注     |
    | `merge`         | `target` 必需                               | 合并到另一工单    |
    | `notifications` | —                                         | 您自己的工单提醒偏好 |

    除 `notifications` 外均须在工单频道内运行。
  </Accordion>
</AccordionGroup>

<Warning>
  **`/ticket` 本身不携带任何 Discord 权限要求。** 访问权由您的工单面板的支持角色决定。

  只有 `close`、`claim`、`add`、`remove` 和 `reopen` 受每按钮权限规则覆盖。其他九个 —— 包括 `rename`、`transfer`、`merge` 和 `note` —— 任何能在工单中操作的人都可以运行。请在决定谁能访问工单时留意这一点。
</Warning>

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

<Note>
  仪表盘列出了一个 `tag` 子命令，但机器人没有注册。它无法运行。
</Note>

## 疑难解答

<AccordionGroup>
  <Accordion title="/clear 没有删除全部消息">
    Discord 阻止批量删除超过 14 天的消息。
  </Accordion>

  <Accordion title="/lock 没有阻止人们发言">
    某个显式允许 "发送消息" 的角色覆写了 `@everyone` 的拒绝。请检查该频道的角色覆写。
  </Accordion>

  <Accordion title="/starboard 说找不到 starboard">
    名字必须精确匹配，且不会自动补全。
  </Accordion>

  <Accordion title="工单子命令提示必须在工单中运行">
    除 `notifications` 外都需要一个活动的工单频道。
  </Accordion>

  <Accordion title="/add-emoji 失败了">
    通常是没有空闲表情槽位，或 Vetox 缺少管理表情权限。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="成员管理" icon="gavel" href="/zh-CN/commands/moderation">
    对成员的操作。
  </Card>

  <Card title="工单" icon="ticket" href="/zh-CN/utility/tickets/overview">
    工单系统如何工作。
  </Card>
</CardGroup>