标注编辑器#

Ultralytics Platform 提供标注编辑器，可使用边界框、多边形、关键点、定向框和分类为图像添加标签。编辑器支持手动绘制、基于 SAM 的智能标注以及兼容 YOLO 模型的预测结果。

graph TB
    subgraph Draw["Shape set by the dataset task"]
        A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]:::start
        G[YOLO Predict]:::start
    end
    Draw --> H[Save Labels]:::out
    AI --> H

    classDef start fill:#4CAF50,color:#fff
    classDef out fill:#9C27B0,color:#fff

支持的任务类型#

标注编辑器为 6 种 YOLO 任务类型提供标注工具：

深度真值是你上传的配对地图，而不是通过绘制生成的内容，因此在深度数据集上，编辑器会以只读模式打开。

任务详情#

入门#

为图像添加标注：

1. 进入你的数据集
2. 单击一次图像，打开全屏标注编辑器
3. 使用默认的 Draw 模式，或在支持时切换到 Smart
4. 选择一个类别，直接在图像上添加或调整标注
5. 继续处理另一张图像或关闭编辑器；每次编辑后更改都会自动保存

对于可编辑的数据集，桌面端全屏查看器打开后，标注控件会立即启用。不存在单独的编辑模式或 Edit 按钮。在移动端以及你没有编辑权限时，全屏查看器为只读模式。

graph LR
    A[Open Dataset]:::start --> B[Click Image]:::proc
    B --> C[Annotate in Fullscreen]:::proc
    C --> D[Changes Auto-Save]:::out
    D --> E[Next Image]:::proc
    E --> B

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

标注模式#

Draw 是空间标注任务的默认模式。对于目标检测、分割、语义分割、姿态估计和旋转目标检测（OBB）数据集，当智能标注可用时，工具栏还提供 Smart 模式：

姿态标注使用带有骨架模板的 Draw；其 Smart 模式仅提供 YOLO 姿态模型，没有 SAM 选择器或自动应用开关。图像分类直接使用类别侧边栏，不显示任何绘图工具栏或 Smart 按钮。

目前，基于云存储或 On Premise 存储的已连接数据集不支持智能标注。

绘制模式工具#

边界框（检测）#

在对象周围绘制矩形框：

1. 在类别侧边栏中选择一个类别
2. 在默认的 Draw 模式下，单击并拖动以绘制矩形
3. 松开鼠标以完成边界框

多边形（分割）#

绘制精确的多边形掩码：

1. 在类别侧边栏中选择一个类别
2. 在默认的 Draw 模式下，单击以添加顶点，或按住 Shift 并移动鼠标以徒手绘制密集点
3. 双击、单击第一个顶点，或按 Enter 或 Escape 以闭合多边形

关键点（姿态）#

使用骨架模板标注姿态。从工具栏中选择模板，单击一次以放置所有关键点，然后拖动单个关键点来调整位置。

1. 在类别侧边栏中选择一个类别
2. 在默认的 Draw 模式下，从工具栏的模板选择器中选择骨架模板
3. 在图像上单击，一次性放置所有关键点
4. 拖动单个关键点以调整其位置

内置骨架模板#

编辑器包含 5 个内置模板：

自定义骨架模板#

为任意姿态结构创建自定义模板：

1. 点击模板选择器旁边的 + 按钮
2. 可选：点击 从……开始，从现有模板加载标志点和连接关系，作为起始模板
3. 点击画布以放置标志点
4. 为每个标志点命名并自定义颜色
5. 通过选择两个点来连接标志点（依次放置标志点时会自动绘制连接线）
6. 保存模板，以便在整个数据集中重复使用

自定义模板会保存到你的账户中，并可在所有姿态数据集中使用。

定向边界框（OBB）#

为倾斜对象绘制旋转框：

1. 在类别侧边栏中选择一个类别
2. 在默认的 Draw 模式下，点击并拖动以绘制初始框
3. 使用旋转控制柄调整角度
4. 拖动角点控制柄调整大小

分类（Classify）#

分配图像级类别标签：

