标注编辑器#

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 任务类型提供了标注工具：

Depth ground truth 是你上传的配对图，而不是你绘制的内容，因此编辑器在深度数据集上会以只读方式打开。

任务详情#

入门指南#

要标注图像：

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 是空间标注任务的默认模式。对于 detect、segment、semantic 和 OBB 数据集，当智能标注可用时，工具栏还提供 Smart 模式：

姿态标注使用带有骨架模板的 Draw——Smart 按钮会显示，但处于禁用状态并标记为“即将推出”（Coming Soon）。分类直接使用类别侧边栏，根本不显示绘图工具栏或 Smart 按钮。

智能标注目前不适用于由云端或本地（On Premise）存储支持的已连接数据集。

Draw 模式工具#

边界框 (Detect)#

在对象周围绘制矩形框：

1. 在类别侧边栏中选择一个类别
2. 在默认的 Draw 模式下，点击并拖动以绘制矩形
3. 释放以完成盒子

多边形 (Segment)#

绘制精确的多边形掩码：

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

关键点 (Pose)#

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

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

内置骨架模板#

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

自定义骨架模板#

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

1. 点击模板选择器旁边的 + 按钮
2. （可选）点击 Start from... 以从现有模板加载关键点和连接作为起点
3. 通过点击在画布上放置关键点
4. 命名每个关键点并自定义颜色
5. 通过选择两个点来连接关键点（当你按顺序放置关键点时，连接会自动绘制）
6. 保存模板以便在你的数据集之间重复使用

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

旋转边界框 (OBB)#

绘制旋转框以处理有角度的物体：

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

分类 (Classify)#

分配图像级类别标签：

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

智能标注#

智能标注为编辑器添加了模型辅助标注功能。在智能模式下，你可以使用SAM（Segment Anything Model）进行基于点击的标注，或使用预训练的 Ultralytics YOLO 模型和你自己的微调 YOLO 模型将预测添加为标注。智能标注适用于 detect、segment、semantic 和 OBB 任务。

SAM 智能标注#

选中 SAM 模型后：

1. 选择 Smart 或按 S
2. 点击你想要标注的物体 — SAM 会实时生成初始掩码
3. 通过额外点击完善掩码：点击当前掩码外部以增加覆盖范围，或点击当前掩码内部以减去区域
4. 按 Enter 或 Escape 以保存标注，或者启用自动应用以实现一键工作流

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. 检查添加的标注并进行必要的更正

类别侧边栏#

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

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

上下文菜单#

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

可见性控件#

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

十字准线光标#

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

SAM 悬停预览#

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

多边形顶点编辑#

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

• 移动顶点：拖动任何顶点手柄以重新定位
• 删除顶点：选择一个顶点并按 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；关闭会触发后台保存未保存的更改

常见问题解答#