genshin-assistant/docs/scanner-rework-status.md

# Scanner Rework Status

Updated: 2026-07-11 after the 2,211-Artifact full-inventory acceptance,
review-gate correction, strict game-process targeting, and the offline-tested
Build-Fit evidence-ranking checkpoint

Short current-state entry point: [CURRENT_STATUS.md](CURRENT_STATUS.md).
Detailed evidence:
[NATIVE_SCANNER_LIVE_ACCEPTANCE_2026-07-10.md](NATIVE_SCANNER_LIVE_ACCEPTANCE_2026-07-10.md).

## Was Es Kann

- Der native Artifact-Scanner setzt das 2.400-Slot-Inventar begrenzt an den
  Anfang, erfasst ein validiertes 4x8-Grid ueber mehrere Seiten und streamt
  jeden Crop direkt in vier begrenzte OCR-/Parse-/Evaluierungsworker.
- Genshin-HWND, Stop-Signale und Input-Erfolg werden vor jedem relevanten
  Wheel-, Klick- und Capture-Schritt geprueft. Fokusverlust refokussiert nicht.
- Die frische Live-Kette `5/20/50/100` bestand mit 0 Review, 0 Fehlern und
  0 Store-Writes. Der 100er `20260710-102547` erreichte 4,37 Captures/s und
  3,15 verarbeitete Results/s.
- Gespeicherte Runs werden auf exakte Jobs/PNGs/Results, Sequenzen, Pfade,
  Click-Events, Seitenwiederholung, PNG-Hashes und Replay-Determinismus geprueft.
- Inventory zeigt Native- und Store-Zeilen mit getrennten Signalen fuer
  Extraktion, Review, IK, Roll-Efficiency, Promotion und spaeteren Build-Fit.
- Die unpacked App ist aus `%TEMP%` live gestartet. Renderer, Preload, IPC,
  paketierter C#-Helper und IK 6.7.0 funktionierten; der paketierte 5er
  `20260710-103736` bestand ohne Persistenz.

## Was Zuletzt Gemacht Wurde

- Capture-Quellenklassifizierung schliesst die eigene App trotz `Genshin` im
  Titel aus.
- Dev-Cleanup beendet nur echte Repo-Vite/Electron/Helper-Prozesse und nicht
  mehr den Codex-CUA-Node.
- Native Runs starten immer mit einem begrenzten Top-Reset und pruefen den
  Foreground vor jedem Input/Capture. Reset-Pacing senkte die Live-Zeit von
  50,7 s auf rund 1,7 s.
- Der Smoke-Gate prueft exakte Counts, Dateivertraege, Reviewrate,
  Non-Persistence und bestaetigten Stop-Cleanup.
- Run-Aufloesung waehlt nur den neuesten vollstaendigen Run; gestoppte oder
  unprozessierte Runs ersetzen die Inventory-Evidenz nicht.
- Packaged Pfade verwenden `resourcesPath`, Vite relative Assets und eine
  verifizierte Runtime-Signatur.
- Elevation wird sowohl im Runtime- als auch im Helper-Guard korrekt angezeigt.
- Inventory-Layout und Promotion-Duplikatstatus wurden im finalen Paket visuell
  korrigiert und abgenommen.
- Der aktuelle Renderer-Stand setzt den Scanumfang standardmaessig auf die
  erkannte Besitzanzahl und bietet optional ein Artifact- oder Reihenlimit. Die
  linke Hauptflaeche uebernimmt den Lauf-Fortschritt; die separate
  Fortschrittskarte entfaellt und die Ergebnisleiste startet sitzungsleer.
- Der bestehende gebundene Wheel-Top-Reset bleibt Produktionsstandard. Ein
  `B`-Reopen mit Artifact-Tab ist nur eine spaeter live zu benchmarkende
  Alternative, nicht Teil des aktuellen Produktionspfads.
