English | Deutsch
Docker-Wrapper für rawel2/vault-stl-repair (MIT): repariert die Mesh-Fehler der VAULT-STL-Bibliothek (USSA Design) komplett in einem Durchlauf — plattformunabhängig auf Linux (x86/arm64) und macOS mit Docker Desktop, ohne Windows und ohne Python-Setup auf dem Host.
Die Reparatur-Methode numpy entfernt duplizierte Flächenpaare, nicht-manifold Kanten und
invertierte Flächen, bis Slicer (Bambu Studio, OrcaSlicer) die Dateien kampflos schlucken.
- Laut Upstream-Messung (älterer Bibliotheksstand mit 310 fehlerhaften Dateien) schafft die numpy-Methode 308 davon (die S6-1F/2F-Schließmodul-Varianten mit bis zu 12-fach gestapelter Wand bleiben unverändert; dafür existiert nur die Windows-Methode des Upstream-Tools).
- Geometrie bleibt erhalten (typische Abweichung 0 mm, nie schlechter als das Original — Details und Messtabellen im Upstream-Repo)
- Reparierte Dateien tragen den STL-Header
VAULT STL repair (numpy)
Voraussetzungen: Docker (mit Compose-Plugin), ~50 GB freier Speicher während des Laufs (Bibliothek ~24 GB, einmal als Eingang und einmal als Ausgang).
# 1. Repo klonen
git clone https://github.com/DocBigs-Lab/vault-repair-docker.git vault-repair && cd vault-repair
# 2. VAULT-Bibliothek bereitstellen (Ordner mit 01. DRAWERS, 02. SUSTAINERS, …)
ln -s /pfad/zu/VAULT ./vault
# 3. Zielordner und Host-User festlegen (sonst legt Docker den Ordner als root an)
mkdir -p vault_repariert
printf 'HOST_UID=%s\nHOST_GID=%s\n' "$(id -u)" "$(id -g)" > .env
# 4. Bauen (~2 min, danach kein Internet mehr nötig)
docker compose build
# 5. Reparieren (pro Worker ~3,5 GiB „available“ laut free -h, sonst --workers 1 bzw. Swap; siehe INSTALL.md)
docker compose run --rm vault-repair /vault /out --method numpy --workers 2Fertige Dateien liegen in ./vault_repariert/, mit CSV-Bericht
(vault_stl_repair.csv: Fehler vorher/nachher pro Datei).
| Kommando | Zweck |
|---|---|
docker compose run --rm vault-repair /vault /out --method numpy |
komplette Bibliothek |
… --workers 4 |
mehr Kerne parallel (größte Module brauchen bis zu ~3,3 GiB RAM pro Worker) |
… --only "S6" |
nur Dateien mit „S6“ im Pfad |
… --skip XL |
XL-Module auslassen (die größten Brocken) |
… --all |
auch fehlerfreie Dateien durch die Reparatur-Jagd schicken |
Unterbrechen jederzeit ok: Die Resume-Datei vault_stl_repair.json liegt im Zielordner —
nächster run überspringt fertige Dateien. Ctrl+C, Reboot, Container-Tod: alles egal.
Ausnahme SSH-Abbruch: Dann läuft der Container im Hintergrund weiter. Vor einem Neustart
docker ps prüfen, nie zwei Läufe auf denselben Zielordner. Lange Läufe am besten in tmux.
Wie viele Dateien Fehler haben, hängt vom Stand deiner gelieferten Bibliothek ab
(USSA liefert nach und nach fixes nach) — die Laufzeit folgt der Fehlerzahl pro
Datei, nicht der Dateigröße: die zwei M5-Module mit je 1.300–1.700 s waren
langsamer als alle anderen 43 reparierten zusammen. Details und Tempo-Hebel
(--skip XL, --workers, Resume-Neustart) in INSTALL.md.
Nur ein ~15-Zeilen-Dockerfile: python:3.12-slim + numpy (Version gepinnt), die beiden
Upstream-Skripte als fester Commit einkopiert und per sha256-Prüfsumme festgenagelt —
das Reparatur-Tool driftet nicht mit Upstream mit. (Das Basis-Image python:3.12-slim ist
ein wandernder Tag und bekommt Sicherheits-Updates.) compose.yaml mountet die Quelle
read-only und den Zielordner lesend-schreibend; Container läuft als Nicht-Root mit
UID/GID aus .env (Standard 1000:1000).
Details zur Installation (UID ermitteln, Mount-Varianten, Troubleshooting): siehe INSTALL.md.
- Die zwei S6-Module (1F/2F) bleiben unbearbeitet — Upstream-Limit der numpy-Methode
--method windowsbraucht Windows und funktioniert nicht im Container- Die STLs selbst sind nicht Teil dieses Repos (© USSA Design, nur für Backer/Lizenznehmer)
- Diese Docker-Hülle ist inoffiziell, kein Upstream-Teil; Upstream-Autoren: rawel2 + Claude
MIT (Wrapper-Code). Upstream-Tool: MIT (rawel2). VAULT-Design/STLs: © USSA Design.