shadowtor/fusion-studio

Was macht fusion-studio?

Sie modellieren in Fusion, indem Sie Python-Skripte an dessen MCP-Server senden. Der Benutzer stellt Fotos, Maße und Geschmack zur Verfügung. Sie erstellen das Modell, betrachten es und korrigieren es.

0. Verbinden (immer zuerst)

python <fertigkeit>/scripts/fusion_mcp.py ping

Gibt die Fusion-Version und das geöffnete Dokument aus. Wenn die fusion_mcp_* MCP-Werkzeuge geladen sind, verwenden Sie diese (fusion_mcp_execute mit featureType: "script", fusion_mcp_read für Screenshots und API-Dokumentation, fusion_mcp_update für Rückgängig). Andernfalls führt der Client dasselbe über eine Shell aus. Wenn ping keine Verbindung herstellen kann, teilen Sie dem Benutzer mit, Fusion zu starten und seinen MCP-Server zu aktivieren. Raten Sie nicht.

Regeln, die die Arbeit des Benutzers schützen:

• Bearbeiten Sie niemals ein bereits geöffnetes Dokument. new_design() in fx_lib.py öffnet ein neues. Lesen Sie geöffnete Dokumente nur mit --ro.
• Speichern, schließen oder überschreiben Sie niemals, es sei denn, der Benutzer fordert es an. Exporte gehen in den Projektordner.
• Wickeln Sie run() nicht in try/except. Ein ausgelöster Fehler zeigt Ihnen, was fehlgeschlagen ist.
• Skripte können nicht geändert werden, während ein Befehlsdialog geöffnet ist. Bitten Sie den Benutzer, ihn zu schließen, oder verwenden Sie --ro zur Inspektion.

1. Den Modus auswählen (der Selektor)

Stellen Sie eine Frage und empfehlen Sie Druck, sofern die Aufgabenstellung nichts anderes vorgibt. Beginnen Sie nicht mit der Modellierung, bevor diese Frage beantwortet ist.

Modus	Für	Erstellt als	Endbearbeitung
Druck	Teile, die auf dem Drucker des Benutzers gedruckt werden: Halterungen, Klammern, Gehäuse, Schlüsselanhänger	Passungstoleranzen, Wandregeln, Ausrichtung, eine Komponente pro gedrucktem Teil	3MF pro Teil + STEP
Showcase	Gegenstände, die gezeigt, nicht gedruckt werden: Acryl-Schlüsselanhänger für eine Crowdfunding-Seite, Explosionszeichnungen für Videos	Optik zuerst: geschichtete Teile, Dicke realer Materialien, Explosionsdarstellung	PNG mit transparentem Hintergrund, OBJ, STEP
Apparel	Mockups für Bekleidungsmarken: Anhänger, Etiketten, Besätze, Knöpfe, Reißverschlussanhänger, Verpackung, Ausstellungsstücke	Flache Grafiken auf 3D-Besätzen, reale Materialstärke	PNG-Ansichten, STEP, Notizen zur Grafikplatzierung

Details: referenzen/modi.md. Fragen Sie für den Druckmodus auch nach dem Filament (PLA, PETG, ABS, ASA, TPU, Nylon, PC oder einer kohlenstoffgefüllten Variante) und verwenden Sie den Bambu Lab H2C, sofern nicht anders angegeben. Das Filament bestimmt die Passungen und die Grenzen für Wandstärke, Überhangwinkel und Brückenlänge: referenzen/materialien.md, referenzen/druckregeln.md.

Führen Sie dann python <fertigkeit>/scripts/new_project.py <name> --mode print|showcase|apparel [--material PETG] aus, um den Projektordner zu erstellen (project.json, build/, shots/, exports/).

2. Aufgabenstellung und Maße

Fragen Sie nach dem, was Sie nicht erfinden können: die tatsächliche Größe von allem, in das das Modell passen muss (eine Dose, ein Telefon, ein Schlüssel), das Material, die Wandgestaltung und Referenzfotos. Geben Sie an, welche Zahlen angenommen werden und tragen Sie sie unter assumptions in project.json ein. Eine fehlende Abmessung wird zu einem benannten Parameter mit einem offensichtlichen Standardwert, niemals zu einer versteckten Zahl.

3. Parameter zuerst

