Zur Nutzungsanleitung springen

FreeCAD Scripts Skill.

Übersetzen Sie eine bemaßte Modellierungsaufgabe in FreeCAD-Objekte, die nachvollziehbar und anpassbar bleiben.

  • 3D-Design
  • CAD
  • Python
Quellenprüfung · FreeCAD ScriptsSKILL.md
Aufgabe 3D-Design Ergebnis • Ein FreeCAD-Python-Makro oder skriptgesteuertes parametrisches Objekt • Ein Dokument mit benannten Volumenkörpern, Skizzen oder benutzerdefinierten Eigenschaften • Ein gewünschter Export als STEP, STL, IGES oder OBJ Vor dem Start FreeCAD mit mitgeliefertem Python; für GUI-Arbeit wird zusätzlich das mitgelieferte PySide verwendet, für Szenegraph-Arbeit Pivy.
Redaktionelle Zusammenfassung · Quelle geprüft 2026-10-07 · kein generiertes Beispiel

01 Funktionen

Parametrische CAD-Modelle mit Python erstellen

Eine FreeCAD-Python-Referenz zu Dokumentobjekten, parametrischer Geometrie, Skizzen, Anwendungsoberfläche und Export-Workflows.

Quellenbasierter WorkflowKein Ausführungs-Benchmark

Die Arbeitsweise

FreeCAD Scripts führt einen Agenten durch die eingebettete Python-Umgebung von FreeCAD, statt ein CAD-Modell als generisches Netz zu behandeln. Abgedeckt sind OpenCASCADE-basierte Part-Geometrie, Mesh-Operationen, bemaßte Skizzen und FeaturePython-Objekte, deren Eigenschaften die Form neu aufbauen. Das ist relevant für wiederholbare Bauteile, kleine Modellierungswerkzeuge und CAD-Automatisierung, bei der Maße zählen.

Die Quelle unterscheidet außerdem zwischen Modelllogik und Arbeit an der Anwendungsoberfläche. PySide-Dialoge, Task-Panels und Coin3D-Szenegraph-Elemente erfordern die GUI, während wiederverwendbarer Geometriecode für die Ausführung ohne GUI abgesichert werden kann. Ein sinnvoller erster Auftrag ist ein einzelnes parametrisiertes Bauteil mit klarer Exportanforderung; eine umfassende Anfrage für eine ganze Workbench bedeutet deutlich mehr Integrationsaufwand.

Erwartete Ergebnisse

  • Ein FreeCAD-Python-Makro oder skriptgesteuertes parametrisches Objekt
  • Ein Dokument mit benannten Volumenkörpern, Skizzen oder benutzerdefinierten Eigenschaften
  • Ein gewünschter Export als STEP, STL, IGES oder OBJ
Beispielbriefing ansehen

Vom Briefing zur Prüfung

  1. 01
    Einheiten und Geometrie klären

    Beschreiben Sie Maße, Koordinatenplatzierung und die vorgesehene Darstellung als Volumenkörper oder Netz. Die Quelle setzt nicht angegebene Längen standardmäßig auf Millimeter; ausdrücklich angegebene Längeneinheiten werden in die interne Einheit von FreeCAD, Millimeter, umgerechnet.

  2. 02
    Das Dokumentmodell aufbauen

    Erstellen Sie benannte Objekte und die nötige Geometrie bzw. Constraints. Verwenden Sie FeaturePython, wenn bearbeitbare Eigenschaften künftige Neuberechnungen steuern sollen.

  3. 03
    Neu berechnen und prüfen

    Berechnen Sie nach Änderungen neu, prüfen Sie die Formeigenschaften und validieren Sie den gewählten Export. Halten Sie GUI-Importe abgesichert, wenn das Makro auch ohne Fenster laufen muss.

02 Einsatzbereiche

Wann es sich eignet

FreeCAD mit mitgeliefertem Python; für GUI-Arbeit wird zusätzlich das mitgelieferte PySide verwendet, für Szenegraph-Arbeit Pivy.

Gut geeignet

  • Anpassbare BauteileNützlich für ein Bauteil, dessen Länge, Breite oder andere Konstruktionsmaße explizite Eigenschaften bleiben sollen statt versteckter Konstanten.
  • Wiederkehrende CAD-OperationenPasst zu Makros für Arrays, boolesche Operationen, Netzkonvertierung und den Export ausgewählter Objekte.

Zu prüfende Grenzen

  • Anwendungsspezifisches PythonDie FreeCAD-Module gehören nicht zur normalen Python-Standardbibliothek. Ein außerhalb von FreeCAD entworfenes Skript validiert sein Laufzeitverhalten nicht.
  • Modellvalidierung bleibt wichtigDer Skill deckt die Geometriekonstruktion ab, bescheinigt aber weder Fertigbarkeit noch Tragsicherheit oder Eignung für die Zerspanung.

