"""Offline, native-mask gallery and measured training report for face completion."""
from __future__ import annotations

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

import numpy as np
from PIL import Image, ImageDraw

from pallet.fork_face_anylabeling import protected_write
from pallet.instance_segmentation_seed import digest, encoded, native_image, read_json, read_jsonl


STYLE = '''@font-face{font-family:SeedSans;src:url(assets/AnnotationSeedSans.woff)}
*{box-sizing:border-box}body{margin:0;font:16px/1.75 SeedSans,"Noto Sans CJK SC",sans-serif;background:#f3f5f8;color:#243247}
main{max-width:1100px;margin:auto;padding:40px 28px}h1{font-size:32px;line-height:1.35}h2{margin-top:36px;color:#12395a}
a{color:#145d94}table{border-collapse:collapse;width:100%;display:block;overflow:auto;background:white}
th,td{padding:10px 12px;border:1px solid #dce3ec;text-align:left}pre{background:#e5eaf2;padding:16px;overflow:auto}
img{max-width:100%;height:auto}blockquote{border-left:4px solid #eab764;padding-left:18px}code{overflow-wrap:anywhere}
.banner{background:#143c59;color:white;border-radius:16px;padding:20px 24px}'''


def write_csv(path, rows, fields):
    buffer = io.StringIO(newline='')
    writer = csv.DictWriter(buffer, fieldnames=fields, extrasaction='ignore')
    writer.writeheader()
    for row in rows:
        writer.writerow({k: json.dumps(v, ensure_ascii=False) if isinstance(v, (dict, list)) else v
                         for k, v in row.items()})
    protected_write(path, buffer.getvalue().encode('utf-8-sig'))


def training_history(ctx, kind):
    with (ctx['output']/f'training/{kind}/metrics.csv').open() as stream:
        rows = list(csv.DictReader(stream))
    result = {}
    for row in rows:
        epoch = int(float(row['epoch'])) + 1
        values = result.setdefault(epoch, {})
        for key in ('train/loss', 'val/loss', 'val/ema_segm_mAP_50_95', 'val/segm_mAP_50_95'):
            if row.get(key): values[key] = float(row[key])
    return result


def curves(ctx, delivery):
    import matplotlib
    matplotlib.use('Agg')
    matplotlib.rcParams['svg.hashsalt']='pallet-face-seed-v1'
    import matplotlib.pyplot as plt
    figure, axes = plt.subplots(1, 2, figsize=(11, 4), constrained_layout=True)
    histories = {}
    for kind, color in [('small', '#138e89'), ('medium', '#6578db')]:
        history = training_history(ctx, kind); histories[kind] = history
        for key, label, axis in [('val/ema_segm_mAP_50_95', kind+' EMA', axes[0]),
                                 ('train/loss', kind+' train', axes[1])]:
            points = [(e, v[key]) for e, v in sorted(history.items()) if key in v]
            if points: axis.plot(*zip(*points), color=color, label=label)
        points = [(e, v['val/loss']) for e, v in sorted(history.items()) if 'val/loss' in v]
        if points: axes[1].plot(*zip(*points), color=color, linestyle='--', label=kind+' validation')
    for axis in axes:
        axis.set_xlabel('Epoch'); axis.grid(alpha=.2); axis.legend()
    axes[0].set_ylabel('Mask AP 50:95 (internal validation)'); axes[1].set_ylabel('Loss')
    buffer = io.BytesIO(); figure.savefig(buffer, format='svg',metadata={'Date':None}); plt.close(figure)
    protected_write(delivery/'training_curves.svg', buffer.getvalue())
    return histories


