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

# 工单通用设置

> 服务器范围的工单配置 — 日志频道、限制、支持身份组、被封禁用户和个人员工提醒。

此处的设置适用于服务器上的**每一个**工单面板。逐面板的行为在[面板](/zh-CN/utility/tickets/panels)中设置。

四个选项卡：**通用**、**限制**、**访问**、**通知**。

## 通用

### 工单编号

| 设置         | 默认     | 效果                                 |
| ---------- | ------ | ---------------------------------- |
| **连续编号**   | **开启** | 编号一直向上递增。关闭后，工单关闭时空缺的编号会被重复使用      |
| **编号补零位数** | 0      | 前导零，0–6。补零位数为 4 时，`#7` 会变为 `#0007` |

<Tip>
  请保持连续编号开启。重复使用的编号会让记录文本和审计追踪变得模糊 — 两个不同的工单可能共用 `#12`。
</Tip>

### 工单嵌入消息默认值

<Info>
  需要 **Basic**。
</Info>

一个默认颜色和一个默认页脚（文本加图标），会应用于未覆盖它们的工单嵌入消息。

<Note>
  如果你设置了页脚图标但页脚文本为空，保存时图标会被丢弃。要让图标保留，必须填写文本。
</Note>

### 备份与恢复

<Info>
  需要 **Basic**。
</Info>

**导出配置**会下载你完整的工单设置。**导入配置**会替换它。

<Warning>
  导入会覆盖你当前的配置。它会先要求确认，但没有撤销功能 — 请先导出再导入。
</Warning>

### 危险区

* **重置所有工单设置** — 将本页所有内容恢复为默认值
* **吊销记录链接** — 使曾经发放的所有记录链接失效

<Warning>
  吊销记录链接会立即且全局生效。你分享给成员或存档到其他位置的所有链接都将停止工作。
</Warning>

## 限制

| 设置                | Starter | Basic 及以上 | 默认  |
| ----------------- | ------- | --------- | --- |
| **最大活跃工单数**（服务器）  | 200     | 无限制       | 200 |
| **每位用户最大活跃工单数**   | **1**   | 5         | 1   |
| **工单之间的冷却时间**     | 0       | 0         | 0   |
| **每位用户最大已关闭工单数**  | 3       | 100       | 0   |
| **最大已关闭工单数**（服务器） | 50      | 2,000     | 0   |
| **限制豁免身份组**       | 最多 10   | 最多 10     | 无   |

<Note>
  已关闭工单限制中值为 **0** 表示无限制 — 已关闭的工单会无限期保留。
</Note>

<Warning>
  **在 Starter 上，"每位用户最大活跃工单数"会被静默强制为 1。** 你可以输入 5，也会保存成功，但存储的值会变成 1，没有高级徽章，也没有任何解释。这是本页唯一没有任何视觉提示表明其受限制的设置。
</Warning>

### 冷却时间行为

冷却时间以秒为单位，并在保存时会被规整：

* **小于 10** 的值会变为 **0**（无冷却）
* **大于 3600** 的值会变为 **3600**（一小时）

因此 5 秒的冷却时间并不是短冷却 — 而是完全没有冷却。

### 豁免身份组

<Warning>
  豁免身份组会一次性跳过此选项卡上的**所有**限制 — 每位用户上限、服务器上限、冷却时间以及两个已关闭工单上限。

  无法只豁免其中一项。请仅授予员工。
</Warning>

## 访问

* **支持身份组** — 服务器范围的员工。面板可以在此基础上添加自己的
* **被封禁身份组** — 持有此身份组的成员无法开启工单
* **被封禁用户** — 具体的成员，可选设置到期时间和原因

<Info>
  被封禁用户：Starter 上限为 **100**，Basic 及以上为 **500**。
</Info>

封禁可以是永久的，也可以设置为 1 小时、1 天、7 天或 30 天后过期。原因存储供你自己参考，最多 500 个字符。

## 通知

七个独立的日志频道，全部默认关闭：

| 频道        | 日志      |
| --------- | ------- |
| **已开启**   | 新工单     |
| **已关闭**   | 关闭事件    |
| **已重新开启** | 重新开启事件  |
| **已重命名**  | 频道重命名   |
| **已删除**   | 删除事件    |
| **记录**    | 生成的记录文本 |
| **评分**    | 成员评分    |

### 我的提醒

逐员工的私信偏好，全部默认关闭：工单开启、升级、关闭、评分和 SLA 违约。

<Note>
  这些是**你自己的**偏好，而非服务器范围。每位员工都自行设置。
</Note>

## Vetox 所需的权限

| 权限                         | 用途              |
| -------------------------- | --------------- |
| **管理频道**                   | 用于创建、重命名和删除工单频道 |
| **管理身份组**                  | 用于应用逐工单的权限覆盖    |
| **查看频道**、**发送消息**、**嵌入链接** | 用于发布面板和工单消息     |
| **读取消息历史**                 | 用于构建记录文本        |
| **管理主题**、**创建私密主题**        | 仅限主题模式的面板       |

<Warning>
  **工单系统的任何地方都不会检查身份组层级。** 如果某个支持身份组位于 Vetox 身份组**之上**，涉及该身份组的权限变更会静默失败 — 频道里没有报错，日志中没有记录，工单看起来一切正常。

  请将 Vetox 身份组拖到所有支持身份组之上。这是"员工看不到工单"的最常见原因。
</Warning>

<Note>
  如果没有**读取消息历史**权限，工单仍可成功关闭，但记录文本会是空的。
</Note>

## 记录文本

上限为 **5,000 条消息**、每条消息 **2,000 个字符**、每份记录文本 **10 MB**。超出长度的工单会被截断。

## 降级时会发生什么变化

<Note>
  **任何工单数据都不会被删除。** 超出限制的值会被截断，受限功能会被关闭，升级后一切都会恢复。

  具体而言：服务器上限和已关闭工单上限会被截断到免费上限，关联的面板和升级目标会被清空，表单会被解除关联，优先级会重置为无，支持时段的所有时段都会被强制设为开启。
</Note>

## 故障排查

<AccordionGroup>
  <Accordion title="员工无法查看或操作工单">
    几乎总是身份组层级的问题 — 将 Vetox 身份组移到你的支持身份组之上。系统不会对此发出任何警告。
  </Accordion>

  <Accordion title="某位成员无法开启第二个工单">
    在 Starter 上，每位用户的上限为 1 且无法调高。在 Basic 及以上，可将其调至最高 5。
  </Accordion>

  <Accordion title="我设置的冷却时间被忽略了">
    小于 10 秒的值会被存储为 0。请使用 10 或以上。
  </Accordion>

  <Accordion title="工单频道存在但按钮没有反应">
    创建过程中偶发的失败可能导致频道缺少其存储状态。请手动删除该频道，并让成员重新开启一个。
  </Accordion>

  <Accordion title="记录文本是空的">
    Vetox 在该工单频道中缺少**读取消息历史**权限。
  </Accordion>

  <Accordion title="我设置了离开时自动关闭的选项，但从未触发">
    该开关目前不生效。当成员离开时，请手动关闭工单。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="面板" icon="ticket" href="/zh-CN/utility/tickets/panels">
    逐面板的问题、按钮和路由。
  </Card>

  <Card title="工单概览" icon="circle-info" href="/zh-CN/utility/tickets/overview">
    系统端到端的工作原理。
  </Card>
</CardGroup>