1. 点击图像以打开全屏编辑器
2. 在类别侧边栏中选择一个类别，或按下 1-9 中的数字键

智能标注#

智能标注为编辑器添加了模型辅助标注功能。在智能模式下，你可以使用 Segment Anything Model (SAM) 进行基于点击的标注，或者使用预训练的 Ultralytics YOLO 模型和你自己微调的 YOLO 模型将预测结果添加为标注。SAM 智能标注适用于目标检测、分割、语义分割和旋转目标检测（OBB）任务；YOLO 智能标注还涵盖姿态估计。

SAM 智能标注#

选择 SAM 模型后：

1. 选择 Smart 或按下 S
2. 点击你要标注的对象 — SAM 会实时生成初始掩码
3. 通过更多点击来优化掩码：点击当前掩码外部以扩大覆盖范围，或点击当前掩码内部以减去区域
4. 按下 Enter 或 Escape 保存标注，或启用 auto-apply 以使用单击工作流

graph LR
    A[Press S]:::start --> B[Left-click Object]:::proc
    B --> C[SAM Generates Mask]:::proc
    C --> D{Auto-apply?}:::decide
    D -->|Yes| E[Mask Applied Automatically]:::out
    D -->|No| F{Accurate?}:::decide
    F -->|Yes| G[Enter to Save]:::out
    F -->|No| H[Add +/- Points]:::proc
    H --> C

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

SAM 智能标注可以生成：

• 用于分割任务的 多边形
• 用于检测任务的 边界框
• 用于 OBB 任务的 定向框

自动应用模式#

自动应用模式会在每次点击后自动保存 SAM 掩码，从而加快智能标注 — 无需按下 Enter。你可以使用工具栏中的自动应用按钮切换该模式，或按下 A。

SAM 模型选择#

当智能模式处于活动状态时，工具栏中会出现一个模型选择器。有六个 SAM 模型可供选择——请根据适合你数据集的速度与精度权衡来进行选择：

在智能模式激活时切换模型会为当前图像自动重新初始化预测器。

YOLO 智能标注#

选择 YOLO 模型后，智能标注可以从预训练的 Ultralytics 模型或你自行微调的模型中添加预测结果。

1. 选择 Smart 或按下 S
2. 从工具栏的模型选择器中选择 YOLO 模型（Official 或 My Models）
3. 点击 Predict
4. 检查已添加的标注，并进行所需的更正

批量标注#

批量标注是在整个数据集上运行一个 YOLO 模型，而不是仅针对打开的图像。你可以从数据集页面点击更多操作 > 批量标注来打开它，或者在编辑器中进行 YOLO 预测后，从浮动提示栏的全部推理操作中打开。它适用于平台托管且通道数最多为三通道的数据集上的数据集编辑人员，深度任务除外。

1. 从选择器中选择一个模型（Official 或 My Models）
2. 调整置信度（默认 0.25）和 IoU（默认 0.7）滑动条——当你移动它们时，测试运行条会显示模型在几张样本图像上检测到的结果
3. 开启包含已标注图像以对已经有标签的图像也进行运行；该运行会添加模型检测到的内容并保留它们原有的标签
4. 查看预计费用并点击开始

默认情况下，只对未标注的图像进行标注，且永远不会更改现有标签。运行需要数据集类别。如果模型的类别与数据集的类别不同，映射类别步骤会将每个模型类别映射到数据集类别或跳过它，而在没有类别的上游数据集中它会创建类别——运行仅在类别存在后才会开始。启动运行会首先保存一个数据集版本，因此如果你对结果不满意，可以还原数据集。

数据集页面会显示运行的进度，点击停止会保留并结算到目前为止已处理的图像。当运行完成时，摘要会显示处理过的图像以及添加的标注和类别。

类别侧边栏#

标注编辑器在画布右侧包含一个可折叠的类别侧边栏。该侧边栏提供：

