← Все гайды AI Release
EN Подписаться на @ai_release1

Как спроектировать 3D-модель робота с помощью LLM и бесплатного CAD: пошаговое руководство

Обновлено: 22.11.2026 · AI Release · @ai_release1
Как спроектировать 3D-модель робота с помощью LLM и бесплатного CAD: пошаговое руководство

TL;DR

Что вы получите

Где этот подход не работает: LLM не создаёт геометрию, она пишет текст-код, а форму считает CAD-ядро OpenSCAD. Поэтому органические формы (голова робота со «лицом», обтекатель, скульптурные панели) и точные посадки под подшипники/резьбу этим маршрутом не делаются — там нужен mesh-моделинг или ручная работа в CAD. Зато компоновка, габариты, колёсная база и посадочные места под электронику — ровно тот класс задач, где связка «LLM + параметрический CAD» экономит часы.

Быстрый старт

mkdir -p ~/robot-cad/build && cd ~/robot-cad
printf 'W=120; L=160; H=40; cube([L,W,H], center=false);\n' > robot.scad
openscad -o build/robot.stl robot.scad
python3 -c "import trimesh; m=trimesh.load('build/robot.stl'); print('watertight:', m.is_watertight, 'volume_mm3:', round(m.volume))"

Подробности и проверка — в шагах ниже.

Промпт для копирования

Иллюстрация к разделу «Промпт для копирования»
Иллюстрация к разделу «Промпт для копирования»
ПромптСкопируйте целиком — это готовый системный промпт
Ты — CAD-инженер, который пишет код для OpenSCAD. Сгенерируй параметрическую модель колёсного робота.

Жёсткие требования к результату:
1. Единицы — миллиметры. Модель стоит в положительном октанте: минимальные координаты по X и Y равны нулю, низ модели — на плоскости z = 0.
2. В начале файла — блок переменных с комментариями в формате "ИМЯ = значение; // что это, мм". Все размеры в геометрии берутся только из этих переменных, магических чисел внутри модулей нет.
3. Разрешены только примитивы cube, cylinder, sphere и операции translate, rotate, union, difference, hull. Никаких include/use внешних библиотек, никаких импортов STL.
4. Каждая деталь — отдельный module с осмысленным именем (chassis, wheel, axle), в конце файла один вызов сборки.
5. Соединения деталей должны перекрываться минимум на 0.5 мм. Совпадающих граней (две плоскости ровно друг на друге) быть не должно — иначе сетка получится неводонепроницаемой.
6. Винты, фаски и скругления не нужны: цель — проверить компоновку, а не печатать финальную деталь.
7. Ответ — один файл целиком, без markdown-разметки, без пояснений до и после, без сокращений и многоточий.

Параметры робота:
- корпус: длина <L> мм, ширина <W> мм, высота <H> мм
- клиренс (расстояние от пола до низа корпуса): <C> мм
- колесо: диаметр <WHEEL_D> мм, толщина <WHEEL_T> мм
- ось колеса: диаметр <AXLE_D> мм
- отступ осей от торцов корпуса: <INSET> мм
- сегментов на окружности колеса ($fn): 48

Замените в блоке: <L>, <W>, <H> — габариты корпуса; <C> — клиренс; <WHEEL_D>, <WHEEL_T> — колесо; <AXLE_D> — диаметр оси; <INSET> — отступ осей от торцов.

Требования и подготовка

Иллюстрация к разделу «Требования и подготовка»
Иллюстрация к разделу «Требования и подготовка»

Как проверить:

openscad --version
python3 -c "import trimesh; print(trimesh.__version__)"

На экране — строка вида OpenSCAD version <номер> и номер версии trimesh. Если openscad: command not found, бинарь не в PATH — переустановите или пропишите путь.

Шаг 1. Бриф и параметрическая заготовка

Что сделать: зафиксировать габариты в файле robot.scad как переменные, а не как числа внутри геометрии. Заготовка ниже — это «скелет», который дальше расширит LLM.

