# 可人工编辑的叉取面多边形

**本页的95% IoU规则已被后续用户指令替换。** 当前使用填平内部破损、覆盖全部原mask的凹包，见[最新操作说明](fork_face_enclosure.md)。严格版在3,362帧后停止并保留历史记录，不作为最新交付。

本轮从冻结的原mask重新生成两种AnyLabeling工作区；原检测数据、分割mask和旧AnyLabeling工作区保留。全量处理正在运行，最终结果以 `outputs/pallet_fork_face_anylabeling_simplified_v1/delivery_manifest.json` 为准。

## 使用方式

建议使用逐托盘联合版：解压新ZIP，在AnyLabeling打开 `pallets/images/train`；val/test同理。需要逐几何面片编辑时使用 `faces/images/<split>`。两版独立保存，修改一版不会同步另一版。

每个自动通过的组最多12个多边形、128个总顶点，单片最多24个顶点；采用AnyLabeling官方填充后与原mask比较，IoU至少95%。同组多片共同表示一个托盘或面片。IoU只衡量与原机器mask的接近程度，不是分割正确率；自动几何结果仍须人工确认。

**没有可编辑多边形的正例仍可能需要重画。** 查看JSON的 `flags.redraw_required`、`pallet_segmentation.groups`、`parents` 和 `redraw_tasks.jsonl`。`reference_masks`保留原mask；`redraw_previews/<view>/<split>`内的同名图左侧显示原mask，右侧显示简化结果，红框标记待重画身份。父框保留在元数据和预览，不作为可填充分割形状。原41个无mask正例也保留父框；逐面版可能没有组，但有未解决父托盘记录。

重画使用 `pallet_fork_face` 类别，保留JSON记录的group_id与父托盘身份。为了保留叉孔、遮挡和缺测，可用多片polygon绕开孔洞；不能只画外轮廓填实整张托盘。原263张人工确认负例才是明确的空目标，其他空JSON不能当作负例。图像已包含180°校正，保持原生尺寸，不再次旋转或缩放。

所有分割初始为 `human_reviewed=false`、`mask_human_reviewed=false`、`unreviewed=true`、`proposal_only=true`。在工作副本中修改、保存，并记录实际已检查帧；未改动不自动表示人工确认。不要把只读参考mask当作修正后的人工结果。保留原ZIP，另交修改后的工作版本。

## 方法与恢复

从mask提取新轮廓，同时支持像素中心环与有效像素单元环，避免自接触轮廓丢失细线。候选枚举小连通域删除阈值0/2/4/8、封闭小孔填补阈值0/1/4/9；跨度达到父框对应边长25%的细长结构和孔洞受保护。Shapely 2.1.2执行保拓扑Douglas–Peucker，容差0/0.25/0.5/0.75/1/1.5/2原生像素。保留孔洞经几何切分转为无孔多边形；仅安全合并相邻片段。

每个候选都按固定版本AnyLabeling的实际填充像素检验IoU、坐标、保留孔洞、细结构和不同实例重叠；按总顶点最少、多边形最少、IoU最高选择。没有合格候选的目标不载入原巨量片段，而进入待重画正例清单。连通域数量作为复杂度下界用于加速，不放宽阈值。

```bash
.venv/bin/pip install --no-deps shapely==2.1.2
.venv/bin/python -m pallet.fork_face_simplify --workers 8
```

入口支持 `--stage pilot|export|verify|package|all`、`--config`、`--source`、`--output` 和 `--before`。配置在 `configs/fork_face_simplify_v1.json`。固定seed42，每种分辨率32个目标，共160目标；试跑通过光栅核验后冻结，再开展全量。

再次使用相同参数恢复。任务绑定源码、配置、mask发布清单、旧版计数清单和依赖版本；已完成图像、JSON及参考文件变更时拒绝覆盖。旧版人工修改保持不动，简化前计数可回读旧冻结ZIP。打包前必须重新核对验收时的文件快照，避免把验收后的人工修改混入原包。最多8进程，各数值库单线程，使用spawn避免OpenCV/BLAS线程池fork死锁，磁盘保留50 GiB。

`verify`全量调用官方AnyLabeling LabelFile读取和shape_to_mask填充；试跑JSON另做官方保存检查。`package`核验全成员CRC、SHA-256及异目录解压后的读取/保存。桌面GUI没有运行。

格式与算法依据：[Shapely 2.1.2](https://shapely.readthedocs.io/en/2.1.2/reference/shapely.simplify.html)、[AnyLabeling固定提交](https://github.com/vietanhdev/anylabeling/tree/130e44d1b9afd9d54d950cccfd37ce1298ae1a32)。旧版精确无损导出仍用 `pallet.fork_face_anylabeling`，本轮未修改该模块。

## 验证记录

新增19项相关用例，连同旧导出测试共38项通过：复杂孔洞、嵌套岛、断开结构、孤立点、细线、小目标、边界、实例冲突、空正例、固定试跑、完整两版导出/读取/保存/打包/恢复、输入和配置变更拒绝、人工修改保护及验收后变更拒绝。开发期试跑独立保存，不作为最终交付。

正式运行产物包括 `summary.json`、`report_zh.md/html`、`validation.json`、逐帧/逐目标/逐组索引及待重画清单。报告同时给出全部加载形状的减少比例和自动通过组自身的减少比例，不把未加载的待重画任务当作已完成标注。
