"""Portable reports and offline measured-cloud viewer for mask proposals."""
from __future__ import annotations

from collections import Counter
import csv
import html
import json
from pathlib import Path

import numpy as np

from .cluster_targets import save_json


def write_pilot_report(out,summary,records):
    grids=Counter(f'{r["width"]}×{r["height"]}' for r in records)
    duration=summary['elapsed_this_process_seconds']
    rate=len(records)/max(duration,1.)
    text=f'''# 叉取面提取试跑

完成 {len(records)} 帧，{summary['targets']} 个托盘目标；读取成功状态：{summary['all_selected_read_successfully']}。
图像网格覆盖：{dict(grids)}。重建强度图 {summary['reconstructed_frames']} 帧，180°校正 {summary['rotation_corrected_frames']} 帧。
没有正例训练帧的网格：{summary.get('grids_without_positive_training_frames',[])}。
这些网格在配置冻结后仅补做源数据对应检查，不用于调参。

提取 {summary['selected_faces']} 个待复核可见面；未解决目标 {summary['target_status'].get('unresolved_no_mask',0)} 个。
几何诊断面 {summary['diagnostic_faces']} 个，后层背景面 {summary['rejected_background_faces']} 个。

首次试跑墙钟 {duration:.1f} 秒（包含原始点云哈希、解析、±25%容差敏感性和导出缓存）。
本进程吞吐约 {rate:.3f} 帧/秒；按此保守速度处理10,374帧约 {10374/max(rate,1e-9)/3600:.2f} 小时。
续跑计时不能视为首次吞吐；全量不重复敏感性分析，实际耗时记录在提取日志。

容差敏感性：{json.dumps(summary['pilot_parameter_sensitivity'],ensure_ascii=False)}。
该数值是参数变化下的掩膜一致性，不是相对人工掩膜的准确率。

默认几何配置在完成全部预定试跑帧后冻结。所有掩膜保持自动建议标志，未确认叉取可行性。
'''
    (Path(out)/'pilot_report_zh.md').write_text(text)


def write_cloud_preview(delivery,frame,targets,faces):
    directory=Path(delivery)/'preview_clouds'/frame['split'];directory.mkdir(parents=True,exist_ok=True)
    with np.load(Path(delivery)/frame['cloud'],allow_pickle=False) as z:
        xyz=z['xyz_raw'];assignment=z['face_id']
    chosen=[]
    for fid in sorted(set(assignment.tolist())):
        ids=np.flatnonzero(assignment==fid)
        limit=256 if fid>0 else 512
        if len(ids)>limit:ids=ids[np.linspace(0,len(ids)-1,limit,dtype=int)]
        chosen.extend(ids.tolist())
    ids=np.asarray(chosen,dtype=int)
    points=xyz[ids].astype(float)
    positive=assignment[ids]>0
    support=points[positive] if positive.any() else points
    if len(support):
        center=np.median(support,axis=0);extent=float(np.max(np.ptp(support,axis=0)))
        points=(points-center)/max(extent,1e-8)
    payload={'frame':frame,'targets':targets,'faces':faces,
             'preview_scope':'subsample_for_display_only_full_points_in_npz',
             'points':np.column_stack([np.round(points,5),assignment[ids]]).tolist() if len(ids) else []}
    text='window.forkFrameLoaded('+json.dumps(frame['frame_key'])+','+json.dumps(payload,ensure_ascii=False,allow_nan=False)+');\n'
    path=directory/(frame['frame_key']+'.js')
    if path.exists() and path.read_text()!=text:raise ValueError('Cloud preview modified; refusing overwrite')
    path.write_text(text)


def _csv(path,rows,columns):
    with Path(path).open('w',newline='') as stream:
        writer=csv.DictWriter(stream,fieldnames=columns,extrasaction='ignore');writer.writeheader()
        for row in rows:
            writer.writerow({k:json.dumps(row.get(k),ensure_ascii=False) if isinstance(row.get(k),(dict,list)) else row.get(k) for k in columns})


