MediaWiki:Gadget-LabelScan.js: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(72 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
/* global mw, Tesseract */
/* global mw */
(function () {
(() => {
   'use strict';
   'use strict';


   // =============================
   const CFG = {
  //   KONFIGURATION
    // ---- Daten & Model ----
  // =============================
    indexTitle: (window.LabelScanConfig && window.LabelScanConfig.indexTitle) ||
                'MediaWiki:Gadget-LabelScan-index.json',
    transformersURL: 'https://cdn.jsdelivr.net/npm/@xenova/transformers@2.15.0',
    modelId: 'Xenova/clip-vit-base-patch32',
    localModelPath: '/models',          // <<— deine Modelle liegen hier


  // ← Für Tests leer lassen: const ADOS_CATEGORIES = [];
    topK: 3,                            // <<— MAX. 3 TREFFER
  const ADOS_CATEGORIES = [
     maxSide: 1280,                     // Downscale vor Auto-Crop (Performance)
    'Alle A Dream of Scotland Abfüllungen',
    'Alle A Dream of Ireland Abfüllungen',
    'Alle A Dream of... – Der Rest der Welt Abfüllungen',
     'Friendly Mr. Z Whiskytainment Abfüllungen',
    'Die Whisky Elfen Abfüllungen',
    'The Fine Art of Whisky Abfüllungen',
    'Alle Rumbastic Abfüllungen'
  ];


  const KNOWN_TOKENS = [
     // ---- Auto-Crop ----
     // Serien / Reihen
     autoCrop: true,
     'The Tasteful 8', 'Heroes of Childhood', 'A Dream of Scotland',
    edgeKeepRatio: 0.10,               // oberste 10% Kanten als Maske
     'A Dream of Ireland', 'The Fine Art of Whisky', 'Friendly Mr. Z',
     cropPadding: 0.08,                 // 8% Randzugabe um die Box
     'Die Whisky Elfen', 'Rumbastic',
     cropMinRel: 0.40,                   // min. 40% der kleineren Bildkante


     // Brennereien / Regionen
     // ---- Score-Badges ----
     'Ardbeg','Ardmore','Arran','Auchroisk','Ben Nevis','Blair Athol','Bowmore',
     showNumericScore: false,           // true = Zahlen zeigen, false = Badges
     'Caol Ila','Clynelish','Glenallachie','Glenrothes','Longmorn','Lagavulin',
     confidenceBands: [0.90, 0.80],     // hoch ≥0.90, mittel ≥0.80, sonst niedrig
    'Tullibardine','Dalmore','Benrinnes','Mortlach','Glenlivet','Inchgower',
    'Islay','Speyside','Highland','Lowland','Campbeltown','Ireland','Irland',


     // typische Label-Wörter
     // ---- Sonstiges ----
     'Cask Strength','First Fill','Bourbon Barrel','Sherry','PX','Oloroso'
     debug: true
   ];
   };


   // =============================
   // --------- Helpers ----------
  //  UI-Hilfen
   const log=(...a)=>{ if(CFG.debug) console.log('[LabelScan]',...a); };
   // =============================
  const warn=(...a)=>{ if(CFG.debug) console.warn('[LabelScan]',...a); };
  const err=(...a)=>{ console.error('[LabelScan]',...a); };
  const qs=id=>document.getElementById(id);
  const setStatus=t=>{ const el=qs('ados-scan-status'); if(el) el.textContent=t||''; };
  const setProgress=p=>{
    const bar=qs('ados-scan-progress'); if(!bar) return;
    if(p==null){ bar.hidden=true; bar.value=0; }
    else{ bar.hidden=false; bar.value=Math.max(0,Math.min(1,p)); }
  };


   function hasUI () {
   function resetResultsBox(msg){
     return !!document.getElementById('ados-scan-run') &&
     const r = qs('ados-scan-results');
          !!document.getElementById('ados-scan-file');
    if (r) {
      r.innerHTML = `<div class="empty">${msg || 'Hier erscheinen Treffer.'}</div>`;
    }
   }
   }


   function setStatus (t) {
   function showPreview(file){
     var el = document.getElementById('ados-scan-status');
     const url=URL.createObjectURL(file);
     if (el) el.textContent = t || '';
    const prev=qs('ados-scan-preview');
     if(prev){
      prev.innerHTML=`<img alt="Vorschau" style="max-width:260px;width:100%;height:auto;border-radius:8px;display:block;margin:0 auto;" src="${url}">`;
      prev.setAttribute('aria-hidden','false');
    }
   }
   }


   function setProgress (p) {
   function base64ToFloat32(b64){
     var bar = document.getElementById('ados-scan-progress');
     const bin=atob(b64), len=bin.length;
     if (!bar) return;
     const buf=new ArrayBuffer(len), view=new Uint8Array(buf);
     if (p == null) { bar.hidden = true; bar.value = 0; }
     for(let i=0;i<len;i++) view[i]=bin.charCodeAt(i);
     else { bar.hidden = false; bar.value = Math.max(0, Math.min(1, p)); }
     return new Float32Array(buf);
   }
   }


   function showPreview (file) {
   // --------- Index ----------
     var url = URL.createObjectURL(file);
  let INDEX=[], INDEX_EMB=[];
     var prev = document.getElementById('ados-scan-preview');
  async function loadIndex({ ui=true }={}){
     if (prev) {
    if(INDEX.length) return INDEX;
      prev.innerHTML = '<img alt="Vorschau" src="' + url + '">';
    if(ui){ setStatus('Index laden …'); setProgress(0.03); }
      prev.setAttribute('aria-hidden', 'false');
     const rawURL = mw.util.getUrl(CFG.indexTitle,{ action:'raw', ctype:'application/json' });
     }
     const res = await fetch(rawURL,{ cache:'reload' });
    if(!res.ok) throw new Error('Index nicht ladbar: '+res.status);
    const json = await res.json();
     if(!Array.isArray(json)) throw new Error('Index ist keine Array-JSON');
    INDEX = json;
    INDEX_EMB = INDEX.map(it => (typeof it.embed==='string' && it.embed.length) ? base64ToFloat32(it.embed) : null);
    log('Index geladen:', INDEX.length, 'Einträge');
    log('Embeddings vorhanden:', INDEX_EMB.filter(v=>v&&v.length).length, '/', INDEX.length);
     if(ui) setProgress(0.06);
    return INDEX;
   }
   }


   function showOCRText (t) {
   // --------- Transformers (lokal) ----------
     var el = document.getElementById('ados-scan-ocr');
  let _visionLoadPromise=null;
     if (el) el.textContent = (t || '').trim();
  async function ensureClipVision(){
   }
     if(_visionLoadPromise) return _visionLoadPromise;
 
    setStatus('Modell laden …'); setProgress(0.08);
 
     _visionLoadPromise = (async()=>{
      const mod = await import(/* webpackIgnore: true */ CFG.transformersURL);
 
      // Nur lokal laden
      mod.env.allowLocalModels = true;
      mod.env.allowRemoteModels = false;
      mod.env.localModelPath   = CFG.localModelPath;


  // =============================
      // WASM-Runtime (ort-wasm-simd.wasm) von transformers-CDN
  //   Tesseract laden (nur 1x)
      mod.env.backends = mod.env.backends || {};
  // =============================
      mod.env.backends.onnx = mod.env.backends.onnx || {};
      mod.env.backends.onnx.wasm = mod.env.backends.onnx.wasm || {};
      mod.env.backends.onnx.wasm.wasmPaths =
        'https://cdn.jsdelivr.net/npm/@xenova/transformers@2.15.0/dist/';


  var tesseractReady;
      const [processor, model] = await Promise.all([
  function ensureTesseract () {
        mod.AutoProcessor.from_pretrained(CFG.modelId),
    if (tesseractReady) return tesseractReady;
         mod.CLIPVisionModelWithProjection.from_pretrained(CFG.modelId, { quantized: true })
    tesseractReady = new Promise(function (resolve, reject) {
       ]);
      if (window.Tesseract) return resolve();
      var s = document.createElement('script');
      s.src = 'https://cdn.jsdelivr.net/npm/tesseract.js@5/dist/tesseract.min.js';
      s.async = true;
      s.onload = resolve;
      s.onerror = function () {
         var s2 = document.createElement('script');
        s2.src = 'https://unpkg.com/tesseract.js@5/dist/tesseract.min.js';
        s2.async = true;
        s2.onload = resolve;
        s2.onerror = function () { reject(new Error('Tesseract konnte nicht geladen werden')); };
        document.head.appendChild(s2);
      };
       document.head.appendChild(s);
    });
    return tesseractReady;
  }


  // =============================
      let backend='unknown';
  //  Vorverarbeitung (OCR)
      try { backend = model?.session?.executionProvider || backend; } catch(_){}
  //  Graustufen + Unsharp + adaptive Schwelle
      log('CLIP ready (vision, local):', model?.constructor?.name || 'unknown', '| Backend:', backend);
  // =============================


  async function preprocessImage (file) {
      return { mod, processor, model };
    const img = await new Promise((res, rej) => {
    })();
      const o = new Image();
      o.onload = () => res(o);
      o.onerror = rej;
      o.src = URL.createObjectURL(file);
    });


     const MAX = 1800;
     return _visionLoadPromise;
    const s = Math.min(1, (img.width > img.height) ? MAX / img.width : MAX / img.height);
  }
    const w = Math.round(img.width * s), h = Math.round(img.height * s);


     const c = document.createElement('canvas'); c.width = w; c.height = h;
  // --------- Auto-Crop Heuristik ----------
     const g = c.getContext('2d', { willReadFrequently: true });
  function toCanvasScaled(img, maxSide){
     const c=document.createElement('canvas');
    let { width:w, height:h } = img;
    const s = Math.min(1, maxSide / Math.max(w,h));
    w = Math.round(w*s); h = Math.round(h*s);
    c.width=w; c.height=h;
     const g=c.getContext('2d', { willReadFrequently:true });
     g.imageSmoothingEnabled = true;
     g.imageSmoothingEnabled = true;
     g.drawImage(img, 0, 0, w, h);
     g.drawImage(img,0,0,w,h);
    return c;
  }


    // → Graustufen
  function autoCropCanvas(inCanvas){
     let id = g.getImageData(0, 0, w, h), d = id.data;
     const w=inCanvas.width, h=inCanvas.height;
     for (let i=0;i<d.length;i+=4){
     const ctx=inCanvas.getContext('2d', { willReadFrequently:true });
      const y = 0.2126*d[i] + 0.7152*d[i+1] + 0.0722*d[i+2];
    const imgData=ctx.getImageData(0,0,w,h);
      d[i]=d[i+1]=d[i+2]=y;
    const data=imgData.data;
    }
    g.putImageData(id, 0, 0);


     // → Unsharp (leichter Hochpass)
     // Graustufen
    id = g.getImageData(0,0,w,h); d = id.data;
     const gray=new Uint8ClampedArray(w*h);
     const copy = new Uint8ClampedArray(d);
     for(let y=0, p=0, i=0; y<h; y++){
    const idx = (x,y)=>4*(y*w+x);
       for(let x=0; x<w; x++, i++, p+=4){
     for (let y=1;y<h-1;y++){
         const r=data[p], g=data[p+1], b=data[p+2];
       for (let x=1;x<w-1;x++){
        gray[i] = (0.299*r + 0.587*g + 0.114*b)|0;
         const i0=idx(x,y), a=copy[i0], b=copy[idx(x-1,y)], c0=copy[idx(x+1,y)],
              d0=copy[idx(x,y-1)], e=copy[idx(x,y+1)];
        const lap = 4*a - b - c0 - d0 - e;
        const v = Math.max(0, Math.min(255, a + 0.3*lap));
        d[i0]=d[i0+1]=d[i0+2]=v;
       }
       }
     }
     }
    g.putImageData(id,0,0);


     // → adaptive Schwelle (lokaler Mittelwert)
     // Sobel-Kanten (Magnitude)
     const win = 25, half = (win|0);
     const mag=new Float32Array(w*h);
     id = g.getImageData(0,0,w,h); d = id.data;
     const sobelX=[-1,0,1,-2,0,2,-1,0,1];
     for (let y=0;y<h;y++){
    const sobelY=[-1,-2,-1,0,0,0,1,2,1];
       for (let x=0;x<w;x++){
     for(let y=1; y<h-1; y++){
         let sum=0, cnt=0;
       for(let x=1; x<w-1; x++){
         for (let yy=Math.max(0,y-half); yy<=Math.min(h-1,y+half); yy+=5){
         let gx=0, gy=0, k=0;
           for (let xx=Math.max(0,x-half); xx<=Math.min(w-1,x+half); xx+=5){
         for(let j=-1;j<=1;j++){
             sum += d[4*(yy*w+xx)];
           for(let i=-1;i<=1;i++,k++){
             cnt++;
             const v=gray[(y+j)*w + (x+i)];
             gx += sobelX[k]*v; gy += sobelY[k]*v;
           }
           }
         }
         }
         const thr = (sum/cnt) - 6;
         mag[y*w+x] = Math.hypot(gx,gy);
        const i = 4*(y*w+x);
        const v = d[i] < thr ? 0 : 255;
        d[i]=d[i+1]=d[i+2]=v;
       }
       }
     }
     }
    g.putImageData(id,0,0);


     return c;
     // Schwellwert: oberes x%-Quantil
  }
    const vals = Array.from(mag).sort((a,b)=>a-b);
    const keep = CFG.edgeKeepRatio;
    const tIdx = Math.max(0, Math.min(vals.length-1, Math.floor(vals.length*(1-keep))));
    const thr = vals[tIdx];


  // Hilfsfunktionen für Varianten
    // Bounding-Box der Pixel > thr
  function crop(canvas, x, y, w, h){
    let minX=w, minY=h, maxX=0, maxY=0, count=0;
     const c = document.createElement('canvas'); c.width=w; c.height=h;
     for(let y=0;y<h;y++){
    c.getContext('2d').drawImage(canvas, x, y, w, h, 0, 0, w, h);
      for(let x=0;x<w;x++){
    return c;
        const m=mag[y*w+x];
  }
        if(m>thr){ count++; if(x<minX)minX=x; if(y<minY)minY=y; if(x>maxX)maxX=x; if(y>maxY)maxY=y; }
  function rotate(canvas, deg){
      }
    const r = document.createElement('canvas');
     }
    const ctx = r.getContext('2d');
    if (deg % 180 === 0){ r.width=canvas.width; r.height=canvas.height; }
    else { r.width=canvas.height; r.height=canvas.width; }
    ctx.translate(r.width/2, r.height/2);
    ctx.rotate(deg*Math.PI/180);
    ctx.drawImage(canvas, -canvas.width/2, -canvas.height/2);
     return r;
  }


  async function ocrOne(canvas, lang) {
    if(count<50) return inCanvas; // zu wenig Signal → return original
    const res = await Tesseract.recognize(canvas, lang, {
      // Sparse text funktioniert bei Labels (verschieden orientierte Textblöcke)
      tessedit_pageseg_mode: 11,
      preserve_interword_spaces: 1
    });
    return { text: (res?.data?.text||'').trim(), conf: res?.data?.confidence||0 };
  }


  // =============================
    // Padding
  //  Mehrfach-OCR (Rotationen/Regionen) + Fallback-Sprache
    const pad = Math.round(CFG.cropPadding * Math.max(w,h));
  // =============================
    minX = Math.max(0, minX - pad);
    minY = Math.max(0, minY - pad);
    maxX = Math.min(w-1, maxX + pad);
    maxY = Math.min(h-1, maxY + pad);


  async function runOCR(file){
    // Mindestgröße
     await ensureTesseract();
     const boxW=maxX-minX+1, boxH=maxY-minY+1;
     setProgress(0.01);
     const minLen = Math.round(CFG.cropMinRel * Math.min(w,h));
     const base = await preprocessImage(file);
     let cx=minX, cy=minY, cw=boxW, ch=boxH;
 
     if(cw<minLen || ch<minLen){
     // Kandidatenflächen
      const needW = Math.max(minLen, cw);
    const variants = [];
      const needH = Math.max(minLen, ch);
    variants.push(base); // komplett
      const centerX = Math.round((minX+maxX)/2);
    variants.push(crop(base, 0, 0, Math.round(base.width*0.4), base.height)); // linke Spalte
      const centerY = Math.round((minY+maxY)/2);
    variants.push(crop(base, 0, Math.round(base.height*0.72), base.width, Math.round(base.height*0.28))); // unteres Banner
      cx = Math.max(0, Math.min(w-needW, centerX - Math.floor(needW/2)));
 
       cy = Math.max(0, Math.min(h-needH, centerY - Math.floor(needH/2)));
    // + Rotationen
      cw = needW; ch = needH;
    const more = [];
    for (const v of variants){
       more.push(v, rotate(v, 90), rotate(v, -90));
     }
     }


    // zwei Sprachmodi testen
     const out=document.createElement('canvas');
     const results = [];
    out.width=cw; out.height=ch;
    for (const canv of more){
     out.getContext('2d').drawImage(inCanvas, cx, cy, cw, ch, 0, 0, cw, ch);
      for (const lang of ['deu+eng','eng']){
     return out;
        try {
          const r = await ocrOne(canv, lang);
          results.push(r);
        } catch(e){ /* einzelne Fehlschläge ignorieren */ }
      }
     }
    setProgress(null);
 
    results.sort((a,b)=> (b.conf||0)-(a.conf||0));
     return (results[0]?.text)||'';
   }
   }


   // =============================
   // --------- Embedding-Pipeline ---------
   //  Hinweise aus OCR
   async function embedFileImage(file){
  // =============================
    const { mod, processor, model } = await ensureClipVision();


  function extractHints (text) {
     setStatus('Bild vorbereiten …'); setProgress(0.20);
     const raw = String(text || '').replace(/\s+/g, ' ').trim();


     const foundNames = [];
    // 1) Bild laden
    KNOWN_TOKENS.forEach(t => {
     const img = await new Promise((res,rej)=>{
       const re = new RegExp('\\b' + t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\b', 'i');
       const url=URL.createObjectURL(file);
       if (re.test(raw)) foundNames.push(t);
      const image=new Image();
      image.crossOrigin='anonymous';
      image.onload=()=>{ URL.revokeObjectURL(url); res(image); };
       image.onerror=e=>{ URL.revokeObjectURL(url); rej(e); };
      image.src=url;
     });
     });


     const ages = [];
     // 2) Scale → Auto-Crop
     const ageRe = /\b([1-9]\d?)\s?(?:years?|yo|jahr(?:e)?)\b/gi;
     let canvas = toCanvasScaled(img, CFG.maxSide);
     let m;
     if(CFG.autoCrop){
    while ((m = ageRe.exec(raw)) !== null) {
       setStatus('Auto-Crop …'); setProgress(0.30);
       const n = m[1]; if (!ages.includes(n)) ages.push(n);
      canvas = autoCropCanvas(canvas);
     }
     }


     const years = [];
    // 3) Canvas → Blob → RawImage (robust für Processor)
     const yearRe = /\b(19|20)\d{2}\b/g;
     const blob = await new Promise(r => canvas.toBlob(r, 'image/jpeg', 0.95));
     while ((m = yearRe.exec(raw)) !== null) {
     const imageRaw = await mod.RawImage.fromBlob(blob);
      if (!years.includes(m[0])) years.push(m[0]);
 
    }
     setStatus('Bild analysieren …'); setProgress(0.45);
 
    // 4) Processor & Model
    const inputs = await processor(imageRaw, { return_tensors: 'pt' });
    const out = await model.forward({ pixel_values: inputs.pixel_values });


     const wordRe = /\b[A-ZÄÖÜ][A-Za-zÄÖÜäöüß\-]{3,}\b/g;
     const vec = out?.image_embeds?.data || out?.image_embeds;
    const uniq = new Set(); let w; const words = [];
     if(!(vec instanceof Float32Array)) throw new Error('Embedding-Format unerwartet');
     while ((w = wordRe.exec(raw)) !== null) {
      const s = w[0];
      if (!uniq.has(s)) { uniq.add(s); words.push(s); if (words.length >= 8) break; }
    }


     return { names: foundNames, ages, years, words, raw };
    // 5) Normieren
    let n=0; for(let i=0;i<vec.length;i++) n+=vec[i]*vec[i];
    const norm = Math.sqrt(n)||1;
    const v = new Float32Array(vec.length);
    for(let i=0;i<vec.length;i++) v[i]=vec[i]/norm;
     return v;
   }
   }


   // =============================
   function cosine(a,b){ let s=0,L=Math.min(a.length,b.length); for(let i=0;i<L;i++) s+=a[i]*b[i]; return s; }
  //  Suche (3 Pässe) + Fallbacks
  // =============================


   function esc (s) { return mw.html.escape(String(s || '')); }
  // vorher: slice(0, topK) hier
  // jetzt: ALLE sortiert zurückgeben, damit wir danach deduplizieren können
   function rankByCosine(q){
    const s=[];
    for(let i=0;i<INDEX.length;i++){
      const v=INDEX_EMB[i];
      if(!v) continue;
      s.push({ i, score: cosine(q,v) });
    }
    s.sort((a,b)=> b.score-a.score);
    return s;
  }


   function incatStr () {
  // NEU: pro Titel nur bester Treffer
     return (ADOS_CATEGORIES || []).map(c => 'incategory:"' + c + '"').join(' ');
   function dedupeByTitle(ranked){
     const bestByTitle = Object.create(null);
    for (let k = 0; k < ranked.length; k++) {
      const hit = ranked[k];
      const it = INDEX[hit.i];
      const rawTitle = it && it.title ? String(it.title) : '';
      const key = rawTitle.trim().toLowerCase();
      if (!key) continue;
      const prev = bestByTitle[key];
      if (!prev || hit.score > prev.score) {
        bestByTitle[key] = hit;
      }
    }
    const arr = [];
    for (const key in bestByTitle) {
      if (Object.prototype.hasOwnProperty.call(bestByTitle, key)) {
        arr.push(bestByTitle[key]);
      }
    }
    arr.sort(function(a,b){ return b.score - a.score; });
    return arr;
   }
   }


   async function searchWikiSmart (hints, limit) {
   // --------- Score-Badges ---------
    await mw.loader.using(['mediawiki.api','mediawiki.util','mediawiki.html']);
  function scoreBadge(score){
    const api = new mw.Api();
     if (CFG.showNumericScore) {
    const ns0 = 0;
    return `<span style="font-variant-numeric:tabular-nums;color:#666">${score.toFixed(3)}</span>`;
    const MAX = limit || 12;
 
    // PASS 1: intitle-Kombis (präzise)
    const pass1 = [];
     if (hints.names.length) {
      hints.names.forEach(n => {
        if (hints.ages.length) hints.ages.forEach(a => pass1.push(`intitle:"${n}" intitle:${a} ${incatStr()}`));
        if (hints.years.length) hints.years.forEach(y => pass1.push(`intitle:"${n}" "${y}" ${incatStr()}`));
        pass1.push(`intitle:"${n}" ${incatStr()}`);
      });
     }
     }
    const [hi, mid] = CFG.confidenceBands || [0.90, 0.80];
    let txt = 'niedrig', bg = '#f1f5f9', fg = '#334155';
    if (score >= hi) { txt = 'hoch';  bg = '#e6ffed'; fg = '#0a7d2c'; }
    else if (score >= mid) { txt = 'mittel'; bg = '#fff7e6'; fg = '#a45500'; }
    return `<span style="display:inline-block;padding:.12rem .45rem;border-radius:999px;background:${bg};color:${fg};font-weight:600;font-size:.85em;line-height:1">${txt}</span>`;
  }


    // PASS 2: gewichtete Volltextsuche
  // --------- Rendering (max. 3 Treffer) ---------
    const key = []
// Score-Badge ausgeblendet
      .concat(hints.names.slice(0, 2), hints.ages.slice(0, 1), hints.years.slice(0, 1), hints.words.slice(0, 3))
// <div>${scoreBadge(score)}</div>
      .map(x => `"${x}"`).join(' ');
    const pass2 = key ? [ `${key} ${incatStr()}` ] : [];


    // PASS 3: Prefix auf Titel
  function renderResults(ranked){
     const pass3 = [];
     const box=qs('ados-scan-results');
     if (hints.names.length) pass3.push(hints.names[0]);
     if(!box) return;
     if (!pass3.length && hints.words.length) pass3.push(hints.words[0]);
     box.innerHTML='';


     const seen = new Set(); const out = [];
     if(!ranked || !ranked.length){
      box.innerHTML='<div class="empty">Keine klaren Treffer. Bitte ein anderes Foto oder näher am Frontlabel.</div>';
      return;
    }


     async function runSr (q) {
     // NEU: Dedupe nach Titel, DANN auf topK begrenzen
      const r = await api.get({ action: 'query', list: 'search', srsearch: q, srnamespace: ns0, srlimit: MAX, formatversion: 2 });
    const uniqueRanked = dedupeByTitle(ranked).slice(0, CFG.topK);
      (r.query?.search || []).forEach(it => {
        const k = it.title;
        if (seen.has(k)) return;
        seen.add(k);
        out.push(it);
      });
    }


     for (const q of pass1) { await runSr(q); if (out.length >= MAX) return out.slice(0, MAX); }
     const makeCard = (it, score) => `
    for (const q of pass2) { await runSr(q); if (out.length >= MAX) return out.slice(0, MAX); }
      <div class="ados-card" style="display:grid;grid-template-columns:120px 1fr;gap:14px;align-items:center;padding:12px;border:1px solid #e6e6e6;border-radius:14px;box-shadow:0 1px 8px rgba(0,0,0,.04);">
        ${it.thumb?`<img src="${it.thumb}" alt="" style="width:120px;height:auto;border-radius:10px;">`
                  :`<div style="width:120px;height:90px;background:#f3f3f3;border-radius:10px;"></div>`}
        <div style="display:flex;flex-direction:column;gap:8px;">
          <div style="font-weight:700;font-size:1.05rem;line-height:1.2;">
            <a href="${mw.util.getUrl((it.title||'').replace(/ /g,'_'))}">${mw.html.escape(it.title||'')}</a>
          </div>
          <div>
            <a href="${mw.util.getUrl((it.title||'').replace(/ /g,'_'))}" class="mw-ui-button" style="display:inline-block;padding:.4rem .7rem;border-radius:8px;background:#2a4b8d;color:#fff;text-decoration:none;">Artikel öffnen</a>
          </div>
        </div>
      </div>`;


     // Prefix (list=prefixsearch)
     const grid = document.createElement('div');
    for (const p of pass3) {
    grid.style.display='grid';
      const r = await api.get({ action: 'query', list: 'prefixsearch', pssearch: p, psnamespace: ns0, pslimit: MAX });
    grid.style.gridTemplateColumns='1fr';
      (r.query?.prefixsearch || []).forEach(it => {
    grid.style.gap='12px';
        const title = it.title || it['*'];
        const k = title;
        if (seen.has(k)) return;
        seen.add(k);
        out.push({ title, snippet: '' });
      });
      if (out.length >= MAX) break;
    }


     return out.slice(0, MAX);
     // max. CFG.topK (=3) Karten nach Dedupe
  }
    uniqueRanked.forEach(function(hit){
      const it = INDEX[hit.i];
      grid.innerHTML += makeCard(it, hit.score);
    });


  // ganz einfacher Fuzzy-Fallback auf Suchergebnissen
     box.appendChild(grid);
  function scoreTitle(title, hints){
    const t = String(title||'').toLowerCase();
    let s = 0;
    hints.names.forEach(n => { if (t.includes(n.toLowerCase())) s += 1.0; });
    hints.words.forEach(n => { if (t.includes(n.toLowerCase())) s += 0.4; });
    hints.ages.forEach(a => { if (t.includes(String(a))) s += 0.4; });
     hints.years.forEach(y => { if (t.includes(String(y))) s += 0.4; });
    return s;
   }
   }


   async function fallbackFuzzyTitles(hints, limit){
   // --------- UI / Flow ----------
    await mw.loader.using('mediawiki.api');
  let BOUND=false;
    const api = new mw.Api();
  function bindUI(){
    const MAX = limit || 12;
     if(BOUND) return;
 
    // Breite Suche mit Tokens (mit/ohne Kategorie)
    const q1 = []
      .concat(hints.names.slice(0,2), hints.ages.slice(0,1), hints.years.slice(0,1), hints.words.slice(0,3))
      .map(x => `"${x}"`).join(' ');
     const q = `${q1} ${incatStr()}`.trim();


     const r = await api.get({ action:'query', list:'search', srsearch:q || hints.raw.split(/\s+/).slice(0,6).join(' '), srlimit:50, formatversion:2 });
     const btnRun = qs('ados-scan-run');
     const items = (r.query?.search || []);
    const inCam  = qs('ados-scan-file-camera');
     const scored = items.map(it => ({ ...it, _score: scoreTitle(it.title, hints) }));
     const inGal  = qs('ados-scan-file-gallery');
     scored.sort((a,b)=> b._score - a._score);
     const btnCam = qs('ados-scan-btn-camera');
     const top = scored.slice(0, MAX).filter(x=> x._score >= 0.10); // großzügiger
     const btnGal = qs('ados-scan-btn-gallery');
     return top;
     const drop  = qs('ados-scan-drop');
  }
     const btnReset = qs('ados-scan-reset');


  async function broadSearchNoCategory(hints, limit){
     if(!btnRun || !inCam || !inGal) return;
     await mw.loader.using('mediawiki.api');
    const api = new mw.Api();
    const MAX = limit || 12;


     const parts = []
    // Hilfsfunktion: wenn neues Bild gewählt → Vorschau & Ergebnisse zurücksetzen
       .concat(hints.names.slice(0,2), hints.ages.slice(0,1), hints.years.slice(0,1), hints.words.slice(0,3))
     const onNewImage = (file) => {
       .map(x => `"${x}"`);
       if (!file) return;
    const q = parts.length ? parts.join(' ') : hints.raw.split(/\s+/).slice(0,6).join(' ');
       showPreview(file);
      resetResultsBox('Hier erscheinen Treffer.');
      setStatus('Bereit.');
      setProgress(null);
    };


     const r = await api.get({ action:'query', list:'search', srsearch:q, srlimit:MAX, formatversion:2 });
     btnCam && btnCam.addEventListener('click', ()=> inCam.click());
     return (r.query?.search || []);
     btnGal && btnGal.addEventListener('click', ()=> inGal.click());
  }


  // =============================
    const pick = e => {
  //  Ergebnisse rendern
      const f=e.target.files?.[0];
  // =============================
      if(f) onNewImage(f);
    };
    inCam.addEventListener('change', pick);
    inGal.addEventListener('change', pick);


  function renderResults (items) {
    if(drop){
    var box = document.getElementById('ados-scan-results');
      drop.addEventListener('dragover', function(ev){ ev.preventDefault(); drop.classList.add('is-over'); });
    if (!box) return;
      drop.addEventListener('dragleave', function(){ drop.classList.remove('is-over'); });
    box.innerHTML = '';
      drop.addEventListener('drop', function(ev){
    if (!items || !items.length) {
        ev.preventDefault(); drop.classList.remove('is-over');
      box.innerHTML = '<div class="ados-hit">Keine klaren Treffer. Bitte anderes Foto oder manuell suchen.</div>';
        const f = ev.dataTransfer && ev.dataTransfer.files && ev.dataTransfer.files[0];
       return;
        if(f){
          const dt=new DataTransfer(); dt.items.add(f);
          inGal.files=dt.files;
          onNewImage(f);
        }
       });
     }
     }
     items.slice(0, 12).forEach(function (it) {
 
       var title = it.title || '';
     btnReset && btnReset.addEventListener('click', function(){
      var link = mw.util.getUrl(title.replace(/ /g, '_'));
       setStatus('Bereit.'); setProgress(null);
      var snip = String(it.snippet || '').replace(/<\/?span[^>]*>/g, '').replace(/&quot;/g, '"');
       const p=qs('ados-scan-preview'); if(p) p.innerHTML='<div class="note">Noch keine Vorschau.</div>';
       var div = document.createElement('div');
      resetResultsBox('Hier erscheinen Treffer.');
      div.className = 'ados-hit';
       inCam.value=''; inGal.value='';
      div.innerHTML =
        '<b><a href="' + link + '">' + esc(title) + '</a></b>' +
        (snip ? '<div class="meta">' + snip + '</div>' : '');
       box.appendChild(div);
     });
     });
    btnRun.addEventListener('click', onRunClick);
    BOUND=true; log('UI gebunden.');
   }
   }


   // =============================
   async function onRunClick(){
  //  Binding
    const btnRun = qs('ados-scan-run');
  // =============================
    const inCam  = qs('ados-scan-file-camera');
    const inGal  = qs('ados-scan-file-gallery');


  var BOUND = false;
    try{
  function bind () {
      const file = (inCam.files && inCam.files[0]) || (inGal.files && inGal.files[0]);
    if (BOUND || !hasUI()) return;
      if(!file){ alert('Bitte zuerst ein Foto auswählen.'); return; }


    var runBtn = document.getElementById('ados-scan-run');
      if(btnRun) btnRun.disabled = true;
    var fileIn = document.getElementById('ados-scan-file');
    var bigBtn = document.getElementById('ados-scan-bigbtn');
    var form = document.getElementById('ados-scan-form');


    if (!runBtn || !fileIn) return;
      // Ergebnisse direkt leeren / „Suche läuft …“
    if (runBtn.dataset.bound === '1') return;
      resetResultsBox('Suche läuft …');
    runBtn.dataset.bound = '1'; BOUND = true;


    if (bigBtn) bigBtn.addEventListener('click', function () { fileIn.click(); });
      await loadIndex({ ui:true });
    fileIn.addEventListener('change', function () {
       await ensureClipVision(); // warmup
       if (this.files && this.files[0]) showPreview(this.files[0]);
    });


    function onSubmit(ev){
       const q = await embedFileImage(file);
      ev.preventDefault();
      if (!(fileIn.files && fileIn.files[0])) { alert('Bitte ein Foto auswählen oder aufnehmen.'); return; }
       var f = fileIn.files[0];
      (async function(){
        try {
          runBtn.disabled = true; runBtn.textContent = 'Erkenne …';
          setStatus('Erkenne Label …');
          const text = await runOCR(f);
          showOCRText(text);


          setStatus('Suche im Wiki …');
      setProgress(0.70);
          const hints = extractHints(text);
      setStatus('Abgleich …');


          let hits = await searchWikiSmart(hints, 12);
      const ranked = rankByCosine(q);
          if (!hits || !hits.length) {
      renderResults(ranked);
            setStatus('Kein direkter Treffer – Fuzzy über Kategorien …');
            hits = await fallbackFuzzyTitles(hints, 12);
          }
          if (!hits || !hits.length) {
            setStatus('Kein Treffer – breite Suche ohne Kategorien …');
            hits = await broadSearchNoCategory(hints, 12);
          }


          renderResults(hits);
      setStatus('Fertig.');
          setStatus('Fertig.');
      setProgress(null);
        } catch (e) {
    } catch(e){
          console.error('[LabelScan]', e);
      err('Fehler', e);
          setStatus('Fehler bei Erkennung/Suche. Bitte erneut versuchen.');
      setStatus('Fehler bei Erkennung.');
        } finally {
      resetResultsBox('Fehler bei der Erkennung – bitte ein anderes Foto versuchen.');
          runBtn.disabled = false; runBtn.textContent = 'Erkennen & suchen';
      setProgress(null);
        }
    } finally {
      })();
      if(btnRun) btnRun.disabled = false;
     }
     }
  }


    runBtn.addEventListener('click', onSubmit);
  function init(){
     if (form) form.addEventListener('submit', onSubmit);
     if(document.readyState==='loading'){
 
      document.addEventListener('DOMContentLoaded', bindUI, { once: true });
     // Sicherheit
     } else {
    var wrap = document.getElementById('ados-labelscan');
      bindUI();
     if (wrap) wrap.style.position = 'relative';
     }
    runBtn.style.position = 'relative';
    loadIndex({ ui:false }).catch(err).finally(()=>{
    runBtn.style.zIndex = '9999';
      setStatus('Bereit.');
     runBtn.style.pointerEvents = 'auto';
      resetResultsBox('Hier erscheinen Treffer.');
      setProgress(null);
     });
   }
   }


   if (document.readyState === 'loading') {
   log('gadget file loaded');
    document.addEventListener('DOMContentLoaded', bind);
   init();
  } else {
    bind();
  }
  setTimeout(bind, 250);
  setTimeout(bind, 1000);
  var mo = new MutationObserver(function () { if (!BOUND) bind(); });
   mo.observe(document.documentElement || document.body, { childList: true, subtree: true });


})();
})();