Technischer Deep Dive

Hash-basierte vs. geometriebasierte Duplikaterkennung für 3D-Druckdateien

Von Petros, der Meshory entwickelt · Aktualisiert am 10. Sept. 2026 · 9 Min. Lesezeit

Ja: Doppelte 3MF- und STL-Dateien lassen sich per Hash erkennen, aber nur exakte Kopien. Ein Inhalts-Hash bildet einen Fingerabdruck der Bytes einer Datei. Umbenannte Kopien gruppiert er deshalb perfekt, Re-Exporte übersieht er komplett: Wird dasselbe Mesh erneut gespeichert, entsteht eine Datei mit anderen Bytes, und für einen Hash ist das ein brandneues Modell. Um diese Kopien zu erkennen, braucht es eine zweite Stufe, einen Fingerabdruck, der aus der Geometrie selbst abgeleitet wird. Diese Seite erklärt, was jede Stufe erkennt, was sie übersieht und wie Meshory beide mit einer Prüfwarteschlange dazwischen ausführt, damit nichts allein auf das Wort einer Maschine hin bereinigt wird.

Warum der Abgleich von Dateinamen bei 3D-Modellen scheitert

Der Abgleich von Dateinamen scheitert, weil doppelte 3D-Modelle fast nie denselben Dateinamen haben und Dateien mit gleichem Namen oft völlig verschiedene Modelle sind. Kopien häufen sich durch ganz normale Gewohnheiten an: das Patreon-Paket, das du ein zweites Mal heruntergeladen hast, nur um eine fehlende Datei zurückzuholen, die Miniatur, die du vom Thingiverse-Eintrag eines Creators und noch einmal von seinem Printables-Eintrag gespeichert hast, die halb fertige Umsortierung, die neben jedem unsortierten Original eine sortierte Kopie hinterlassen hat, der USB-Stick mit Favoriten, der wieder auf die Hauptfestplatte gekippt wurde.

Jedes dieser Ereignisse ändert den Namen oder den Ort, lässt das Modell aber identisch. Genau diesen Fall kann ein Vergleich von Dateinamen nicht sehen. Der umgekehrte Fehler ist genauso häufig: Exporter spucken generische Namen wie body.stl und output_v3.stl aus, und ein Abgleich nach Namen würde munter Dateien gruppieren, die nichts gemeinsam haben. Namen sind in keiner Richtung ein verlässliches Signal.

Deshalb setzt jeder ernsthafte Ansatz auf inhaltsbasierte Duplikaterkennung: vergleichen, was in den Dateien steckt, nicht wie sie heißen. Bei 3D-Modellen hat „was in der Datei steckt“ zwei nützliche Ebenen: die Bytes und das Mesh, das diese Bytes beschreiben. Jede Ebene erkennt eine andere Art von Duplikat.

Was ein Inhalts-Hash erkennt und was er übersieht

Ein Inhalts-Hash erkennt jede byte-identische Kopie einer Datei, egal wie die Kopie heißt oder wo sie liegt. Der Hash ist ein kompakter Fingerabdruck, berechnet aus den tatsächlichen Bytes der Datei: Zwei Dateien mit demselben Fingerabdruck haben denselben Inhalt. Umbenannte Kopien, Kopien in vergessenen Ordnern, auf anderen Festplatten und auf NAS-Laufwerken landen deshalb alle in einer Gruppe. Fingerabdrücke lassen sich außerdem günstig vergleichen, und erst das macht die exakte Erkennung über Zehntausende Dateien praktikabel.

Was ein Hash übersieht, ist alles, was die Datei neu schreibt. Ein neu exportiertes Modell ist für einen Hash eine brandneue Datei. Das Mesh ist dasselbe, die Bytes sind es nicht. Wer über einen Slicer oder ein CAD-Tool neu speichert, serialisiert jeden Vertex neu. Wer eine binäre STL als ASCII exportiert (oder umgekehrt), ändert jedes Byte. Eine Umwandlung zwischen Formaten, etwa STL zu 3MF oder OBJ zu STL, legt einen anderen Container um dieselbe Form. Ein einziges abweichendes Byte bedeutet einen anderen Fingerabdruck, also landet keine dieser Kopien in derselben Gruppe.

Das ist die ehrliche Grenze von Duplikat-Findern, die nur auf Hashes setzen, einschließlich des Prüfsummen-Abgleichs, auf den sich die meisten Bibliothekstools verlassen: Sie finden deine erneuten Downloads und sind für deine Re-Exporte strukturell blind.

Was geometriebasierte Erkennung ergänzt

Geometriebasierte Erkennung vergleicht das Mesh selbst statt der Bytes, die es zufällig kodieren. So landet dasselbe Modell auch als verschiedene Dateien in einer Gruppe. In Meshory bekommt jedes Modell zusätzlich zum Inhalts-Hash einen Geometrie-Fingerabdruck. Bei STL, OBJ, 3MF und FBX stammt er aus dem in der Datei hinterlegten Mesh. Ein Re-Export unter anderem Namen oder eine einfache Umwandlung in ein anderes Format landet deshalb in derselben Duplikatgruppe wie das Original, obwohl beide kein Byte gemeinsam haben. Der Abgleich ist exakt, das Modell muss also an seiner Position bleiben: Slicer-Projekte zentrieren es meist neu und erscheinen stattdessen als wahrscheinliche Duplikate. STEP-Dateien beschreiben CAD-Flächen statt eines Meshes. Ihr Fingerabdruck wird deshalb aus der Triangulierung abgeleitet, die Meshory erzeugt, und gruppiert sie mit anderen STEP-Dateien.

