FreeCAD Scriptsdi GitHub Awesome Copilot Contributors

FreeCAD Scripts Skill.

Trasforma un compito di modellazione quotato in oggetti FreeCAD che restano ispezionabili e modificabili.

Design 3D
CAD
Python

Scarica OpenDesign Vedi la guida all'uso

Revisione della fonte · FreeCAD ScriptsSKILL.md

Compito Design 3D Produce • Una macro Python per FreeCAD o un oggetto parametrico creato tramite script • Un documento con solidi, schizzi o proprietà personalizzate dotati di nome • Un'esportazione richiesta in STEP, STL, IGES o OBJ Prima di iniziare FreeCAD con il suo Python incluso; il lavoro sulla GUI usa inoltre PySide incluso e il lavoro sullo scenegraph usa Pivy.

Sintesi editoriale · fonte rivista 2026-10-07 · non è un esempio generato

01 Funzionalità

Crea modelli CAD parametrici con Python

Un riferimento Python per FreeCAD che copre oggetti del documento, geometria parametrica, schizzi, interfaccia dell'applicazione e flussi di esportazione.

Flusso di lavoro basato sulla fonteNon è un benchmark di esecuzione

Il metodo di lavoro

FreeCAD Scripts guida un agente nell'ambiente Python incorporato di FreeCAD, invece di trattare un modello CAD come una generica mesh. Copre la geometria Part basata su OpenCASCADE, le operazioni Mesh, gli schizzi vincolati e gli oggetti FeaturePython le cui proprietà ricostruiscono la forma. Per questo è utile per parti ripetibili, piccoli strumenti di modellazione e automazione CAD in cui le quote contano.

La fonte distingue inoltre la logica del modello dal lavoro sull'interfaccia dell'applicazione. Finestre di dialogo PySide, pannelli operativi ed elementi dello scenegraph Coin3D richiedono la GUI, mentre il codice geometrico riutilizzabile può essere protetto per l'esecuzione headless. Un buon primo compito è una singola parte parametrizzata con un requisito di esportazione chiaro; la richiesta di un intero workbench comporta molte più responsabilità di integrazione.

Risultati attesi

Una macro Python per FreeCAD o un oggetto parametrico creato tramite script
Un documento con solidi, schizzi o proprietà personalizzate dotati di nome
Un'esportazione richiesta in STEP, STL, IGES o OBJ

Vedi il brief di esempio

Dal brief alla revisione

01
Definire unità e geometria
Descrivi dimensioni, posizionamento nelle coordinate e rappresentazione prevista, solida o mesh. La fonte imposta i millimetri come predefiniti per le lunghezze non specificate; le unità di lunghezza indicate esplicitamente vengono convertite nei millimetri interni di FreeCAD.
02
Costruire il modello del documento
Crea oggetti con nome e la geometria o i vincoli necessari. Usa FeaturePython quando proprietà modificabili devono guidare i ricalcoli futuri.
03
Ricalcolare e verificare
Ricalcola dopo le modifiche, ispeziona le proprietà della forma e convalida l'esportazione scelta. Mantieni protetti gli import della GUI se la macro deve funzionare anche senza finestra.

02 Quando usarlo

Quando usarla

FreeCAD con il suo Python incluso; il lavoro sulla GUI usa inoltre PySide incluso e il lavoro sullo scenegraph usa Pivy.

Adatta a

Parti regolabiliUtile per una parte le cui lunghezza, larghezza o altre quote di progetto devono restare proprietà esplicite invece di costanti nascoste.
Operazioni CAD ripetitiveAdatta a macro per matrici, operazioni booleane, conversione in mesh ed esportazione di oggetti selezionati.

Limiti da verificare

Python specifico dell'applicazioneI moduli di FreeCAD non sono normali moduli della libreria standard di Python. Scrivere uno script fuori da FreeCAD non convalida il suo comportamento in esecuzione.
La convalida del modello resta necessariaLa skill copre la costruzione della geometria, ma non certifica producibilità, sicurezza strutturale o idoneità alla lavorazione meccanica.

Cosa portare

