# v4模型与几何基线对比HTML

## 交付

- 单文件：`outputs/pallet_pose_benchmark_v4/comparison_html/index.html`（约8MB）。
- 完整包：`outputs/pallet_pose_benchmark_v4/comparison_html.zip`（约4.5MB）。
- 数据：包内 `comparison_data.json`、`target_comparison.csv`。
- 来源：包内 `evidence/`，含冻结选模、分支评估、原报告和输入哈希。
- 静态验收：包内 `acceptance.json`。
- 浏览器专项：独立目录 `outputs/pallet_pose_benchmark_v4/comparison_html_validation/`；
  仅当 `validation.json` 存在且 `state=passed` 时才表示桌面/手机离线专项完成。

HTML嵌入原图、SVG、字体、案例及全量逐目标数据下载，不调用线上接口、CDN或第三方服务。
ZIP解压后直接打开 `index.html` 即可。报告有类别/关键词筛选、表头排序、打印/PDF样式。
手机验证使用390px触摸模拟，不等于实机iPhone Safari验收。

## 比较口径

主模型固定为原train CV选定的 `pointnext/long_b32`，不因test结果改选。
主基线为几何＋ROI回退，与模型同覆盖574个米制test目标。纯几何只有566个输出，
单独标注，不把其均值与全574例直接作配对差值。表中Δ统一为模型减同覆盖几何。

报告包括全部8模型和续训配方、val补充、未知单位分支、三种子CV区间、真正末轮CV、
真实batch/更新步数/耗时、散点分布、按域及采集组拆分，以及12例改善/退化/回退案例。

主模型在test挽回3例、退化5例，联合达标数由542降至540。位置均值改善不代表方向或达标率改善。
其原train相对几何的配对区间跨0，保留几何部署建议。未知单位结果使用自动宽度百分比，禁止当毫米。

## 案例选择与视觉编码

`pallet/pose_comparison_report.py:choose_cases`固定类别和排序条件。选例是**事后诊断**，
包括最大差异、跨50mm/5°门槛、双方常规小误差、双方失败、ROI回退及两种补充模型/配方。
部分类型优先不同采集组，其规则和候选数量逐例展示；12个不同目标，不声称随机或无偏代表。

每例提供：

1. 正式数据集原图与原检测框，及原框邻域放大；不虚构标定做姿态像素投影。
2. 原PCD通过原像素映射取得原框点，按明确单位缩放，绘制源坐标XY俯视。
3. 人工研究标签、几何/回退和本例模型中心/方向叠加；另给毫米级中心差放大图。
4. 各主/补充模型误差、联合达标、目标ID、原PCD文件名、采集组、单位依据、修订和哈希。

XY图横轴源Y、纵轴源X，保持相同物理比例。箭头长度固定用于可见性，不表示运动距离；
方向角不放大。俯视图以0.5%–99.5%点分位并纳入全部中心设显示范围，最多确定性抽样2400点；
显示抽样不改变模型输入、人工标签或评测。人工标签是非盲研究草稿，不能直接称独立物理GT。

## 生成与验证

```bash
OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 .venv/bin/python \
  scripts/render_pose_comparison_report_v4.py

.venv/bin/python -m pytest tests/test_pose_comparison_report.py -q

OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 .venv/bin/python \
  scripts/verify_pose_comparison_html_v4.py
```

生成器拒绝非空输出和既有ZIP，重做应指定新的 `--output` 版本目录，不覆盖先前报告。
默认从 `/tmp/opencode/pallet_pose_design/NotoSansCJKsc-Regular.otf` 提取嵌入字体子集，
可用 `--font` 指定；附带原字体许可并给子集新名称。没有该文件时回退到本机字体。

浏览器验证直接从 `file://` 打开，禁网，检查桌面1440px与手机390px下的布局、图片、
筛选、搜索空态、重置、鼠标/键盘排序、溯源展开、嵌入CSV/JSON下载和打印完整性。
截图与验证记录只写新验证目录，不改变封装报告。

## 数据保护

生成过程不打开真实人工SQLite、不训练/推理重选，不改标签或机器侧车；
用现存冻结逐目标预测重算56份模型/划分指标，检查20,768个正式保护文件不变，
复核既有源码/标签/交付哈希，并校验每个案例的PCD及图像身份。
原单位注册、旧实验和模型ZIP保持原样。全部研究输出仍 `robot_command_eligible=false`。