def preview(ctx, record, delivery):
    image = Image.open(io.BytesIO(native_image(ctx, record['frame_key']))).convert('RGB')
    array = np.array(image, dtype=float)
    for face in record['faces']:
        mask = np.asarray(Image.open(ctx['output']/face['mask'])) > 0
        color = [54, 213, 151] if face['source']=='human' else ([255, 176, 67] if face['low_confidence'] else [69, 168, 255])
        array[mask] = .56*array[mask] + .44*np.asarray(color)
        from pallet.instance_segmentation_completion import closed_holes
        holes = closed_holes(mask)
        array[holes] = .5*array[holes] + .5*np.array([230, 80, 180])
    rendered = Image.fromarray(array.astype(np.uint8)); draw = ImageDraw.Draw(rendered)
    box=record['original_parent_bbox']
    if isinstance(box,dict):
        corners=(box['x'],box['y'],box['x']+box['width'],box['y']+box['height'])
    else:
        x,y,w,h=box;corners=(x,y,x+w,y+h)
    draw.rectangle(corners, outline='#f7df7c', width=max(1, image.width//350))
    width = max(640, min(1024, image.width))
    rendered = rendered.resize((width, round(width*image.height/image.width)), Image.Resampling.NEAREST)
    buffer=io.BytesIO(); rendered.save(buffer,format='PNG')
    protected_write(delivery/f'previews/{record["frame_key"]}.png',buffer.getvalue())


GALLERY = r'''<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>440 托盘 · 逐面分割复核图册</title><style>__STYLE__
main{max-width:1500px}header{display:flex;justify-content:space-between;gap:20px;align-items:center}.filters{display:flex;gap:12px;flex-wrap:wrap;margin:24px 0}
select,input,button{font:inherit;padding:8px 12px;border:1px solid #c7d4e3;border-radius:8px;background:white}
#grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(290px,1fr));gap:20px}.card{background:white;border:1px solid #dce3ec;border-radius:12px;overflow:hidden;cursor:pointer}
.card img{width:100%;height:190px;object-fit:contain;background:#111b25;image-rendering:pixelated}.info{padding:12px 16px}.tag{color:#486680;font-size:14px}
.pages{display:flex;justify-content:center;gap:18px;align-items:center;margin:30px 0}dialog{border:0;border-radius:14px;width:min(1100px,96vw);max-height:94vh;padding:24px}
dialog::backdrop{background:#061428bb}dialog img{width:100%;max-height:65vh;object-fit:contain;background:#111b25;image-rendering:pixelated}.detail-controls{display:flex;gap:14px;flex-wrap:wrap;align-items:center}
#detailtext{white-space:pre-wrap;overflow-wrap:anywhere}.legend{font-size:14px;color:#577088}.empty{padding:50px}</style>
<main><header><div><h1>逐面分割 · 440 托盘复核图册</h1><p>每个面独立实例；人工轮廓保留，机器轮廓待复核。</p></div><a href="report_zh.html">训练与结果报告 ↗</a></header>
<div class="banner">__SUMMARY__</div><p class="legend">绿色：人工面　蓝色：机器面　橙色：低置信面　粉色：闭合孔洞　黄色框：原父托盘定位（仅图册参考）</p>
<div class="filters"><select id="cluster" aria-label="A 类"><option value="">全部 A 类</option></select>
<select id="split" aria-label="原划分"><option value="">全部原划分</option><option>train</option><option>val</option><option>test</option></select>
<select id="state" aria-label="复核状态"><option value="">全部复核状态</option><option value="human">人工保留</option><option value="model">机器补标</option><option value="low">低置信</option><option value="missing">待补画</option><option value="quarantine">返回标注有歧义</option><option value="holes">包含孔洞</option><option value="multiple">多个面</option></select>
<input id="search" placeholder="搜索帧 ID / 目标 ID" aria-label="搜索"><span id="count"></span></div><div id="grid"></div>
<div class="pages"><button id="prev">上一页</button><span id="page"></span><button id="next">下一页</button></div></main>
<dialog id="detail"><div class="detail-controls"><button id="close">关闭</button><button id="toggle">查看原图</button><a id="pnglink" download>原生 PNG</a><a id="jsonlink" download>AnyLabeling JSON</a></div><h2 id="detailtitle"></h2><img id="detailimage" alt="原尺寸托盘与逐面掩膜"><p id="detailtext"></p></dialog>
<script>const rows=__DATA__;const $=id=>document.getElementById(id);let page=0,active=null,raw=false;const perPage=36;
for(const c of [...new Set(rows.map(r=>r.appearance_class))].sort()){const o=document.createElement('option');o.value=o.textContent=c;$('cluster').append(o)}
function filtered(){return rows.filter(r=>(!$('cluster').value||r.appearance_class===$('cluster').value)&&(!$('split').value||r.original_split===$('split').value)&&(! $('search').value||[r.frame_key,r.target_id].join(' ').includes($('search').value.trim()))&&({human:r.human_faces>0,model:r.model_faces>0,low:r.low_confidence_faces>0,missing:r.face_instances===0,quarantine:r.quarantined_return,holes:r.has_holes,multiple:r.face_instances>1}[$('state').value]??true))}
function render(){const list=filtered();page=Math.min(page,Math.max(0,Math.ceil(list.length/perPage)-1));$('grid').replaceChildren();$('count').textContent=`${list.length} 个目标`;
for(const r of list.slice(page*perPage,(page+1)*perPage)){const card=document.createElement('article');card.className='card';const img=document.createElement('img');img.src=`previews/${r.frame_key}.png`;img.alt=`${r.appearance_class} ${r.frame_key}`;img.loading='lazy';const info=document.createElement('div');info.className='info';const title=document.createElement('b');title.textContent=`${r.appearance_class} · ${r.original_split} · ${r.face_instances} 个面`;const status=document.createElement('div');status.className='tag';status.textContent=`人工 ${r.human_faces} / 机器 ${r.model_faces} / 低置信 ${r.low_confidence_faces}${r.has_holes?' · 孔洞':''}${r.face_instances?'':' · 待补画'}`;const id=document.createElement('small');id.textContent=r.frame_key;info.append(title,status,id);card.append(img,info);card.onclick=()=>open(r);$('grid').append(card)}
if(!list.length){const e=document.createElement('p');e.textContent='没有符合条件的目标';e.className='empty';$('grid').append(e)}$('page').textContent=`${page+1} / ${Math.max(1,Math.ceil(list.length/perPage))}`;$('prev').disabled=page===0;$('next').disabled=(page+1)*perPage>=list.length}
function image(){ $('detailimage').src=raw?`${active.frame_key}.png`:`previews/${active.frame_key}.png`;$('toggle').textContent=raw?'查看掩膜叠图':'查看原图'}
function open(r){active=r;raw=false;image();$('detailtitle').textContent=`${r.appearance_class} · ${r.frame_key}`;$('pnglink').href=`${r.frame_key}.png`;$('jsonlink').href=`${r.frame_key}.json`;$('detailtext').textContent=`父托盘：${r.target_id}\n采集组：${r.group_id}\n配置域：${r.domain}\n原划分：${r.original_split}\n状态：${r.face_instances?'已提供分割；机器面须人工复核':'待补画正例，不能作为负例'}\n${r.faces.map(f=>`面 ${f.group_id}：${f.source==='human'?'人工':'机器'}，分数 ${f.score.toFixed(3)}，独立框 ${JSON.stringify(f.face_bbox)}${f.low_confidence?'，低置信':''}`).join('\n')}`;$('detail').showModal()}
for(const id of ['cluster','split','state','search'])$(id).addEventListener(id==='search'?'input':'change',()=>{page=0;render()});$('prev').onclick=()=>{page--;render()};$('next').onclick=()=>{page++;render()};$('close').onclick=()=>$('detail').close();$('toggle').onclick=()=>{raw=!raw;image()};render();</script></html>'''


def report(ctx, public, summary):
    from markdown_it import MarkdownIt
    delivery=ctx['output']/'delivery'; audit=read_json(ctx['output']/'audit/summary.json')
    manifest=read_json(ctx['output']/'dataset_manifest.json'); selection=read_json(ctx['output']/'model_selection.json')
    histories=curves(ctx,delivery)
    protected_write(delivery/'assets/FONT_LICENSE.txt',(Path(__file__).parent/'assets/FONT_LICENSE.txt').read_bytes())
    records=read_json(ctx['output']/'prediction_index.json'); rowmap={r['target_id']:r for r in ctx['rows']}
    allfaces=read_jsonl(delivery/'faces.jsonl'); faces_by_frame={}
    for f in allfaces: faces_by_frame.setdefault(f['frame_key'],[]).append(f)
    enriched=[]
    for record,item in zip(records,public):
        source=source_for_report(ctx,record['frame_key']); row=rowmap[record['target_id']]
        faces=faces_by_frame.get(record['frame_key'],[])
        enriched.append({**item,'group_id':row['group_id'],'domain':source['pallet_export']['domain'],
                         'original_split':source['pallet_annotation_task']['original_split'],
                         'has_holes':any(f['closed_hole_pixels'] for f in faces),'faces':faces})
        preview(ctx,record,delivery)
    write_csv(delivery/'targets.csv',enriched,['frame_key','frame_id','target_id','appearance_class','original_split',
        'group_id','domain','face_instances','human_faces','model_faces','low_confidence_faces','has_holes',
        'state','quarantined_return','original_parent_bbox'])
    write_csv(delivery/'faces.csv',allfaces,['frame_key','instance_id','group_id','parent_target_id','source','score',
        'low_confidence','face_bbox','parent_bbox','mask_pixels','closed_hole_pixels','mask_human_reviewed'])
    quarantined=[f for f in read_json(ctx['output']/'audit/frames.json') if f['state']=='quarantined']
    protected_write(delivery/'ambiguities.jsonl',b''.join(encoded(f) for f in quarantined))
    protected_write(delivery/'low_confidence.jsonl',b''.join(encoded(f) for f in allfaces if f['low_confidence']))
    protected_write(delivery/'unresolved.jsonl',b''.join(encoded(r) for r in enriched if not r['face_instances']))
    columns=['模型','完成轮数 / 最佳轮','mask AP50:95','AP50','匹配掩膜 IoU','孔洞背景 IoU','失败面数','训练分钟','峰值显存 GiB']
    table=['| '+' | '.join(columns)+' |','|'+'---|'*len(columns)]
    for m in selection['comparisons']:
        completion=read_json(ctx['output']/f'training/{m["model"]}/completion.json')
        history=histories[m['model']]
        best_epoch=max((e for e in history if 'val/ema_segm_mAP_50_95' in history[e]),
                       key=lambda e:history[e]['val/ema_segm_mAP_50_95'])
        table.append('| '+ ' | '.join([m['model'].title(),f'{max(history)} / {best_epoch}',
            f'{m["mask_ap_50_95"]:.4f}',f'{m["mask_ap_50"]:.4f}',f'{m["matched_mask_iou"]:.4f}',
            f'{m["hole_background_iou"]:.4f}' if m['hole_background_iou'] is not None else '缺测',
            str(m['failed_gt_instances']),f'{m["training_elapsed_seconds"]/60:.1f}',
            f'{m["peak_cuda_memory_bytes"]/2**30:.2f}'])+' |')
    train,valid=manifest['split_counts']['train'],manifest['split_counts']['valid']
    source_counts=Counter(r['original_split'] for r in enriched)
    domain_counts=Counter(r['domain'] for r in enriched)
    lines=['# 人工种子集训练与 440 托盘逐面补标报告','',
        f'已使用实际人工多边形构建最小数据集，并完成 RF-DETR-Seg Small 与 Medium 的训练。内部验证选中 **{selection["model"].title()}**，常规置信阈值为 **{selection["threshold"]:.2f}**。','',
        f'交付覆盖 **{summary["frames"]} 张原生图像、{summary["selected_targets"]} 个入选托盘**，共 **{summary["face_instances"]} 个面实例**：人工保留 {summary["human_faces"]} 面，机器补标 {summary["model_faces"]} 面，其中低置信 {summary["low_confidence_faces"]} 面；**{summary["targets_without_mask"]} 个目标仍待补画**。','',
        '[打开离线掩膜图册](gallery.html)。440 组 PNG/JSON 全部平铺在本目录，可直接用 AnyLabeling 打开；A 编号只作为抽样属性。','',
        '## 实例与孔洞语义','',
        '一个可见叉取面对应一个 group_id 和唯一 instance_id。同托盘双面分别保留。每个面框由自身掩膜计算，采用原生像素的 `[x, y, width, height]`；原托盘框只在 `pallet_segmentation.original_parent_bbox` 中定位，不是标注形状。','',
        '所有形状均为 polygon。`pallet` 同组正轮廓并集减去 `__hole__` 同组孔洞并集，得到该面的掩膜。孔洞不是类别或实例；闭合孔洞与外部开口分别处理。机器掩膜的多个正轮廓片段仍属于同一个面，不能按片段数统计实例。人工轮廓坐标未简化或重画。','',
        '## 人工输入审计与划分','',
        f'返回 ZIP 共 {audit["returned_frames"]} 份 JSON；审计通过 {audit["manual_accepted"]} 帧、{audit["accepted_instances"]} 面、{audit["accepted_holes"]} 孔洞、{audit["accepted_groups"]} 个采集组。嵌套/大量重叠歧义 {audit["quarantined"]} 帧整帧隔离；仅矩形 {audit["no_mask_not_negative"]} 帧不用于分割训练或负例。原件保存在训练包 inputs 中。旧的导出状态字段未作为训练资格依据。','',
        f'按采集组 seed=42 划分：训练 {train["frames"]} 帧 / {train["instances"]} 面 / {train["groups"]} 组；验证 {valid["frames"]} 帧 / {valid["instances"]} 面 / {valid["groups"]} 组。组比例接近 80%/20%，受组大小约束帧数比例不同；验证至少含两个有孔洞采集组，各配置域保留训练覆盖。增强跟随原组。','',
        '训练 COCO 采用压缩 RLE，原生二值面/孔洞掩膜另存。面框从扣孔后的掩膜计算。图像保持比例补边至 768×768，强度复制三通道；原生图像尺寸、旋转和像素不变。','',
        '隔离文件：','',*[f'- `{f["frame_key"]}.json`：'+ '; '.join(f['reasons']) for f in quarantined],'',
        '## 模型调研与本机选择','',
        '| 模型 | 预训练与数据接口 | 孔洞支持 | 本机适配与本轮选择 |','|---|---|---|---|',
        '| RF-DETR-Seg | DINOv2 骨干、官方 COCO 分割权重；COCO 标注 | 本地 1.11.0 加载器直接解码 RLE，孔洞作为背景监督 | 当前 PyTorch 2.6 环境可训练；实际比较 Small / Medium |',
        '| YOLO26-Seg | 官方 COCO 预训练；常规 YOLO 分割文本为逐实例多边形坐标 | 常规单行多边形格式没有本任务的同组减孔语义，需要改造加载与监督 | 可作速度基线；本轮未训练，避免通过填孔改变人工监督 |',
        '| SAM3 | Meta 官方概念/交互分割预训练；提供推理及微调代码 | 输出稠密掩膜能包含孔洞，任务数据需适配其微调管线 | 官方要求 Python≥3.12、PyTorch≥2.7、CUDA≥12.6；本机当前版本不同，本轮不改动既有 SAM 推理环境 |','',
        '依据：[RF-DETR 分割官方说明](https://rfdetr.roboflow.com/latest/learn/run/segmentation/)、[官方 COCO 加载器](https://github.com/roboflow/rf-detr/blob/develop/src/rfdetr/datasets/coco.py)、[YOLO26 模型说明](https://docs.ultralytics.com/models/yolo26/)、[YOLO 分割数据格式](https://docs.ultralytics.com/datasets/segment/)、[SAM3 官方仓库](https://github.com/facebookresearch/sam3)。本报告记录实际适配结果，不把公开 COCO 成绩当成本数据精度。','',
        '## 实际训练与选优','',
        '固定 `rfdetr==1.11.0` 和官方对应预训练权重。两模型保持相同组划分、768 分辨率、学习率 1e-4、编码器学习率 1e-5、有效 batch=8（初始 batch=2 / 累积4）、EMA、最多150轮、早停耐心30。关闭随机裁剪、多尺度和比例抖动，仅水平翻转。Small 在 16GB 卡，Medium 在 24GB 卡；训练日志、精确设备、实际 batch 与依赖版本保存在训练包。','',
        *table,'', '![训练曲线](training_curves.svg)','',
        '以上均为参与模型选择的内部验证结果，不能作为独立测试成绩。AP 采用相同交付推理及重复抑制后的 COCO mask AP；官方训练曲线是 EMA 验证指标，后处理不同可使曲线最佳值与此表不同。','',
        '匹配掩膜 IoU：在校准阈值下按原生掩膜 Hungarian 匹配，缺失实例记0；失败面指匹配 IoU<0.5 或未匹配。孔洞背景 IoU：对有人工孔洞的验证面，比较其孔洞掩膜与匹配预测的闭合孔洞，缺失记0。阈值按 IoU≥0.5 的实例 F1 校准。选优依次按 AP、孔洞 IoU、掩膜 IoU、训练耗时。','',
        ('**孔洞恢复限制：选优模型的内部验证孔洞背景 IoU 低于 0.1，未可靠学会闭合孔洞。机器建议需重点复核叉孔、细边界与相邻托盘；自动导出仅保留预测实际产生的孔洞，不使用人工孔洞位置或矩形伪造机器结果。**' if next(m for m in selection['comparisons'] if m['model']==selection['model'])['hole_background_iou'] is not None and next(m for m in selection['comparisons'] if m['model']==selection['model'])['hole_background_iou']<.1 else '孔洞质量应与表中掩膜质量分别评估；机器面仍需人工复核。'),'',
        '## 补标规则与复核','',
        '清晰人工面先根据原父框覆盖关系归属；相邻侧面需水平邻接、纵向范围相符且不优先归属其他托盘。未获得可归属人工面的入选托盘采用选优模型整帧推理，失败后扩大父框上下文重试，再映射回原生坐标。相同面的重复预测抑制，不同面不合并。','',
        '常规候选须达到校准阈值。没有常规候选时保留最高分、空间匹配且非空的低置信面并标记；完全无有效掩膜的目标保持待补画正例，JSON 可无形状，不能当作负例。机器结果始终未人工复核，训练资格为 false。返回标注有歧义的帧在图册中提示，不自动修正原标注。','',
        f'原来源划分：train {source_counts["train"]}、val {source_counts["val"]}、test {source_counts["test"]}。同帧非入选托盘的清晰人工面用于训练，但不加入最终入选目标交付。此次参与种子集训练的原 val/test 帧不能继续作为独立分割测试依据。','',
        '复核入口：`review_queue.jsonl`、`low_confidence.jsonl`、`unresolved.jsonl`、`ambiguities.jsonl`；图册可按 A 类、原划分、孔洞、双面和复核状态筛选。后续人工修改后，应以 JSON 的同组正轮廓减孔洞重建标签，明确标记复核状态，再重新训练。未标注的同帧其他托盘需要忽略策略，另留独立分割评估数据。','',
        '## 可复现记录与验收','',
        '入口：','', '```bash','python -m pallet.instance_segmentation_seed --stage all --seed 42','```','',
        '支持 audit/build/train/select/predict/export/verify/package/all；已有内容使用哈希保护，发现人工 JSON 修改或冻结结果变化拒绝覆盖。训练包含 COCO 数据、原生面/孔洞掩膜、原始返回 ZIP/JSON、采集组划分、两模型最佳权重、训练配置与曲线原始 CSV、依赖及源码哈希、模型选择结果。试运行和设备编号修正日志单独保留，最终比较仅用正确设备的完整训练。','',
        '检查包括 RLE 与二值掩膜像素一致、孔洞扣除、无矩形监督、采集组无泄漏、440目标及实例身份唯一、PNG原件一致、官方固定版本 AnyLabeling JSON 读取/保存、同组掩膜回栅格一致、面框独立计算，以及正式标签/冻结源哈希未变。验证结果见 `validation.json`，ZIP 校验结果和 SHA-256 见上级交付清单；AnyLabeling 桌面 GUI 不在自动测试范围内。','',
        f'输入 ZIP SHA-256：`{digest(ctx["archive"])}`。','',
        '| 配置域 | 入选目标数 |','|---|---:|',*[f'| {domain} | {count} |' for domain,count in sorted(domain_counts.items())], '']
    markdown='\n'.join(lines); protected_write(delivery/'report_zh.md',markdown.encode())
    body=MarkdownIt('commonmark').enable('table').render(markdown)
    page='<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>人工种子集训练与逐面补标</title><style>'+STYLE+'</style><main>'+body+'</main></html>'
    protected_write(delivery/'report_zh.html',page.encode())
    banner=f'{summary["frames"]} 个目标 · {summary["human_faces"]} 人工面 · {summary["model_faces"]} 机器面 · {summary["low_confidence_faces"]} 低置信面 · {summary["targets_without_mask"]} 待补画目标'
    data=json.dumps(enriched,ensure_ascii=False,separators=(',',':')).replace('<','\\u003c')
    gallery=GALLERY.replace('__STYLE__',STYLE).replace('__SUMMARY__',html.escape(banner)).replace('__DATA__',data)
    protected_write(delivery/'gallery.html',gallery.encode())
    install_font(delivery,markdown+gallery)


def source_for_report(ctx,key):
    from pallet.instance_segmentation_seed import source_document
    return source_document(ctx,key)


def install_font(delivery,text):
    """Subset the existing licensed CJK font so file:// reports need no network."""
    target=delivery/'assets/AnnotationSeedSans.woff'
    if target.exists():return
    original=Path('/tmp/NotoSansCJKsc-Regular.otf')
    if not original.exists():
        protected_write(target,(Path(__file__).parent/'assets/AnnotationSeedSans.woff').read_bytes())
        return
    from fontTools import subset
    from fontTools.ttLib import TTFont
    font=TTFont(original,recalcTimestamp=False);font.flavor='woff'
    options=subset.Options();options.recalc_timestamp=False
    selection=subset.Subsetter(options=options);selection.populate(text=text);selection.subset(font)
    buffer=io.BytesIO();font.save(buffer);protected_write(target,buffer.getvalue())