def write_report(delivery,summary,frames,targets,faces):
    delivery=Path(delivery)
    _csv(delivery/'targets.csv',targets,['target_id','frame_id','split','group_id','domain','box_index','bbox','status',
              'unit_status','scale_to_mm','valid_roi_points','selected_face_count','mask_points','union_mask','cloud','review_reasons'])
    _csv(delivery/'faces.csv',faces,['face_key','target_id','frame_id','split','face_id','status','points','mask_points',
              'plane','plane_raw','geometry_units','unit_status','residual_median','residual_p95','view_normal_cosine',
              'image_vertical_normal_cosine','mask','cloud','reasons'])
    domains=sorted(set(r['domain'] for r in frames))
    rows=[]
    for domain in domains:
        subset=[f for f in frames if f['domain']==domain];subset_targets=[t for t in targets if t['domain']==domain]
        rows.append(f'| {domain} | {len(subset)} | {len(subset_targets)} | {sum(t["status"]=="unresolved_no_mask" for t in subset_targets)} |')
    table='\n'.join(rows)
    residuals=[f['residual_p95'] for f in faces if f['status']=='selected_candidate' and f['geometry_units']=='mm']
    median_residual=f'{np.median(residuals):.3f} mm' if residuals else '无已标尺结果'
    report=f'''# 托盘叉取面点云与掩膜提取报告

已处理 **{summary['frames']:,} 帧、{summary['targets']:,} 个人工托盘框**，生成 **{summary['selected_faces']:,} 个叉取面候选**。
原始检测标签和划分未改写；所有新掩膜是未经人工复核的自动派生标注。

## 结果入口

- [离线图像与可旋转点云图册](gallery.html)
- [逐目标CSV](targets.csv)、[逐面CSV](faces.csv)、[完整目标记录](targets.jsonl)
- [复核清单](review_queue.jsonl)、[逐帧溯源](frames.jsonl)、[统计JSON](summary.json)
- COCO RLE：`annotations/faces_{{train,val,test}}.json`；逐托盘联合掩膜：`annotations/pallets_{{train,val,test}}.json`。
- 完整点云：`clouds/`；二值掩膜：`masks/`；面编号图：`instances/`；冲突像素：`conflicts/`。

## 处理状态

| 项目 | 数量 |
|---|---:|
| 人工确认无托盘的原负例 | {summary['frame_status'].get('confirmed_negative',0)} |
| 有候选掩膜的托盘目标 | {summary['target_status'].get('candidate_needs_review',0)} |
| 尚无可用叉取面掩膜的托盘目标 | {summary['target_status'].get('unresolved_no_mask',0)} |
| 仅作诊断的平面 | {summary['diagnostic_faces']} |
| 识别为孔内或后层背景的平面 | {summary['rejected_background_faces']} |
| 不确定归属的重叠像素 | {summary['conflict_pixels']} |
| 选中面实测点 | {summary['selected_points']:,} |
| 所有框内有效点记录（重叠框可重复） | {summary['roi_points']:,} |
| 重建强度图 | {summary['reconstructed_frames']} |
| 180°校正图 | {summary['rotation_corrected_frames']} |

单位状态：`{json.dumps(summary['unit_status'],ensure_ascii=False)}`。
已换算到毫米的候选面，其逐面P95残差的中位数为 **{median_residual}**。
残差只描述几何拟合，不证明这个面一定是可叉取面。

| 配置域 | 帧 | 托盘框 | 无掩膜目标 |
|---|---:|---:|---:|
{table}

## 方法与边界

读取原始PCD，按冻结网格恢复排列，通过原生强度与浮点传感器张量核验逐像素对应。
180°校正只重排点索引，XYZ保留原坐标。点云不因强度为零而删除有效XYZ。
不使用SAM3掩膜或旧采样点云裁定叉取面。

使用8邻域、局部点间距与法向约束聚类；法向来自排除三维跳变的5×5邻域PCA，XYZ不平滑或替换。
固定种子的RANSAC提议平面，SVD在完整内点上精修。
默认邻接距离为点间距3倍，法向夹角25°；平面容差为点间距0.5倍，已知尺度时限制2–20 mm。
最终面至少32点。跨开口共面片段可以合并，托盘之间不合并。
参考：[PCL区域生长](https://pointclouds.org/documentation/tutorials/region_growing_segmentation.html)、
[PCL平面拟合](https://pointclouds.org/documentation/tutorials/planar_segmentation.html)。

共面片段的凸包只作为判定后层背景的二维支撑，**不填充输出掩膜**。
输出像素来自原始实测点；保留叉孔、遮挡及缺测空洞。可能的顶面/地面保留为诊断，
该图像方向规则不是已标定的重力方向。斜视、非平面、细小结构及深度边缘噪声可能使提取不足。
无法区分的叉取面身份进入复核；所有目标仍记录 `forkability_not_confirmed`。

训练集256帧进行了容差±25%敏感性试跑：
`{json.dumps(summary['pilot_parameter_sensitivity'],ensure_ascii=False)}`。
这属于参数敏感性，不是人工参考准确率，也不是检测AP。
未进行分割模型训练或最终测试评分。

## 使用标注

`cloud.npz`字段：`xyz_raw[N,3]`、`intensity[N]`、`uv[N,2]`（u/v原图整数索引）、
`source_point_index[N]`、`parent_box_index[N]`、`face_id[N]`、`diagnostic_plane_id[N]`。
`face_id>0`对应同帧面编号；0为未选中点，-1为归属冲突。强度缺失可为NaN，不改变有效XYZ资格。
`plane_raw`对应原始XYZ单位，`plane`使用该面记录的`geometry_units`。
编号图0背景，其他值对应逐面记录；掩膜为0/255，不按类别填满托盘框。

所有新分割记录设 `proposal_only=true`、`mask_human_reviewed=false`。
正例的分割训练资格均为false，必须完成掩膜复核后建立新快照；无掩膜正例不能当作负例。
原人工负例独立保留，不代表生成的叉取面已获人工确认。

打开图册可筛选划分、配置域及未解决状态，查看原图、叠图和点云；点云预览进行了显示采样，
完整结果以NPZ为准。所有文件使用相对路径，包内不含原始PCD或历史模型。

验证结果见 `validation.json`，校验命令：`sha256sum -c checksums.sha256`。
'''
    (delivery/'report_zh.md').write_text(report)
    (delivery/'README_zh.md').write_text('# 叉取面候选掩膜数据\n\n先打开 [报告](report_zh.html) 或 [图册](gallery.html)。\n\n'+
        '全部掩膜待人工复核，正例提取失败不构成负例。原检测标签和划分保留。\n\n'+
        '核验：`sha256sum -c checksums.sha256`。完整点云位于clouds/，面编号图位于instances/，COCO RLE位于annotations/。\n')
    from markdown_it import MarkdownIt
    rendered=MarkdownIt('commonmark').enable('table').render(report)
    (delivery/'report_zh.html').write_text('<!doctype html><html lang="zh-CN"><meta charset="utf-8"><title>叉取面提取报告</title>'+STYLE+
        '<body><main>'+rendered+'</main></body></html>')
    target_counts=Counter(t['frame_id'] for t in targets)
    unresolved_counts=Counter(t['frame_id'] for t in targets if t['status']=='unresolved_no_mask')
    index=[{k:f[k] for k in ('frame_id','frame_key','split','group_id','domain','image','overlay','frame_status','selected_face_count')}
           |{'targets':target_counts[f['frame_id']], 'unresolved_targets':unresolved_counts[f['frame_id']]} for f in frames]
    (delivery/'gallery_data.js').write_text('window.FORK_FRAMES='+json.dumps(index,ensure_ascii=False)+';\n')
    (delivery/'gallery.html').write_text(GALLERY.replace('__SUMMARY__',html.escape(f'{summary["frames"]:,}帧 · {summary["targets"]:,}托盘框 · {summary["selected_faces"]:,}候选面')))


