# 叉取面凹包多边形人工修正

本版按最新确认规则生成：保留外轮廓凹陷，覆盖原mask全部像素，填平内部孔洞和破损，不以IoU筛选。每个非空托盘/面片组提供一个最多24顶点的闭合多边形。

输出目录为 `outputs/pallet_fork_face_anylabeling_enclosure_v2`。全量导出、官方格式验证及交付ZIP验收已完成；详情见该目录的 `delivery_manifest.json`。此前95% IoU严格版在3,362帧后按用户新规则停用，历史记录保留，不作为此次交付。

## 打开与修正

解压新ZIP后，在AnyLabeling打开 `pallets/images/train`，这是推荐的逐托盘联合版；val/test同理。逐面版使用 `faces/images/<split>`。两版独立保存，修改不自动同步。PNG保持原生尺寸，已包含原180°校正，不需要再次旋转或缩放。

类别为 `pallet_fork_face`，形状为polygon。逐托盘版同一托盘一个group_id；逐面版一个几何面片一个group_id，JSON保留父托盘与面ID。断开的原mask区域包入同一实例的凹包，不跨实例合并。

`reference_masks`保留原几何mask。`previews/<view>/<split>`前后对比左侧为原mask证据，右侧为可编辑凹包。包围区域会新增像素，原孔洞不再扣除；新增区域不是新测得的点云证据，不能再要求与原实测点逐像素对应。所有分割仍须人工检查叉取面身份与外边界。

逐面版在内部孔洞填平后可能与其他面片重叠；逐托盘版相邻实例也可能出现闭包重叠。JSON的 `flags.enclosure_overlap`、各组 `overlap_pixels` 和 `enclosure_overlaps`原尺寸重叠图记录实际情况，人工检查后裁定；不会通过删除原mask像素强行去重。

原263张人工确认负例保持空目标身份。41个原无mask正例没有可包围的像素，保留父框、原目标ID及 `original_unresolved` 状态，另列 `unresolved_targets.jsonl`；不能把空JSON视为负例。父框仅在元数据和预览中保留，未作为分割矩形加载。

全部新标注初始为 `human_reviewed=false`、`mask_human_reviewed=false`、`unreviewed=true`、`proposal_only=true`。在副本修正、保存，并记录实际已检查状态。保留冻结ZIP，交回独立修正版本；恢复和打包会保护人工修改。

## 算法与执行

以填平封闭孔洞后的原mask像素为输入，使用Shapely 2.1.2无孔凹包、保拓扑轮廓简化和向外补偿生成候选；限制在原图合法坐标。按AnyLabeling固定官方填充函数在**最终原生坐标**下验证覆盖全部原像素及原封闭孔洞，每组一片、最多24顶点。合格候选按填充面积、几何面积、顶点数排序，选择包围面积最小者；这里的最小指固定候选与顶点上限内的最小，不宣称任意多边形的全局最优。退化单点/线也有非零面积的可编辑闭包。

```bash
.venv/bin/python -m pallet.fork_face_simplify --cover-mask --workers 8
# 等价入口
.venv/bin/python -m pallet.fork_face_enclosure --workers 8
```

配置：`configs/fork_face_enclosure_v2.json`。支持 `--stage pilot|export|verify|package|all`、`--source`、`--output`、`--before`、`--config`。固定seed42，每种分辨率32个目标、共160目标试跑；验证后冻结配置，再全量处理。

任务绑定源mask清单、索引、源码、配置与依赖版本。再次使用相同参数可恢复；已完成文件或人工修改不覆盖。最多8个进程、数值库单线程，使用spawn避免线程池fork死锁，磁盘保留50 GiB。原检测标签、原mask和旧AnyLabeling工作区不改变。

AnyLabeling普通多边形为单环。本版直接提供闭合凹包，不再用巨量片段表达内部孔洞。`verify`用官方LabelFile全量读取、官方shape_to_mask还原、检查100%覆盖率、孔洞填平、坐标、实例身份和重叠记录；试跑文件另做官方保存测试。打包前重新核对已验收文件，ZIP执行CRC与逐文件SHA-256，并在异目录测试读取/保存。本机未运行桌面GUI。

算法来源：[Shapely 2.1.2凹包](https://shapely.readthedocs.io/en/2.1.2/reference/shapely.concave_hull.html)、[AnyLabeling官方格式](https://github.com/vietanhdev/anylabeling/tree/130e44d1b9afd9d54d950cccfd37ce1298ae1a32)。IoU保留为面积变化描述值，没有通过阈值，也不是分割准确率。


<!-- fork-face-enclosure-v2-complete-20261014 -->
## 全量结果与下载

交付[2.93 GiB ZIP](../outputs/pallet_fork_face_anylabeling_enclosure_v2/pallet_fork_face_anylabeling_enclosure_v2.zip)、[前后对比报告](../outputs/pallet_fork_face_anylabeling_enclosure_v2/delivery/report_zh.html)、[验收记录](../outputs/pallet_fork_face_anylabeling_enclosure_v2/delivery_manifest.json)及[SHA-256](../outputs/pallet_fork_face_anylabeling_enclosure_v2/pallet_fork_face_anylabeling_enclosure_v2.zip.sha256)。两版各10,374帧原生PNG及同名JSON；12,344个父托盘均有处理记录。

| 版本 | 多边形片段 | 顶点 | 最大顶点/片 | 原mask覆盖率 |
|---|---:|---:|---:|---:|
| 逐托盘 | 2,646,395→12,303 | 14,226,776→264,839 | 24 | 100% |
| 逐面片 | 5,559,311→58,529 | 25,557,641→1,265,265 | 24 | 100% |

逐托盘片段减少99.54%、顶点减少98.14%；逐面片减少98.95%/95.05%。原mask像素删除0，内部封闭孔洞全填平。263张原负例和41个无mask正例身份保留。逐托盘有475帧/1,698组闭包重叠，逐面片有9,717帧/57,465组，均有原尺寸重叠图与JSON标志。

75项相关测试通过（新凹包16项、严格简化/旧导出38项、原几何21项）。全量20,748份JSON经官方LabelFile读取并还原；320份试跑JSON官方保存保持元数据。63份异目录解压文件读取/保存通过；桌面GUI未运行。20,768份原正式标签/元数据哈希未变。

ZIP 3,151,173,388字节、164,224成员，完整CRC及逐成员SHA-256通过；打包前重新核对已验收文件。摘要：

```text
afb16adc411e8c2764dc0ee5e8e20fee93c42f1000d78dc378553bcf426de531
```

完成时间：2026-10-14T02:36:13.979885+08:00。所有新分割仍为未人工复核建议；没有分割准确率或正式模型测试结论。
