# 预标注类别关键点数量纠正

> 后续用户已明确授权采用每类主要点数（众数）作为标准。当前执行与统计见 [22类主要点数与重生成关键点草稿](pallet_mask_class_keypoints_v1.md)。本文件保留暂停时历史依据；“尚需用户确认”不再是当前阻塞。

## 最新要求与当前状态

用户要求：**预标注关键点数量必须与所属类别的关键点数量相同**。

此前v1把分割模型的密集像素边界顶点作为可编辑关键点，未执行类别点数约束。这是交付错误；588份旧草稿均不符合对应类别现有人工记录中的点数范围，不能继续作为合规预标注交付。

- 新的暂停控制：`outputs/pallet_mask_model_managed_v1/keypoint_alignment_pause.json`。
- 暂停页与原网址相同；只重新加载本轮模型应用，不停止原隧道、旧图库或其它标注服务。
- 未删除、覆盖或重算原模型预测、588份冻结草稿、模型、1,559份旧人工来源、数据库及历史回执。
- 停用旧草稿读取/机器掩膜与LabelMe下载/新保存；原图、鉴权、已有人工历史导出仍保留。失败保存沿用503提示，不跳转、不清除本机草稿。
- 不把历史`FINAL_HANDOFF.json`原地改写为成功修复；本轮纠正状态另立版本。
- 本轮暂停审计时，本批真实人工保存0张、事件0条。

## 尚需用户确认的类别标准

现有配置中没有已确认的22类统一关键点数量表，人工记录中14类存在多种点数。这里是**当前真实来源的观测分布**，不是新的类别标准，也不按多数票覆盖历史。

| 类别 | 已有人工点数（点数×份数） |
|---|---|
| 1 | 8×78 |
| 2 | 12×76，16×1 |
| 3 | 8×98，12×2 |
| 4 | 4×52 |
| 5 | 4×55，16×1 |
| 6 | 8×100 |
| 7 | 4×55 |
| 8 | 8×100 |
| 9 | 4×2，12×31，16×35 |
| 10 | 8×66，9×1，10×1，12×23，14×1，16×3 |
| 11 | 8×1，10×49 |
| 12 | 4×34，8×1，12×15 |
| 13 | 8×100 |
| 14 | 4×71，8×3 |
| 15 | 12×8，16×87 |
| 16 | 8×2，10×47，12×1 |
| 17 | 8×49，12×1 |
| 18 | 8×52 |
| 19 | 4×1，8×48，12×1 |
| 20 | 4×6，8×44 |
| 21 | 12×54，16×3 |
| 22 | 4×100 |

请用户指定每类已确认的标准模板，或给出22类的标准点数表；模板还应明确角点对应关系、起点和顺序。数量一致但角点不对应的结果也不能作为合规预标注。

## 新版本发布门禁

1. 每类的点数及其标准模板来源显式冻结，歧义未解决的类别不得自动发布。
2. 以模型结果和原图生成与模板相同物理角点的轮廓，不等距重采样、不补共线点、不随意删掉梁脚/凹口来凑K。
3. 模型观察面/结构与标准不兼容时暂缓，不为补足数量强行套形。已满100张的类别不重新派图。
4. 每份机器导出、预览与API校验均核对`实际点数 == 该类标准点数`，并保留原始模型掩膜和转换诊断。
5. 原人工历史不回写；已保存目标不重开。新版本只替换本轮尚未保存、已获用户要求纠正的机器草稿。
6. 校验数量不是准确率证明，也不自动获得GT、训练、传播种子或机器人资格；不重新训练模型。

只读审计：`outputs/pallet_mask_model_keypoint_alignment_v1/class_count_audit.json`。
暂停与原编辑器回归：`outputs/pallet_mask_model_keypoint_alignment_v1/regressions.xml`（62项通过）。
