# 模型路线执行记录：授权、冻结与本轮补样隔离

用户已在调研后明确授权执行训练计划，并要求训练等待期间补充少样本类别的人工复核任务。
调研文档 `docs/pallet_mask_model_research.md` 中“未启动/需授权”的文字是调研时的状态，不是本次执行状态。

## 执行边界

- 首轮落实M1（ROI分割＋边界辅助）与M2（RF-DETR-Seg Small）两个研究对照。
- 输入只允许图像与原框推导的ROI；人工轮廓仅作监督。位姿GT、标尺、选面、目标ID、采集组ID不作模型特征。
- 仅在正式train内部研究资格审核后的子集训练/开发验证；不把470份val或356份test来源回流train。
- 审计全局同组/同帧/同图像/同PCD和跨类别近重复风险，再冻结内部开发划分。Class14歧义长短面等未解决的样本暂不纳入。
- 新实验的研究监督授权独立记录，不改旧人工载荷里的GT、自动训练、确认或机器人资格字段。
- 从通用预训练开始，不使用与当前val/test有重叠的旧托盘微调权重。
- 优先使用两张非3090卡，按UUID绑定；检查点、设置、数据来源哈希和内部验证模型选择记录可追溯。
- 当前内部验证属于开发而不是新的盲测。冻结模型与后处理后才按原协议考虑val/test复测，不根据已看test重新选模。
- 没有可用的统一语义关键点映射时，不把4–16点原多边形强制补成固定K；关键点分支仍以完成语义映射为前置条件。

## 与新复核批次的并行关系

新批次见 `docs/pallet_mask_under50_pilot.md`。
真实人工轮廓少于50份的类别有11/12/16/17/19/20；本批检查18张备选，仅向人工交付质量可检查的10张草稿，Class12暂缓。
新批次使用独立服务/任务配置，旧第15版图库和第三批26张历史入口保持。

这10张是助手预标注，不是模型生成结果，不计人工完成、不作为传播种子，也不接入正在训练的数据。
以后发生真实人工保存，也只能由下一版冻结与审计决定是否采用，不能在本轮训练过程中动态追加。
训练结果尚未验收前，不把预测批量代替这些任务或自动提升任何源的GT/机器人资格。

## 状态权威来源

本轮训练的数据、启动、GPU绑定、日志和完成回执记录在新的 `outputs/pallet_mask_model_training_v1/` 研究目录；
若资格或运行检查失败，应保留失败目录与原因，再创建新版本，不删除旧证据或把失败记作完成。
最终训练轮数、候选质量和是否达到试运行目标以实际运行回执及原生像素评价为准，不能用单元测试或训练损失代替。

## 首轮实际完成结果

两条路线均已完成，不再处于“等待启动”状态。旧API首次失败输出保留，M2实际完成路线为`m2_retry1`。

| 方法 | 轮数 | 冻结内部dev IoU中位数 | HD95中位（原生像素） | 1px边界F1中位 |
|---|---:|---:|---:|---:|
| M1 ROI mask＋边界头 | 50 | 0.9012 | 2.106 | 0.8680 |
| M2 RF-DETR-Seg Small | 58 | 0.8227 | 3.000 | 0.5148 |

M1最佳第35轮，已完成CPU重新加载与原生指标复算。M1/M2分别使用指定16GB/24GB非3090卡。
冻结数据229份：内部train 138份/16分量，dev 91份/5分量；开发集组数很少，类分布不完整，
不能外推22类整体泛化，也不能与658目标的旧传播交付结果直接当作相同分母的排名。
正式val/test未导出监督标签、未预测、未用于本轮选模。

两个模型均未达到质量门槛，当前按其质量过滤协议交付0份；没有将其预测替换人工初稿或生产标签。
关键点语义映射仍未完成，不为执行计划而强行将原多边形补成固定K，也未自动启动伪标签自训练。
下一阶段应重点研究高分辨率边缘、薄梁/脚底、实际观察面语义与少组验证不确定性，不用降低门槛制造成功。

### 训练期间真实人工修订

本轮用户继续保存了旧v3图像的新修订，随后真实完成新10张。
历史早期事务观察4/10完成与最终10/10完成分别保留，不把早期回执改写成最终状态。
当前继续采样证据见 `outputs/pallet_mask_continuation_sources_v2/audit.json`：
1,494份真实研究轮廓、图库1,012份当前记录/1,115条事件；最初1,088条事件原字节前缀保留。
其中17条事件是14个旧v3目标的后续修订，另10条是新10张的真实保存；修订数不能冒充新增图像数。

旧v3修订影响了本轮冻结train中的2份、dev中的1份来源。**上述模型指标仅对冻结旧版本研究标签计算，
不是对当前最新人工修订或独立GT的准确率**。冻结数据/模型不动态更换、不插入新10张，不自动重训。
另立v2审计记录并逐项报告变更，不能将合法人工修订误报为“旧current字节一直未变”。
模型最终回执：`outputs/pallet_mask_model_training_history_v2_m2/TRAINING_FINAL_HANDOFF.json`。
