# 2200人工目标的面型类别校正候选与人工复核

## 本轮范围与规则

用户授权修正同类面型分散在多个Class、及没有任何Class主导的新面型；明确选择：仅2200份人工目标、旧Class内部严格过半、最新人工实际点数硬分组。本轮不向其余10144个正式目标传播。

不同实际人工K绝不合类；相同K仍结合归一化轮廓、转角顺序、宽高比例和原图梯度结构判断候选，不能只按点数合并。不删改冗余点，不将旧Class的初始标准K当作实际K。

“多数”分母是迁移前整个旧Class的去重面观测，而不是先按K过滤后的子集。相同图像字节且原框IoU≥0.90的重复记录共享一票；同一图片不同物体不直接合并。同一重复观测若有互相矛盾的面型候选，分摊一票，不能重复抬高支持度。

同一面型若在多个旧Class内都严格过半，优先保留面型支持数最多的Class、其次类内占比；两者平票必须人工选择。任何旧Class均不过半则自动提出新类候选，编号23起追加。自interface v5起，人工还可将无多数归属的当前整组明确归入未占用且实际K兼容的旧Class，记录为人工指定而非多数retain，原票数/分母及自动建议保留。所有支持证据保留，图结构修改后按同一冻结分母重算。

## 当前结果不是最终新类目录

- 冻结2200个不同目标的最新人工轮廓，来源事件、原始UTF-8哈希、版本和原图绑定独立核验通过。
- 实际点数分布：`4:565,5:1,8:967,9:1,10:191,12:324,14:1,16:150`。
- **113个面型候选组**；其中11组有严格过半旧类归属，102组没有，暂列为新类候选。当前候选建议改类1325个目标。
- **102不是已确认新增类别数量**。图像噪声、视角、局部遮挡可能将同一真实面型拆成多个组；必须人工核对并按需合并/拆分。5/9/14点各一条同样不自动认定为真实新型号。
- 首次未发布候选的视觉权重不足以独立阻止仅轮廓相似的误合并，证据保留于`outputs/pallet_mask_class_correction_preflight_v0/`；最终视觉项权重独立生效。候选仍不是物理面型准确率证明。
- 所有组初始均待复核，代理没有写任何真实类别确认。旧Class和人工轮廓未覆盖，完整最终类别数尚未确定，也不强求校正后每类100条。

工作包：`outputs/pallet_mask_class_correction_v1/`。

manifest SHA-256：`a688a2ee6a69a17c082093c56d99f933de5d19c4254b823f1d618ea5925d4f77`。

## 复核入口与操作

- 公网：<https://sold-visits-concrete-beats.trycloudflare.com/>。
- 服务器本地：<http://127.0.0.1:3410/>；远程电脑需SSH转发。
- 沿用原访问码，不公开；Quick Tunnel是临时URL，无永久地址或开机自启承诺。
- 可按实际K、旧Class及复核状态筛选，浏览全部目标，不只是建议变更的目标。
- 每组显示旧类分布、过半支持/分母/比例，原图与最新人工轮廓并列；独立比较扩展提供旧类同K参考及拟合入面型参考。旧类参考不假装为纯净真值。
- **确认本组**：表示已检查整个组的面型与归属；不是只看几张代表图就自动确认整组。
- **合并同K组、选中目标移动或拆分**：全程禁止跨实际K。自interface v4起，仅成员或归属证据变化的组重新待确认，持续未变的组保留确认；包括检查重复观测分票造成的间接影响。刷新页面不清除服务器确认。
- **暂缓/拒绝建议、平票选择、历史恢复**：均追加留痕；原始类别和轮廓不动。
- 保存失败不跳转，理由/复核人/选中目标保留本机草稿；全图版本冲突返回409，不覆盖他人决定。源人工轮廓变化也会阻止保存和已确认映射导出，需新版本重新绑定。

独立类图保存库：`outputs/pallet_mask_class_correction_reviews_v1/mask_reviews.sqlite3`。该库保存类别图/动作/理由/审核人/修订和历史，不是原掩膜库，也不改写位姿库。

## 输出口径

