Перейти к руководству
FreeCAD Scriptsавтор GitHub Awesome Copilot Contributors

FreeCAD Scripts Skill.

Превратите задачу моделирования с размерами в объекты FreeCAD, которые можно проверять и изменять.

  • 3D-дизайн
  • CAD
  • Python
Обзор источника · FreeCAD ScriptsSKILL.md
Задача 3D-дизайн Результат • Макрос FreeCAD на Python или параметрический объект, созданный скриптом • Документ с именованными телами, эскизами или пользовательскими свойствами • Экспорт в STEP, STL, IGES или OBJ по запросу Перед началом FreeCAD со встроенным Python; для работы с GUI дополнительно используется встроенный PySide, а для работы со сценографом — Pivy.
Редакторское резюме · источник проверен 2026-10-07 · не сгенерированный пример

01 Возможности

Создавайте параметрические CAD-модели на Python

Справочник по FreeCAD Python: объекты документа, параметрическая геометрия, эскизы, интерфейс приложения и процессы экспорта.

Рабочий процесс на основе источникаНе тест производительности выполнения

Принцип работы

FreeCAD Scripts помогает агенту работать со встроенной средой Python в FreeCAD, а не воспринимать CAD-модель как обычную полигональную сетку. Он охватывает геометрию Part на базе OpenCASCADE, операции с Mesh, эскизы с ограничениями и объекты FeaturePython, свойства которых перестраивают форму. Это актуально для повторяемых деталей, небольших инструментов моделирования и автоматизации CAD, где важны размеры.

Источник также разделяет логику модели и работу с интерфейсом приложения. Диалоги PySide, панели задач и элементы сценографа Coin3D требуют GUI, а повторно используемый код геометрии можно защитить для запуска без интерфейса. Хорошая первая задача — одна параметрическая деталь с чётким требованием к экспорту; широкий запрос на целый верстак (workbench) добавляет заметно больше работы по интеграции.

Ожидаемые результаты

  • Макрос FreeCAD на Python или параметрический объект, созданный скриптом
  • Документ с именованными телами, эскизами или пользовательскими свойствами
  • Экспорт в STEP, STL, IGES или OBJ по запросу
Смотреть пример задания

От задания к проверке

  1. 01
    Уточните единицы и геометрию

    Опишите размеры, положение в координатах и нужное представление: тело или сетка. Если длины не указаны, в источнике по умолчанию используются миллиметры; явно заданные единицы длины переводятся во внутренние миллиметры FreeCAD.

  2. 02
    Постройте модель документа

    Создайте именованные объекты и необходимую геометрию или ограничения. Используйте FeaturePython, если редактируемые свойства должны управлять последующим пересчётом.

  3. 03
    Пересчитайте и проверьте

    После изменений выполните пересчёт, проверьте свойства формы и убедитесь в корректности выбранного экспорта. Если макрос должен работать и без окна, защитите импорты GUI.

02 Когда использовать

Когда использовать

FreeCAD со встроенным Python; для работы с GUI дополнительно используется встроенный PySide, а для работы со сценографом — Pivy.

Подходит для

  • Настраиваемые деталиПолезно для детали, у которой длина, ширина и другие проектные размеры должны оставаться явными свойствами, а не скрытыми константами.
  • Повторяющиеся операции CADПодходит для макросов с массивами, булевыми операциями, преобразованием в сетку и экспортом выбранных объектов.

Что проверить

  • Python, зависящий от приложенияМодули FreeCAD не входят в стандартную библиотеку Python. Черновик скрипта вне FreeCAD не подтверждает его поведение при выполнении.
  • Проверка модели по-прежнему нужнаНавык охватывает построение геометрии, но не подтверждает технологичность, конструктивную безопасность или пригодность для механической обработки.

Что подготовить

  • Задание с размерамиУкажите размеры, значимые для задачи допуски и единицы, использованные на чертеже.
  • Редактируемые параметрыНазовите значения, которые должны стать свойствами документа, и связи, которые должны оставаться ограниченными.
  • Среда выполнения и экспортУкажите версию FreeCAD, режим (GUI или без интерфейса) и нужный формат файла для следующего этапа.

