"""Frozen annotation widths, observation patterns and same-frame adjacent faces.

Widths are measured in source metres already; source scale must not be applied
twice. Class labels are appearance groups, not physical pallet identities.
"""
from collections import Counter,defaultdict
from concurrent.futures import ThreadPoolExecutor
import argparse
import csv
from html import escape
import io
import json
import math
from pathlib import Path
import shutil

import numpy as np
from PIL import Image,ImageDraw,ImageFont

from .cluster_targets import digest,load_dataset,protected_snapshot
from .pose_annotation_audit import (PROJECT,LIVE,FONT,freeze,read_snapshot,rows,write_rows,write_json,
    screen_one,world_ruler,report_font,now)
from .pose_review_geometry import canonical

OUT=PROJECT/'outputs/pallet_pose_dimensions_v1'
PATTERNS={'双开口中支撑面候选':'two_openings_middle_support_candidate',
    '单长开口面候选':'single_long_opening_candidate','低矮窄条边沿面候选':'low_strip_edge_candidate',
    '三开口多支撑面候选':'three_openings_candidate','层状横梁面候选':'layered_beam_candidate','unknown':'unresolved'}


def stats(records):
    if not records:return dict(n=0,groups=0,median_m=None,p10_m=None,p90_m=None,group_balanced_median_m=None)
    widths=np.array([r['width_m'] for r in records]);groups=defaultdict(list)
    for r in records:groups[r['group_id']].append(r['width_m'])
    gm=np.array([np.median(v) for v in groups.values()]);q=np.quantile(widths,[0,.1,.25,.5,.75,.9,1])
    return dict(n=len(records),groups=len(groups),min_m=float(q[0]),p10_m=float(q[1]),p25_m=float(q[2]),median_m=float(q[3]),
        p75_m=float(q[4]),p90_m=float(q[5]),max_m=float(q[6]),group_balanced_median_m=float(np.median(gm)),
        group_medians_p10_p90_m=np.quantile(gm,[.1,.9]).tolist(),spread_is_measurement_distribution_not_CI=True)


def pair_geometry(a,b):
    """Geometric candidate only; visual same-layer identity still required."""
    if a['source']['frame_id']!=b['source']['frame_id']:return None
    fields=('scale_to_m','forward_axis','forward_sign','up_axis','up_sign')
    if any(a['sensor'][f]!=b['sensor'][f] for f in fields):return None
    ca,ba=world_ruler(a['ruler']);cb,bb=world_ruler(b['ruler'])
    angle=float(np.rad2deg(np.arccos(np.clip(abs(ba[:,1]@bb[:,1]),0,1))))
    endpoints_a=[ca+s*a['ruler']['half_width']*ba[:,0] for s in (-1,1)]
    endpoints_b=[cb+s*b['ruler']['half_width']*bb[:,0] for s in (-1,1)]
    gaps=[np.linalg.norm((x-y)@ba[:,:2]) for x in endpoints_a for y in endpoints_b]
    gap=float(min(gaps));height_gap=float(abs((ca-cb)@ba[:,2]))
    pa=np.array(a['polygon']);pb=np.array(b['polygon'])
    overlap=max(0.,min(pa[:,1].max(),pb[:,1].max())-max(pa[:,1].min(),pb[:,1].min()))
    overlap/=max(min(np.ptp(pa[:,1]),np.ptp(pb[:,1])),1e-8)
    return dict(normal_acute_angle_deg=angle,nearest_endpoint_workplane_gap_m=gap,
        display_height_center_gap_m=height_gap,pixel_vertical_overlap_fraction=float(overlap),
        candidate_pass=bool(angle>=75 and gap<=.1 and height_gap<=.08 and overlap>=.35),
        score=gap+height_gap+.002*(90-angle),height_is_surface_display_anchor_not_fork_height=True)