- `proposed_mapping.jsonl`：冻结初始逐目标旧类→候选类，全部`pending_human`。
- `face_groups.json`：初始面型组、实际K、旧类票数和新类建议。
- 页面“下载全部建议”：当前类图提案，明确区分未确认状态，不是新训练标签。
- 页面“下载已确认类别映射”：只导出人工明确确认组的侧附映射；未确认项不默认为已校正。API同时提供`confirmed.json/csv`和`proposals.json/csv`。
- 即使导出已确认映射，也不自动替换旧标签、创建训练集、激活模型或晋升GT。完整校正后的类别数、逐类目标/不同图像数需在人工面型核验后重新统计。

## 验证和复现入口

- 构建：`scripts/build_mask_class_correction.py`。
- 独立来源/点数/去重/严格多数核验：`scripts/verify_mask_class_correction.py`，不宣称物理分类准确率。
- 浏览器：`scripts/check_mask_class_correction_ui.py --comparison --output <新证据目录>`，实际Chromium1400/390宽；确认、暂缓、拆分、合并、历史恢复、409、跨K拒绝、失败保草稿及JSON/CSV映射导出全部成功；每轮10次模拟保存仅在`/tmp/opencode`临时库。最终补测为`outputs/pallet_mask_class_correction_checks_v1/release_v2_ui/`，原验收和失败证据未覆盖。
- 公网：`scripts/check_mask_class_correction_public.py`，230份资源样本哈希及鉴权读取通过，无类别决定POST。
- 只读进度/当前候选类别数量：`scripts/audit_mask_class_correction.py`。
- 服务：`scripts/serve_mask_class_correction.py`，独立3410回环端口。旧3406/3407/3408/3409服务保持。
- 最终实际回执：`outputs/pallet_mask_class_correction_checks_v1/FINAL_HANDOFF.json`。

CPU回归124项通过（含超过50条历史后恢复早期版本、CSV鉴权/范围及来源变化409）；实际iPhone/Safari未验收。旧正式数据、GT、框、图像/PCD、位姿/标尺/选面、人工轮廓/事件、旧模型/训练集及失败证据完整保留。代码和证据没有自动提交或推送。

## 2026-10-29 界面增补（interface v2，历史发布记录；确认失效规则已由v4修正）

- **将选中目标移入指定Class**：下拉框按Class编号展示当前同K、非本组的目标面型，并标注是否已确认；选中目标后填写理由即可移动。仍按同一冻结分母重新计票并清除全部确认。若指定Class没有当前面型、不同K、平票未解决，或移入后多数将变为其它Class，则拒绝本次操作，不默默移入另一类，也不直接覆盖多数规则。显式选择的Class可裁决移入后出现的真实多数平票。
- **顶部常态样例栏**：仅显示当前有效的已确认类别，含Class编号、实际K、目标数量、原图及人工轮廓样例；滚动页面时吸顶，各类别可横向滚动，不受当前组和筛选条件影响。没有有效确认时明确显示空状态；确认被改组清除或源轮廓变化后不继续展示为已确认样例。
- **扩大勾选范围**：当前组的目标卡片支持点击图片、文字、边框内空白或复选框切换一次选择；“原图与人工轮廓放大”只打开放大窗，不改变选择。同属当前组的对照样例可同步勾选；其它组的样例明确标注仅供对照，避免误选其它组目标。
- Class选择、复核人、理由和勾选目标一起保留本机草稿，保存失败或409不会覆盖服务器版本；移动动作追加记录所选Class和目标键。原8条真实类别图事件保留，不写模拟确认到真实库。
- 新界面独立封装于`outputs/pallet_mask_class_correction_checks_v1/ui_extension_v2/`，未改冻结工作包或原比较扩展；页面地址、访问码、namespace和类图数据库不换。
- 验收：136项CPU回归；实际Chromium1400/390宽验证整卡/镜像样例选择、放大按钮不勾选、吸顶样例跨筛选保留、指定Class移动、失败草稿重载、跨K拒绝、409及导出。14次模拟保存仅在`/tmp/opencode`临时库。
- 本次交付回执：`outputs/pallet_mask_class_correction_checks_v1/interface_v2/HANDOFF.json`；旧`FINAL_HANDOFF.json`及成功/失败证据不覆盖。

## 2026-10-29 同K目标选项缺失修复（interface v3）

### 原因与核验