// robot.scad — единицы: миллиметры
W = 120;         // ширина корпуса
L = 160;         // длина корпуса
H = 40;          // высота корпуса
CLEARANCE = 8;   // клиренс: низ корпуса над полом
WHEEL_D = 65;    // диаметр колеса
WHEEL_T = 26;    // толщина колеса
AXLE_D = 8;      // диаметр оси
INSET = 25;      // отступ оси от торца корпуса

module chassis() {
    cube([L, W, H]);
}
chassis();

Зачем: параметрическая модель — это таблица размеров плюс код, который их использует. Пока все числа вынесены в переменные, вы меняете W = 120 на W = 140 и получаете новую модель одной командой, не перерисовывая геометрию.

Как проверить: соберите STL и посмотрите габариты.

openscad -D 'W=120' -o build/robot_step1.stl robot.scad
python3 -c "import trimesh; m=trimesh.load('build/robot_step1.stl'); print(m.bounds)"

Пример: для параметров выше вывод будет [[ 0. 0. 0.] [160. 120. 40.]] — ровно L, W, H. Если получили [[-80. -60. 0.] [80. 60. 40.]], значит в модели стоит center = true: LLM часто добавляет его «для симметрии», и тогда низ модели уезжает ниже нуля.

Шаг 2. Генерация сборки через LLM и сборка STL

Что сделать: отдать LLM промпт из раздела выше вместе с заготовкой и попросить дописать колёса и оси. Минимальная рабочая сборка выглядит так:

module wheel(x, y) {
    translate([x, y, WHEEL_D / 2]) rotate([90, 0, 0])
        cylinder(h = WHEEL_T, d = WHEEL_D, center = true, $fn = 48);
}

module axle(x) {
    translate([x, W / 2, WHEEL_D / 2]) rotate([90, 0, 0])
        cylinder(h = W + 1.5 * WHEEL_T, d = AXLE_D, center = true, $fn = 24);
}

module robot() {
    translate([0, 0, CLEARANCE]) chassis();
    for (x = [INSET, L - INSET]) {
        axle(x);
        wheel(x, -WHEEL_T / 2);
        wheel(x, W + WHEEL_T / 2);
    }
}
robot();

Зачем: rotate([90, 0, 0]) переводит ось цилиндра из Z в Y — иначе колесо встанет «блинчиком» на пол. Длина оси берётся W + 1.5 * WHEEL_T, а не W + 2 * WHEEL_T: торец оси уходит внутрь колеса и не совпадает с его наружной плоскостью. Совпадающие грани — главная причина неводонепроницаемых сеток.

Соберите:

openscad -o build/robot.stl robot.scad

Если планируете генерировать десятки вариантов компоновки, LLM удобнее вынести на сервер — см. Как развернуть локальную ИИ-модель на Kubernetes.

Как проверить: файл появился и весит больше нуля.

ls -lh build/robot.stl

Пример: -rw-r--r-- 1 user user 268K ... build/robot.stl. Пустой STL весит 84 байта (только заголовок) — это признак, что геометрия не построилась.

Шаг 3. Приёмка модели: watertight, габариты, одно тело

Иллюстрация к разделу «Шаг 3. Приёмка модели: watertight, габариты, одно тело»
Иллюстрация к разделу «Шаг 3. Приёмка модели: watertight, габариты, одно тело»

Что сделать: прогнать три проверки — замкнутость сетки, габариты, объём — до того, как открывать слайсер.

python3 - <<'PY'
import trimesh
m = trimesh.load('build/robot.stl')
print('watertight:', m.is_watertight)
print('bodies:', len(m.split(only_watertight=False)))
print('bounds:', m.bounds.round(2).tolist())
print('volume_mm3:', round(m.volume))
PY

Зачем: is_watertight отвечает на вопрос «замкнута ли поверхность», bodies — «это одно тело или пять отдельных кусков», volume — «не вывернуты ли нормали» (при вывернутых объём приходит отрицательным или близким к нулю).

