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自动应用模式 (Auto-Apply Mode)#

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

Link to this sectionSAM 模型选择#

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

当处于“智能”模式时切换模型，系统会自动为当前图像重新初始化预测器。

Link to this sectionYOLO 智能标注#

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

1. 进入编辑模式并选择 Smart 或按 S
2. 从工具栏的模型选择器（Official 或 My Models）中选择一个 YOLO 模型
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 New 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-order)
• 编辑多边形顶点（添加、移除、移动）
• 移动关键点

Link to this section保存标注#

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

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

Link to this section常见问题解答 (FAQ)#

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

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

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

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

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

可以，使用 YOLO 格式标签文件 上传你的数据集。平台会自动解析并在编辑器中显示它们。

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

绘制一个标注后：

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

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

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

可以，但为获得最佳结果：

• 在每张图像中标记目标类的所有对象
• 使用设置为 Unlabeled 的标签过滤器来识别仍需标注的图像
• 未标注的图像将从训练中排除；只有标注过的图像才会对损失函数做出贡献

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如何切换骨架模板？#

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