• 搜索类别：在搜索字段中输入内容以筛选类别列表。对于完全匹配的结果，按下 Enter 以选中；如果不存在匹配项，则创建新类别。
• 内联创建新类别：点击列表底部的 Add class，输入名称，并可选取自定义颜色。按下 Enter 以创建。
• 内联编辑类别名称：将鼠标悬停在类别名称上，然后点击铅笔图标进行重命名。
• 颜色选择器：点击任意类别旁边的颜色色块以更改其颜色。
• 每个类别的标注数量：每个类别行都会显示标注数量的上标。
• 展开/折叠：点击尖括号以展开类别，并在其下方查看列出的各个标注。
• 双向悬停高亮：将鼠标悬停在画布上的标注上时，侧边栏中会高亮对应标注，反之亦然。侧边栏会自动滚动到相关类别。
• 隐藏/显示整个类别：点击类别行上的眼睛图标，即可一次性隐藏或显示该类别的所有标注。
• 隐藏/显示单个标注：点击任意标注行上的眼睛图标，以切换其在画布上的可见性。
• 删除标注：点击任意标注行上的垃圾桶图标以删除该标注。
• 键盘快捷键：按 1-9 可快速选择前 9 个类别，或按 H 切换图像中所有标注的可见性。

上下文菜单#

右键点击选中的标注，可打开包含以下选项的上下文菜单：

可见性控制#

可见性下拉菜单（眼睛图标）可让你切换单个元素的显示状态：

十字准星光标#

标注时，十字准星叠加层会跟踪光标位置，并在画布上显示像素坐标。这有助于精确放置标注。你可以通过可见性下拉菜单切换此功能。

SAM 悬停预览#

在智能模式下，SAM 会在你点击任何点之前提供实时悬停预览。此预览适用于 detect、segment、semantic 和 OBB 任务。添加细化点击后，预览会更新，以反映当前掩码以及活动任务的标注类型。

多边形顶点编辑#

对于 segment 标注，你可以在绘制后编辑多边形顶点：

• 移动顶点：拖动任意顶点控制柄以重新定位顶点
• 删除顶点：选择一个顶点并按 Delete 将其删除

类别管理#

创建类别#

在 Classes 选项卡中为数据集定义标注类别：

1. 导航至 Classes 选项卡
2. 使用底部的输入字段输入类别名称
3. 点击 Add 或按 Enter
4. 系统会自动从 Ultralytics 调色板中分配一种颜色

标注期间添加新类别#

你可以在标注过程中直接创建新类别，无需离开编辑器：

1. 在图像上绘制标注
2. 在类别侧边栏中，点击 Add class（或在侧边栏搜索框中输入新名称）
3. 输入类别名称
4. 按 Enter 创建并分配

这样，你就可以在数据中遇到新的对象类型时定义相应类别，实现流畅的工作流程。

编辑类别#

• 重命名：点击表格中的类别名称即可直接编辑
• 更改颜色：点击颜色色块以打开颜色选择器
• 搜索：使用搜索字段按名称筛选类别
• 排序：点击列标题，按索引、名称、标注数量或图像数量排序

类别颜色#

每个类别都会从 Ultralytics 调色板中分配一种颜色。你可以在 Classes 选项卡中使用颜色选择器自定义颜色；所选颜色会应用于整个数据集。

键盘快捷键#

使用键盘快捷键高效完成标注：

撤销/重做#

标注编辑器会维护完整的撤销/重做历史记录：

• 撤销：Cmd/Ctrl+Z
• 重做：Cmd/Ctrl+Y

历史记录包括：

• 添加标注（单个和批量）
• 编辑标注（移动、调整大小、旋转）
• 删除标注（单个和批量）
• 更改类别（单个和批量）
• 重新排列标注（z 顺序）
• 编辑多边形顶点（添加、删除、移动）
• 移动关键点

保存标注#

自上次编辑标注起一秒后，更改会自动保存。当你切换到另一张图像或关闭全屏编辑器时，更改也会保存。

• 立即保存：点击保存按钮或按下 Cmd/Ctrl+S
• 关闭：点击关闭按钮、点击图像外部，或按下 Escape；关闭时会在后台保存待处理的更改

常见问题#