<!-- fork-face-enclosure-v2-complete-20261014 -->
最新可编辑版本采用填平内部破损的凹包，见[凹包修正说明](fork_face_enclosure.md)。本页保留原mask/精确无损版本的历史依据。

# 托盘叉取面点云与掩膜

本流程使用正式数据集的10,374帧及12,344个人工托盘框，在独立目录生成可见实体表面的点云和分割建议。多个可见面分别编号，同时提供逐托盘联合掩膜。叉孔、缺测和遮挡留空。

<!-- fork-face-masks-v1-complete-20261013 -->
## 本次实际交付（2026-10-13）

[下载完整ZIP（2.26 GiB）](../outputs/pallet_fork_face_masks_v1/pallet_fork_face_masks_v1.zip) · [中文报告](../outputs/pallet_fork_face_masks_v1/delivery/report_zh.html) · [可旋转点云图册](../outputs/pallet_fork_face_masks_v1/delivery/gallery.html) · [完整验收记录](../outputs/pallet_fork_face_masks_v1/delivery_manifest.json) · [SHA-256文件](../outputs/pallet_fork_face_masks_v1/pallet_fork_face_masks_v1.zip.sha256)。解压后打开 `README_zh.md`；图册可直接以本地文件打开。

全部10,374帧读取和处理成功，12,344个目标均有记录。12,303个目标得到候选掩膜，41个目标未得到可用掩膜；原263张人工负例保留明确空目标记录。58,529个选中结果是几何面片候选，一个真实面可能被分为多个片段，不能按该数目统计真实叉取面。选中实测点共27,670,574个，185,585个归属冲突像素单独登记且不分配给多个托盘。

256帧训练试跑覆盖224×172、352×264和640×480三种网格；176×132和240×96没有正例训练帧，配置冻结后另做原始数据对应检查，并在全量阶段处理。不得将这两种网格称为训练试跑覆盖，也未使用其验证/测试数据调整参数。118帧重建强度与300帧180°校正均保持原映射。

试跑默认距离容差±25%的570次比较中，联合掩膜平均IoU为0.6463，524次低于0.85，表明参数敏感性较高。此数值不是分割正确率。全部托盘目标仍须复核，优先查看叉孔背景、薄横梁、堆叠边界、顶面/地面混入及重叠框冲突。

35项相关回归通过。全量验证核对72,528,514条框内点记录、70,873份逐面/逐托盘掩膜和70,832条RLE；逐点映射、空洞、归属与恢复保护检查通过。原正式标签和元数据20,768个文件哈希不变。ZIP的133,173个成员CRC、逐成员SHA-256及异目录三划分读取通过，不包含原始PCD。

ZIP实际大小2,425,495,324字节，SHA-256：

```text
9ff418f7eca980feab92db0edae604121e3c62c3e2858a3776f6c527258481ff
```

交付时间为2026-10-13T21:58:44.649530+08:00；交付后本地日志与本说明的补充不改变ZIP及包内冻结源码。该任务未训练检测或分割模型。

## AnyLabeling人工修正包

[下载AnyLabeling ZIP（1.74 GiB）](../outputs/pallet_fork_face_anylabeling_v1/pallet_fork_face_anylabeling_v1.zip) · [打开、分组与修正说明](fork_face_anylabeling.md)。每帧均提供原生PNG与同名多边形JSON；逐托盘联合版与逐面片版独立保存。建议从 `pallets/images/train` 开始。通过同组多边形分片保持叉孔与缺测，官方填充规则的全量逐像素校验已通过。原几何交付包保持不变。

## 入口与恢复

```bash
.venv/bin/python -m pallet.fork_face_masks \
  --config configs/fork_face_masks_v1.json --workers 8
```

依次执行 `audit → pilot → extract → export → verify → package`。先完成256帧训练集分层试跑，绑定默认配置后处理全量。

