FreeCAD Scriptspor GitHub Awesome Copilot Contributors

FreeCAD Scripts Skill.

Transforme uma tarefa de modelagem com dimensões em objetos do FreeCAD que continuem inspecionáveis e ajustáveis.

Design 3D
CAD
Python

Revisão da fonte · FreeCAD ScriptsSKILL.md

Tarefa Design 3D Produz • Uma macro Python do FreeCAD ou um objeto paramétrico criado por script • Um documento com sólidos nomeados, esboços ou propriedades personalizadas • Uma exportação em STEP, STL, IGES ou OBJ, se solicitada Antes de começar FreeCAD com o Python incluído; o trabalho com GUI usa também o PySide incluído, e o trabalho com scenegraph usa o Pivy.

Resumo editorial · fonte revisada em 2026-10-07 · não é um exemplo gerado

01 Funcionalidades

Crie modelos CAD paramétricos com Python

Uma referência de Python para FreeCAD que abrange objetos de documento, geometria paramétrica, esboços, interface do aplicativo e fluxos de exportação.

Fluxo de trabalho baseado na fonteNão é um benchmark de execução

A abordagem de trabalho

FreeCAD Scripts orienta um agente pelo ambiente Python incorporado do FreeCAD, em vez de tratar um modelo CAD como uma malha genérica. Abrange geometria Part baseada em OpenCASCADE, operações de Mesh, esboços com restrições e objetos FeaturePython cujas propriedades reconstroem a forma. Isso a torna relevante para peças repetíveis, pequenas ferramentas de modelagem e automação de CAD em que as dimensões importam.

A fonte também distingue a lógica do modelo do trabalho de interface do aplicativo. Diálogos PySide, painéis de tarefas e elementos de scenegraph do Coin3D exigem a GUI, enquanto o código de geometria reutilizável pode ser protegido para execução sem interface. Uma boa primeira tarefa é uma única peça parametrizada com um requisito de exportação claro; um pedido amplo por um workbench inteiro acrescenta bem mais responsabilidade de integração.

Entregas esperadas

Uma macro Python do FreeCAD ou um objeto paramétrico criado por script
Um documento com sólidos nomeados, esboços ou propriedades personalizadas
Uma exportação em STEP, STL, IGES ou OBJ, se solicitada

Ver o briefing de exemplo

Do briefing à revisão

01
Definir unidades e geometria
Descreva as dimensões, o posicionamento nas coordenadas e a representação pretendida, sólido ou malha. A fonte assume milímetros para comprimentos sem unidade; unidades de comprimento informadas explicitamente são convertidas para os milímetros internos do FreeCAD.
02
Construir o modelo do documento
Crie objetos nomeados e a geometria ou as restrições necessárias. Use FeaturePython quando propriedades editáveis devem conduzir recomputações futuras.
03
Recomputar e verificar
Recompute após as alterações, inspecione as propriedades da forma e valide a exportação escolhida. Mantenha as importações de GUI protegidas se a macro também precisar rodar sem janela.

02 Quando usar

Quando usar

FreeCAD com o Python incluído; o trabalho com GUI usa também o PySide incluído, e o trabalho com scenegraph usa o Pivy.

Bom encaixe

Peças ajustáveisÚtil para uma peça cujo comprimento, largura ou outras dimensões de projeto devem permanecer propriedades explícitas, e não constantes ocultas.
Operações repetitivas de CADServe para macros de arranjos, operações booleanas, conversão de malha e exportação de objetos selecionados.

Limites a verificar

Python específico do aplicativoOs módulos do FreeCAD não são módulos comuns da biblioteca padrão do Python. Escrever um script fora do FreeCAD não valida seu comportamento em execução.
A validação do modelo continua importandoA Skill cobre a construção de geometria, mas não certifica fabricabilidade, segurança estrutural nem adequação à usinagem.

Traga estas entradas

