Pose 关键点标注
这个功能解决什么问题
姿态估计任务不仅要圈出目标位置，还要标出目标身上的若干个关键点，比如人体的肩、肘、腕、膝、踝。VortLab 标注工作台为关键点（pose）项目采用「先画框、再按顺序放点」的 bbox-first 模式：先拖一个边界框圈住整个目标，然后按类别定义的顺序逐个放置关键点。
本页带你完成一个 pose 标注从画框、放点到设置可见性的完整流程。
适用范围
- 项目任务类型：关键点 / 姿态估计（keypoints / pose）
- 典型场景：人体 17 点、手部 21 点、人脸 68 点等关键点检测
工作流程
Pose 标注分两步走：第一步画边界框，第二步按顺序放关键点。系统会在第二步自动跟踪放置进度，并在顶部工具栏实时显示当前点的名称、序号和点位图。
确认关键点工具已激活
进入工作台后，左侧工具栏的 CircleDot（圆点）图标默认高亮，也就是关键点工具。如果不是，点一下激活。
选择类别
在类别选择器里挑一个当前要标的类，比如「person」。每个类别的关键点定义（数量、名称、顺序）由数据集 schema 决定。
第一步 绘制边界框
在画布上按住鼠标拖拽，画一个矩形框圈住整个目标。框要包住目标的全部关键点范围，比如整个人体。
自动进入关键点放置阶段
松开鼠标后，系统自动进入关键点放置阶段。顶部工具栏出现放置进度，显示当前要放的点名称、序号和一张 SVG 点位图，帮你认清当前进度。
第二步 放置关键点
按类别定义的顺序，依次点击每个关键点在图片上的位置。支持两种放置模式，详见下方说明。
放完所有点后自动完成
所有关键点都放置（或跳过）后，标注自动完成，进入可编辑状态。
两种放置模式
第二步放置关键点时，有逐点放置和一键放置两种模式：
- 逐点放置（默认）：按类别定义的顺序，依次点击每个关键点的位置。每点一次前进到下一个点，顶部进度条同步更新。
- 一键放置：在顶部选择一个骨架模板，点击「一键放置」，系统会按模板预设的比例把所有关键点批量放在边界框内，再逐个微调即可。适合标准姿态（如人体 17 点）的快速起手。
对于标准姿态（如人体 17 点），用一键放置能省掉逐个点击的功夫。选好对应模板后，所有关键点会按预设比例落在边界框内，你只要逐个微调位置就行。
关键点可见性
每个关键点都有三种可见状态，用数字表示。这是 pose 标注区别于其他任务的重要概念：
2= 可见：目标上的这个点在画面里清楚可见，正常标注。1= 遮挡：目标上确实存在这个点，但被其他物体挡住了。0= 未标注 / 跳过：没标这个点，或主动跳过。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
V | 快捷键 | 可选 | — | 循环切换选中关键点的可见性，顺序为 2 → 1 → 0 → 2。 |
S 或 0 | 快捷键 | 可选 | — | 放置过程中跳过当前关键点（设为 0），前进到下一个。 |
编辑关键点
标注完成后，关键点进入可编辑状态：
- 移动关键点：按住任意一个关键点拖拽，可调整它的位置。
- 修改可见性：选中关键点后按 V 键循环切换可见性（2 → 1 → 0 → 2），也可以在左侧关键点列表点对应点的
v按钮切换。 - 取消放置：放置过程中按 Esc 键取消当前放置，已放置的不会受影响。
保存校验
保存时系统会逐条校验标注，任一规则不通过就整体拒绝保存，必须改到全部通过：
- 边界框必须有效，宽和高都要大于 0。
- 关键点数量必须与类别定义完全一致，多一个少一个都不行。
- 每个关键点的可见性必须是 0、1 或 2 中的一个。
- 关键点坐标必须落在图片范围内。
放置进度可视化
放置阶段顶部工具栏提供一套实时进度提示，方便你认清当前进度：
- 顶部工具栏在放置阶段显示进度条，包含当前点名称、序号和 SVG 点位图。
- 点位图用不同颜色区分已放置、已跳过、当前和未放置的关键点，一眼看清还剩几个点要标。
接下来
通用操作（选类别、删除标注、撤销重做、画布缩放平移）与检测标注一致，整体布局可参考标注工作台总览，完整快捷键见快捷键大全。