Brief quotatoFornisci le quote, le tolleranze rilevanti per il compito e le unità usate nel disegno.
Parametri modificabiliIndica i valori che devono diventare proprietà del documento e le relazioni che devono restare vincolate.
Runtime ed esportazioneIndica la versione di FreeCAD, la modalità GUI o headless e il formato di file richiesto a valle.

03 Decisioni importanti

Decisioni importanti

Parametrico invece che statico
FeaturePython separa le proprietà di input della parte dalla forma generata, così una successiva modifica di una quota può attivare una ricostruzione.
Separazione tra geometria e interfaccia
Le protezioni per la GUI previste dalla fonte aiutano a evitare che una macro di modellazione utile dipenda per errore da una vista o da una finestra di dialogo aperta.

04 Esempio di brief

Prova un brief mirato

Il brief di esempio qui sotto non è stato testato. Controlla la configurazione della skill prima di usarlo.

Controlla la configurazione

Tieni i file di riferimento della skill a disposizione dell'agente. Verifica come le macro generate modificheranno il documento prima di eseguirle in FreeCAD.

File sorgente originale

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

FreeCAD con il suo Python incluso; il lavoro sulla GUI usa inoltre PySide incluso e il lavoro sullo scenegraph usa Pivy.

Parti da un solo risultato

Adatta ambito, materiale di partenza e vincoli di questo brief prima di eseguire la skill.

Brief di esempio

Usa freecad-scripts per preparare una macro FreeCAD per una piastra di montaggio rettangolare con quattro fori a uguale distanza dai bordi. Prima di costruirla, chiedi dimensioni della piastra, diametro dei fori e distanza dal bordo. Esponi questi valori come proprietà modificabili, assegna un nome all'oggetto risultante, ricalcola dopo le modifiche ed esporta una copia STEP. Mantieni il codice geometrico separato dalla visualizzazione GUI opzionale e non affermare che la parte sia pronta per la produzione.

Ispeziona il risultato

Confronta l'output reale con questi criteri osservabili.

Modificando una quota dichiarata, la geometria prevista viene ricalcolata.
Unità e posizionamento degli oggetti corrispondono al disegno fornito.
Il file esportato contiene il solido richiesto e non un oggetto vuoto o parziale non voluto.

OpenDesign offre uno spazio di lavoro di progettazione locale per agenti di programmazione. Questo elenco non significa che la skill sia inclusa nel pacchetto né che strumenti esterni, credenziali e dipendenze software siano compresi.

Scarica OpenDesign Leggi la guida rapida

05 Fonte e licenza

Fonte e licenza

Questa pagina descrive la revisione della fonte fissata collegata qui sotto. Comportamento e requisiti upstream possono cambiare.

Autore della fonte: GitHub Awesome Copilot Contributors
Repository: github/awesome-copilot
File della skill: skills/freecad-scripts/SKILL.md
Licenza: MIT
Snapshot rivisto: 2026-10-07 · 3a685010a7af

Sintesi editoriale della fonte

Un riferimento Python per FreeCAD che copre oggetti del documento, geometria parametrica, schizzi, interfaccia dell'applicazione e flussi di esportazione.

Sintesi originale di OpenDesign, basata sulla fonte collegata. Le stelle del repository sono un indicatore di popolarità datato, non un dato di utilizzo della skill né un punteggio di qualità.

06 Domande prima di iniziare

Domande prima di iniziare

Può creare oggetti parametrici modificabili?

Sì. La fonte documenta proxy FeaturePython, proprietà tipizzate e un metodo execute richiamato durante il ricalcolo del documento.

STL produce lo stesso output di STEP?

No. Il flusso distingue le mesh triangolate dai solidi Part. Scegli la rappresentazione richiesta dallo strumento successivo invece di considerare le esportazioni intercambiabili.

Ogni esempio può essere eseguito in modalità headless?

No. Finestre di dialogo, view provider e lavoro sullo scenegraph dipendono dalla GUI. Le macro headless devono proteggere od omettere queste operazioni.

OpenDesign

Fai spazio alla prossima iterazione del design.

Tieni brief, materiale di partenza e lavoro di design insieme in uno spazio di lavoro locale. Controlla la configurazione della skill prima di aggiungerla al tuo flusso di lavoro.

Scarica OpenDesign Sfoglia le skill di design