Использование CLI: BeamBench

Управляйте Beam Bench из терминала. Открывайте проекты, визуализируйте холсты, просматривайте состояние и экспортируйте файлы.

Бинарный файл beambench-cli собирается вместе с приложением Beam Bench. Используйте его для создания скриптов, пакетных операций и рендеринга без графического интерфейса.

Что потребуется

Установленный Beam Bench (или склонированный репозиторий, если вы собираете приложение из исходного кода).
Терминал (Terminal в macOS, PowerShell в Windows или любая оболочка в Linux).
Для некоторых команд запущенное приложение. Большинство команд не требуют его запуска.

Где его найти

Бинарный файл называется beambench-cli и устанавливается вместе с настольным приложением. Точный путь зависит от структуры пакета платформы для текущей сборки. Проверьте каталог установки.

Для удобства можно добавить его в PATH или создать сокращенный псевдоним:

alias bb=beambench-cli

В приведенных ниже примерах используется полное имя beambench-cli.

Шаги

1. Проверьте работу CLI

beambench-cli --help

Выводит список всех подкоманд. У каждой подкоманды есть собственный параметр --help.

2. Просмотрите состояние агента

beambench-cli agent state --json

Возвращает дамп JSON с данными о текущем проекте, подключении к станку, выделении и состоянии камеры. Это полезно для создания скриптов и отладки.

3. Визуализируйте холст в PNG без графического интерфейса

beambench-cli design render --png /tmp/out.png --pixels-per-mm 4

Визуализирует дизайн текущего проекта без наложения камеры и сохраняет его в PNG. Работает без запущенного графического интерфейса.

4. Визуализируйте изображение с наложением камеры, требуется графический интерфейс

beambench-cli camera overlay render --output /tmp/overlay.png --view fit

Сохраняет холст вместе с текущим кадром наложения камеры. Настольное приложение должно быть запущено. CLI отправляет обратный RPC-запрос приложению, которое выполняет рендеринг и записывает файл.

5. Откройте проект

beambench-cli project open /abs/path/to/project.lzrproj

Путь указывается как позиционный аргумент. Чтобы сохранить изменения, используйте beambench-cli project save (без аргументов, открытый файл будет перезаписан) или beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Экспортируйте файлы

beambench-cli export svg --path /abs/path/out.svg
beambench-cli export gcode /abs/path/to/project.lzrproj /abs/path/out.gcode

Для экспорта в SVG, DXF, PDF, EPS и AI используется параметр --path. Для G-code используются два позиционных аргумента: входной .lzrproj и выходной .gcode.

7. Просмотрите порты и возможности

beambench-cli ports
beambench-cli agent capabilities --json
beambench-cli agent guide --json

Команда agent capabilities возвращает схему возможностей CLI. Команда agent guide возвращает начальный рабочий процесс для внешних агентов.

Что CLI не умеет

Выбирать инструмент холста.
Открывать или закрывать панель или диалоговое окно.
Запускать горячую клавишу.
Перетаскивать объекты на холсте.

Для этих действий управляйте графическим интерфейсом напрямую, например с помощью computer-use или AppleScript, а не через CLI.

Примеры

Пакетный рендеринг всех проектов в папке

for f in /path/to/projects/*.lzrproj; do
  beambench-cli project open "$f"
  beambench-cli design render --png "${f%.lzrproj}.png" --pixels-per-mm 4
done

Создание снимка состояния станка каждую минуту

while true; do
  beambench-cli agent state --json > "/tmp/state-$(date +%s).json"
  sleep 60
done

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

beambench-cli --help выполняется без ошибок.
Команда design render создает PNG ненулевого размера.
Команда agent state возвращает корректный JSON.

Использование CLI