Link to this section标注编辑器#

Ultralytics Platform 包含一个强大的标注编辑器，用于通过边界框、多边形、关键点、旋转框和分类来标注图像。该编辑器支持手动绘制和 SAM 支持的智能标注。

graph TB
    subgraph Manual["Manual Tools"]
        A[Box] & B[Polygon] & C[Keypoint] & D[OBB] & E[Classify]
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]
    end
    Manual --> H[Save Labels]
    AI --> H

Link to this section支持的任务类型#

标注编辑器支持所有 6 种 YOLO 任务类型：

Link to this section任务详情#

Link to this section入门指南#

要标注图像：

1. 导航到你的数据集
2. 点击图像以打开全屏查看器
3. 点击 Edit 进入标注模式
4. 从工具栏选择你的标注工具
5. 在图像上绘制标注
6. 完成后点击 Save

graph LR
    A[Open Dataset] --> B[Click Image]
    B --> C[Click Edit]
    C --> D[Draw Annotations]
    D --> E[Save]
    E --> F[Next Image]
    F --> B

    style C fill:#2196F3,color:#fff
    style D fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff

Link to this section标注模式#

编辑器提供两种可从工具栏选择的标注模式：

Link to this section手动标注工具#

Link to this section边界框 (Detect)#

在对象周围绘制矩形框：

1. 进入编辑模式并选择 Draw
2. 点击并拖动以绘制矩形
3. 释放以完成盒子
4. 从下拉菜单中选择一个类别

Link to this section多边形 (Segment)#

绘制精确的多边形掩码：

1. 进入编辑模式并选择 Draw
2. 点击以添加顶点，或按住 Shift 并移动鼠标以手绘密集点
3. 点击第一个顶点，或按 Enter 或 Escape 闭合多边形
4. 从下拉菜单中选择一个类别

Link to this section关键点 (Pose)#

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

1. 进入编辑模式并选择 Draw
2. 从工具栏的模板选择器中选择一个骨架模板

3. 点击图像一次性放置所有关键点
4. 拖动单个关键点以调整它们的位置
5. 按 Enter 确认或按 Escape 取消

Link to this section内置骨架模板#

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

Link to this section自定义骨架模板#

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

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

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

Link to this section旋转边界框 (OBB)#

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

1. 进入编辑模式并选择 Draw
2. 点击并拖动以绘制初始框
3. 使用旋转手柄调整角度
4. 拖动角点手柄以调整大小
5. 从下拉菜单中选择一个类别

Link to this section分类 (Classify)#

分配图像级类别标签：

1. 进入编辑模式
2. 侧面板会出现类别选择按钮
3. 点击类别按钮或按下数字键 1-9

Link to this section智能标注#

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

Link to this sectionSAM 智能标注#

选中 SAM 模型后：

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

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

    style A fill:#2196F3,color:#fff
    style C fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff
    style G fill:#4CAF50,color:#fff

SAM 智能标注可以生成：

• 多边形用于分割任务
• 边界框用于检测任务
• 旋转框用于 OBB 任务

Link to this section自动应用模式#

自动应用模式通过在每次点击后自动保存 SAM 掩码来加速智能标注 — 无需按 Enter。通过工具栏中的自动应用按钮进行切换或按 A。

Link to this sectionSAM 模型选择#

当智能模式激活时，工具栏中会出现模型选择器。提供五个 SAM 模型 — 根据适合你数据集的速度与准确性权衡进行选择：

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

Link to this sectionYOLO 智能标注#

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

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

Link to this section类别侧边栏#

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

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

Link to this section上下文菜单#

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

Link to this section可见性控件#

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

Link to this section十字准线光标#

在编辑模式下，十字准线覆盖层会追踪光标位置并在画布上显示像素坐标。这有助于精确放置标注。可通过可见性下拉菜单进行切换。

Link to this sectionSAM 悬停预览#

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

Link to this section多边形顶点编辑#

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

• 移动顶点：拖动任何顶点手柄以重新定位
• 删除顶点：选中一个顶点并按 Delete 键将其移除

Link to this section类别管理#

Link to this section创建类别#

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

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

Link to this section在标注过程中添加新类别#

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

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

这实现了一个流畅的工作流程，你可以在数据中遇到新对象类型时随时定义类别。

Link to this section编辑类别#

• 重命名：点击表中的类别名称进行内联编辑
• 更改颜色：点击色块以打开颜色选择器
• 搜索：使用搜索字段按名称过滤类别
• 排序：点击列标题可按索引、名称、标注计数或图像计数进行排序

Link to this section类别颜色#

每个类别都会从 Ultralytics 配色方案中分配一种颜色。你可以使用 Classes 选项卡上的颜色选择器自定义颜色。颜色在整个平台中保持一致，以便于识别。

Link to this section键盘快捷键#

通过键盘快捷键实现高效标注：

Link to this section撤销/重做#

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

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

历史记录追踪：

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

Link to this section保存标注#

当你点击 Save 或按下 Cmd/Ctrl+S 时，标注会被保存：

• 保存：点击保存按钮或按下 Cmd/Ctrl+S
• 取消：点击取消以放弃更改
• Escape：如果有未保存的更改则保存，否则退出编辑模式

Link to this section常见问题解答#

Link to this sectionSAM 标注的准确度如何？#

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

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

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

Link to this section我可以导入现有的标注吗？#

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

Link to this section如何标注同一类别的多个对象？#

绘制一个标注后：

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

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

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

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

• 在每张图像中标注目标类的所有对象
• Use the Annotations filter set to Unannotated to identify images that still need annotation
• 未标注的图像会从训练中排除；只有标注过的图像才会对损失计算做出贡献

Link to this section我应该使用哪个 SAM 模型？#

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

Link to this section哪些任务支持 SAM 智能标注？#

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

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

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

Link to this section如何切换骨架模板？#

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