Alles Messbare wird zu einem Benutzerparameter mit einem Kommentar, in drei Gruppen: gemessen (Dosendurchmesser), Passung (Spielräume, Wand) und abgeleitet (Ausdrücke, die aus den anderen aufgebaut sind). Rufen Sie im Druckmodus zuerst print_profile("PETG") auf: Es erstellt die Parameter fit_press, fit_close, fit_free, min_wall, min_feature und hole_comp des Materials, und die Passungen sind diametral (gesamt über beide Seiten). Verwenden Sie diese, anstatt Spielräume zu erfinden. Namen sind 3+ Zeichen mit einem Unterstrich (can_dia): Einzelbuchstaben wie w, h, t kollidieren mit Einheitennamen und Fusion lehnt sie ab. Skizzenabmessungen und Extrusionsabstände verwenden die Parameterausdrücke, sodass das Ändern einer Zahl das gesamte Modell ändert. Lesen Sie referenzen/fusion-api.md, bevor Sie das erste Skript schreiben.

4. In kleinen Skripten bauen

Stellen Sie die Hilfsbibliothek mit --lib voran:

python <fertigkeit>/scripts/fusion_mcp.py run build/01_body.py --lib
python <fertigkeit>/scripts/fusion_mcp.py shot shots/01.png --dir iso-top-right

fx_lib.py bietet Ihnen new_design, param, component, sketch, rect, circle, extrude, box, fillet, chamfer, edges_where, appearance, view, health, report, export, und für den Druckmodus (fx_print.py) print_profile, print_check, fit_coupon. Eine Komponente pro physischem Teil, benannt <Teil> - DRUCK oder - SHOWCASE. Verrundungen kommen zuletzt. Betrachten Sie jeden Screenshot, bevor Sie fortfahren. Wenn Bild und Zahlen nicht übereinstimmen, vertrauen Sie dem Bild und finden Sie den Fehler.

Unbekannte API? fusion_mcp.py api "ExtrudeFeatures" --filter adsk.fusion gibt die Live-Dokumentation zurück. Bevorzugen Sie dies gegenüber dem Gedächtnis.

5. Überprüfen, bevor Sie fertig sagen

1. health() meldet 0 Probleme.
2. Parametertest: Ändern Sie den wichtigsten gemessenen Parameter, prüfen Sie erneut health() und report() und setzen Sie ihn zurück. Ein Modell, das hier bricht, ist nicht fertig.
3. Screenshots aus mindestens einer isometrischen, einer Vorderansicht und einer Schnitt- oder Unteransicht, die Sie selbst begutachten.
4. Druckmodus: print_check("PETG") (dünne Wände und Überhänge, lange Brücken, kleine oder horizontale Löcher, Bettpassung), dann die Ausrichtung, Stützen und die erste Schichtkante angeben. Beheben Sie jede WARNUNG oder erklären Sie, warum sie akzeptabel ist. Führen Sie für jede wichtige Passung zuerst fit_coupon() aus und drucken Sie ihn: Dies dauert Minuten und legt das tatsächliche Spiel für dieses Filament und diesen Drucker fest.
5. Druckmodus: Exportieren Sie die 3MF und führen Sie python <fertigkeit>/scripts/slicer_check.py exports/teil.3mf --material PETG aus. Es treibt OrcaSlicer headless auf den H2C-Profilen an und meldet wasserdicht oder nicht, Druckzeit, Filament, ob Stützen benötigt werden und ob Ihre Ausrichtung die beste des Slicers ist. Führen Sie das Ergebnis zurück in das Modell. Die GUI und der optionale orcaslicer-mcp-Server sind Alternativen: referenzen/slicer.md.
6. Sagen Sie, was nicht bewiesen ist. Ein Modell, das richtig aussieht, wurde nicht testgedruckt. Nennen Sie den ersten Testdruck und welchen Parameter Sie danach justieren würden.

6. Exportieren und übergeben

Druck: export(body, path, "3mf") für jedes Teil, plus step. Showcase: transparentes PNG pro Winkel (shot verwendet auf Anfrage einen transparenten Hintergrund), OBJ für Videotools. Apparel: PNG-Ansichten und STEP. Geben Sie dem Benutzer dann: Dateien, Parameterliste, Annahmen, den ersten durchzuführenden Test.

Was diese Fertigkeit nicht tut

• Sie sendet keine Aufträge an den Drucker und wählt keine Temperaturen oder Geschwindigkeiten. Sie slict nur, um ein Modell zu überprüfen (Stützenbedarf, Zeit, Ausrichtung) und gibt Stützenauswahlen als Ausgangspunkte an.
• Sie ersetzt keinen Testdruck. Spielräume sind Startwerte für eine 0,4-mm-Düse, keine Garantien.
• Sie kann die Fotos des Benutzers nicht sehen, es sei denn, dieser teilt sie. Fragen Sie nach Abmessungen, anstatt sie aus einem Bild zu schätzen.
• Sie modelliert keinen Stoff. Der Apparel-Modus umfasst Besätze, Etiketten, Anhänger, Hardware und Verpackung.