# Segmentation Runbook

状态：给 segmentation / SAM3 / CVAT 同事使用  
范围：PRD 相关全部历史 case 的分割交接索引  
入口：`segmentation_handoff.html` / `segmentation_manifest.json`

## 先看什么

1. 打开 `segmentation_handoff.html`。
2. 优先处理 `P0`。
3. 再处理 `P1`。
4. `hold`、`blocked`、`locked`、`display_only` 不要直接标。

## Priority 解释

| Priority | 含义 | 处理 |
|---|---|---|
| `P0` | 已明确进入 segmentation / boundary refinement 的当前队列 | 可以跑 SAM3/CVAT/manual refinement |
| `P1` | 有候选图，但 mask 未完成或 draft mask 不可靠 | 可跑，但必须返回 review JSON |
| `P2` | draft truth 存在，但不是当前优先队列 | 先不批量跑，除非用户指定 |
| `gate_first` | 先过 visual/source-preservation gate | gate 通过前不标 |
| `hold` | display/demo 或训练门未过 | 不标 |
| `locked` | 已 training-ready 或 hard negative empty mask | 不重标，除非做审计 |
| `blocked` | rejected / no visible target / source drift | 不标 |

## 当前最重要的队列

1. `handoff/road_debris_sam3_cvat_handoff_2026-05-24/`
   - 8 个 road-debris P0 case。
   - 已有 images、draft masks、draft JSON、QA overlays、return spec。
   - 目标是边界修正，不是重新判定生成质量。

2. `data/v0_packages/uav_disabled_vehicle_0001` 到 `0004`
   - 需要车辆边界 cleanup。
   - draft mask 只能当 reference。

3. `data/v0_packages/uav_pedestrian_intrusion_0004` 到 `0008`
   - 有 SAM3 target hint / bbox。
   - 需要生成 image-aligned pedestrian mask。

## 不要标的内容

- `slope_retaining_wall_display_evidence_2026-05-25` 的 display-only 图片。
- `slope_retaining_wall_colleague_run_pack_2026-05-25/cases/*` 的 display images。
- `bridge_pier_image2_mask_first_2026-05-22` 的 display candidates，除非另有训练 gate。
- `slope_rockfall_regen_v2_2026-05-24` 的 v2/v3 failed source-preserving attempts。
- rejected / no visible event / source drift case。

## 返回原则

每个 segmentation case 必须返回：

- final reviewed mask；
- review JSON；
- 是否可进入 final JSON / YOLO / QA 的结论；
- 若失败，写清楚失败原因，不要用空白结果冒充完成。

详细格式见 `SEGMENTATION_RETURN_SPEC.md`。