03 Важные решения

Важные решения

  1. Параметрическая, а не статичная модель

    FeaturePython отделяет входные свойства детали от созданной формы, поэтому последующее изменение размера может запускать перестроение.

  2. Разделение геометрии и интерфейса

    Защита GUI в источнике помогает не допустить, чтобы полезный макрос моделирования случайно зависел от открытого вида или диалога.

04 Пример задания

Попробуйте узкое задание

Приведённый ниже пример задания не тестировался. Перед использованием проверьте настройку навыка.

Проверьте настройку

Держите справочные файлы навыка доступными для агента. Прежде чем запускать созданные макросы в FreeCAD, проверьте, как они изменят документ.

Исходный файл upstream
https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/freecad-scripts/SKILL.md

FreeCAD со встроенным Python; для работы с GUI дополнительно используется встроенный PySide, а для работы со сценографом — Pivy.

Начните с одного результата

Перед запуском навыка адаптируйте объём, исходные материалы и ограничения в этом задании.

Пример задания
Используйте freecad-scripts, чтобы подготовить макрос FreeCAD для прямоугольной монтажной пластины с четырьмя равномерно отступающими от краёв отверстиями. Перед построением запросите размеры пластины, диаметр отверстий и величину отступа. Сделайте эти значения редактируемыми свойствами, назовите полученный объект, выполняйте пересчёт после изменений и экспортируйте копию в STEP. Отделите код геометрии от необязательного отображения в GUI и не утверждайте, что деталь готова к производству.

Проверьте результат

Сравните фактический результат с этими наблюдаемыми критериями.

  • Изменение заданного размера приводит к пересчёту нужной геометрии.
  • Единицы и положение объектов соответствуют предоставленному чертежу.
  • Экспортированный файл содержит запрошенное тело, а не пустой или неполный объект.

OpenDesign предоставляет локальное дизайнерское рабочее пространство для кодирующих агентов. Наличие в каталоге не означает, что навык входит в комплект или что его внешние инструменты, учётные данные и программные зависимости включены.

05 Источник и лицензия

Источник и лицензия

На этой странице описана зафиксированная версия источника по ссылке ниже. Поведение и требования upstream могут измениться.

Владелец источника
GitHub Awesome Copilot Contributors
Репозиторий
github/awesome-copilot
Файл навыка
skills/freecad-scripts/SKILL.md
Лицензия
MIT
Проверенная версия
2026-10-07 · 3a685010a7af
Редакторское резюме источника
Справочник по FreeCAD Python: объекты документа, параметрическая геометрия, эскизы, интерфейс приложения и процессы экспорта.

Оригинальное резюме подготовлено OpenDesign на основе указанного источника. Звёзды репозитория — датированный показатель популярности, а не данные об использовании навыка или оценка качества.

06 Вопросы перед началом

Вопросы перед началом

Можно ли создавать редактируемые параметрические объекты?

Да. В источнике описаны прокси FeaturePython, типизированные свойства и метод execute, вызываемый при пересчёте документа.

STL — это то же самое, что STEP?

Нет. В рабочем процессе различаются триангулированные сетки и твёрдые тела Part. Выбирайте представление, которое требуется следующему инструменту, а не считайте экспорты взаимозаменяемыми.

Можно ли запустить любой пример без интерфейса?

Нет. Диалоги, поставщики представлений и работа со сценографом зависят от GUI. Макросы без интерфейса должны защищать или исключать такие операции.

OpenDesign

Оставьте место для следующей итерации дизайна.

Храните задание, исходные материалы и дизайнерскую работу вместе в локальном рабочем пространстве. Перед добавлением навыка в рабочий процесс проверьте его собственную настройку.

Исходный файл upstream
https://github.com/github/awesome-copilot/blob/3a685010a7afdc0dbd4c83b7fbda6c316aa516e5/skills/freecad-scripts/SKILL.md