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

Просматривайте состояние работающего приложения и изменяйте его через локальный API либо экспортируйте G-code напрямую.

Двоичный файл beambench-cli распространяется вместе с настольным приложением. Большинство команд для работы с проектами, дизайном, станком, профилями и состоянием являются клиентами локального API приложения. Для них требуется, чтобы приложение было запущено с включенным параметром Settings > General > Local API.

Оставляйте параметр Allow network devices to connect выключенным для скриптов, работающих на том же компьютере. CLI считывает настроенный порт API из параметров приложения; значение по умолчанию равно 5900.

Поиск доступных команд

beambench-cli --help
beambench-cli agent capabilities --json
beambench-cli agent guide --json

Справка работает без приложения. Возможности и текущее состояние используют API. Выполните подкоманду с параметром --help, чтобы просмотреть ее параметры для установленной версии.

Открытие и проверка проекта

beambench-cli project open /abs/path/project.lzrproj
beambench-cli agent state --json

Открытие проекта изменяет проект в настольном приложении. Сохраните работу перед запуском скриптов, которые заменяют или изменяют проект.

beambench-cli project save
beambench-cli project save-as /abs/path/copy.lzrproj

Рендеринг и экспорт

beambench-cli design render --png /tmp/design.png --pixels-per-mm 4
beambench-cli export svg --path /tmp/design.svg

Эти команды используют проект работающего приложения через API. Для рендеринга дизайна отображение холста не требуется, но сервер по-прежнему необходим.

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

Для рендеринга наложения камеры также требуется, чтобы интерфейс приложения обработал запрос на рендеринг. Это не безынтерфейсная замена рабочего процесса с камерой.

Команды, работающие без приложения

Список последовательных портов, справка и позиционная команда экспорта G-code имеют прямые локальные пути:

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

Автономный экспорт G-code использует локально сохраненный профиль станка, а также проверки планирования и вывода настольного приложения. Он не может прочитать текущее положение станка. Ознакомьтесь с разделом Вывод G-code, чтобы узнать требования к профилю и размещению.

Автоматизация и конфликты

Транзакции дизайна используют текущую ревизию проекта. Если другое изменение, переключение проекта или его закрытие делает зафиксированный проект недействительным, транзакция отклоняется. Обновите состояние и заново оцените операцию перед повторной попыткой; не перезаписывайте одновременные изменения пользователя устаревшим снимком.

Для команд, которые могут перемещать станок, включать лазер, отправлять необработанный G-code или изменять воздушную поддержку, требуются соответствующие флаги подтверждения. Просмотрите справку по команде и предполагаемое действие перед их указанием.

CLI не выбирает инструменты холста, не изменяет расположение панелей и не запускает сочетания клавиш. Это действия интерфейса настольного приложения.

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