Как проверить: сверьте вывод с расчётом для примера и пройдите чек-лист.

Пример: watertight: True, bodies: 1, bounds: [[0.0, -13.0, 0.0], [160.0, 146.0, 48.0]]. Нижняя граница по Y отрицательная, потому что левое колесо центрировано в y = -WHEEL_T / 2.

Проверка параметризации в одну команду:

openscad -D 'L=200' -D 'INSET=30' -o build/robot_long.stl robot.scad

Ожидаемый результат — новый STL с удлинённым корпусом без правок кода; так вы подтверждаете, что модель действительно параметрическая, а не «нарисованная».

Возможные проблемы и решения

Проблема. OpenSCAD не собирает файл после вставки ответа LLM

Проблема. Слайсер ругается на импортированный STL

Проблема. Скрипт FreeCAD не запускается обычным Python

Резюме и следующие шаги

Вы получили параметрический robot.scad, собранный из него build/robot.stl и три числовые проверки, которые отличают годную сетку от «на вид нормальной». Дальше имеет смысл добавить в переменные посадочные места под конкретную электронику и прогнать 3–4 варианта колеи через -D, сравнив volume_mm3 и габариты.

FAQ

Можно ли сделать это без установки CAD?

Полноценно — нет: STL строит CAD-ядро. Но проверить чужой STL можно просмотрщиком в браузере, а кодогенерацию вести в веб-чате LLM.

Почему LLM не выдаёт сразу готовый STL?

Она работает с текстом, а не с геометрией. Её продукт — код для CAD, а форму считает и проверяет ядро OpenSCAD; отсюда и обязательный шаг с is_watertight.

Подойдёт ли метод для печати финального корпуса с резьбой и посадками?

Нет. Перекрытия 0.5 мм и примитивы без фасок дают компоновочную модель; допуски под подшипники и резьбу делаются в CAD вручную или метчиком после печати.

Что делать, если bodies больше единицы?

Найти отсоединённую деталь: чаще всего это колесо, которое не пересекается с осью по X. Увеличьте перекрытие оси с корпусом или сдвиньте INSET, затем пересоберите STL.

🤖 Кратко для ИИ

AI Release Knowledge Layer
Машинно-читаемое описание публикации · Версия 1.0

Статус: практическое руководство. Часть утверждений — заявления вендоров и проектов; проверяйте на своей среде.

1. Суть публикации

Пошаговый разбор пайплайна «текст → CAD»: какой LLM и открытые инструменты (FreeCAD, CadQuery, OpenSCAD) взять, как формулировать промпты под детали и проверять геометрию перед печатью. Время выполнения: 40–60 минут Уровень сложности: Intermediate

Внутри: прямые ответы, ключевые факты, участники, связи, достоверность, неизвестное и источники.

Машинные данные публикации: Citation Map JSON · JSON-LD · Semantic Embeddings — отдельный этап.

Полный Knowledge Layer: разделы 2–8

2. Прямые ответы

Что это за материал?
Пошаговый разбор пайплайна «текст → CAD»: какой LLM и открытые инструменты (FreeCAD, CadQuery, OpenSCAD) взять, как формулировать промпты под детали и проверять геометрию перед печатью. → подробнее (AR-GUIDE-KAKSPROEKT-001)
Что понадобится?
ОС: Linux, macOS или Windows; все команды ниже — для bash (в Windows используйте WSL).; OpenSCAD: установите из пакетного менеджера или с сайта проекта. Проверьте, что работают флаги -o (файл на выходе) и -D (переопределить переменную из командной строки) — синтаксис сверьте с документацией вашей сборки.; Python 3 и… → подробнее (AR-GUIDE-KAKSPROEKT-003)
Как это сделать?
Шаг 1. Бриф и параметрическая заготовка → Шаг 2. Генерация сборки через LLM и сборка STL → Шаг 3. Приёмка модели: watertight, габариты, одно тело → подробнее (AR-GUIDE-KAKSPROEKT-004)
Что может пойти не так?
Ошибка: ERROR: Parser error: syntax error in file robot.scad, line 12 → подробнее (AR-GUIDE-KAKSPROEKT-006)

