mcp:navi-3d:compile_scad

Что делает

Компилирует существующий OpenSCAD-скрипт (.scad) в binary STL-файл.

Требует: OpenSCAD установлен в системе (openscad в PATH).

Предпосылки

Файл .scad уже должен существовать. Напишите его заранее через filesystem write.
OpenSCAD должен быть установлен. Если нет — инструмент вернёт ошибку openscad_not_found.

Формат вызова

mcp:navi-3d:compile_scad(
    session_id="...",
    source_path="handle.scad",
    output_path="handle.stl"
)

Параметры

Параметр	Обязательно	Описание
`session_id`	Да	UUID текущей сессии Navi. Файлы разрешаются внутри `session_files/<session_id>/`.
`source_path`	Да	Путь к существующему `.scad`-файлу (внутри сессии или абсолютный)
`output_path`	Да	Путь, куда записать сгенерированный `.stl`. Родительские директории создаются автоматически.

Workflow

1. Написать OpenSCAD-скрипт

filesystem write session_files/sess-abc/bracket.scad '
difference() {
    cube([40, 20, 5], center=true);
    translate([15, 0, 0]) cylinder(h=6, d=4, center=true);
    translate([-15, 0, 0]) cylinder(h=6, d=4, center=true);
}
'

2. Проверить линтингом (рекомендуется)

mcp:navi-3d:lint_scad(
    session_id="sess-abc",
    source_path="bracket.scad"
)

3. Скомпилировать в STL

mcp:navi-3d:compile_scad(
    session_id="sess-abc",
    source_path="bracket.scad",
    output_path="bracket.stl"
)

4. Показать пользователю

content_publish(filename="bracket.stl", title="Bracket")

Что возвращает

При успехе:

Generated: bracket.stl
Path: /home/.../session_files/sess-abc/bracket.stl
Size: 12.4 KB

При ошибке:

openscad_not_found — OpenSCAD не установлен
scad_not_found — исходный файл не найден
openscad_compile_error — ошибка компиляции (невалидный CSG, деление на ноль и т.д.)
no_output — OpenSCAD завершился без ошибок, но файл не создался
wrong_session_dir — файл находится вне разрешённой сессии

Важные правила

Всегда binary STL — нет параметра ASCII/binary, всегда используется --export-format binstl.
Скрипт должен существовать до вызова — compile_scad не пишет .scad, только компилирует.
Всегда передавайте session_id — без него инструмент не знает, в какой директории искать файлы.
Ошибки OpenSCAD читаемы: строка, символ, тип ошибки — всё в stderr.