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

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-sproektirovat-3d-model-robota-s-pomoschyu-llm-i-bes.html

## TL;DR

- Время выполнения: 40–60 минут
- Уровень сложности: Intermediate
- Понадобится: OpenSCAD (бесплатный параметрический CAD — геометрия описывается кодом, а не мышкой), Python 3 с пакетами `trimesh` и `numpy-stl`, любая доступная LLM (чат-интерфейс или локальная модель), опционально FreeCAD для второго мнения и слайсер/просмотрщик STL. Конкретные версии инструментов — сверьтесь с документацией, здесь они не фиксируются.

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

- Файл `robot.scad` — параметрическую модель колёсного робота: блок переменных в миллиметрах плюс модули `chassis`, `wheel`, `axle`, из которых одной командой собирается STL.
- Файл `build/robot.stl` — водонепроницаемую (manifold: замкнутая поверхность без дыр и самопересечений) сетку, которую слайсер принимает как одно тело.
- Готовый промпт для LLM, который воспроизводит эту модель из брифа, и чек-лист приёмки из пяти пунктов.

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

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

```bash
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))"
```

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

## Промпт для копирования
![Иллюстрация к разделу «Промпт для копирования»](https://ai-release.org/guides/img/kak-sproektirovat-3d-model-robota-s-pomoschyu-llm-i-bes-ru-1.jpg?v=1795337450)


```prompt
Ты — 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>` — отступ осей от торцов.

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-sproektirovat-3d-model-robota-s-pomoschyu-llm-i-bes-ru-2.jpg?v=1795337455)


- ОС: Linux, macOS или Windows; все команды ниже — для bash (в Windows используйте WSL).
- OpenSCAD: установите из пакетного менеджера или с сайта проекта. Проверьте, что работают флаги `-o` (файл на выходе) и `-D` (переопределить переменную из командной строки) — синтаксис сверьте с документацией вашей сборки.
- Python 3 и пакеты: `python3 -m pip install trimesh numpy-stl`.
- FreeCAD — опционально, если нужен второй CAD-движок и его Python-консоль (`freecadcmd`).
- Доступ к LLM. Если хотите держать модель локально — см. [Как подключить ИИ к домашнему серверу](https://ai-release.org/guides/kak-podklyuchit-ii-k-domashnemu-serveru-poshagovoe-ruko.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).
- Свободное место: несколько десятков мегабайт под пакеты Python и STL.

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

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

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

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

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

```openscad
// 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 и посмотрите габариты.

```bash
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 промпт из раздела выше вместе с заготовкой и попросить дописать колёса и оси. Минимальная рабочая сборка выглядит так:

```openscad
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`: торец оси уходит внутрь колеса и не совпадает с его наружной плоскостью. Совпадающие грани — главная причина неводонепроницаемых сеток.

Соберите:

```bash
openscad -o build/robot.stl robot.scad
```

Если планируете генерировать десятки вариантов компоновки, LLM удобнее вынести на сервер — см. [Как развернуть локальную ИИ-модель на Kubernetes](https://ai-release.org/guides/kak-razvernut-lokalnuyu-ii-model-na-kubernetes-poshagov.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

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

```bash
ls -lh build/robot.stl
```

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

## Шаг 3. Приёмка модели: watertight, габариты, одно тело
![Иллюстрация к разделу «Шаг 3. Приёмка модели: watertight, габариты, одно тело»](https://ai-release.org/guides/img/kak-sproektirovat-3d-model-robota-s-pomoschyu-llm-i-bes-ru-3.jpg?v=1795337460)


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

```bash
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` — «не вывернуты ли нормали» (при вывернутых объём приходит отрицательным или близким к нулю).

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

- [ ] `openscad -o build/robot.stl robot.scad` завершилась без строк `ERROR:`
- [ ] `watertight: True`
- [ ] `bodies: 1`
- [ ] `bounds` совпадает с расчётными: `[[0, -13, 0], [160, 146, 48]]` для параметров из Шага 1
- [ ] `volume_mm3` — положительное число

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

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

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

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

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

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

- Ошибка: `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`.

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

- Ошибка: `WARNING: Object may not be a valid 2-manifold and may need repair!`
- Причина: в модели есть совпадающие грани или детали, которые касаются друг друга в ноль, без перекрытия. В нашем примере это происходит, если ось сделать длиной ровно `W + 2 * WHEEL_T`: её торец совпадёт с наружной плоскостью колеса.
- Решение: дайте соединениям перекрытие не меньше 0.5 мм (`W + 1.5 * WHEEL_T`) и пересоберите. Проверка — `watertight: True` и `bodies: 1` из Шага 3.

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

- Ошибка: `ModuleNotFoundError: No module named 'FreeCAD'`
- Причина: FreeCAD поставляется со собственным интерпретатором Python; системный `python3` модуль `FreeCAD` не видит.
- Решение: запускайте скрипт через консольный бинарь FreeCAD: `freecadcmd make_robot.py`. Точное имя команды и флаги зависят от сборки — сверьтесь с документацией.

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

Вы получили параметрический `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.