STYLE='''<style>body{margin:0;background:#f1f5f9;color:#172b40;font:16px/1.6 system-ui,sans-serif}main{max-width:1150px;margin:auto;padding:28px}h1{font-size:28px}h2{font-size:22px;margin-top:30px}a{color:#146d9b}table{border-collapse:collapse;background:white;width:100%}td,th{padding:8px 12px;border:1px solid #dae2eb;text-align:left}code{font-size:13px;overflow-wrap:anywhere}button,select,input{font:inherit;padding:7px;border:1px solid #bacbd9;border-radius:5px}button{cursor:pointer}.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(270px,1fr));gap:14px}.card{background:white;border-radius:8px;padding:12px;border:1px solid #cedbe6;cursor:pointer}.card img{width:100%;height:170px;object-fit:contain;background:#1d2d3a}.card small{display:block;overflow-wrap:anywhere}.filters{display:flex;gap:10px;flex-wrap:wrap;position:sticky;top:0;background:#f1f5f9;padding:12px 0}dialog{width:min(1250px,94vw);max-height:94vh;border:0;border-radius:10px;padding:22px}dialog::backdrop{background:#142737aa}.viewer{display:grid;grid-template-columns:1fr 1fr;gap:16px}.viewer img{max-width:100%;max-height:410px;object-fit:contain;background:#152534}canvas{width:100%;height:410px;background:#122b3d;touch-action:none}pre{white-space:pre-wrap;word-break:break-all;font-size:12px;max-height:300px;overflow:auto;background:#f1f5f9;padding:12px}.notice{background:#fff1cc;padding:12px;border-radius:8px}@media(max-width:750px){.viewer{grid-template-columns:1fr}} </style>'''


