> ## 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 问题。

按顺序完成这些步骤。前三步能解决大多数报告。

## 前三项检查

<Steps>
  <Step title="模块是否开启？">
    大多数功能 **默认关闭**。在 [服务器设置](/zh-CN/server-management/setup) 打开它的开关之前，配置该功能自身的页面不会有任何效果。

    这是 "我设置好了但什么都没发生" 最常见的原因。
  </Step>

  <Step title="Vetox 角色是否足够高？">
    对于任何涉及角色或成员的操作，**Vetox 角色必须位于目标最高角色之上**。在服务器设置 → 角色中将其上移。

    Discord 无论权限如何都会拒绝这些操作，Vetox 的多个部分在这方面出错时 **静默** 失败 —— 尤其是工单，完全没有错误提示。
  </Step>

  <Step title="Vetox 是否在该频道拥有权限？">
    检查机器人在具体频道中的 *有效* 权限，而非其服务器范围的角色。**嵌入链接** 是最常缺失的一项。
  </Step>
</Steps>

## 按症状

<AccordionGroup>
  <Accordion title="自动管理没有过滤任何东西" icon="filter">
    1. 全部八条规则出厂时 **禁用** —— 请开启您想要的
    2. **管理员永远不会被过滤。** 请用普通账户测试
    3. 每条消息只会触发第一条匹配的规则
    4. 检查该规则自身的禁用频道和角色
    5. 如果存在任何自动化操作，规则级别的超时会在各处被抑制
  </Accordion>

  <Accordion title="通知从未到达" icon="bell">
    1. **服务器设置** 中该平台的开关 —— 默认关闭，通知页面不显示其状态
    2. 有效的 **Basic** 或更高级别高级会员
    3. 目标频道的 **嵌入链接** 权限
    4. 在 Twitch 和 Kick 上，添加已经在直播的主播直到下次开播才会公告
    5. 高级会员失效期间发布的任何内容都被标记为已读，不会重播
  </Accordion>

  <Accordion title="角色没有被分配" icon="user-tag">
    1. 角色必须在 Vetox 角色 **之下**
    2. Vetox 需要 **管理角色** 权限
    3. Vetox 拒绝将任何持有管理员、管理服务器或管理角色的角色作为奖励发放 —— 无法覆盖
    4. 奖励角色行未选择角色时，保存时该行会被静默丢弃
  </Accordion>

  <Accordion title="员工无法在工单中查看或操作" icon="ticket">
    几乎总是 **角色层级** 问题。将 Vetox 角色移到所有支持角色之上。

    工单权限失败不会产生错误、不会记录日志，除了员工无法操作之外没有可见症状。
  </Accordion>

  <Accordion title="一个嵌入字段总是消失" icon="rectangle-list">
    它的标题或值解析为空，而空字段会被丢弃。几乎总是拼写错误的变量或该功能中不存在的变量 —— 请检查 [变量](/zh-CN/help/variables)。
  </Accordion>

  <Accordion title="设置已保存但未生效" icon="floppy-disk">
    配置通常在几秒内到达机器人。如果通知丢失，机器人会保留旧值直到其缓存过期 —— **最长约 10 分钟**。

    请在重新保存前等待十分钟。
  </Accordion>

  <Accordion title="成员没有获得经验值" icon="chart-line">
    1. 等级已在服务器设置中开启
    2. 频道未被排除，且成员未持有排除角色
    3. 在 **Starter** 上，文字/语音/反应开关不生效 —— 机器人一律使用标准速率
  </Accordion>

  <Accordion title="欢迎消息没有发送" icon="hand-wave">
    1. 服务器设置中 Welcomer 已开、频道已设、消息开关已开
    2. 图片需要 **附加文件** 权限
    3. 如果 `[Server]` 按字面显示，请将其改为 `[ServerName]`
    4. 如果您的嵌入总是恢复，保存时消息类型必须设为 **Embed**
  </Accordion>

  <Accordion title="申请无法提交" icon="clipboard-list">
    带有超过 5 个问题的对话框表单，如果其中较靠后的一个必填，就 **永远** 无法提交 —— Discord 显示 5 个字段但第 6 个仍会被验证。

    请切换到私信流程，或将第 6 个及以后的问题设为可选。
  </Accordion>

  <Accordion title="命令未出现" icon="terminal">
    1. 每个命令都是 **仅公会** —— 私信中无一可用
    2. 它可能已在 [Commands](/zh-CN/server-management/command-management) 页面被禁用或限制
    3. 重启 Discord 客户端以刷新命令列表
  </Accordion>

  <Accordion title="AI 功能停止工作" icon="sparkles">
    检查 [AI Usage](/zh-CN/moderation/ai-usage) 的 token 余额。

    Auto-Mod 在低于 3,000 token 时停止；Server Control 在低于 30,000 时拒绝。Auto-Mod 是失败关闭的 —— 如果无法确认预算就不会扫描。
  </Accordion>

  <Accordion title="AI 服务器控制完全无视我" icon="wand-magic-sparkles">
    沉默是所有访问失败的正常回应。按顺序：

    1. **直接** 提及机器人 —— 角色 ping 或回复 ping 不算触发
    2. 服务器设置中 AI 服务器控制已开
    3. 频道在范围内
    4. 您是管理员，**或** 在开启了 *允许列表绕过管理员* 的允许列表中 —— 允许列表本身不会做任何事
    5. 您未被限速
  </Accordion>

  <Accordion title="购买未应用" icon="credit-card">
    通常一秒内应用。请等待约 15 分钟，然后联系支持 —— **不要再次购买**。
  </Accordion>

  <Accordion title="降级后数据消失了" icon="triangle-exclamation">
    九个类别是永久删除而非禁用 —— 最重要的是 **超过新限额的申请问题**。请参见 [功能限额](/zh-CN/premium/feature-limits)。
  </Accordion>

  <Accordion title="计划任务在错误时间触发" icon="clock">
    检查服务器设置中的 **服务器时区** —— 它驱动连胜、重置和计划操作。

    提醒是例外：它们会捕获创建时浏览器的时区，且没有相应控件。
  </Accordion>
</AccordionGroup>

## 看似坏了但其实没坏

<Note>
  | 行为                     | 原因                    |
  | ---------------------- | --------------------- |
  | 管理员绕过自动管理              | 这是设计使然，界面中未显示         |
  | 每条消息只触发一条 Auto-Mod 规则  | 设计使然 —— 首条匹配获胜        |
  | 直播中途添加主播未产生任何东西        | 直播追踪在状态转变时触发          |
  | 您的 Vito 排名落后于余额        | 排行榜每 12 小时重算          |
  | 一次性提醒触发后仍留在列表中         | 作为记录保留，标记为已完成         |
  | 首次加载时七张服务器设置卡片闪烁 "已启用" | 装饰效果；Disabled 状态才是真实的 |
  | 不带用户的 `/move` 移动了您     | 该选项默认为调用者             |
</Note>

## 仍然卡住

<CardGroup cols={2}>
  <Card title="支持服务器" icon="discord" href="https://discord.gg/vetox">
    在 Vetox Discord 中提问。
  </Card>

  <Card title="我需要帮助" icon="life-ring" href="/zh-CN/server-management/support-sessions">
    让坐席实时查看您的仪表盘。
  </Card>
</CardGroup>