- Class 1在真实历史r9时尚未形成当前归属，r10合组后才出现，r13为`H8-7c9363c133c5`，K8、100目标、已确认。旧Class1样本存在不等于当时已有当前归属Class1。
- 修复前以新浏览器读取r13，另外19个K8组的两个下拉框均包含Class1；因此没有发现服务器按K误判或将已确认组过滤的证据。旧页面只在登录/保存/手动刷新时加载图，另一窗口形成新Class后仍持有旧版本，旧目标列表不会更新。已用真实r9/r13状态的临时库重放并验证这一缺陷。
- 原面型组下拉框按内部`F…/H…`组ID顺序列出，人工拆分的`H8…` Class1靠后，难以查找；本组从目标列表直接隐藏、平票未定的Class不列出，也没有解释。

### 修复

- 新增鉴权、只读的`/api/review/version`，返回binding和类别图revision，不计算全部来源或写事件。页面每8秒、窗口重新聚焦/恢复可见、下拉框获得焦点时检测版本变化，必要时同步最新目标目录。
- 目标目录和当前编辑版本分离：选项可更新到最新Class，但理由、选中目标和编辑基准版本不自动覆盖或重置。版本不一致时显示两个版本号并拦截保存，要求点击“刷新服务器版本”核对后操作；后端原有409保护保持。
- 两个下拉框均展示全部当前同K组，按当前Class编号数字排序，Class1靠前；不受旧Class/复核状态筛选影响。本组显示为禁选并解释原因，平票未定项明确标注，不伪造归属或放松K约束。
- 顶部已确认样例、拟合入组样例随最新目录同步；当前旧版本的选择仍属于旧编辑快照，未经刷新不能保存到新图。
- 独立新页面资源`ui_extension_v3/`，旧v2扩展、冻结工作包、全部原人工历史保留，访问地址/访问码/namespace不换。

验收：137项CPU回归；1400/390宽实际Chromium重放历史后，逐个检查20个K8组的两个下拉框，验证Class1、编号排序、禁选本组、跨旧Class/状态筛选、草稿保留和版本变化拦截；完整原交互回归通过。最终公网只读回执为`outputs/pallet_mask_class_correction_checks_v1/interface_v3/HANDOFF.json`。

运行中3410应用已单独重载，原隧道URL保持，真实图r13及全部13条事件在发布核验前后未变。公网鉴权页面/新版资源字节核验通过；本机无头Chromium直接导航公网时发生`ERR_INVALID_AUTH_CREDENTIALS`传输失败，失败证据保留，未修改浏览器安全或代理凭据。正式应用的浏览器逐组选项验收改用本地3410，同一页面/资源与公网逐字节一致；不声称该轮无头浏览器直接公网导航通过。

## 2026-10-29 确认持久化修复与历史恢复（interface v4，当前规则）

原因：原`transition()`在任意merge/split/move/move_class后执行`group_status={}`，全局清空确认，而非仅使受影响组待确认。r8拆Class1时清掉了Class16/11/18，r15合Class18时清掉了Class1，r18拆K12时又清掉了Class1/18。18条原始事件均完整存在；浏览器刷新本身没有写数据库，刷新展示的是此前全局清空后的当前状态。

修复：逐组对比确切成员键、实际K、旧类组成、完整多数票数/分母/比例、多数及平票归属、最终Class。仅证据改变或成员改变的组失效，未变组的确认/暂缓/拒绝以及有效平票裁决继续保留。重复样本分票影响未直接移动的组时也能触发失效，不把“同Class编号、同数量”冒充同一批目标。保存回执列出失效的原确认组，页面明确提示刷新保留确认。

恢复：逐条重放真实历史，仅延续自人工确认以来每一步成员与归属证据始终不变的确认；显式拒绝/暂缓、历史恢复省略的确认、曾改动后又回到原成员的组均不自动恢复。经只读计划、临时库恢复和实际浏览器验收后，生产库从r18追加r19 `recover_confirmations`，携带原复核人、原确认修订/时间和证据哈希，标记`new_semantic_confirmations=false`。

| 恢复类别 | 实际K | 目标数 | 原人工确认修订 |
| --- | --- | --- | --- |
| Class1 | 8 | 100 | r16 |
| Class11 | 10 | 99 | r5 |
| Class16 | 10 | 92 | r3 |
| Class18 | 8 | 70 | r17 |

