Короткий ответ
Если загрузить .FCStd в окно чата, модель получит zip-архив с XML и геометрией BREP, о котором она не сможет рассуждать как о модели. Можно вставить кусок Python, скриншот или выгрузку свойств — Claude ответит разумно, но ответит о копии, а каждое изменение всё равно придётся переносить в FreeCAD руками.
Полезная конфигурация — обратная: модель живёт внутри FreeCAD как верстак и читает открытый документ через Python API FreeCAD. Я сделал такой плагин — FreeGAD, — потому что устал копировать Python между вкладкой браузера и консолью FreeCAD и хотел, чтобы помощник был рядом с моделью. Ниже — что он реально делает, чтобы вы могли решить, подходит ли такая схема для вашей работы.
Что видит модель
Каждый разговор начинается с компактного снимка активного документа: объекты, их типы и зависимости, габаритные боксы, объёмы, размещения и текущее выделение. Снимок намеренно небольшой и стабильный, чтобы работало кэширование промпта и повторные вопросы стоили дёшево.
Когда нужно больше, модель вызывает инструменты чтения над живым документом: любое свойство, выражения, геометрия и ограничения эскизов, ячейки таблиц, данные граней и рёбер. И есть инструмент, которого нет в версии для AutoCAD: take_screenshot отрисовывает 3D-вид и отправляет картинку модели, чтобы она визуально проверила форму, ориентацию и собственные правки.
Она умеет и измерять — расстояния между объектами или их элементами, площади граней, длины рёбер, радиусы, — а не оценивать на глаз по картинке.
Что модель может изменить
Инструменты записи: run_python (полный API FreeCAD, один шаг отмены, пересчёт после выполнения), set_property, set_expression, delete_object, set_visibility, select и recompute.
Каждая запись открывает диалог подтверждения с точным кодом или изменением до того, как что-то произойдёт. В панели есть галочка Auto-approve edits для сессий, которым вы доверяете, — по умолчанию выключена. Каждый вызов инструмента — одна транзакция, так что всё сделанное моделью откатывается обычной отменой.
Чего он не делает
- Не моделирует деталь по одной фразе. Он читает, измеряет и правит существующее через тот же API, который вы бы скриптовали вручную; замысел по-прежнему ваш.
- Не пишет ничего в
.FCStd. Заметки и история чата лежат в%APPDATA%\FreeGADи привязаны кUidдокумента, так что переживают переименование и перенос файла, не трогая его. - Пока не работает на Linux и macOS. Плагин, установщик и хранение ключа (Windows DPAPI) сегодня только для Windows; поддерживаемые версии — FreeCAD 1.0 и 1.1.
Память между сессиями
remember сохраняет заметки о пользователе (соглашения, принтер, материалы, как вы любите получать ответы) и о документе (замысел, какой эскиз что задаёт). Они подставляются в следующие сессии, и помощник перестаёт задавать одни и те же вопросы. FreeGAD → Memory… показывает и удаляет то, что он помнит; можно просто сказать «запомни, что …» или «забудь, что …».
Модели и стоимость
Модель по умолчанию — claude-opus-5 через Anthropic API с вашим ключом; подходит и любой OpenAI-совместимый эндпоинт — OpenAI, OpenRouter или локальный сервер, что заодно отвечает на вопрос «а можно без выхода в интернет?». Платите вы своему провайдеру за токены; сам плагин бесплатен под AGPL. Клиент написан на голом HTTP из стандартной библиотеки, без SDK: у FreeCAD свой встроенный Python, и ставить в него пакеты через pip ненадёжно от версии к версии. Ключ хранится зашифрованным через DPAPI для текущего пользователя Windows и никогда не лежит открытым текстом.
Предохранители для скриптов
Убежавший цикл булевых операций или тесселяции может загнать Windows в такой своп, что помогает только перезагрузка. Поэтому у run_python есть лимит времени (120 с по умолчанию, 0 — отключить) и защита по памяти, которая прерывает скрипт, как только он раздул память FreeCAD больше чем на половину ОЗУ машины или оставил меньше примерно 8 % свободной. Оба включены по умолчанию и отключаются в настройках.
Телеметрия, честно
Сбор статистики использования включён по умолчанию и отключается в Settings… → Collect anonymous usage data. Что уходит на каждый ход: модель и уровень усилия, счётчики токенов, задержки API и инструментов, сколько был заблокирован поток интерфейса, рост памяти на скрипт, класс ошибки, версии плагина, FreeCAD и ОС, число объектов — с привязкой к случайному идентификатору установки. Никогда не отправляются: запросы, ответы, код, имена файлов, содержимое документов, ключ API.
Установка
Скачайте установщик: он ставится для текущего пользователя в %APPDATA%\FreeCAD\Mod\FreeGAD без прав администратора и спрашивает провайдера и ключ API. Запускаете FreeCAD — в каждом верстаке появляются меню FreeGAD и кнопка на панели, плюс отдельный верстак FreeGAD. Разработчики могут установить из репозитория скриптом install.ps1. Краткое описание — на странице проекта; архитектура обоих плагинов разобрана в заметке о проектных решениях FreeGAD и его брата для AutoCAD.
Что я сделал бы иначе и что дальше
Я бы сделал инструмент скриншота первым: именно на него реагируют люди, и он поймал больше ошибок самой модели, чем любая текстовая проверка. Дальше — поддержка Linux, если её будут просить, и короткое видео цикла «эскиз → ограничение → измерение → правка».