中断后使用相同输入、源码与配置，并添加 `--resume`。可用 `--stage` 单独继续当前阶段；全量提取支持 `--shards N --shard-index K`。未完成或失败的帧重新尝试，新尝试保留旧失败记录。已完成结果发生修改时拒绝覆盖，应建立新的人工修正版本。

```bash
.venv/bin/python -m pallet.fork_face_masks --stage extract --resume \
  --config configs/fork_face_masks_v1.json --workers 8
.venv/bin/python -m pallet.fork_face_masks --stage export --resume \
  --config configs/fork_face_masks_v1.json
.venv/bin/python -m pallet.fork_face_masks --stage verify --resume \
  --config configs/fork_face_masks_v1.json
.venv/bin/python -m pallet.fork_face_masks --stage package --resume \
  --config configs/fork_face_masks_v1.json
```

源码或几何配置改变时必须选择新的 `--output` 版本。已交付ZIP保持不变。

## 文件说明

输出根目录：`outputs/pallet_fork_face_masks_v1`；便携产物位于其 `delivery/`。

| 文件 | 含义 |
|---|---|
| `run_manifest.json`、`configuration_freeze.json` | 输入、源码、配置、标签与试跑选择哈希 |
| `extraction/{split}/{frame}/attempt_NNNN` | 完整点云、掩膜、叠图和处理记录；尝试历史保留 |
| `delivery/masks/faces` | 原尺寸逐面二值掩膜 |
| `delivery/masks/pallets` | 原尺寸逐托盘联合掩膜 |
| `delivery/instances` | uint16面编号图，0为无选中面 |
| `delivery/conflicts` | 未解决归属冲突像素，0/255 |
| `delivery/clouds` | 未降采样的框内有效点NPZ，包括诊断点 |
| `delivery/annotations/faces_*.json` | 逐面COCO RLE，保留空洞 |
| `delivery/annotations/pallets_*.json` | 逐托盘联合掩膜COCO RLE |
| `delivery/targets.jsonl`、`faces.jsonl` | 父框、面编号、平面参数、单位和复核原因 |
| `delivery/gallery.html` | 离线图册，筛选原划分/配置域，查看强度图、叠图和可旋转点云 |
| `delivery/report_zh.html`、`report_zh.md` | 实际处理统计、参数敏感性及局限 |
| `validation.json`、`delivery_manifest.json` | 全量配对、逐点映射、RLE及ZIP验证 |

NPZ字段：`xyz_raw[N,3]`、`intensity[N]`、`uv[N,2]`、`source_point_index[N]`、`parent_box_index[N]`、`face_id[N]`、`diagnostic_plane_id[N]`。`uv`是原图整数u/v索引；`face_id>0`对应本帧的面编号，0未选中，-1归属冲突。相同点可在重叠框的ROI记录里重复，但最终选中像素只有一个归属。

XYZ保留原坐标和单位。`plane_raw`可直接用于原始XYZ；`plane`使用该面记录的`geometry_units`。已知与推断的尺度均有明确来源，未知单位仅采用相对点间距，不假定米或毫米。图册的点云采样仅供显示，完整点云以NPZ为准。

## 标注资格与局限

原始检测框仍为人工标注；新掩膜统一为 `proposal_only=true`、`mask_human_reviewed=false`。正例的分割训练资格为false，需人工复核后另建冻结快照。原263张人工负例保留明确空目标记录；正例无掩膜不得冒充负例。

平面性不等于可叉取性。可能的顶面/地面及后层背景有诊断记录；图像方向判别不等于已标定重力方向。非平面、薄结构、边缘噪声和斜视可能造成漏提取。全部托盘目标进入掩膜复核清单，不报告没有人工掩膜参考支撑的分割准确率。

参考：[PCL区域生长](https://pointclouds.org/documentation/tutorials/region_growing_segmentation.html)、[PCL平面拟合](https://pointclouds.org/documentation/tutorials/planar_segmentation.html)。原始点云不复制；运行期间保留至少50 GiB可用空间。