共4类361个目标恢复已确认状态；Class18使用扩展到70目标后的r17确认，未套用旧53目标确认。r19仅恢复状态与追加修复来源，成员分组、Class归属、平票选择、新类注册表、轮廓和原18条事件均不改；备份和恢复计划位于`outputs/pallet_mask_class_correction_checks_v1/interface_v4/recovery/`。

验收：150项CPU回归；1400/390宽真实Chromium在临时库重放r18，验证恢复后刷新/重载/新窗口保留4类、拆无关K12仍保留4类、拆Class1仅Class1失效、导出/历史恢复/409正常。线上本地3410浏览器只读验证刷新/重载/新窗口及已确认筛选保持4类；公网HTTPS新版资源与已确认361条导出核验通过。原隧道URL、访问码和旧3406–3409服务保留。

交付回执：`outputs/pallet_mask_class_correction_checks_v1/interface_v4/HANDOFF.json`。新界面为独立`ui_extension_v4/`；旧版本、历史回执和失败证据完整保留。

## 2026-10-31 无多数归属时人工复用旧Class（interface v5）

“指定Class”现同时列出现有同K面型和可复用旧Class：

1. 当前组没有任何旧类严格过半归属时，选择标有“**旧Class N · 未占用 · 含实际K…样本 · 可将当前整组归入**”的条目。
2. 填写复核人/理由，点击“**将当前整组归入所选旧Class**”。作用于当前面型组全部成员，不是仅处理复选框勾选的目标，提交前再次明确组内总数。
3. 保存后归属方式为`manual_old_class_assignment`，不是`retain_majority_class`；本组重新待确认。再次检查并“确认本组”后才进入有效标签导出，顶部样例随之展示。

约束：仅可复用旧Class1–22；旧Class不能已被其它当前面型占用，也不能处于未裁决平票的候选中；其冻结旧样本必须包含与当前组相同的真实人工K，不按旧标准K推断。当前组已有strict-majority归属时拒绝覆盖多数规则。目标Class已有面型时继续使用原“移动勾选目标”操作，不暗中合并或抢占Class编号。

状态/留痕：`manual_class_choices`仅附加到独立类别图，保留Class、实际K和理由。事件动作为`reuse_old_class`，记录whole-face scope、所选Class、复核人、理由、版本，并标记`majority_rule_overridden=false`。原成员分组、旧Class字段、原始轮廓及来源库均不改动，未受影响的确认继续保留。后续显式合并/移动到手工归属的面型时，在仍无多数且Class兼容/未被抢占的情况下可保留人工归属建议，但成员/投票证据变化必须重新确认；出现真实多数或冲突时撤销不再适用的人工归属并保留多数计算结果。

JSON/CSV导出新增`class_assignment_method`、`majority_proposed_class_id`、`majority_decision`、`manual_class_id`，区分人工分配与原多数建议；票数和冻结分母不变。只读进度审计也按人工侧附归属统计。历史恢复支持撤销人工分配且仍追加事件，不删旧操作。

验收：166项CPU回归；1400/390宽Chromium在临时复制库验证整组作用域（仅勾1项仍只改变全组标签、不改变成员）、手工而非retain来源、确认前不进入有效导出、确认后刷新/CSV一致、占用Class400、失败草稿重载、409、历史恢复。Class1目标目录同步和4类确认持久化亦以新版实现复测通过，所有成功/失败旧回执保留。

真实库本次发布前后仍为r19/19事件，原4类361个确认保持；代理未执行任何真实人工旧Class分配。仅重载3410应用，原隧道URL、访问码、namespace和其它服务保持。新资产为`ui_extension_v5/`，最终回执为`outputs/pallet_mask_class_correction_checks_v1/interface_v5/HANDOFF.json`；新版验收证据绑定于`interface_v5/release/`。

## 最新人工修改整合版（当前3410服务）

用户完成分类/属性至r421后，又完成88份可修改轮廓并明确要求更新类别复核服务。当前3410已切换独立整合版：Class12/85为K12，108→14，124→115，45类/2200目标。原421条类别历史、94条修改历史和原属性完整保留；37/47未保存的异常/遮挡项仍未解决。详情见[`pallet_mask_class_note_integration_v1.md`](pallet_mask_class_note_integration_v1.md)，同一公网URL及访问码保持，新整合库从r1追加，旧库未重绑。