3. Ключевые факты

  1. Время выполнения: 40–60 минут — подтверждение; статус: заявление источника.
  2. Уровень сложности: Intermediate — подтверждение; статус: заявление источника.
  3. Понадобится: OpenSCAD (бесплатный параметрический CAD — геометрия описывается кодом, а не мышкой), Python 3 с пакетами trimesh и numpy-stl, любая доступная LLM (чат-интерфейс или локальная модель), опционально FreeCAD для второго мнения и слайсер/просмотрщик STL. Конкретные версии инструментов — сверьтесь с документацией, здесь они не фиксируются. — подтверждение; статус: заявление источника.
  4. ОС: Linux, macOS или Windows; все команды ниже — для bash (в Windows используйте WSL). — подтверждение; статус: заявление источника.
  5. OpenSCAD: установите из пакетного менеджера или с сайта проекта. Проверьте, что работают флаги -o (файл на выходе) и -D (переопределить переменную из командной строки) — синтаксис сверьте с документацией вашей сборки. — подтверждение; статус: заявление источника.
  6. Python 3 и пакеты: python3 -m pip install trimesh numpy-stl. — подтверждение; статус: заявление источника.
  7. Ошибка: ERROR: Parser error: syntax error in file robot.scad, line 12 — подтверждение; статус: анализ AI Release.
  8. Причина: в файл попала markdown-разметка (строки с тремя обратными кавычками) или десятичная запятая вместо точки — LLM иногда отвечает в «человеческом» формате 12,5. — подтверждение; статус: анализ AI Release.

4. Участники и сущности

СущностьТипРоль в публикации
как спроектировать робота с помощью ИИтема/инструментупоминается в заголовке, TL;DR или разделах гайда
LLM для CADтема/инструментупоминается в заголовке, TL;DR или разделах гайда
текст в CAD нейросетьтема/инструментупоминается в заголовке, TL;DR или разделах гайда
FreeCAD и нейросетьтема/инструментупоминается в заголовке, TL;DR или разделах гайда
Pythonплатформа/технологияупоминается в заголовке, TL;DR или разделах гайда

5. Связи и контекст

  • Гайд — описывает → Как спроектировать 3D-модель робота с помощью LLM и бесплатного CAD: пошаговое руководство (AR-GUIDE-KAKSPROEKT-001).
  • Гайд — содержит шаг → Шаг 1. Бриф и параметрическая заготовка (AR-GUIDE-KAKSPROEKT-001).

6. Достоверность и происхождение информации

Подтверждено

В материале нет отдельного независимого подтверждения; ниже разделены заявления источников и редакционные выводы.

Заявление источника

  • Характеристики продуктов, версии, цены и лимиты — из описаний вендоров и материалов гайда.
  • Команды и шаги приведены как рекомендация, а не как гарантированный результат.

Анализ AI Release

  • Структура, сравнение и критерии выбора — редакционные.
  • Гайд не заменяет независимый аудит или юридическую консультацию.

7. Что пока неизвестно

  • Ошибка: ERROR: Parser error: syntax error in file robot.scad, line 12
  • Причина: в файл попала markdown-разметка (строки с тремя обратными кавычками) или десятичная запятая вместо точки — LLM иногда отвечает в «человеческом» формате 12,5.
  • Решение: удалите в редакторе строки, начинающиеся с трёх обратных кавычек, и замените запятые в числах на точки. Проверьте: grep -n "," robot.scad покажет подозрительные строки (в комментариях запятые допустимы), после правки повторите openscad -o build/robot.stl robot.scad.
  • Ошибка: WARNING: Object may not be a valid 2-manifold and may need repair!

8. Источники

ИсточникТипРоль
Внешние ссылки в материале не указаны——

Как цитировать: AI Release. Как спроектировать 3D-модель робота с помощью LLM и бесплатного CAD: пошаговое руководство. ai-release.org.