def build(out):
    freeze(out);manifest=json.loads((out/'snapshot/manifest.json').read_text());current,histories=read_snapshot(out)
    classes={r['target_key']:r for r in rows(out/'snapshot/classes.jsonl')}
    # Reuse an earlier screening result only on exact frozen payload identity.
    audit=PROJECT/'outputs/pallet_pose_annotation_audit_v1/screening.jsonl'
    old={r['target_key']:r for r in rows(audit)} if audit.exists() else {}
    import hashlib
    def one(key):
        value=current[key];r=old.get(key)
        if r and r.get('source_review_sha256')==hashlib.sha256(canonical(value)).hexdigest():return r
        return screen_one(value,histories[key],classes[key],LIVE/'geometry')
    with ThreadPoolExecutor(max_workers=6) as pool:screen=list(pool.map(one,sorted(current)))
    records=[];excluded=[]
    for s in screen:
        key=s['target_key'];v=current[key];c=classes[key]
        if v['state']=='deleted':excluded.append(dict(target_key=key,reason='deleted'));continue
        if not v.get('ruler') or v['sensor']['scale_to_m'] is None or not np.isfinite(v['ruler']['half_width']) or v['ruler']['half_width']<=0:
            excluded.append(dict(target_key=key,reason='no_positive_metric_ruler'));continue
        flags=s.get('screen_flags',[])
        bad=bool(set(flags)&{'ruler_endpoints_differ_from_visible_extent','selected_depth_spread_check_background_or_multiple_faces',
            'many_polygon_pixels_without_usable_depth','manual_all_roi_check_background','image_edge_truncation_candidate','axis_revision_width_and_angle_need_review'})
        revised=s.get('history',{}).get('multiple_human_saves_with_geometric_change',False)
        r=dict(target_key=key,frame_id=c['frame_id'],group_id=c['group_id'],class_id=c['final_class_id'],split=c['split'],domain=c['domain'],
            original_A=c.get('original_appearance_class'),classification_source=c['classification_source'],classification_review_required=c.get('classification_review_required',False),
            observation_pattern=PATTERNS.get(c.get('structure_candidate'),'unresolved'),structure_candidate=c.get('structure_candidate'),
            viewpoint_candidate=c.get('viewpoint_candidate'),physical_face_identity='unresolved',paired_physical_object_id=None,
            width_m=float(v['ruler']['half_width']*2),source_scale_to_m=v['sensor']['scale_to_m'],revision=v['revision'],
            axes_confirmed=v['sensor']['axes_confirmed'],human_pose_confirmed=v['human_pose_confirmed'],
            historical_geometric_revision=revised,screening_status=s['screen_status'],screen_flags=flags,
            lower_risk_revised=bool(s['eligible'] and not bad and revised),
            source_review_sha256=s['source_review_sha256'],full_pallet_length_m=None,full_pallet_width_m=None,height_m=None,
            robot_command_eligible=False)
        records.append(r)
    write_rows(out/'width_records.jsonl',records);write_rows(out/'excluded.jsonl',excluded);write_rows(out/'quality_screen.jsonl',screen)
    frame=defaultdict(list)
    for r in records:frame[r['frame_id']].append(r)
    candidates=[];all_pairs=[]
    for fid,rs in sorted(frame.items()):
        for i,a in enumerate(rs):
            for b in rs[i+1:]:
                g=pair_geometry(current[a['target_key']],current[b['target_key']])
                if g is None:continue
                p=dict(frame_id=fid,group_id=a['group_id'],keys=[a['target_key'],b['target_key']],class_ids=[a['class_id'],b['class_id']],
                    widths_m=[a['width_m'],b['width_m']],**g,identity_status='geometric_candidate_not_verified_same_pallet',
                    long_short_candidate_m=sorted([a['width_m'],b['width_m']],reverse=True),robot_command_eligible=False)
                all_pairs.append(p)
                if g['candidate_pass']:candidates.append(p)
    # Mutual best matches reduce cross-layer pairings; do not silently force a
    # whole frame's multiple pallets into a single physical object.
    by_key=defaultdict(list)
    for i,p in enumerate(candidates):
        for k in p['keys']:by_key[k].append(i)
    for k,ix in by_key.items():ix.sort(key=lambda i:(candidates[i]['score'],candidates[i]['keys']))
    for p in candidates:
        ix=candidates.index(p);p['mutual_best']=all(by_key[k][0]==ix for k in p['keys'])
        margins=[candidates[by_key[k][1]]['score']-p['score'] if len(by_key[k])>1 else None for k in p['keys']]
        p['alternative_score_margins']=margins
        p['unambiguous_mutual_best']=p['mutual_best'] and all(m is None or m>=.02 for m in margins)
    candidates.sort(key=lambda p:(not p['unambiguous_mutual_best'],p['score'],p['frame_id']))
    # Diverse visual sample: choose one per class-pair/group before repeats.
    selected=[];groups=Counter();used=set();remaining=list(candidates)
    while remaining and len(selected)<24:
        remaining.sort(key=lambda p:(not p['unambiguous_mutual_best'],groups[(tuple(sorted(p['class_ids'])),p['group_id'])],p['score']))
        p=remaining.pop(0)
        if any(k in used for k in p['keys']):continue
        selected.append(dict(p,pair_id=f'P{len(selected)+1:02d}'));used.update(p['keys']);groups[(tuple(sorted(p['class_ids'])),p['group_id'])]+=1
    write_rows(out/'all_same_frame_pairs.jsonl',all_pairs);write_rows(out/'adjacent_face_candidates.jsonl',candidates)
    write_rows(out/'visual_pair_samples.jsonl',selected)
    aggregate=[];strata=[]
    for cid in range(1,23):
        rs=[r for r in records if r['class_id']==cid]
        aggregate.append(dict(class_id=cid,all=stats(rs),lower_risk_revised=stats([r for r in rs if r['lower_risk_revised']]),
            original_members=stats([r for r in rs if r['classification_source']=='retained_excel_merge']),
            reassigned_members=stats([r for r in rs if r['classification_source']!='retained_excel_merge']),
            dimension_status='observed_face_width_only_not_pallet_LxW',physical_length_m=None,physical_width_m=None,height_m=None))
        for field in ('observation_pattern','original_A','domain','viewpoint_candidate','classification_source'):
            for val in sorted({str(r[field]) for r in rs}):
                sub=[r for r in rs if str(r[field])==val]
                strata.append(dict(class_id=cid,stratum_field=field,stratum_value=val,**stats(sub)))
    write_json(out/'class_summary.json',aggregate);write_rows(out/'strata.jsonl',strata)
    write_json(out/'analysis_policy.json',dict(width_definition='2 * saved ruler.half_width in metres; no second scale multiplication',
        physical_face_identity='No explicit persistent physical-pallet identifier or adjacent-face ID in source annotations',
        face_patterns='Inherited unsupervised image-structure suggestions, never verified A/B identities',
        pairing='same frame, compatible axes/scale, normals 75..90 degrees, endpoint workplane gap <=0.1m, display-height gap <=0.08m, vertical overlap >=0.35; mutual-best ambiguity flagged; visual verification still required',
        lower_risk='historical geometry edit and no selected automatic endpoint/depth/truncation warnings; NOT confirmed full boundary or GT',
        group_weighting='median within acquisition group, then median of group medians; groups not known physical pallet identities',
        source_annotation_writes=0,robot_command_eligible=False))
    print(json.dumps(dict(records=len(records),excluded=len(excluded),same_frame_pairs=len(all_pairs),adjacent_candidates=len(candidates),
        mutual_unambiguous=sum(p['unambiguous_mutual_best'] for p in candidates),visual_pairs=len(selected))),flush=True)