- Ein realer Settings-UI-Lauf mit Artifact-Limit 5 bestand Genshin-, Detail-
  und Grid-Preflight. Ziel/Capture/Processing/Parsing endeten bei 5/5,
  Review/Fehler bei 0, `persist=false`; die sitzungsgebundene Ergebnisleiste
  zeigte alle 5 Resultate.
- Der paketierte Settings-UI-Reihenlauf `20260710-180851` loeste eine Reihe
  ueber das erkannte 8-Spalten-Raster zu Ziel 8 auf. Capture, Processing und
  Parsing endeten bei 8/8, Review/Fehler bei 0 und der Top-Reset bei 1.715 ms.
  Zwei Fokusverlust-Versuche blockierten vorher korrekt mit 0 Klicks.
- Der paketierte Streaming-Lauf `20260710-201614` startete Processing beim
  ersten verfuegbaren Run-Verzeichnis. Noch waehrend Capture `running` war,
  zeigte die Session-Rail bereits 11 ausgewertete Ergebnisse. Final waren
  Capture/Processing/Parsing/Evaluation 20/20, Review/Fehler/Store-Writes 0;
  alle Sequenzen 1-20 waren eindeutig und chronologisch sichtbar.
- Die Scanner-Hierarchie nutzt jetzt mehr Breite fuer die sitzungsgebundenen
  Ergebnisse als fuer Guide/Capture. Scanbereitschaft und Live-Auswertung sind
  kompakte Statusleisten statt verschachtelter Karten.
- Scanumfang, Aufnahmequelle und manuelle Werkzeuge liegen in einem
  fokusgefangenen `Scanoptionen`-Modal und verschieben den Arbeitsbereich nicht
  mehr. Collection-Pipeline-Details im Inventory liegen ebenfalls in einem
  Modal; Diagnose-Import/-Export ist standardmaessig eingeklappt.
- Der frisch paketierte UI-Lauf `20260710-214406` bestaetigte die neue
  Hierarchie erneut live: 20/20 Capture, Processing, Parsing und Evaluation,
  0 Review/Fehler/Store-Writes, bis zu 9 sichtbare Ergebniszeilen und 12 bereits
  ausgewertete Resultate waehrend Capture noch lief. Der erste Startversuch
  blockierte korrekt an der doppelten Detailkarten-Pruefung; nach stabiler
  Detailkarte lief derselbe begrenzte Pfad durch.
- `build-fit-contract-v1` trennt gesourcte Character-/Zielregeln,
  Set-Pfade, Main-Stat-Prioritaeten, Substat-Gewichte, Gesamtziele, Konflikte
  und Profil-Ablaufdaten von OCR und Roll-Efficiency. Unsichere oder nicht
  kanonische Scanergebnisse blockieren; V1 gibt absichtlich noch keinen
  Fit-Score aus.
- Reale lokale Account-Snapshots rufen den alten Demo-Scorer nicht mehr auf.
  Der getrennte `build-fit-evidence-ranking-v1` liest stattdessen nur den
  neuesten vollstaendigen nativen Run und kann bis zu drei read-only
  Profilvorschlaege ausgeben.
- Der score-freie Fuenfer-Verifier prueft genau einen Eintrag pro Slot,
  vollstaendige Set-Formen, verschachtelte OCR-/Review-Gates, Konflikte und
  optional gesourcte Gesamtwerte. Fehlender Nicht-Artifact-Kontext bleibt
  `pending` und wird nicht geraten.
- Der Profil-Corpus umfasst Furina Off-field/Solo Hydro C0-C1, Neuvillette
  Charged Attack, Raiden Off-field Hyperbloom und Nahida Off-field Deepwood.
  Jede Regel ist quellen-/versions-/ablaufgebunden, gegen reale IK-6.7.0-Keys
  geprueft und durch Golden plus adversarial Fixture abgesichert.
- Die sichtbare Regelabdeckung kombiniert nur Set-Form, Main-Stat-Prioritaet
  und dokumentierte Substat-Praesenz. Roll-Efficiency, Rollhoehe und OCR-
  Confidence sind keine Rankinggewichte; Charakterbesitz, Team, Waffe und
  Rotation werden nicht geraten. Furinas ER-Kontext ist nur explizit und
  sitzungsgebunden bestaetigbar.