Briefing com dimensõesInforme as dimensões, as tolerâncias relevantes para a tarefa e as unidades usadas no desenho.
Parâmetros editáveisIndique os valores que devem virar propriedades do documento e as relações que devem permanecer restritas.
Execução e exportaçãoInforme a versão do FreeCAD, o modo (com GUI ou sem interface) e o formato de arquivo necessário na etapa seguinte.

03 Decisões importantes

Decisões que importam

Paramétrico, não estático
FeaturePython separa as propriedades de entrada da peça da forma gerada, de modo que uma mudança posterior de dimensão possa acionar uma reconstrução.
Separação entre geometria e interface
As proteções de GUI da fonte ajudam a evitar que uma macro de modelagem útil dependa sem querer de uma vista ou de um diálogo abertos.

04 Exemplo de briefing

Experimente um briefing focado

O briefing de exemplo abaixo não foi testado. Confira a configuração da skill antes de usá-lo.

Revise a configuração

Mantenha os arquivos de referência da skill disponíveis para o agente. Revise como as macros geradas alterarão o documento antes de executá-las no FreeCAD.

Arquivo-fonte original

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

FreeCAD com o Python incluído; o trabalho com GUI usa também o PySide incluído, e o trabalho com scenegraph usa o Pivy.

Comece com uma única entrega

Adapte o escopo, o material de origem e as restrições deste briefing antes de executar a skill.

Briefing de exemplo

Use freecad-scripts para escrever uma macro do FreeCAD para uma placa de montagem retangular com quatro furos igualmente afastados das bordas. Pergunte as dimensões da placa, o diâmetro dos furos e o afastamento antes de construí-la. Exponha esses valores como propriedades editáveis, dê um nome ao objeto resultante, recompute após as alterações e exporte uma cópia em STEP. Mantenha o código de geometria separado da exibição opcional na GUI e não afirme que a peça está pronta para fabricação.

Inspecione o resultado

Compare a saída real com estes critérios observáveis.

Alterar uma dimensão declarada recomputa a geometria pretendida.
As unidades e o posicionamento dos objetos correspondem ao desenho fornecido.
O arquivo exportado contém o sólido solicitado, e não um objeto vazio ou parcial não intencional.

OpenDesign oferece um espaço de trabalho de design local para agentes de programação. Esta listagem não significa que a skill esteja incluída nem que suas ferramentas externas, credenciais e dependências de software estejam incluídas.

Baixar OpenDesign Ler o guia rápido

05 Fonte e licença

Fonte e licença

Esta página descreve a revisão fixada da fonte indicada abaixo. O comportamento e os requisitos originais podem mudar.

Proprietário da fonte: GitHub Awesome Copilot Contributors
Repositório: github/awesome-copilot
Arquivo da skill: skills/freecad-scripts/SKILL.md
Licença: MIT
Versão revisada: 2026-10-07 · 3a685010a7af

Resumo editorial da fonte

Uma referência de Python para FreeCAD que abrange objetos de documento, geometria paramétrica, esboços, interface do aplicativo e fluxos de exportação.

Resumo original de OpenDesign, com base na fonte vinculada. As estrelas do repositório são um sinal de popularidade datado, não indicam uso da skill nem são uma nota de qualidade.

06 Perguntas antes de começar

Dúvidas antes de começar

Ela consegue criar objetos paramétricos editáveis?

Sim. A fonte documenta proxies FeaturePython, propriedades tipadas e um método execute chamado durante a recomputação do documento.

STL é a mesma saída que STEP?

Não. O fluxo distingue malhas triangulares de sólidos Part. Escolha a representação exigida pela próxima ferramenta, em vez de tratar as exportações como intercambiáveis.

Todos os exemplos rodam sem interface gráfica?

Não. Diálogos, view providers e o trabalho com scenegraph dependem da GUI. Macros sem interface devem proteger ou omitir essas operações.

OpenDesign

Abra espaço para a próxima iteração de design.

Mantenha seu briefing, o material de origem e o trabalho de design juntos em um espaço de trabalho local. Confira a configuração da própria skill antes de adicioná-la ao seu fluxo de trabalho.

Baixar OpenDesign Ver skills de design