--- title: 'USDseal Inspector v0.28: 3D-Preview, Trust-Layer und Variants-Realität' description: 'Update-Artikel zum USDseal Inspector: v0.28 bringt Two-File-Pattern, 3D-Preview, 3-Layer-Trust mit Avalanche-Demo und USDconfig-Brücke. Kostenlos, Open Source, läuft im Browser.' slug: usdseal-inspector-v028-update date: '2026-06-04T13:25:37.000Z' author: Gerhard Schröder tags: - usdseal primary_tag: usdseal excerpt: Seit dem Projektstart im April sind Geometrie-Vollscope, AR-Diagnose mit 21 Regeln, die Avalanche-Demo und ein Two-File-Pattern für Standard und Advanced dazugekommen. canonical: https://visales.de/usdseal-inspector-v028-update.html --- - **Inspector v0.28 kommt jetzt in zwei Varianten: Standard (schlank, Privacy-First, kein CDN-Load) und Advanced (mit optionalem 3D-Preview via Three.js) — beide Open Source, beide kostenlos, beide vollständig lokal im Browser.** - **Don't trust, verify — konkret gemacht: Ein einzelner Bit-Flip verändert 53,9 % aller Bits im SHA-256-Hash. Der Inspector zeigt das live, mit Python-Verifier zum Selbstprüfen.** - **3D-Preview mit Realitätsbild: Variants-Assets — im B2B-Vertrieb die Norm — rendert Three.js nur eingeschränkt. Der Inspector sagt das offen. USDconfig löst es via offline Asset-Vorbereitung.** Folgeartikel zum ursprünglichen Beitrag [USDseal Inspector — Browser-Tool](https://visales.de/usdseal-inspector-browser-tool.html). Der bestehende Artikel bleibt als Snapshot Stand v0.23 erhalten; dieser Update-Beitrag fasst alle Entwicklungen seit dem Projektstart am 28. April 2026 zusammen. ## Das Problem und warum es einen Advanced gibt Wer ein USDZ-Asset erhält, sieht von außen: eine Datei. Was drin ist — Geometrie, Texturen, Materialien, eingebettete Subfiles, Variants, Provenienz — bleibt unsichtbar. Kein Betriebssystem öffnet USDZ wie einen Ordner. AR Quick Look rendert oder bricht, ohne zu erklären warum. CAD-Exporteure liefern Assets, die auf dem iPhone nicht starten, weil ein Texturformat falsch ist oder der defaultPrim fehlt. Der USDseal Inspector löst genau das: USDZ droppen, sofort sehen was drin ist. AR-Diagnose mit konkreten Fix-Hinweisen. Geometrie-Kennzahlen. Texturen mit PBR-Channel-Zuordnung. Alles lokal im Browser, kein Upload, kein Server. Warum dann zwei Varianten? Weil sich zwei Anforderungen widersprechen. Compliance- und Audit-Rollen brauchen ein Tool ohne externe Abhängigkeiten — kein CDN-Load, keine Netzwerkaktivität außer dem initialen Seitenaufruf. Vertriebsteams und 3D-Reviewer wollen das Asset auch sehen, nicht nur analysieren. Standard und Advanced lösen beide Anforderungen aus einer gemeinsamen Codebasis — ohne Kompromiss in die falsche Richtung. ## Was der Inspector heute zeigt: Validator-Vollscope **Geometrie-Kennzahlen.** Der Inspector analysiert heute zehn Kennzahlen: Polygon-Anzahl, Vertices, Materialien, Prims, Joints, UV-Sets, Subdivision-Status, Time-Range, FPS und Mesh-Komplexität. **Texturen mit PBR-Channel-Erkennung.** Ein Texture-Vollbild-Modal zeigt alle eingebetteten Texturen mit Kanal-Zuordnung: Albedo, Normal, Roughness, Metallic, Emissive, Occlusion und vier weitere PBR-Channels. Formate werden über Magic-Bytes erkannt — AVIF, HEIC, KTX2, TIFF und ASTC werden korrekt identifiziert. **AR-Quick-Look-Diagnose.** 21 Regeln in sieben Kategorien, gegen die aktuelle Apple-Dokumentation verifiziert. Das System unterscheidet zwischen "läuft mit Vorbehalt" und "bricht" — statt alles als kritischen Fehler zu markieren. **USDC-Binary-Limitation.** Bei binären USDC-Assets kann der Inspector Material-Details nicht vollständig auslesen. Das wird transparent kommuniziert — inklusive Hinweis, welche Informationen fehlen und warum. **Multi-File-Drop.** Mehrere Assets lassen sich gleichzeitig droppen und werden vertikal gestapelt ausgewertet. ## Don't trust, verify: Die 3-Layer-Trust-Architektur **Komponenten-Hash live im Browser.** Die Verify-UI zeigt eine Tabelle mit Hash-Werten aller Asset-Komponenten, direkt im Browser berechnet via `WebCrypto SubtleCrypto.digest()`. Kein Server-Request, keine externe Abhängigkeit. **Avalanche-Demo: Mathematik in Aktion.** Ein einzelner Bit-Flip im Input verändert im Durchschnitt 138 von 256 Bits im SHA-256-Ausgabehash — das entspricht 53,9 %. Die Demo läuft vollständig im Browser. "Das ist Mathematik in Aktion. Don't trust, verify." **Independent Verifier als Python-Snippet.** Fünf Zeilen Python reichen für eine vollständige Hash-Verifikation: [github.com/KopfKinoK3/usdseal-verify](https://github.com/KopfKinoK3/usdseal-verify) ## Inspector Standard & Advanced: zwei Varianten **Inspector Standard** ist schlank, Privacy-First und Reviewer-tauglich. Keine CDN-Abhängigkeiten, kein 3D-Bundle. Eignet sich für Audit-Rollen, Einkauf und air-gapped Umgebungen. **Inspector Advanced** enthält alle Standard-Features plus den optionalen 3D-Preview via Three.js. Das Three.js-Bundle (r184) wird erst on-Click geladen — der Initial-Load des Advanced beträgt 217 KB statt 1.244 KB. Beide Varianten sind kostenlos, Open Source (Apache-2.0): [github.com/KopfKinoK3/usdseal-inspector](https://github.com/KopfKinoK3/usdseal-inspector) ## 3D-Preview und Variants-Realität Der Inspector bewertet das Asset vor dem Render: - **PASS** — einfache USDA-Assets: 3D-Preview wird zuverlässig gerendert. - **CAUTION** — große USDZ oder USDC-Binary: Render-Qualität unsicher. - **BLOCK** — Variants, References oder eingebettete Sub-USDZ: Three.js rendert nur den `defaultPrim`. Variants-Assets sind im B2B-Vertrieb die Norm. Für diese ist [USDconfig](https://kopfkinok3.github.io/USDconfig-demo-player/landingpage/deutsch/) die richtige Lösung — der Inspector zeigt warum, USDconfig löst es. ## Was als nächstes kommt - **v0.28.1** — LLM-Findings-Erklärungen: Der Inspector erklärt Befunde in natürlicher Sprache. - **v0.28.2** — USDC-Material-Parser: Direktes Auslesen aus binären USDC-Assets. - **v0.3** — Ed25519-WebCrypto-Verify scharf: vollständige kryptografische Verifikation direkt im Browser. → [Inspector Advanced direkt im Browser testen](https://kopfkinok3.github.io/usdseal-inspector/advanced/)  
Update bis v0.28.0.7 Der Artikel oben dokumentiert den Stand v0.28.0. Zwischen 25. Mai und 4. Juni 2026 sind sieben weitere Patch-Releases erschienen — überwiegend Hygiene, mit einem strategisch wichtigen Feature dazwischen. **v0.28.0.4: PDF mit Prüfer-Signatur (Audit-Sektion)** Der PDF-Report bekommt einen optionalen Prüfer-Block. Vier Felder lassen sich klappbar in der Topbar ausfüllen: Name, Firma, Rolle und eine mehrzeilige Notiz für den Prüfungs-Kontext (z. B. *"Eingangsprüfung Frankfurt-Asset für Showroom Q3"*). Auf Wunsch werden die Angaben lokal im Browser gemerkt — für Wiederholungs-Prüfungen muss nichts neu eingetippt werden. Im PDF erscheinen die Angaben in einer eigenen Audit-Sektion am Report-Anfang (orange Akzentleiste, Datum automatisch gesetzt) plus auf jeder Seite im Footer als kompakte Signatur-Zeile. Die Angaben sind als **Selbstangabe** gekennzeichnet — viSales verifiziert die Identität des Prüfers nicht. Bei leeren Feldern fällt die Sektion komplett weg, der Report bleibt sauber. Damit wird der PDF-Report von einem Inspektions-Snapshot zur **Compliance-Dokumentation**: Wer hat wann mit welcher Notiz geprüft — direkt im Report nachvollziehbar. Im B2B-Vertriebsprozess deckt das den typischen Audit-Trail-Bedarf bei Asset-Übergaben an Agenturen, Messen oder Endkunden. Strategisch ergänzt das die *"Don't trust, verify"*-Story um eine zweite Vertrauensschicht: **Signatur der Datei** (USDseal-Stempel) plus **Signatur des Prüfers** (v0.28.0.4 Selbstangabe) — beide in einem Report. **v0.28.0.1 bis v0.28.0.3: UI- und Architektur-Polish** Click-Through-Links zwischen Standard und Advanced wurden beidseitig konsistent gesetzt (Header und Footer in beiden Distributionen). Die Lazy-Load-Mechanik für das Three.js-Bundle wurde gehärtet — der Initial-Load des Advanced bleibt bei 217 KB, das 3D-Bundle wird ausschließlich on-Click nachgeladen. Die Asset-Klassifikation PASS/CAUTION/BLOCK wurde gegen vier Real-World-Asset-Klassen validiert und liefert seitdem reproduzierbare Befunde vor dem Klick. **v0.28.0.5 bis v0.28.0.7: CSS- und Theme-Hygiene** Drei Patches haben das CSS-System strukturell aufgeräumt. Hintergrund: Mehrere undefinierte CSS-Variablen führten zu still fehlschlagenden Stilen — Eingabefelder waren weiß-auf-weiß unsichtbar, Panels halbtransparent. Statt nur die Symptome zu fixen, wurde ein Theme-Audit eingebaut: Der Build-Step prüft jetzt bei jedem Lauf, ob alle `var(--*)`-Calls im Code auch im Theme definiert sind, und warnt bei undefinierten Referenzen. Eine neue Reference-Dokumentation (`docs/CSS-THEME-REFERENCE.md`) listet alle 20 definierten Theme-Variablen tabellarisch plus die häufigen Anti-Pattern aus der Korrekturhistorie. Künftige UI-Sprints können das Problem damit strukturell nicht mehr neu einbauen. **Weitere Roadmap** Der nächste Sprint **v0.28.1 (Findings-Klartext, Erklärbär-Sprint)** ersetzt die ursprünglich geplante LLM-Bridge. Statt jedes Finding dynamisch von einem externen Sprachmodell erklären zu lassen, bekommt der Inspector eine kuratierte Klartext-Tabelle: Für jeden bekannten Finding-Typ (etwa *"TEXTURE_TOO_LARGE"* oder *"STRUCTURE_DEFAULT_PRIM_MISSING"*) gibt es eine verständliche Erklärung plus konkreten Fix-Vorschlag, DE und EN. Vollständig lokal, keine externe Abhängigkeit, kein API-Key, keine Datenweitergabe. Die ursprünglich angedachte LLM-Anbindung wandert in eine separate **Premium-Distribution** — sie braucht Server-Infrastruktur, was den kostenlosen Stack nicht belasten soll. Der freie Inspector bleibt damit weiterhin vollständig privacy-first und offline-tauglich. Danach folgen v0.28.2 (USDC-Material-Parser via WebAssembly) und v0.28.3 (Texture-Polyfills für KTX2/TIFF/ASTC). v0.3 wartet auf den USDseal CLI-Stand und aktiviert dann die vollständige Ed25519-Signaturverifikation direkt im Browser. **Aktueller Stand:** v0.28.0.7 — live auf [kopfkinok3.github.io/usdseal-inspector/](https://kopfkinok3.github.io/usdseal-inspector/) (Standard) und [kopfkinok3.github.io/usdseal-inspector/advanced/](https://kopfkinok3.github.io/usdseal-inspector/advanced/) (Advanced).
  *USD and USDZ are trademarks of Pixar. OpenUSD is an open standard developed and maintained by the [Alliance for OpenUSD (AOUSD)](https://aousd.org/). viSales GmbH is a member of the Alliance for OpenUSD. USDseal and the USDseal Inspector are independent open-source tools developed by viSales GmbH and are not affiliated with or endorsed by Pixar or the AOUSD.*