Zwischen „identisch“ und „verschieden“ gibt es eine dritte Kategorie: fast identische 3D-Modelle. Eine Kopie, die verschoben, gedreht, skaliert oder neu tesselliert wurde, ist wahrscheinlich dasselbe Modell. Aber wahrscheinlich ist nicht sicher, und eine absichtlich veränderte Variante verdient es, eine Bereinigung zu überleben. Meshory zeigt diese Fälle getrennt als wahrscheinliche Duplikate zur Prüfung an: Sie werden markiert und nie stillschweigend in die Gruppen übernommen, die du in einem Rutsch bereinigen würdest.

Wie Meshory beide Stufen ausführt

Meshory führt beide Stufen in einem Durchgang aus, und diesen Durchgang startest du selbst: Klick in der Duplicates-Ansicht auf Analyze, dann berechnet Meshory die Inhalts-Hashes der Bibliothek und zusätzlich den Geometrie-Fingerabdruck. Das ist absichtlich vom Scannen getrennt, denn jedes Byte einer Bibliothek im Terabyte-Bereich zu lesen sollte nicht ungefragt im Hintergrund passieren. Die Engine wurde an einer 3,5 TB großen Bibliothek mit 118.270 Modellen robust gemacht, Archivinhalte eingeschlossen, die sich über ein NAS in etwa anderthalb Minuten indexieren lässt. Das Ergebnis ist der Duplikat-Finder für STL-Dateien: eine Duplicates-Ansicht, in der der Drache, den du dreimal unter drei Namen heruntergeladen hast, zu einem einzigen Eintrag wird, der jede Kopie und ihren Speicherort auflistet.

Die beiden sicheren Stufen, identische Bytes und identische Geometrie, sind die einzigen, die Sammelaktionen je anfassen. Beinahe-Kopien bleiben in der Warteschlange der wahrscheinlichen Duplikate unter Quarantäne, bis du dir eine Gruppe ansiehst und sie bestätigst. So ist eine Gruppe, die du bereinigst, wirklich dasselbe Modell. Die Ansicht bleibt auch in die andere Richtung ehrlich: Als Duplikate gemeldet werden nur Modelle und Archive, damit das Vorschau-Render, das ein Creator in fünfzig Ordnern wiederholt hat, die echten Funde nicht verschüttet.

• Nichts wird für dich gelöscht. Meshory gruppiert die Kopien und zeigt jeden Speicherort. Es löscht, verschiebt oder benennt nie etwas von sich aus um. Wenn du dich entscheidest, schickt Move to Trash die ausgewählten Kopien in den Papierkorb deines Systems, wo du sie noch wiederherstellen kannst.
• Alles läuft lokal. Scannen, Hashen und Gruppieren passieren auf deinem Rechner: kein Upload, keine Cloud, kein Konto.
• NAS-Quellen werden schonend behandelt. Fingerabdrücke auf Netzlaufwerken werden in einem NAS-freundlichen Tempo berechnet, und dabei werden nur Dateien gelesen, deren Größe mit der einer anderen Datei übereinstimmt. Du kannst das in der Duplicates-Ansicht pausieren oder ganz abschalten.

Die ganze Mechanik gehört zur geometriebasierten Duplikaterkennung in jeder Meshory-Lizenz: beide sicheren Stufen, die Prüfwarteschlange und was Sammelaktionen anfassen dürfen und was nicht.

Duplikate, die sich in ZIP-, RAR-, 7Z- und TAR/TGZ-Archiven verstecken

Manche deiner doppelten Modelle sind gar keine losen Dateien. Sie stecken noch in den Archiven, in denen sie angekommen sind. Ein Patreon-Bundle, das du entpackt, aber behalten hast, ein ZIP, das zweimal in verschiedene Ordner heruntergeladen wurde, dasselbe Creator-Paket einmal als Archiv und einmal entpackt: Für ein Tool, das nur lose Dateien scannt, ist diese ganze Redundanz unsichtbar.

Meshory behandelt ZIP-, RAR-, 7Z- und TAR/TGZ-Archive als Teil der Bibliothek: Modelle darin werden als vollwertige Einträge indexiert, sodass eine Kopie, die in einem heruntergeladenen ZIP steckt, mit der losen Datei daneben gruppiert wird. Du musst nichts entpacken, um herauszufinden, was doppelt ist: Der Archivinhalt landet in derselben Duplicates-Ansicht wie alles andere.

Welche Stufe brauchst du also?

Du brauchst beide Stufen, denn eine echte Bibliothek enthält beide Arten von Duplikaten: erneute Downloads, also exakte Kopien, die ein Hash erkennt, und Re-Exporte, bei denen das Mesh gleich ist, die Bytes aber abweichen und nur der Geometrie-Abgleich sie erkennt. Ein reiner Hash-Durchgang lässt die zweite Art liegen, und genau die entsteht durch Namensgewohnheiten wie _fixed und _v2 am häufigsten. Wie die Stufen in der App arbeiten, inklusive Prüfwarteschlange und Abgleich auf Ordnerebene, steht in der Referenz So funktioniert die Duplikaterkennung.

Eine benachbarte Unterscheidung solltest du klar im Kopf behalten: Wenn deine heruntergeladenen Pakete kaputt statt überflüssig sind, mit Löchern, umgedrehten Normalen oder nicht-mannigfaltigen Kanten, ist das ein Fall für Mesh-Reparatur, nicht für Duplikat-Bereinigung. Den Unterschied erklärt Reparatur vs. Duplikat-Bereinigung. Und die Deduplizierung selbst ist nur der erste Schritt eines größeren Projekts. Das komplette System steht im Leitfaden STL-Bibliothek organisieren.