Diese Eingaben mitbringen

  • Bemaßtes BriefingGeben Sie Maße, für die Aufgabe relevante Toleranzen und die in der Zeichnung verwendeten Einheiten an.
  • Bearbeitbare ParameterBenennen Sie die Werte, die zu Dokumenteigenschaften werden sollen, und die Beziehungen, die als Constraints erhalten bleiben sollen.
  • Laufzeit und ExportNennen Sie die FreeCAD-Version, den GUI- oder Headless-Modus und das benötigte nachgelagerte Dateiformat.

03 Wichtige Entscheidungen

Wichtige Entscheidungen

  1. Parametrisch statt statisch

    FeaturePython trennt die Eingabeeigenschaften des Bauteils von seiner erzeugten Form, sodass eine spätere Maßänderung einen Neuaufbau auslösen kann.

  2. Trennung von Geometrie und Oberfläche

    Die GUI-Absicherungen der Quelle verhindern, dass ein nützliches Modellierungsmakro versehentlich von einer geöffneten Ansicht oder einem Dialog abhängt.

04 Beispielbriefing

Mit einem fokussierten Briefing testen

Das folgende Beispielbriefing wurde nicht getestet. Prüfen Sie die Einrichtung des Skills, bevor Sie es verwenden.

Einrichtung prüfen

Halten Sie die Referenzdateien des Skills für den Agenten verfügbar. Prüfen Sie, wie erzeugte Makros das Dokument verändern, bevor Sie sie in FreeCAD ausführen.

Upstream-Quelldatei
https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/freecad-scripts/SKILL.md

FreeCAD mit mitgeliefertem Python; für GUI-Arbeit wird zusätzlich das mitgelieferte PySide verwendet, für Szenegraph-Arbeit Pivy.

Mit einem Ergebnis beginnen

Passen Sie Umfang, Quellmaterial und Vorgaben dieses Briefings an, bevor Sie den Skill ausführen.

Beispielbriefing
Nutze freecad-scripts, um ein FreeCAD-Makro für eine rechteckige Montageplatte mit vier gleichmäßig eingerückten Bohrungen zu entwerfen. Frage vor der Konstruktion nach Plattenmaßen, Bohrungsdurchmesser und Einrückung. Stelle diese Werte als bearbeitbare Eigenschaften bereit, benenne das resultierende Objekt, berechne nach Änderungen neu und exportiere eine STEP-Kopie. Halte den Geometriecode getrennt von der optionalen GUI-Anzeige und behaupte nicht, das Bauteil sei fertigungsreif.

Ergebnis prüfen

Prüfen Sie das tatsächliche Ergebnis anhand dieser beobachtbaren Kriterien.

  • Eine Änderung eines deklarierten Maßes berechnet die vorgesehene Geometrie neu.
  • Einheiten und Objektplatzierung entsprechen der gelieferten Zeichnung.
  • Die exportierte Datei enthält den gewünschten Volumenkörper und kein unbeabsichtigt leeres oder unvollständiges Objekt.

OpenDesign bietet einen lokalen Design-Arbeitsbereich für Coding-Agenten. Dieser Eintrag bedeutet nicht, dass der Skill mitgeliefert wird oder dass seine externen Tools, Zugangsdaten und Software-Abhängigkeiten enthalten sind.

05 Quelle und Lizenz

Quelle und Lizenz

Diese Seite beschreibt die unten verlinkte, fest ausgewählte Quellversion. Verhalten und Anforderungen im Upstream können sich ändern.

Lizenz
MIT
Geprüfter Stand
2026-10-07 · 3a685010a7af
Redaktionelle Quellenzusammenfassung
Eine FreeCAD-Python-Referenz zu Dokumentobjekten, parametrischer Geometrie, Skizzen, Anwendungsoberfläche und Export-Workflows.

Originalzusammenfassung von OpenDesign auf Grundlage der verlinkten Quelle. Repository-Sterne sind ein datiertes Popularitätssignal, keine Skill-Nutzung und keine Qualitätsbewertung.

06 Fragen vor dem Start

Fragen vor dem Start

Kann er bearbeitbare parametrische Objekte erzeugen?

Ja. Die Quelle dokumentiert FeaturePython-Proxys, typisierte Eigenschaften und eine execute-Methode, die bei der Dokumentneuberechnung aufgerufen wird.

Ist STL dieselbe Ausgabe wie STEP?

Nein. Der Workflow unterscheidet triangulierte Netze von Part-Volumenkörpern. Wählen Sie die Darstellung, die das nächste Tool verlangt, und behandeln Sie die Exporte nicht als austauschbar.

Lässt sich jedes Beispiel ohne GUI ausführen?

Nein. Dialoge, View Provider und Szenegraph-Arbeit hängen von der GUI ab. Makros ohne GUI müssen diese Operationen absichern oder weglassen.

OpenDesign

Schaffen Sie Raum für die nächste Design-Iteration.

Halten Sie Briefing, Quellmaterial und Designarbeit in einem lokalen Arbeitsbereich zusammen. Prüfen Sie die Einrichtung des Skills, bevor Sie ihn in Ihren Workflow aufnehmen.

Upstream-Quelldatei
https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/freecad-scripts/SKILL.md