Meshy 3D – Generierung + Druck
Verwenden Sie die Meshy CLI 0.8 (0.8.5 oder neuer), um die Anfrage des Benutzers in ein ausgeliefertes Asset umzusetzen: die angeforderten Dateien am gewünschten Ort, eine Vorschau zur Inspektion, falls vorhanden, und – für Drucke – die vorgesehene Größe, Analyse-/Reparaturergebnisse und eine Slicer-Übergabe auf Wunsch. Die reine Anmeldung oder Aufgabeneinreichung allein ist kein Abschluss. Wählen Sie die kürzeste geeignete Pipeline und verwenden Sie vorhandene Assets für Folgefragen wieder.
SICHERHEITSMANIFEST
Ausführbare Dateien: die Meshy CLI – meshy, oder das temporäre, fixierte Paket npm exec --yes [email protected] -- meshy – plus npm zur Installation, node --version zur Laufzeitprüfung. Kein Python, kein curl, keine gebündelten Skripte.
Anmeldedaten: Die browserbasierte Anmeldung der CLI (OAuth-Gerätefluss) speichert und erneuert eine Sitzung in ~/.config/meshy/credentials.v2.json (Modus 0600), verschlüsselt mit einem vom Betriebssystem verwalteten Schlüssel. Ein vorhandener MESHY_API_KEY oder eine explizite --api-key-file wird beachtet und hat Vorrang. Das Skill liest, druckt oder kopiert nie ein Token, einen Gerätecode oder einen Schlüssel und fragt niemals danach im Chat. MESHY_API_KEY ist optional.
Netzwerk: die Meshy-API (api.meshy.ai) und ihre Anmeldeseite (www.meshy.ai), oder api.meshy.cn und meshy.cn auf der China-Seite; die Medien-Hosts der heruntergeladenen Assets oder der überprüften Eingabe-URLs, ohne die Anmeldedaten; die npm-Registrierung, wenn die CLI installiert oder als temporäres Paket ausgeführt wird.
Dateien: Schreibt nur innerhalb eines Arbeitsbereichs pro Aufgabe – das vom Benutzer benannte Verzeichnis oder ./meshy_output – und die CLI verweigert Pfade, die diesen verlassen, einschließlich symbolischer Links. Vorhandene Dateien werden nicht überschrieben, es sei denn, der Benutzer hat darum gebeten. Liest die Eingabedateien, auf die der Benutzer verweist, und seine eigenen Ausgaben im Arbeitsbereich (Vorschauen, Begleitdateien). Die Slicer-Übergabe startet eine bereits installierte Slicer-Anwendung.
Von diesem Rechner abgehende Daten: Aufforderungen, Eingabebilder/-modelle und Aufgabenanfragen, die an Meshy gesendet werden.
Lesen Sie, was diese Anfrage benötigt
| Bedarf | Referenz |
|---|---|
| CLI-Ausführung, Anmeldung oder Ausgabeort | Einrichtung |
| Digitale Assets: Generierung und die Modelle für ein Projekt, Texturierung, Remeshing, Konvertierung, Bilder | Pipelines |
| Rigging, Animation oder generierte Bewegung | Animation |
| Physische Drucke: lokale Vorbereitung, Druckerzeugung, Analyse/Reparatur, Slicer | Druckrezepte |
| Creative Lab Produkte (Figuren, Lampen, Schlüsselanhänger, Magnete, Tastenkappen, Fidget-Spielzeuge) | Creative Lab |
| Kosten, Wartezeit, Vorschau, Lieferung oder Suche nach einem früheren Modell | Lieferung |
| Fehlgeschlagene oder unsichere Operation | Fehlerbehebung |
Lesen Sie bei Bedarf den entsprechenden Abschnitt; Rezepte sind Beispiele zur Anpassung, keine vollständig auszuführenden Schritte. Ein untexturiertes Modell überspringt die Texturierung; eine vorhandene GLB benötigt keine Konvertierung. Verwenden Sie den Befehl --help, wenn Parameter unsicher sind.
Digitales Asset oder physischer Druck
Alles, was gedruckt werden soll – ein Druck, Slicer, 3MF, STL, Bambu/Orca/Prusa/Cura, Mehrfarben, ein Schreibtischspielzeug oder eine physische Figur – folgt ab dem ersten Befehl den Druckrezepten, damit die Generierungsparameter zum Druck passen. Alles andere folgt den Pipelines.
| Druckanfrage | Route |
|---|---|
| Vorhandenes OBJ skalieren, ausrichten oder auf den Boden setzen | Lokal mesh prepare-print; keine Anmeldung oder Guthaben erforderlich |
| Vorhandene STL oder 3MF öffnen | Lokal slicer detect und slicer open; keine Anmeldung oder Guthaben erforderlich |
| Weißes Modell aus einem Foto, einer Skizze oder Text | Foto: image-to-3d. Sonst zuerst ein Referenzbild empfehlen (Mehrfachansicht, wenn Tiefe oder Seiten wichtig sind), mit text-to-3d als schnellerer Alternative; Geometrie ohne Texturen; Analyse/Reparatur bei Bedarf; Datei vorbereiten |
| Mehrfarbenmodell | Geometrie generieren/wiederverwenden; Analyse/Reparatur bei Bedarf; texturieren; mehrfarben-drucken |
| Druck in separaten Teilen (Bauplatte, Farben pro Teil, weniger Stützen) | Geometrie generieren/wiederverwenden; automatisch teilen; Teile slicen |
| Vorhandenes Modell prüfen oder reparieren (Löcher, dünne Wände), jedes Format | Kostenlose Druckbarkeitsanalyse über Aufgaben-ID oder --model-url; Reparatur nur bei Bedarf |
| Vorhandene STL, 3MF oder GLB in der Größe ändern | Im Slicer skalieren; nur ein OBJ wird lokal in der Größe geändert |
| Creative Lab Figur (stilisierte Sammlerfigur aus einem Foto), Vinyl-Figur, Ziegelstein-Figur, Lampe, Schlüsselanhänger, Kühlschrankmagnet, Tastenkappe oder Pixel-Fidget-Board | Prototyp → Überprüfung → Bau → Produktartefakte auswählen |
| Creative Lab zusammenklappbares Fidget-Spielzeug | Einmal aus dem Foto erstellen → STL |
Farb-Routen unterscheiden sich: Mehrfarbig bemalt die Oberfläche eines Objekts für einen Multi-Material-Drucker; eine Teilung schneidet es in Teile, jeweils ein Filament, und verwirft die Textur (Teilung vor jeder Reparatur; die beiden lassen sich nicht verketten); das Pixel-Fidget-Board ist ein eigenes Produkt.
Eine einzelne Figur impliziert nicht Creative Lab. Fragen Sie nach Größe, Farbe oder Stil nur, wenn die fehlende Wahl das Ergebnis wesentlich verändert.
Erste Verwendung und Anmeldung auf OpenClaw
Führen Sie vor dem ersten Befehl meshy --version aus; nicht fragen. Wenn meshy fehlt oder älter als 0.8.5 ist, installieren Sie die neueste 0.8.x mit npm install -g [email protected] und teilen Sie dies in einer Zeile mit; die Einrichtung deckt eine verweigerte Installation und eine CLI ab 0.9 ab. Lokale reine Druckarbeit endet hier. Alles andere verwendet eine verifizierte auth status-Sitzung wieder; nur wenn keine vorhanden ist, anmelden:
- Starten Sie
meshy auth login --device --format json --no-update-check(fügen Sie--region cnfür einen Benutzer auf dem chinesischen Festland hinzu: dasselbe Konto und Guthaben wie die globale Seite) mitexecund einem kurzenyieldMs(etwa 3000) undtimeoutSeconds: 900, damit es im Hintergrund läuft und einesessionIdzurückgibt. - Die CLI gibt innerhalb von Sekunden
Geben Sie den Code … auf https://www.meshy.ai/device einauf stderr aus. Wenn die erste Ausgabe nur npm-Hinweise enthält,process pollauf dieselbesessionId. Senden Sie dem Benutzer die URL als Link und den Code wortwörtlich, sowie die Anweisung: Öffnen, bei Meshy anmelden, falls erforderlich, den Code eingeben, bestätigen. Es muss nichts zurück in den Chat gesendet werden. - Starten Sie keine zweite Anmeldung, beenden Sie die Sitzung nicht oder führen Sie keinen eigenen HTTP-Poll durch; die CLI wartet auf die Bestätigung. Wenn sie beendet wird, weckt OpenClaw diese Sitzung; sammeln Sie das Ergebnis mit
process poll(ein Subagent, der keinen Wake erhält, pollt vor der Übergabe). Überprüfen Sie dannauth statusund setzen Sie die ursprüngliche Anfrage mit den bereits angegebenen Eingaben, Pfaden und Budget fort.
Eine Hintergrundsitzung darf nicht mit & oder nohup getrennt werden. Ein abgelaufener oder abgelehnter Code bedeutet, dass dieselbe Anmeldung erneut ausgeführt wird; er rechtfertigt niemals die erneute Ausführung einer bezahlten Aufgabe. Lange wait-Befehle verhalten sich genauso: Lassen Sie exec sie im Hintergrund laufen und setzen Sie ab dem Abschluss-Wake fort, anstatt erneut zu senden oder in einer sleep-Schleife zu laufen.
Nur die CLI greift auf ihr Konfigurationsverzeichnis zu; eine durch eine Sandbox blockierte Anmeldung folgt der Einrichtung, Abschnitt 3.
Ausführungsgrenzen
- Führen Sie API-, Upload-, Download- und Netzoperationen über die CLI aus. Lokale Eingaben haben ein Limit von 50 MiB, und ein lokales Modell muss GLB oder glTF sein (Rigging, UV-Entfaltung und Mehrfarben: GLB); verwenden Sie für alles andere die unterstützte URL-Eingabe-Route.
- Jeder Befehl verwendet
--format json --no-update-checkund gibt einenmeshy.cli/v1-Envelope aus, Authentifizierung enthalten. Ermitteln SieWORKSPACEaus dem vom Benutzer angegebenen Ausgabepfad und übergeben Sie es bei jedem Schreibvorgang. - Wissen Sie, wofür das Modell ist, vor der ersten kostenpflichtigen Erstellung: ein Spiel-Asset, eine Figur zum Rigg, ein Render, ein 3D-Druck. Wenn der Benutzer es nicht gesagt hat, fragen Sie einmal; die Antwort bestimmt die Route und die Modelle (Pipelines). Ein Spiel-Asset oder ein Polygon-Budget bedeutet intelligente Topologie, nicht ein heruntergerechnetes Standardmodell.
- Einmal einreichen mit
create --async, die besitzende Ressource und Aufgaben-ID behalten, dann auf diese Aufgabewaiten. Timeouts und unbekannte Einreichungen folgen der Fehlerbehebung; sie autorisieren niemals eine weitere kostenpflichtige Erstellung. - Ohne ein brauchbares Foto empfehlen Sie, zuerst ein Referenzbild zu erstellen und das Modell daraus zu bauen; text-to-3d ist die schnellere Alternative (Pipelines, Von einem Bild aus starten; Drucke: Druckrezepte, Abschnitt 1).
- Arbeiten Sie innerhalb des genehmigten Umfangs und Budgets; schlagen Sie zusätzliche kostenpflichtige Schritte oder Wiederholungen vor der Ausgabe vor. Die lokale Vorbereitung und Druckbarkeitsanalyse sind kostenlos; die Lieferung enthält Kostenschätzungen.
- Reparatur ändert die Geometrie und verwirft Texturen: Verwenden Sie die reparierte Geometrie nachgelagert und texturieren Sie vor der Mehrfarbenausgabe neu. Bereiten Sie ein Y-up-OBJ einmal als neue Datei vor; wenden Sie diese Transformation niemals auf STL-, 3MF- oder Reliefproduktausgaben an.
Liefern
Laden Sie nur die benötigten Assets herunter. Senden Sie dem Benutzer eine verfügbare gerenderte Vorschau als Bild; eine fehlende Vorschau wird angegeben, niemals impliziert, und ein gerendertes PNG ist kein 3D-Viewer. Melden Sie Dateipfade, Aufgaben-IDs für Folgefragen und die tatsächlichen Kosten. Melden Sie für Drucke auch Abmessungen und den Analyse-/Reparaturstatus; starten Sie einen erkannten Slicer nur auf Anfrage und beachten Sie, dass launch_requested nicht beweist, dass das Modell importiert wurde. Erwähnen Sie relevante verbleibende Prüfungen wie Stützen und Wandstärke, ohne ein ungetestetes Modell als druckbar zu bezeichnen.