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

# 叉取面分割掩膜：AnyLabeling人工修正

基于 `outputs/pallet_fork_face_masks_v1/delivery` 的原尺寸掩膜导出。原正式检测数据、几何掩膜、点云与划分保持不变；新目录中的多边形仍是自动建议。

<!-- fork-face-anylabeling-v1-complete-20261013 -->
## 实际交付与验收

[下载ZIP（1.74 GiB）](../outputs/pallet_fork_face_anylabeling_v1/pallet_fork_face_anylabeling_v1.zip) · [SHA-256](../outputs/pallet_fork_face_anylabeling_v1/pallet_fork_face_anylabeling_v1.zip.sha256) · [完整验收记录](../outputs/pallet_fork_face_anylabeling_v1/delivery_manifest.json)。交付时间2026-10-13T15:37:51.261763+00:00，大小1,869,348,884字节，133,137成员，CRC及逐成员SHA-256通过。

两版各覆盖10,374帧，原train/val/test=6,552/1,455/2,367。逐面片版有58,529个组、5,559,311个多边形片段；逐托盘版有12,303个非空组、2,646,395个片段。41个未解决目标保留父框与状态，263张原人工负例明确记录为空。多边形片段数不代表实际托盘或面的数量。

逐托盘版每帧片段数中位数163、最高6,675；逐面片版中位数323、最高10,612。像素级实测掩膜有较多孔洞和孤立点，原样保留会增加编辑负担，建议优先使用逐托盘版。没有自动填洞或删除小片段。

19项相关测试通过，其中新增12项。12张真实帧试跑覆盖五种网格及旋转、重建、负例与未解决状态；官方LabelFile读取/保存24份JSON的分组、形状与自定义元数据一致。全量官方shape_to_mask核对两版全部多边形，逐组掩膜与原二值掩膜完全一致。101,999份使用的源产物哈希不变，20,768份正式标签/元数据未变，原几何ZIP摘要不变。桌面GUI未在本机启动。

整包SHA-256：

```text
4edd187d154cf67f60e2d88b5493c4e3d8869d8c0834e4e7d153018dae291577
```

## 打开与修正

解压交付ZIP后，在AnyLabeling中打开 `pallets/images/train`。这是逐托盘联合掩膜，通常更便于人工检查；`val`、`test`同理。需要分别编辑几何面片时，打开 `faces/images/train`。两版各自具有PNG与同名JSON，可直接加载，不需要先导入COCO。

两版类别均为 `pallet_fork_face`，形状为polygon。逐托盘版同一托盘共用group_id；逐面片版同一面片共用group_id，JSON中 `pallet_mask_part.pallet_group_id` 指向父托盘。多个多边形属于同一组，不表示多个托盘。两版独立保存；修改一版不会同步修改另一版，交回时说明使用的版本。

为保持孔洞，复杂掩膜被拆为多个无孔多边形，并且孤立像素、细线与断开的结构均保留。不能仅保留外轮廓或做凸包合并，否则会把叉孔和缺测填成实体。未进行有损简化，部分图像包含较多片段；可按组选择、删除或调整。同一面的完整分割是该组所有多边形填充后的并集。

原人工托盘框保留在JSON的 `pallet_segmentation.parents[].bbox`；没有把这些矩形作为分割形状导入。正例无掩膜的帧保留 `unresolved_positive=true` 与具体目标身份，不能按空JSON视为负例。263张原人工负例有来源明确的 `confirmed_negative` 标记。

所有新分割初始 `human_reviewed=false`、`mask_human_reviewed=false`、`unreviewed=true`、`proposal_only=true`、`checked=false`。保存修改后的JSON，并单独记录实际已检查帧；未改动的文件不能据此自动判定已检查。类别名和分组身份尽量保留，原JSON中的源身份、父托盘和面编号等元数据也需保留。

`reference_masks`、`reference_instances`、`reference_conflicts` 是只读的原始依据。修改后应以实际JSON重建掩膜，不能继续使用未修改的参考PNG充当人工标签。`provenance`保留原框、面片参数、复核原因及格式来源。

## 导出、验证与恢复

```bash
.venv/bin/python -m pallet.fork_face_anylabeling --workers 8
```

入口支持 `--stage export|verify|package|all`、`--source`、`--output`。使用相同参数再次运行可恢复；源码、输入索引和源发布清单均由任务哈希绑定。已完成的JSON/PNG被修改时拒绝覆盖，未完成任务只复用内容完全一致的文件。需新增版本时指定新的输出目录。运行保留50 GiB磁盘空间，最多8个进程，每进程数值库单线程。

默认验证使用与AnyLabeling相同的PIL多边形填充规则。此次交付另用固定提交的官方 `shape_to_mask` 函数进行全量独立光栅验证：

```bash
.venv/bin/python -m pallet.fork_face_anylabeling --workers 8 \
  --upstream-shape-source outputs/fork_face_anylabeling_tooling/anylabeling__views__labeling__utils__shape.py \
  --upstream-sha256 77a574e131d4e6bbbd4291859317a4bc59bacb6e64111cdcd0880065472015bc
```

官方源码仅用于格式验证，不需要在服务器安装完整桌面程序。记录区分JSON读取/保存及光栅规则验证和桌面GUI测试；本机未运行AnyLabeling桌面GUI。

格式来源：[官方LabelFile](https://github.com/vietanhdev/anylabeling/blob/130e44d1b9afd9d54d950cccfd37ce1298ae1a32/anylabeling/views/labeling/label_file.py)、[官方shape_to_mask](https://github.com/vietanhdev/anylabeling/blob/130e44d1b9afd9d54d950cccfd37ce1298ae1a32/anylabeling/views/labeling/utils/shape.py)。单环polygon格式通过同组分片保留孔洞，不依赖工具未定义的减法标志或自交多边形。

最终数目与交付摘要以 `outputs/pallet_fork_face_anylabeling_v1/delivery_manifest.json` 为准。几何候选不等于已确认叉取面；参数敏感性与41个未解决目标沿用原报告，没有新增分割准确率。