- Der reale Vollinventar-Lauf `20260710-223233` nahm den OCR-Besitzwert 2.211,
  erfasste exakt 2.211 Karten auf 70 Seiten mit 4,24/s und schrieb nichts in
  den Store. Die aktuelle paketierte Reprozessierung erreichte 2.211/2.211,
  136 Review (6,15%), 0 Fehler und 0 Writes; der Saved-Run-Validator meldet
  `issues=0`.
- Der erste Parse desselben Laufs wurde bei 490 Review (22,16%) korrekt nicht
  akzeptiert. 360 widerspruechliche `+0`-Main-Values werden jetzt nur dann aus
  der kanonischen 5-Sterne-Tabelle repariert, wenn vier Anfangs-Substats die
  Seltenheit strukturell beweisen; Drei-Substat-Faelle bleiben Review.
- Der Review-Corpus-Exporter priorisiert jetzt nur noch Kandidaten mit
  abrufbarem lokalem Crop und gibt sichere Capture-/Run-Referenzen statt lokaler
  Pfade aus. Der Snippet-Preparer blockiert OCR-only Kandidaten ohne visuelle
  Evidenz. Ein read-only Export der aktuellen 177 Eintraege fand drei abrufbare,
  bereits bestaetigte `native-review-approved` Faelle; keine neue Label-Promotion
  wurde vorgenommen.
- Native Helper und PowerShell-Fallback akzeptieren nur noch die exakten
  Prozessnamen `GenshinImpact` oder `YuanShen`. Bei geschlossenem Spiel bestand
  der Package-Smoke mit `genshinFound=false`, HWND 0 und leerem Zielprozess.

## Was Noch Nicht

- Roll-Efficiency ist weiterhin kein Build-Fit. Die offline getestete Builds-
  Oberflaeche ist keine Optimizer- oder DPS-Aussage und wurde noch nicht als
  frischer paketierter Renderer-Fall live abgenommen.
- Weapons, Materials und Character Details bleiben ausserhalb des aktiven
  Scanner-Scope.
- Andere Aufloesungen, Seitenverhaeltnisse und UI-Sprachen haben noch kein
  live validiertes Profil.
- Batch-Review/-Promotion und automatische Store-Persistenz bleiben aus.
- Der absichtlich schreibende Review-/Promotion-Pfad wurde nicht live
  ausgefuehrt; er bleibt zustimmungspflichtige separate QA.

## Wo Es Noch Probleme Macht

- Die fruehere `1,77/s`-Zahl ist nur der historische serielle 100er-Smoke:
  Capture/Reset und danach Batch-Processing wurden addiert. Sie darf nicht als
  aktuelle Streaming-End-to-End-Rate gelesen werden. Der dry Streaming-20er
  `20260711-090019` lief 20/20 mit 0 Review/Fehlern/Writes, lieferte das erste
  Ergebnis vor Capture-Ende, mass `4,43 Capture/s` und beobachtet `2,39/s`
  vom Startrequest bis zur Result-Reconciliation. Der gemeinsame Clock-Contract
  ist jetzt persistiert: der aktuelle 50er `20260711-154827` bestand mit
  50/50 Capture/Parse/Results, 0 Review/Fehler/Writes und `28.022 ms`
  Request-to-Reconciliation (`~1,78/s`). Der 3/s-Gesamtclaim bleibt offen.
- Neue OCR-Zustaende koennen weiterhin Review ausloesen; das ist ein sicherer
  Fallback, kein Grund die Plausibilitaetsgates zu lockern.
- Der Renderer hat weiter einen nicht-blockierenden ~630-kB-Chunk.
- Die neuen Live-Artifacts waren alle +20, deshalb entstand kein neuer echter
  Under-Level-Projektionsfall.
