标注编辑器

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

支持的任务类型

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

任务详情

入门指南

标注图像步骤：

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

标注模式

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

手动标注工具

边界框 (检测)

在对象周围绘制矩形框：

1. 进入编辑模式并选择 Draw
2. 点击并拖动以绘制矩形
3. 松开鼠标完成方框绘制
4. 从下拉菜单中选择一个类别

多边形 (分割)

绘制精确的多边形掩码：

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

关键点 (姿态)

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

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

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

内置骨架模板

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

自定义骨架模板

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

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

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

旋转边界框 (OBB)

为有角度的物体绘制旋转框：

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

分类 (Classify)

分配图像级类别标签：

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

智能标注

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

SAM 智能标注

选中 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 任务

自动应用模式

自动应用模式通过在每次点击后自动保存 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 个类别。

上下文菜单

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

可见性控制

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

十字准线光标

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

SAM 悬停预览

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

多边形顶点编辑

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

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

类别管理

创建类别

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

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

在标注过程中添加新类别

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

1. 在图像上绘制一个标注
2. 在类别下拉菜单中，点击 Add New Class
3. 输入类别名称
4. 按 Enter 键进行创建并分配

这实现了流畅的工作流，让你能在数据中遇到新目标类型时随时定义类别。

编辑类别

• 重命名：点击表格中的类别名称即可直接进行内联编辑
• 更改颜色：点击色块即可打开颜色选择器
• 搜索：使用搜索框按名称过滤类别
• 排序：点击列标题可按名称、标签数量或图像数量进行排序

类别颜色

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

键盘快捷键

使用键盘快捷键提高标注效率：

撤销/重做

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

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

历史记录追踪：

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

保存标注

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

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

常见问题 (FAQ)

SAM 标注有多准确？

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

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

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

我可以导入现有标注吗？

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

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

绘制标注后：

1. 保持选中同一个类别
2. 绘制下一个标注
3. 重复此步骤直到所有对象都已标注

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

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

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

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

我应该使用哪个 SAM 模型？

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

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

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

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

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

如何切换骨架模板？

点击标注工具栏中的模板选择器下拉菜单。选择任何内置模板（Person、Hand、Face、Dog、Box）或你保存的自定义模板。当你点击图像时，选定的模板决定了放置哪些关键点。