Biblioteca 3D comunitaria

Gemeinschaftliche 3D-Bibliothek

HOME3D = $EXPLICADORES_3D oder ~/.explicadores-3d. Die Bibliothek befindet sich in HOME3D/biblioteca/: CATALOGO.md (eine Zeile pro Modell mit Miniatur, Parametern und Mängeln), manifiesto.json, modelos/, piezas/, base/ (Stile, lib2d, Einstellungsbereich), aportes/ (was die Community beiträgt), vendor/ (three.js, three.quarks, Tweakpane, Fredoka-Schriftart) und vista.html.

Alles ist prozedural und deterministisch: keine heruntergeladenen Texturen oder Math.random. Standard-Skalierung 1 E = 1 cm.

Ein Modell suchen und verwenden

1. Suche nach Name oder Idee, ohne den gesamten Katalog zu lesen (ca. 200 Zeilen): grep -i "mosquito\|insecto" HOME3D/biblioteca/CATALOGO.md. Lies die Zeile: Was es ist, Datei → export(Parameter), Farbstil und bekannte Mängel (insbesondere "⚠ ojos").
2. Betrachte es (optional): Starte den Server (python -m http.server 8795 innerhalb von biblioteca/) und öffne localhost:8795/vista.html?m=<id>; mit &ajustes=1 erscheint das Bedienfeld zum Bewegen der Kamera, Ändern von Farben und Lichtern. Oder betrachte das Miniaturbild miniaturas/<id>.png (in einem Unter-Agenten, wenn dein Harness es erlaubt, um keine Bilder in deinen Kontext zu laden).
3. Kopiere es in das Projekt (escena/modelos/), importiere es niemals aus der Bibliothek, und passe den Import des Stils an (../../base/estilo3d.js → ../estilo3d.js). Wenn es Partikel verwendet (piezas/particulas/), kopiere auch vendor/quarks/ und füge "quarks.core" zur Importmap hinzu.
4. Jede Datei enthält oben ihre API (Achsen, Skalierung, Methoden .poner* / .update(t)): das kommt in eine Zeile im Auftrag des Konstrukteurs.

Neue Modelle beitragen: standardmäßig aktiviert (nach jedem Video)

Beitragen ist der Normalfall: nach einem Video wird es immer angeboten, und der Benutzer muss nur Nein sagen, wenn er nicht möchte. Die Lizenz ist MIT für den Code und CC BY 4.0 für die Modelle, mit sichtbarer Nennung des Beitragenden.

1. Erkenne die neuen Modelle und Teile des Projekts (verbraucht keine Tokens; vergleicht mit der Bibliothek):

   python "SKILL_DIR/nuevos.py" <projekt>
   

   Wenn es heißt „keine neuen Modelle“ oder „der Benutzer hat bereits Nein gesagt“, frage nichts und beende.
2. Bereite alles vor dem Fragen vor, Modell für Modell. Extrahiere --nombre und --que-es aus dem Kommentar am Anfang der Datei und --fn aus dem Haupt-Export. Überprüfe vorher, dass es nichts Persönliches enthält (Kunden, Marken, Logos, Texte des eigenen Kanals), dass es deterministisch ist und keine Formen aufweist, die wie Augen gelesen werden können; was nicht erfüllt wird, wird nicht vorbereitet.

   python "SKILL_DIR/aportar.py" --archivo <projekt>/escena/modelos/regadera.js --fn crearRegadera --id regadera \
     --nombre "Gießkanne" --que-es "Gießkanne für den Garten mit Henkel und Ausguss" [--autor "<name oder @benutzer>"] --estilo casa
   

   Der Autor wird einmalig erfragt (wie er in der Nennung erscheinen möchte) und in ~/.explicadores-3d/autor.txt gespeichert. Dies erzeugt ein Miniaturbild 400x400, ficha.json (Autor, Datum, CC BY 4.0), die Zeile im Manifest und im Katalog und besteht den Validator. Es wird noch nichts hochgeladen.
3. Frage in einer Zeile mit der Liste des Vorbereiteten: Soll ich sie hochladen? (S/n). Eingabetaste, "s", "sí" oder "va" = ja. Nur "n" oder "no" (oder etwas, das es eindeutig ablehnt) = nein.
4. Ja → ein einzelner PR mit allen:

   python "SKILL_DIR/aportar.py" --publicar regadera,maceta
   python "SKILL_DIR/nuevos.py" <projekt> --subido escena/modelos/regadera.js escena/modelos/maceta.js
   

   Gib den Link zum PR. Nein → python "SKILL_DIR/nuevos.py" <projekt> --no und frage in diesem Projekt nicht erneut (auch nicht in neuen Sitzungen: bleibt in <projekt>/.biblioteca.json).

• Ohne gh: --publicar hinterlässt alles bereit und erklärt die 3 Schritte manuell (Fork auf der Webseite, Commit in einem Branch, PR). So installierst du gh: winget install GitHub.cli / brew install gh / cli.github.com, und dann gh auth login.
• Jeder PR wird von einem GitHub Action validiert (headless Browser, Determinismus, kein Netzwerk, Größe, Miniatur, Zeile und Autor) und von einer Person genehmigt. Nach der Zusammenführung erscheint der Autor im CATALOGO.md, in der Galerie index.html und im Ranking APORTADORES.md. Wer beiträgt, erhält zuerst die neuen oder herausragenden Pakete (siehe README, „Du trägst bei und erhältst“).

Einen Mangel beheben

Wenn du in einem Video einen Mangel an einem Modell aus der Bibliothek behebst, schlage die Behebung auch im Repository vor (normaler PR, mit Erklärung des Vorher und Nachher); Änderungen außerhalb von aportes/ werden manuell vom Repository-Betreuer überprüft.