SAM 智能辅助标注

这个功能解决什么问题

手动画框、勾轮廓费时费力。分割任务尤其磨人，沿物体边缘一点点描多边形，一张图就要好几分钟。SAM 智能辅助标注用分割模型帮你把这件事做完：在目标上点一下，模型自动识别出目标的轮廓，再按你的项目类型转换成对应的标注格式。

检测项目自动取外接矩形，分割项目直接用多边形，OBB 项目还会算出最小外接旋转矩形和角度。无论哪种任务类型，标注效率都能提升好几倍。

适用范围

• 目标检测：点击目标生成外接矩形框。
• 实例分割：点击目标生成多边形掩码。
• OBB 旋转框：点击目标生成带角度的旋转框。
• 关键点 / 姿态项目不支持 SAM 辅助。

前置条件

• 管理员已经在「管理中心 - 全局设置 - SAM 模型管理」里下载并启用至少一个 SAM 模型。
• 当前处于标注批次模式。数据集模式不提供 SAM 辅助，只做人工修正。

操作步骤

1. 找到 SAM 工具按钮

   在标注工作台左侧工具栏，找到带闪烁 Sparkles（✨）图标的 SAM 工具按钮。

2. 选择一个 SAM 模型

   右键点击该按钮，在弹出的菜单里选择一个已启用的 SAM 模型。

3. 启用 SAM

   左键点击该按钮启用 SAM。启用后光标变成十字形，表示已进入 SAM 点击模式。

4. 点击目标

   在画布上点击你想标注的目标位置，系统会调用 SAM 模型生成分割结果。

5. 自动转换标注格式

   根据当前项目类型，分割结果会自动转换：

   • 检测项目：取分割掩码的外接矩形。
   • 分割项目：直接使用多边形坐标。
   • OBB 项目：取最小外接旋转矩形并计算角度。
6. 绑定类别并继续

   生成的标注会自动绑定当前选中的类别。切换类别后再点击其他目标，可以连续标注多个对象。

图1：左侧工具栏的 SAM 按钮和右键模型选择菜单

图2：点击目标后自动生成的标注

启用与关闭

• 左键点击 SAM 按钮切换开启或关闭。
• 关闭后自动恢复到当前项目的默认标注工具（检测 / 旋转框恢复矩形框，分割恢复多边形）。

点击式操作

点击式分割采用点击操作：在目标上任意位置点一下就行，不支持框选区域。想一次圈出全图同类目标，用下面的文本提示分割。

文本提示分割（SAM3）

SAM3 模型额外支持文本提示：输入一个名词短语（如 hard hat、safety vest），模型会一次性找出画面里所有同类目标，逐个生成掩码。一图多目标的场景（货架商品、安全帽、工件）比逐个点击快得多。

1. 确认选中 SAM3 模型

   在工具栏 SAM 按钮的右键菜单里选择带文本提示能力的 SAM3 模型（旧版 SAM2 不支持文本）。选中后，左侧类别列表每一行的右侧会出现 ✨ 图标。

2. 点击 ✨ 发起文本分割

   点击某个类别的 ✨，系统以「类别英文别名 > 类别名」为查询词（优先用别名），对这个类别发起全图文本分割。

3. 预览并接受结果

   画面上所有识别出的实例以虚线幽灵标注显示。逐个点击要保留的实例即转为正式标注（可再拖拽手柄微调）；按 Escape 清除全部未接受的建议。

4. 按置信度过滤（可选）

   每个实例带有模型给出的置信度，可用滑杆过滤低分结果，只保留高置信度的实例。

文本查询只认英文

SAM3 文本编码器只支持英文。中文类别名直接查询效果很差——请在数据集「类别」标签页为类别维护英文查询别名（名词短语，如 hard hat）。设置了别名的类别会优先用别名查询。

对查询词不满意时，Alt + 点击 ✨ 可以临时改写本次查询词，不影响类别里保存的别名。

结果贴当前类别

与点击式分割一致：文本分割的结果统一绑定 ✨ 所在行的类别，不会由模型猜测类别。

SAM 模型说明

平台内置四档 SAM 模型，体积越大精度越高，对显存的要求也越高。管理员可以在「管理中心 - 全局设置 - SAM 模型管理」下载和切换。

字段	类型	必填	默认值	说明
Tiny	模型	可选	—	最轻量，约 75MB，适合 2GB 以上显存，速度最快。
Small	模型	可选	—	约 88MB，平衡速度与精度，需 4GB 显存。
Base	模型	可选	—	约 155MB，高精度，需 8GB 显存。
Large	模型	可选	—	约 429MB，最高精度，需 16GB 显存。

图3：SAM 模型管理页（管理员视角，可选）

标注效率技巧

• 先用 SAM 快速生成大部分标注，再用手动工具修正个别不准确的结果。
• 每次点击生成的标注会使用当前选中的类别，标注不同类别前记得先在侧边栏切换。

未检测到目标时

如果你点击的位置 SAM 没有识别出目标，会提示「未检测到目标」。换个位置再试一次，或者直接改用手动工具标注这个目标。