# 同类等顶点掩膜补充

入口：`.venv/bin/python -m pallet.mask_template_transfer`。默认写入新的
`outputs/pallet_mask_template_preview_v3/`，已有目录拒绝覆盖。
首批预览经用户确认后，批量扫描已完成；结果以独立候选层接入在线页面，不自动覆盖人工记录。

## 批量结果与在线使用

### 在线修改功能

图册现已支持原图坐标编辑：每张图点击 **修改掩膜 / 在线复核**，使用原位姿标注访问码登录。
可拖动顶点、点击边增点、删点、缩放平移、撤销重做、保存修订和恢复历史；保存失败不跳转，
本机草稿保留。修改写入独立掩膜复核库，既有位姿、选面与机器建议不覆盖，不自动确认为GT。
详见 [图册在线掩膜修改](pallet_mask_gallery_editor.md)。

### 修正通过后的续批（当前版本3）

用户确认“修正通过，继续生成”后，新生成5份候选，累计56份：Class 1新增2份、
Class 10新增2份、Class 15新增1份。最终文件在 `outputs/pallet_mask_template_bulk_v5/`；
v4为保留的中间生成目录，不发布，不覆盖。

入口：`.venv/bin/python -m pallet.mask_template_continue --output outputs/<新的目录>`。
本轮保留原51份候选逐字节不变，排除已撤下风险样本、人工改掩膜及删除目标。
使用原52份人工编辑模板及1份用户已通过修正的辅助模板，遍历全部兼容模板，
而不是只试前三个；**未放宽**原图像对应、顶点跟踪和局部横梁边界检查。
2份新增来自修正版辅助模板，另3份来自排序第4的原人工模板。

辅助模板不是新的人工数据库修订，也不自动升级为GT。它的配置在
`configs/pallet_mask_auxiliary_seeds_v1.json`，绑定原修正文件/多边形哈希。
最多一跳，不将本轮生成结果再当模板递归传播；同类、同划分、同源配置及观察面保护不变。
后端同时核对辅助模板源目标、上游人工模板和待补目标的修订；任何依赖变化会隐藏旧建议。
采用建议仍须明确操作，只保存未确认草稿，来源完整保存在 `mask_proposal_provenance`。

最新公网图册：<https://lesson-leslie-criteria-result.trycloudflare.com/?revision=3#new-batch>。
默认勾选“只看本轮新增”，显示5份；取消后可看累计56份，类别筛选可组合使用。
页面用“辅助修正版（用户已通过，非人工GT修订）”区别原人工模板，不虚构人工修订号。
下载 `mask_template_bulk.zip` 包含累计56份，`new_proposals.jsonl` 单独提供新增5份。
验收记录：`outputs/pallet_mask_continuation_validation_v1/`；137项回归、全部新增配准复算、
原记录/旧交付保护和离线/公网桌面手机检查。

### 第2顶点边界修订（历史版本2）

用户指出 `2023_9_26/26-09-2023_02-02-35#yellow/405mm/1700mm` 的第2顶点偏右下，
1→2边切入横梁。现已另存 `outputs/pallet_mask_template_bulk_v3/` 并发布为建议版本2：

- 只调整该目标第2顶点：原图边坐标 `(261.31148, 191.01649)` → `(259.98245, 186.64089)`；
  顶点数仍为8，其余7个坐标及编号不变。位置来自原图横梁上缘与右缘的局部稳健交点拟合，
  不是把点无条件移回原框。新增包含216个亮实测图像像素（不是三维点数或精度指标）。
- 新增 `pallet/mask_boundary_review.py`：检查上边缘内漂、局部梁厚塌缩、上缘排除亮材料。
  原问题候选触发检查，修正后通过；所有52份旧候选均重查，同模板3份均单独核验。
- 同模板目标 `2023_9_26/26-09-2023_02-19-47#yellow/405mm/2100mm`
  （`bf59aa3d7d604db6fe49debd`）存在较轻局部风险，撤下机器建议待人工复核，未自动改点。
  其余50份候选记录逐字节保留。当时在线/图册提供51份（1修正＋50不变），并非减少原始目标。
- `boundary_audits.jsonl`、`review_required.jsonl` 保留检查及撤下理由；原版图册、ZIP、人工SQLite不覆盖。
  已人工采用/编辑的旧建议不会自动改写；新版本仍为待复核机器草稿，不自动确认。
- 后续批量生成器也应用新版局部检查；默认输出目录为新的v4，不覆盖本版或历史交付。

修正对照：<https://lesson-leslie-criteria-result.trycloudflare.com/?revision=2#boundary-correction>。
图册根地址保持不变，新增版本查询参数避免缓存旧轮廓。
图库内容配置 `configs/active_mask_gallery.json`；建议配置
`configs/active_mask_template_proposals.json`。仅重载图库子进程，保留公网隧道及标注服务。
验收记录在 `outputs/pallet_mask_boundary_validation_v1/`。

### 首次批量结果（历史）

批量入口：`.venv/bin/python -m pallet.mask_template_bulk`。
最终交付在 `outputs/pallet_mask_template_bulk_v2/`（v1为保留的中间生成版本）。
使用用户已确认的52个人工模板及完全相同的配准门槛；新增人工编辑不自动成为模板。
扫描1,194个兼容目标，52份通过（Class 1/2/9/10/15各8/5/8/5/26份），
包含首批14份，即新增38份。357个图像相似度不足、785个配准不可靠，不强行生成。
另10,903个未改掩膜目标暂无同类、同划分、同配置且观察面不冲突的模板。