def pictures(out):
    manifest=json.loads((out/'snapshot/manifest.json').read_text());formal=Path(manifest['formal']);_,sources=load_dataset(formal)
    current,_=read_snapshot(out);samples=rows(out/'visual_pair_samples.jsonl');assets=out/'assets';assets.mkdir(exist_ok=True)
    font=ImageFont.truetype(str(FONT),16);tiles=[]
    for p in samples:
        source=sources[p['frame_id']];path=formal/source['image'];assert digest(path)==source['files'][source['image']]
        image=Image.open(path).convert('RGB');draw=ImageDraw.Draw(image)
        bounds=[]
        for i,key in enumerate(p['keys']):
            poly=np.asarray(current[key]['polygon']);bounds.extend(poly.tolist());color=['#00b9ee','#f56841'][i]
            draw.line([tuple(v) for v in np.r_[poly,poly[:1]]],fill=color,width=2)
            draw.text(tuple(poly.min(0)),str(i+1),fill=color)
        bounds=np.array(bounds);lo=np.maximum(np.floor(bounds.min(0)-[15,15]).astype(int),0);hi=np.minimum(np.ceil(bounds.max(0)+[15,15]).astype(int),image.size)
        crop=image.crop((*lo,*hi));crop.save(assets/(p['pair_id']+'_crop.png'));image.save(assets/(p['pair_id']+'_frame.png'))
        tile=Image.new('RGB',(600,360),'white');d=ImageDraw.Draw(tile)
        d.text((8,5),f'{p["pair_id"]} · 类{p["class_ids"]} · '+ ' × '.join(f'{v:.3f}' for v in p['widths_m'])+' m',font=font,fill='#14283f')
        d.text((8,29),f'法向夹角 {p["normal_acute_angle_deg"]:.1f}° · 端点距 {p["nearest_endpoint_workplane_gap_m"]*1000:.1f}mm',font=font,fill='#526378')
        crop.thumbnail((580,295));tile.paste(crop,((600-crop.width)//2,60+(295-crop.height)//2));tiles.append(tile)
    for start in range(0,len(tiles),6):
        board=Image.new('RGB',(1200,1080),'#e2e9f0')
        for i,tile in enumerate(tiles[start:start+6]):board.paste(tile,((i%2)*600,(i//2)*360))
        board.save(out/f'pair_contact_{start//6+1:02d}.jpg',quality=93)
    print(json.dumps(dict(pair_contact_sheets=math.ceil(len(tiles)/6))),flush=True)


def export_csv(path,records):
    if not records:return
    fields=list(dict.fromkeys(k for r in records for k in r));s=io.StringIO(newline='');writer=csv.DictWriter(s,fieldnames=fields);writer.writeheader()
    for r in records:
        row={k:json.dumps(v,ensure_ascii=False) if isinstance(v,(list,dict)) else v for k,v in r.items()}
        for k,v in row.items():
            if isinstance(v,str) and v.lstrip().startswith(('=','+','-','@')):row[k]="'"+v
        writer.writerow(row)
    path.write_text('\ufeff'+s.getvalue())


def fmt(x):return '—' if x is None else f'{x:.3f}'


def histogram(records):
    # Fixed 0.05m bins are display bins, not inferred physical size families.
    edges=np.arange(.0,2.55,.05);h,_=np.histogram([r['width_m'] for r in records],edges)
    maxn=max(int(h.max()),1);out=['<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 160" role="img" aria-label="面宽分布，非规格分组"><rect width="600" height="160" fill="#f4f7fb"/>']
    for i,n in enumerate(h):
        height=n/maxn*110;out.append(f'<rect x="{40+i*10.4:.1f}" y="{130-height:.1f}" width="9.5" height="{height:.1f}" fill="#367b9e"/>')
    for x in np.arange(0,2.6,.5):out.append(f'<text x="{40+x/.05*10.4:.1f}" y="149" font-size="11">{x:.1f}m</text>')
    out.append(f'<text x="10" y="15" font-size="12">n={len(records)}; 0.05m bins, not size classes</text></svg>');return ''.join(out)


def render(out):
    manifest=json.loads((out/'snapshot/manifest.json').read_text());records=rows(out/'width_records.jsonl');by_key={r['target_key']:r for r in records}
    summary=json.loads((out/'class_summary.json').read_text());strata=rows(out/'strata.jsonl');candidates=rows(out/'adjacent_face_candidates.jsonl')
    review_path=PROJECT/'configs/pallet_pose_dimensions_v1_pair_reviews.json';reviews=json.loads(review_path.read_text());pairs=rows(out/'visual_pair_samples.jsonl')
    for p in pairs:
        p.update(visual_review=reviews['pairs'][p['pair_id']],face_convention='F1/F2 local to this pair; no global A/B identity',height_m=None)
        supported=p['visual_review']['status']=='visually_supported_same_pallet_candidate'
        p['reported_dimensions_m']=p['long_short_candidate_m'] if supported else None
        p['dimension_status']='paired_saved_ruler_candidate_not_confirmed_specification' if supported else 'do_not_combine'
        for k in p['keys']:p.setdefault('per_face_quality',[]).append({f:by_key[k][f] for f in ('historical_geometric_revision','lower_risk_revised','screen_flags','revision')})
    write_rows(out/'reviewed_pairs.jsonl',pairs)
    tail=[r for r in records if r['class_id'] in (12,21) and r['width_m']>1.6]
    assert {r['target_key'] for r in tail}==set(reviews['long_tail_review']['target_keys'])
    write_json(out/'long_tail_review.json',dict(review=reviews['long_tail_review'],records=tail))
    # Keep raw candidates separate; do not propagate 22 visual checks to 326 candidates.
    export_csv(out/'per_target_widths.csv',records);export_csv(out/'face_pattern_and_subgroup_stats.csv',strata)
    export_csv(out/'class_width_stats.csv',[dict(class_id=r['class_id'],**r['all'],lower_risk_revised_n=r['lower_risk_revised']['n'],
        lower_risk_revised_median_m=r['lower_risk_revised']['median_m'],original_member_median_m=r['original_members']['median_m'],
        reassigned_member_median_m=r['reassigned_members']['median_m'],height_m=None,full_pallet_LxW=None) for r in summary])
    export_csv(out/'reviewed_pair_dimensions.csv',pairs)
    eligible=[p for p in pairs if p['reported_dimensions_m']];opposite=defaultdict(list)
    for p in eligible:
        for i,k in enumerate(p['keys']):opposite[by_key[k]['class_id']].append(dict(pair_id=p['pair_id'],this_face_width_m=p['widths_m'][i],
            other_face_width_m=p['widths_m'][1-i],other_face_class=p['class_ids'][1-i],same_frame=p['frame_id']))
    write_json(out/'class_paired_evidence.json',dict(opposite))
    header='| 类 | 有效数/采集组 | 面宽中位数m | P10–P90 m | 组间均衡中位数m | 低风险且有修订 n/中位数m |\n|---|---:|---:|---|---:|---|\n'
    for r in summary:
        s=r['all'];q=r['lower_risk_revised'];header+=f'| {r["class_id"]} | {s["n"]}/{s["groups"]} | {fmt(s["median_m"])} | {fmt(s["p10_m"])}–{fmt(s["p90_m"])} | {fmt(s["group_balanced_median_m"])} | {q["n"]}/{fmt(q["median_m"])} |\n'
    report=f'''# 各类别叉取面宽度与双面尺寸候选

冻结时间：{manifest['created_at']}。共{manifest['saved_targets']}条保存记录、{len(records)}条有效米制标尺；删除或缺少有效标尺的记录另列。全部来自人工保存草稿，不作为已校准型号规格。

## 结论

1. **两个叉取面分别统计，不能混合求均值。** 同一托盘的两个面既可能被分到不同外观类别，也可能在同一类别内。P15两个面都为Class 5，标尺分别约0.997m和1.182m；用该类总体中位数约1.102m不能代表这只托盘的任一完整尺寸。
2. **可以获得逐例双面候选，但还不能给每类一个固定长×宽。** 同帧3453对标注经轴向、近正交、端点/显示高度及图像重叠筛查得到{len(candidates)}对候选。互为最佳且间隔足够的有{sum(p['unambiguous_mutual_best'] for p in candidates)}对；抽看24对图像后，{len(eligible)}对支持同一托盘同层的相邻面解释，1对不确定，1对明确为不同托盘堆，均保留审阅依据。
3. **几何接近会误配。** P11属于左右不同托盘堆，尽管法向约90°、端点接近，也禁止组合成尺寸。未视觉核实的其余候选不升格为配对尺寸。
4. **部分托盘两个面宽度接近。** 不能强制所有托盘为明显长短边，也不能把某个类别永久命名为长面。
5. Class 11/13/17无保存标尺；Class 8/19各仅一条可用，Class 6/18仅一个采集组。不能从这些记录推断稳定型号尺寸。
6. Class 12/21的约1.91–1.92m长尾共3条，均来自离群后最近中心分配。图像为长横梁/大跨度观察面，先复核分类与面身份，不能直接叫作同型号第二面，也不因偏离主峰就删除。
7. 本轮不推测高度，也不从类别名、目录数字、原自动几何尺寸或标准托盘规格补长宽。标尺已经按米保存，不再次乘scale_to_m。

## 全类别面宽统计

{header}
P10–P90是标注分布，不是精度置信区间。组间均衡为“组内中位数→组中位数”；采集组并不等于独立物理托盘。低风险仅表示未触发部分端点/深度/裁边线索且历史有几何修改，不能证明外边界已完整确认。原类成员、离群后分配、原A子簇、观察面结构建议和域分层见CSV。

## 已检查的双面尺寸案例

| 对号 | F1/F2类别 | F1宽m | F2宽m | 排序后候选L×W m | 状态 |
|---|---|---:|---:|---|---|
'''
    for p in pairs:
        dim=' × '.join(fmt(v) for v in p['reported_dimensions_m']) if p['reported_dimensions_m'] else '不组合'
        report+=f'| {p["pair_id"]} | {p["class_ids"]} | {fmt(p["widths_m"][0])} | {fmt(p["widths_m"][1])} | {dim} | {p["visual_review"]["status"]} |\n'
    report+='\nF1/F2只在本对内有意义，非跨帧持久身份；长短仅对本对两个标尺排序，未对同一物体跨帧去重，不作为型号数量或规格分布。标尺可能受边界缺失、初值继承和轴向待确认影响；尺寸是现有标注候选，非实物计量GT。\n'
    report+='\n## 后续补齐\n为同一托盘/型号登记物体ID、面ID与两面对应关系；复核左右物理边界和标尺宽度，保留缺失/不确定记录。只有明确型号或同物体证据时才汇总长×宽；高度独立测量。原正式划分、标注历史及旧模型包不变。\n'
    (out/'REPORT_zh.md').write_text(report)
    css='''@font-face{font-family:Dims;src:url(assets/report_font.woff)}*{box-sizing:border-box}body{font:15px/1.65 Dims,system-ui;background:#eef3f8;color:#243b53;margin:0}main{max-width:1250px;margin:auto;padding:20px}section,article,header{background:white;border:1px solid #dbe5ef;padding:18px;border-radius:10px;margin-bottom:16px}h1{font-size:26px}h2{font-size:21px}a{color:#076988}table{border-collapse:collapse;width:100%;font-size:13px}th,td{padding:8px;border-bottom:1px solid #e1e8f0;text-align:left}th{background:#eef5fa;white-space:nowrap}.scroll{overflow-x:auto}p,td,code{overflow-wrap:anywhere}.grid{display:grid;grid-template-columns:1fr 1fr;gap:16px}img{max-width:100%;height:250px;object-fit:contain}select,button{font:inherit;padding:7px;margin:5px}small{color:#60748a}.warning{padding:12px;background:#fff3d7;border-left:4px solid #bb8500}.links{display:flex;gap:18px;flex-wrap:wrap}.pair{border-left:4px solid #258373}.pair.rejected{border-left-color:#c9493c}code{font-size:11px}summary{cursor:pointer}.hist{width:100%;height:auto}@media(max-width:650px){main{padding:8px}.grid{grid-template-columns:1fr}h1{font-size:21px}header,section,article{padding:12px}}'''
    def table(headers,rs):return '<div class="scroll"><table><tr>'+''.join('<th>'+escape(str(h))+'</th>' for h in headers)+'</tr>'+''.join('<tr>'+''.join('<td>'+str(v)+'</td>' for v in row)+'</tr>' for row in rs)+'</table></div>'
    full_table=table(['类别','n/组','中位数m','P10–P90 m','组均衡m','低风险修订 n/m','原成员m','重分类m'],[
        [f'<a href="#class-{r["class_id"]}">Class {r["class_id"]}</a>',f'{r["all"]["n"]}/{r["all"]["groups"]}',fmt(r['all']['median_m']),
         fmt(r['all']['p10_m'])+'–'+fmt(r['all']['p90_m']),fmt(r['all']['group_balanced_median_m']),
         str(r['lower_risk_revised']['n'])+'/'+fmt(r['lower_risk_revised']['median_m']),fmt(r['original_members']['median_m']),fmt(r['reassigned_members']['median_m'])] for r in summary])
    sections=[]
    for r in summary:
        cid=r['class_id'];ss=[x for x in records if x['class_id']==cid];(out/'assets'/f'class_{cid:02d}_width.svg').write_text(histogram(ss))
        patterns=[s for s in strata if s['class_id']==cid and s['stratum_field']=='observation_pattern']
        more=[s for s in strata if s['class_id']==cid and s['stratum_field'] in ('original_A','domain')]
        pairrows=opposite[cid]
        sections.append(f'<article id="class-{cid}" data-class="{cid}"><h2>Class {cid} · 单面宽度，不是固定型号尺寸</h2><div class="grid"><div><img class="hist" src="assets/class_{cid:02d}_width.svg" alt="Class {cid} 面宽分布"><p>直方图使用固定0.05m分箱，仅显示分布，不自动把峰值叫作长面/短面。</p></div><div>'+table(['结构观察候选（非面身份）','n/组','中位m','P10–P90 m'],[[escape(s['stratum_value']),f'{s["n"]}/{s["groups"]}',fmt(s['median_m']),fmt(s['p10_m'])+'–'+fmt(s['p90_m'])] for s in patterns])+'</div></div>'+table(['同托盘候选对','本面m','另一面m','另一面类别'],[[f'<a href="#{p["pair_id"]}">{p["pair_id"]}</a>',fmt(p['this_face_width_m']),fmt(p['other_face_width_m']),p['other_face_class']] for p in pairrows])+('<p>尚无本类经图像检查支持的双面配对，长×宽保持未知。</p>' if not pairrows else '<p>上表只针对已查看的具体实例，不推广为本类统一型号。</p>')+'<details><summary>原A子簇与传感器域分层</summary>'+table(['维度','值','n/组','中位m','P10–P90 m'],[[s['stratum_field'],escape(s['stratum_value']),f'{s["n"]}/{s["groups"]}',fmt(s['median_m']),fmt(s['p10_m'])+'–'+fmt(s['p90_m'])] for s in more])+'</details></article>')
    cards=[]
    for p in pairs:
        dim=' × '.join(fmt(v) for v in p['reported_dimensions_m']) if p['reported_dimensions_m'] else '禁止组合/待确认'
        cards.append(f'<article class="pair {"rejected" if not p["reported_dimensions_m"] else ""}" id="{p["pair_id"]}"><h3>{p["pair_id"]} · 类{p["class_ids"]} · {dim} m</h3><p>{escape(p["visual_review"]["note"])}</p><div class="grid"><a href="assets/{p["pair_id"]}_frame.png"><img loading="lazy" src="assets/{p["pair_id"]}_crop.png" alt="{p["pair_id"]} 两个面"></a><div><p>蓝F1：{fmt(p["widths_m"][0])}m；橙F2：{fmt(p["widths_m"][1])}m</p><p>法向锐角 {p["normal_acute_angle_deg"]:.1f}°；端点工作平面间距 {p["nearest_endpoint_workplane_gap_m"]*1000:.1f}mm；局部显示高度差 {p["display_height_center_gap_m"]*1000:.1f}mm（不是叉取高度）</p><p>状态：{escape(p["visual_review"]["status"])}</p><small>F1/F2仅本对有效；尺寸基于草稿标尺，非标准规格/独立计量。</small></div></div><details><summary>身份和质量追溯</summary><p>{escape(p["frame_id"])}</p><code>{escape(json.dumps(dict(keys=p["keys"],quality=p["per_face_quality"]),ensure_ascii=False))}</code></details></article>')
    html=f'''<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>22类托盘面宽与双面尺寸候选</title><style>{css}</style></head><body><main><header><h1>每个面的宽度，与同一托盘的长×宽</h1><p>冻结：{manifest['created_at']} · {len(records)}条米制标尺 · 22类 · {len(candidates)}对几何候选 · 24对图像检查，{len(eligible)}对支持、1对不确定、1对不同堆</p><p class="warning">类别不是型号，面结构候选不是已核实的A/B身份。两个面不能混合平均；不把不同托盘两条宽度拼成尺寸。高度未知，全部保持非机器人指令资格。</p><div class="links"><a href="REPORT_zh.md">中文报告</a><a href="class_width_stats.csv">每类统计CSV</a><a href="per_target_widths.csv">逐目标CSV</a><a href="face_pattern_and_subgroup_stats.csv">分层CSV</a><a href="reviewed_pair_dimensions.csv">双面候选CSV</a></div></header><section><h2>关键证据</h2><p><a href="#P15">P15</a>的两个面同属Class 5，却约为0.997m和1.182m；<a href="#P10">P10</a>两个面分属Class 9、5，约1.001m和1.185m。应分别保存两面，而不是取均值。</p><p><a href="#P11">P11</a>几何近正交且端点接近，但图像显示不同托盘堆，已拒绝合并。未查看的候选不升级为配对尺寸。</p>{full_table}<p>P10–P90为观测分布，非精度置信区间；低风险修订子集仅供敏感性分析，未验证完整物理边界。组均衡减少连续帧重复权重，不把组视为已知独立托盘。</p></section><section><h2>逐类分面证据</h2><label>查看类别 <select id="classFilter"><option value="">全部22类</option>{''.join(f'<option value="{i}">Class {i}</option>' for i in range(1,23))}</select></label><p>结构观察候选继承早期聚类分析，未据宽度自动赋面身份。未识别记录保留unresolved。</p></section><div id="classes">{''.join(sections)}</div><section><h2>24对图像核查</h2><p>仅逐对解释，尚未获得跨帧物理托盘ID或型号标定，不统计为24个独立型号。</p></section>{''.join(cards)}<footer>原始PCD、在线标注、历史、正式划分及旧交付不改写。字体许可见FONT_LICENSE.txt。</footer></main><script>const select=document.getElementById('classFilter');select.onchange=()=>document.querySelectorAll('[data-class]').forEach(a=>a.hidden=!!select.value&&a.dataset.class!==select.value);window.dimensionReportDiagnostics=()=>({{classes:document.querySelectorAll('[data-class]').length,visibleClasses:[...document.querySelectorAll('[data-class]')].filter(a=>!a.hidden).length,pairs:document.querySelectorAll('.pair').length}});</script></body></html>'''
    tail_html='<section><h2>Class 12/21长尾复核</h2><p>'+escape(reviews['long_tail_review']['finding'])+'</p><a href="long_tail_inspection.jpg"><img src="long_tail_inspection.jpg" alt="3条长横梁长尾记录"></a><p><a href="long_tail_review.json">逐目标证据JSON</a></p></section>'
    html=html.replace('<div id="classes">',tail_html+'<div id="classes">')
    report_font(out,html+report);(out/'index.html').write_text(html)
    write_json(out/'results.json',dict(created_at=now(),classes=summary,paired_class_evidence=dict(opposite),
        records=len(records),geometric_candidates=len(candidates),mutual_unambiguous=sum(p['unambiguous_mutual_best'] for p in candidates),
        visually_reviewed=24,visually_supported_candidates=len(eligible),uncertain=1,rejected_different_stacks=1,
        confirmed_physical_specifications=0,height_available=False,no_source_annotations_modified=True,
        code_sha256=digest(__file__),pair_review_sha256=digest(review_path),robot_command_eligible=False))
    print(json.dumps(dict(html=str(out/'index.html'),records=len(records),paired_candidates=len(eligible))),flush=True)


def main():
    parser=argparse.ArgumentParser(description=__doc__);parser.add_argument('--output',type=Path,default=OUT)
    parser.add_argument('--stage',choices=['build','pictures','render'],required=True);a=parser.parse_args()
    {'build':build,'pictures':pictures,'render':render}[a.stage](a.output.resolve())


if __name__=='__main__':main()
