BeamBench: Korzystanie z interfejsu CLI

Sterowanie Beam Bench z terminala. Otwieranie projektów, renderowanie obszarów roboczych, sprawdzanie stanu i eksportowanie plików.

Plik binarny beambench-cli jest tworzony razem z aplikacją Beam Bench. Służy do tworzenia skryptów, operacji wsadowych i renderowania bez interfejsu graficznego.

Wymagania

Zainstalowany Beam Bench (lub sklonowane repozytorium, jeśli aplikacja jest budowana ze źródeł).
Terminal (Terminal w systemie macOS, PowerShell w systemie Windows lub dowolna powłoka w systemie Linux).
W przypadku niektórych poleceń: uruchomiona aplikacja. Większość poleceń tego nie wymaga.

Gdzie go znaleźć

Plik binarny nosi nazwę beambench-cli i jest instalowany razem z aplikacją desktopową. Dokładna ścieżka zależy od układu pakietu dla używanej kompilacji i platformy; sprawdź katalog instalacyjny.

Można dodać go do zmiennej PATH albo utworzyć alias dla skrócenia poleceń:

alias bb=beambench-cli

W poniższych przykładach używana jest pełna nazwa beambench-cli.

Kroki

1. Sprawdzenie działania CLI

beambench-cli --help

Wyświetla wszystkie podpolecenia. Każde podpolecenie ma własną opcję --help.

2. Sprawdzenie stanu agenta

beambench-cli agent state --json

Zwraca zrzut JSON bieżącego projektu, połączenia z maszyną, zaznaczenia i stanu kamery. Przydatne podczas tworzenia skryptów i debugowania.

3. Renderowanie obszaru roboczego do pliku PNG (bez interfejsu graficznego)

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

Renderuje projekt bieżącego projektu (bez nakładki kamery) do pliku PNG. Działa bez uruchomionego interfejsu graficznego.

4. Renderowanie z nakładką kamery (wymaga interfejsu graficznego)

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

Przechwytuje obszar roboczy z bieżącą ramką nakładki kamery. Wymaga uruchomionej aplikacji desktopowej; CLI wysyła do aplikacji żądanie reverse-RPC, a aplikacja wykonuje renderowanie i zapisuje plik.

5. Otwieranie projektu

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

Ścieżka jest argumentem pozycyjnym. Aby zapisać projekt, użyj beambench-cli project save (bez argumentów, nadpisuje otwarty plik) albo beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Eksportowanie plików

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

Eksporty SVG, DXF, PDF, EPS i AI przyjmują opcję --path. G-code przyjmuje dwa argumenty pozycyjne: wejściowy .lzrproj i wyjściowy .gcode.

7. Sprawdzanie portów i możliwości

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

agent capabilities zwraca schemat działań dostępnych w CLI. agent guide zwraca początkowy przepływ pracy dla agentów zewnętrznych.

Czego CLI nie może robić

Wybierać narzędzia obszaru roboczego.
Otwierać ani zamykać panelu lub okna dialogowego.
Uruchamiać skrótu klawiaturowego.
Przeciągać i upuszczać elementów na obszarze roboczym.

W tych przypadkach steruj bezpośrednio interfejsem graficznym (np. za pomocą computer-use lub AppleScript), a nie CLI.

Przykłady

Renderowanie wsadowe każdego projektu w folderze

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

Wykonywanie migawki stanu maszyny co minutę

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

Weryfikacja działania

beambench-cli --help uruchamia się bez błędów.
Polecenie design render tworzy plik PNG o rozmiarze większym niż zero.
agent state zwraca prawidłowy JSON.

Korzystanie z interfejsu CLI