页面版本 `width-aligned-v14-mask-proposals`（边界修订使用同一前端，只更新候选侧车）：

1. 刷新页面，状态选择 **同类掩膜建议**，点击“筛选”。
2. 原记录仍为蓝色轮廓，候选为橙色虚线。点击 **采用掩膜建议** 并确认后才改变当前草稿。
3. 采用前备份本机状态并建立撤销点；旧人工记录保留在修订历史，点云按新掩膜重新提取。
   不将旧面ID/索引或模板位姿套入新点云；旧标尺不静默当成新掩膜的有效位姿。
4. 采用仅保存待复核草稿，不勾选掩膜/位姿确认，也不获得机器人或训练资格。
   保存失败仍停留当前目标，保留本机草稿，支持重试。
5. 发布后若目标或模板出现任何新修订，旧建议自动隐藏；删除/搁置/已确认目标不展示。

配置 `configs/active_mask_template_proposals.json` 绑定候选哈希、正式manifest及独立验证结果。
发布本身不写人工SQLite，不改变已保存数、已完成数、分母12,344或“跳转到最新”。
正常人工采用/保存后按原统计规则计数，来源保存在 `mask_proposal_provenance`；后续编辑继续保留来源。
回退只需停用该侧车配置；不以旧SQLite回滚用户已采用或后续编辑的记录。

下载：`mask_template_bulk.zip`，含HTML图册、原分辨率图像、PNG掩膜、LabelMe及追溯JSON。
独立验证：`scripts/verify_mask_template_bulk.py`；逐条重算52份配准，核对12,344条处理结果、
全部20,768个受保护文件及历史事件，验证ZIP与桌面/手机离线图册。

### 公网图册

当前地址：<https://lesson-leslie-criteria-result.trycloudflare.com/>（无需访问码）。
权威状态：`outputs/pallet_mask_gallery_managed_v1/public_access.json`。
该地址为临时Quick Tunnel；隧道重建后可能变化，不保证永久有效。

独立图库服务仅监听 `127.0.0.1:3393`，不重启或共用3389/3390标注服务。
采用文件白名单，只公开当前图册HTML、字体、对照图、原图、PNG掩膜及逐目标LabelMe；
当前续批版为56组及1张修正前后对照图。
没有目录列表或数据库下载；SQLite快照及访问码不对外提供。新增在线编辑API需登录，
人工复核历史和导出也受权限保护；匿名用户仍只能浏览机器图册。
原交付目录不复制改写，资源变化时拒绝继续按旧发布版本提供文件。

运维：`.venv/bin/python scripts/serve_mask_gallery.py start|status|stop`。
守护器可重启图库/隧道子进程，尚未配置机器重启后自动启动。
验证：`.venv/bin/python scripts/verify_mask_gallery_public.py`（已存在的验收文件拒绝覆盖）。

## 来源与范围

- SQLite以只读连接做一致性备份；以快照的当前有效多边形及完整事件历史筛选模板。
- 原人工模板须大于4个顶点，存在相同多边形的人工保存事件；自动单位/轴向修订不算人工修改。
  续批另有且仅有1份用户明确通过的修正版辅助模板，单独标来源、限一跳，不冒充人工GT。
- Class编号使用最终22类归类，保留原类别、离群后归类状态及复核标记。
- 默认只匹配同Class、同正式划分、同源传感器配置且已知观察面不冲突的目标。
  不使用val/test模板向train传递标注，不改变任何原划分，不启动模型训练。
- 所有有过掩膜修改历史的目标均保护，包括仍是4顶点、后来恢复成原矩形的情况；
  删除、搁置及已确认的目标不补写。

## 图像适配

原生图像按原框归一化用于候选排序，随后使用仿射ECC图像配准及逐顶点双向LK跟踪。
保留模板顶点数及顺序，不用增加共线点凑数，不直接复制矩形归一化坐标。
逐顶点不可靠、图像对应不足、形变过大、越界、自交或面积不稳定时拒绝输出。
图像相关度是筛选指标，不代表掩膜正确率；遮挡、结构不同等仍需人工判断。

这些人工模板的实际轮廓包含叉取面开口凹槽。新草稿标记为
`inherited_human_fork_face_contour_with_aperture_notches`，不冒用旧记录中
`coarse_outer_region_including_internal_apertures` 的通用语义。
此阶段不修正模板自身语义或臆造隐藏边界。

## 交付与保护

- `report_zh.html`：可筛选类别的模板/候选对照图册。
- `proposals.jsonl`：候选顶点、模板人工修订、源图身份、目标预期修订及快照哈希。
- `labelme/`、`masks/`、`images/`：逐目标的LabelMe、原分辨率掩膜及图像。
  一份文件只表达当前目标，同图其他对象不隐式删除，也不作为负例。
- `template_inventory.json`：全22类覆盖及逐目标保护状态。
- `registration_attempts.jsonl`：配准尝试及拒绝原因。
- `verification.json`：顶点、原图、掩膜、LabelMe、ZIP及桌面/手机HTML检查。
- `mask_template_preview.zip`：可离线复核的首批包，不含整个SQLite库。

候选一律待复核，`human_mask_confirmed=false`、`automatic_training_eligible=false`、
`robot_command_eligible=false`。不复制模板位姿、选面或点索引，不更改正式标签、在线记录、
缓存或历史交付包。未来应用须再检查目标和模板是否在快照后变化；若改变现有掩膜，
其点云几何必须重建，不能将旧选面索引直接套在新区域上。