GALLERY='''<!doctype html><html lang="zh-CN"><meta charset="utf-8"><title>叉取面掩膜与点云图册</title>'''+STYLE+'''
<body><main><h1>叉取面掩膜与点云图册</h1><p>__SUMMARY__ · <a href="report_zh.html">中文报告</a></p>
<p class="notice">全部掩膜待人工复核；点云预览采样仅供显示。叉孔、缺测与遮挡不补全。几何平面不等于已确认可叉取面。</p>
<div class="filters"><select id="split"><option value="">全部划分</option><option>train</option><option>val</option><option>test</option></select><select id="domain"><option value="">全部配置域</option></select><select id="status"><option value="">全部状态</option><option value="candidate_needs_review">有候选掩膜</option><option value="unresolved_positive">正例无掩膜</option><option value="confirmed_negative">原人工负例</option></select><label><input type="checkbox" id="unresolved">含未解决目标</label><input id="search" placeholder="帧/采集组搜索"></div>
<p><button id="prev">上一页</button> <span id="count"></span> <button id="next">下一页</button></p><div id="cards" class="grid"></div>
<dialog id="detail"><button id="close" style="float:right">关闭</button><h2 id="title"></h2><p id="state"></p><div class="viewer"><section><p><label><input type="checkbox" id="original">显示原始强度图</label> <a id="imageLink" target="_blank">打开原图</a></p><img id="image" alt="强度图与掩膜"><p><a id="cloudLink">完整点云NPZ</a></p></section><section><p><label><input type="checkbox" id="showExcluded">显示诊断/未选中点</label> · 拖动旋转，滚轮缩放</p><canvas id="cloud" width="720" height="500"></canvas></section></div><h3>父托盘框、各面及复核原因</h3><pre id="metadata"></pre></dialog>
<script src="gallery_data.js"></script><script>
const $=id=>document.getElementById(id);let page=0,filtered=[],current=null,points=[],yaw=.3,pitch=-.15,zoom=1;const cache={};
function esc(s){return String(s).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]))}
for(const d of [...new Set(FORK_FRAMES.map(r=>r.domain))].sort()){$('domain').add(new Option(d,d))}
function render(){const term=$('search').value.toLowerCase();filtered=FORK_FRAMES.filter(r=>(!$('split').value||r.split===$('split').value)&&(!$('domain').value||r.domain===$('domain').value)&&(!$('status').value||r.frame_status===$('status').value)&&(!$('unresolved').checked||r.unresolved_targets)&&(!term||(r.frame_id+' '+r.group_id).toLowerCase().includes(term)));page=Math.min(page,Math.max(0,Math.ceil(filtered.length/48)-1));$('count').textContent=`${filtered.length}帧 · ${page+1}/${Math.max(1,Math.ceil(filtered.length/48))}页`;$('prev').disabled=page===0;$('next').disabled=(page+1)*48>=filtered.length;$('cards').innerHTML=filtered.slice(page*48,(page+1)*48).map(r=>`<article class="card" data-key="${esc(r.frame_key)}"><img loading="lazy" src="${esc(r.overlay)}"><b>${r.split} · ${r.targets}托盘 · ${r.selected_face_count}候选面</b><small>${esc(r.frame_id)}</small><small>${esc(r.domain)} · 未解决目标${r.unresolved_targets}</small></article>`).join('');for(const card of $('cards').children)card.onclick=()=>openFrame(FORK_FRAMES.find(r=>r.frame_key===card.dataset.key))}
for(const id of ['split','domain','status','unresolved','search'])$(id).oninput=()=>{page=0;render()};$('prev').onclick=()=>{page--;render()};$('next').onclick=()=>{page++;render()};$('close').onclick=()=>$('detail').close();
function displayImage(){$('image').src=$('original').checked?current.image:current.overlay} $('original').onchange=displayImage;
window.forkFrameLoaded=(key,data)=>{cache[key]=data;if(current&&current.frame_key===key){points=data.points;$('metadata').textContent=JSON.stringify({targets:data.targets,faces:data.faces,preview:data.preview_scope},null,2);draw()}};
function openFrame(r){current=r;points=[];yaw=.3;pitch=-.15;zoom=1;$('title').textContent=r.frame_id;$('state').textContent=`${r.domain} · ${r.split} · ${r.frame_status}`;$('imageLink').href=r.image;$('cloudLink').href=`clouds/${r.split}/${r.frame_key}.npz`;displayImage();$('metadata').textContent='加载点云与逐面记录…';$('detail').showModal();draw();if(cache[r.frame_key]){forkFrameLoaded(r.frame_key,cache[r.frame_key]);return}const script=document.createElement('script');script.src=`preview_clouds/${r.split}/${r.frame_key}.js`;script.onerror=()=>{$('metadata').textContent='点云预览加载失败，请核验包完整性。'};document.body.append(script)}
function color(id){return id<0?'#ff4545':id===0?'#8d9caa':`rgb(${(id*139)%180+60},${(id*103)%180+60},${(id*67)%180+60})`}
function draw(){const c=$('cloud'),ctx=c.getContext('2d');ctx.fillStyle='#122b3d';ctx.fillRect(0,0,c.width,c.height);let cloud=points.filter(p=>p[3]>0||$('showExcluded').checked);const cy=Math.cos(yaw),sy=Math.sin(yaw),cp=Math.cos(pitch),sp=Math.sin(pitch);const projected=cloud.map(p=>{const x=p[0]*cy+p[2]*sy,z=-p[0]*sy+p[2]*cy,y=p[1]*cp-z*sp,depth=p[1]*sp+z*cp;return {x:c.width/2+x*330*zoom,y:c.height/2-y*330*zoom,z:depth,id:p[3]}}).sort((a,b)=>a.z-b.z);for(const p of projected){ctx.fillStyle=color(p.id);ctx.fillRect(p.x,p.y,2.5,2.5)}ctx.fillStyle='white';ctx.fillText(`${cloud.length}显示点 · 完整点云见NPZ`,12,22)}$('showExcluded').onchange=draw;
let drag=null;$('cloud').onpointerdown=e=>{drag=[e.clientX,e.clientY];$('cloud').setPointerCapture(e.pointerId)};$('cloud').onpointermove=e=>{if(!drag)return;yaw+=(e.clientX-drag[0])*.01;pitch+=(e.clientY-drag[1])*.01;drag=[e.clientX,e.clientY];draw()};$('cloud').onpointerup=()=>drag=null;$('cloud').onwheel=e=>{e.preventDefault();zoom=Math.min(6,Math.max(.1,zoom*Math.exp(-e.deltaY*.001)));draw()};render();
</script></main></body></html>'''