- Ohne plausiblen OCR-Wert fuer die aktuelle Besitzanzahl blockiert der
  Full-Inventory-Lauf absichtlich; Kapazitaet darf das Ziel nicht ersetzen und
  der native Helper erkennt das Listenende noch nicht verlaesslich selbst.

## Was Noch Verbesserungsfaehig Ist

1. Die Builds-Oberflaeche hat nun eine gebaute Renderer-Abnahme fuer frisches
   Englisch, Deutsch-Umschaltung, Kontext, Fokus und Overflow bestanden. Ein
   elevated Paket-Start bleibt nur fuer einen gesonderten Runtime/UAC-Claim
   offen; der frische native 50er-Smoke bestand als Scanner-Release-Gate.
2. Profilquellen vor Ablauf erneuern und jedes weitere Profil wieder mit
   Golden-/adversarial Fixtures absichern.
3. Neue Review-Faelle nur nach visueller Crop-Bestaetigung in Parser-Corpus
   oder Lernregeln uebernehmen. Die historische 136er-Population ist bereits
   auditiert; der eine unvollstaendige Crop bleibt bewusst `Review`.
4. Result-Klarheit und explizite Mutation-QA weiter staerken.
5. Erst nach eigenen Quellen fuer Charakterbesitz, Team, Waffe und Rotation
   eine breitere Optimizer- oder Empfehlungsphase erwägen.

## Aktueller Nachweis

- `npm run acceptance:offline`: PASS
- `npm test`: 446/446 in 72 Dateien
- `npm run acceptance:offline`: final PASS nach Lokalisierung, lokaler
  Loeschung, Timing, Korpus und UI-Acceptance-Runner; Package-Verifier 27/27
- Build-Fit-Ranker/Kontext/Profile: offline PASS; gebaute Renderer-UI PASS,
  aber kein elevated Paket- oder neuer nativer Live-Claim
- `npm run package:verify`: 27/27
- `npm audit` und `npm audit --omit=dev`: 0 Findings
- Dev live: 5/20/50/100 PASS
- Settings UI live: Artifact-Limit 5, 5/5 Capture/Processing/Parsing,
  0 Review/Fehler, `persist=false`, Ergebnisleiste 5 PASS
- Packaged Settings UI live: Reihenlimit 1 -> Ziel 8, 8/8
  Capture/Processing/Parsing, 0 Review/Fehler, `persist=false` PASS
- Packaged Settings UI streaming: Artifact-Limit 20, maximal 11 Live-Resultate
  waehrend Capture, final 20/20, 0 Review/Fehler/Writes PASS
- Packaged UI-Dichteabnahme `20260710-214406`: maximal 9 sichtbare Resultate
  und 12 Evaluierungen waehrend Capture, final 20/20, 0 Review/Fehler/Writes;
  Ergebnisflaeche 634 px bei 1304x821 ohne Dokument-Overflow PASS
- Packaged Full Inventory `20260710-223233`: OCR-Ziel/Capture/Results
  2.211/2.211, 70 Seiten, 4,24 Capture/s, aktueller Package-Reprocess
  2.211/2.211 mit 136 Review (6,15%), 0 Fehler/Writes; Saved-Run-Validator
  2.075 evaluated, 0 unknown, `issues=0` PASS
- Packaged No-Genshin Safety: `genshinFound=false`, HWND 0, leerer
  Zielprozess, keine Capture-Quelle und 0 Renderer-Fehler PASS
- Packaged live: Start/Bridge/Resources/Inventory und nativer 5er PASS
- Finale visuelle Evidenz:
  `outputs/ui-qa/final-scan.png`, `outputs/ui-qa/final-scan-settings.png`,
  `outputs/ui-qa/final-inventory.png` und die weiteren `final-*.png`-Ansichten
  unter `outputs/ui-qa/`.
  sowie `outputs/packaged-live/streaming-ui-20-results-view.png`
  (temporäre lokale Dateien zum Abnahmezeitpunkt; bei der angeforderten
  Workspace-Bereinigung am 2026-07-11 entfernt).