标注编辑器#

Ultralytics Platform 包含一个标注编辑器，用于使用边界框、多边形、关键点、旋转框和分类来对图像进行标注。该编辑器支持手动绘制、SAM 驱动的智能标注以及来自兼容 YOLO 模型的预测。

graph TB
    subgraph Draw["Draw Mode"]
        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。分类直接使用类别侧边栏，不显示绘制工具栏。

智能标注目前不适用于连接的数据集。

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 范围内的数字键

智能标注#

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

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 模型 — 根据适合你数据集的速度与准确性权衡进行选择：

在 Smart 模式处于活动状态时切换模型会自动为当前图像重新初始化预测器。

YOLO 智能标注#

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

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

类别侧边栏#

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

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

上下文菜单#

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

可见性控件#

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

十字准线光标#

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

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 键；关闭会触发后台保存以处理未保存的更改

常见问题解答#

SAM 标注的准确度如何？#

SAM 为大多数对象提供高质量的掩码。准确度取决于：

• 对象与背景的区分度
• 图像质量和分辨率
• 提供的正/负点数量

为了获得最佳效果，请先点击对象中心，然后使用掩码外部点击来增加覆盖范围，并使用掩码内部点击来减去附近的对象或背景。

我可以导入现有的标注吗？#

可以，上传带有 YOLO-format label files 的数据集。平台会自动解析并在编辑器中显示它们。

如何标注同一类别的多个对象？#

绘制一个标注后：

1. 保持选中同一个类别
2. 绘制下一个标注
3. 重复操作直到标注完所有对象

键盘快捷键 1-9 可快速选择类别。

我可以在部分标注的数据集上进行训练吗？#

可以，但为了获得最佳效果：

• 在每张图像中标注目标类的所有对象
• 使用 Annotations 过滤器并设置为 Unannotated，以识别仍需标注的图像。

我应该使用哪个 SAM 模型？#

SAM 3 是默认的最新一代模型 —— 从它开始以获得最高质量的掩码。切换到 SAM 2.1 Small 以实现针对普通对象更快的交互式工作流，或者当你需要对复杂形状进行更高精度的掩码时使用 SAM 2.1 Large。在简单的高对比度对象上，使用 SAM 2.1 Tiny 以获得最高速度。

哪些任务支持 SAM 智能标注？#

SAM 智能标注适用于 detect、segment、semantic 和 OBB 任务。分类和姿态任务仅使用手动标注。

我可以为姿态标注创建自定义骨架模板吗？#

可以。点击骨架模板选择器旁边的 + 按钮以打开模板编辑器。放置关键点、命名它们、绘制连接线并保存。自定义模板存储在你的账户中，可在所有姿态数据集间使用。

如何切换骨架模板？#

点击标注工具栏中的模板选择器下拉菜单。选择任何内置模板（人、手、脸、狗、盒）或你保存的自定义模板。所选模板决定了你在点击图像时放置哪些关键点。