类别管理
类别是数据集里对物体类型的定义，每个类别有一个从 0 开始的编号、一个名称和一种颜色。本页介绍如何在数据集详情页管理类别列表，包括添加新类别、重命名、设置颜色和删除。
入口
数据集详情页 → 「类别」标签页。从全局数据集浏览进入的只读模式下，类别表格只展示，不允许修改。
类别表格
类别表格
- ID：类别编号，从 0 开始，与标签文件里每行第一列的数字对应。
- 颜色：类别对应的颜色色块，点击可修改。
- 名称：类别名称，支持中英文、数字、下划线和连字符。
- 使用量：该类别出现在多少张图片、多少条标注里。
- 操作：编辑（铅笔图标）和删除按钮。只读模式下这一列隐藏。
添加类别
定位输入框
在类别表格的顶部找到添加输入框。
输入名称
输入新的类别名称。名称不能与已有类别重名。
提交
按回车键，或点击旁边的「添加」按钮。
确认结果
新类别追加到列表末尾，编号自动接在最后一个类别之后。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
name | 文本 | 必填 | — | 类别名称，支持中英文、数字、下划线和连字符。不可与已有类别重名 |
重命名类别
进入编辑
点击目标类别行的编辑图标（铅笔）。
修改名称
该行变为行内输入框，显示当前名称，直接覆盖修改。
提交或取消
按回车提交修改，按 Esc 取消并还原原名称。
设置颜色
打开取色器
点击目标类别行的颜色色块，会弹出浏览器原生的取色器。
选择颜色
在取色器中挑选需要的颜色，或直接输入十六进制色值。
自动保存
选定后关闭取色器，颜色会自动保存到数据集，无需额外点确认。
颜色用途
- 类别颜色会传播到标注工作台的画布渲染、侧边栏类别列表、编辑对话框，以及数据集图片叠加层。
- 合理的颜色设置有助于在标注时快速区分不同类别，尤其是在类别较多的场景下。
删除类别
点击删除
点击目标类别行的删除图标。
确认对话框
弹出确认对话框，提示即将删除的类别名称。
确认删除
点击确认完成删除。
删除规则
- 只能删除末尾的类别，不能跳过中间类别删除。例如类别 ID 0、1、2，只能先删 2，再删 1。
- 被删除的类别不能有任何使用记录，即图片数和标注数都要为 0。
- 如果类别已被使用，删除按钮会禁用，鼠标悬浮会提示具体原因。
变更保护
类别变更涉及标签文件和数据集配置的同步，系统会在后台做以下保护：
- 类别变更后自动同步
classes.txt和dataset.yaml文件。 - 发布中或恢复中的数据集不允许修改类别，待操作完成后再试。
- 冷存储状态（已存档到对象存储）的数据集不允许修改类别，需要先恢复到本地。
常见问题
为什么删除按钮是灰的
常见原因有两类。一是该类别不是末尾类别，系统只允许从末尾开始删。二是该类别已经在图片或标注里使用过，需要先清理或转移这些标注，使用量归零后才能删除。鼠标悬浮到禁用的删除按钮上，会看到具体原因。
重命名会影响已有标签吗
不会。类别编号（ID）才是标签文件里实际引用的标识，重命名只改名称不改编号，已有的标签数据完全不受影响。颜色修改同样只影响展示，不动标签内容。