BeamBench: Korzystanie z CLI

Sprawdzaj i edytuj działającą aplikację przez jej lokalne API albo eksportuj G-code bezpośrednio.

Plik binarny beambench-cli jest dystrybuowany razem z aplikacją desktopową. Większość poleceń dotyczących projektu, projektu graficznego, maszyny, profilu i stanu korzysta z lokalnego API aplikacji. Wymagają one uruchomionej aplikacji z włączoną opcją Settings > General > Local API.

Pozostaw opcję Allow network devices to connect wyłączoną dla skryptów uruchamianych na tym samym komputerze. CLI odczytuje skonfigurowany port API z ustawień aplikacji. Wartość domyślna to 5900.

Znajdowanie dostępnych poleceń

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

Pomoc działa bez aplikacji. Możliwości i bieżący stan korzystają z API. Uruchom podpolecenie z --help, aby zobaczyć jego parametry dla zainstalowanej wersji.

Otwieranie i sprawdzanie projektu

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

Otwarcie projektu zmienia projekt w aplikacji desktopowej. Zapisz pracę przed uruchomieniem skryptów, które zastępują projekt lub go edytują.

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

Renderowanie i eksport

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

Te polecenia korzystają przez API z projektu otwartego w działającej aplikacji. Renderowanie projektu nie wymaga widocznego obszaru roboczego, ale nadal wymaga serwera.

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

Renderowanie nakładki kamery wymaga także obsłużenia żądania renderowania przez interfejs aplikacji. Nie jest bezgłową alternatywą dla procedury korzystającej z kamery.

Polecenia działające bez aplikacji

Wyświetlanie portów szeregowych, pomoc i pozycyjny eksport G-code mają bezpośrednie ścieżki lokalne:

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

Samodzielny eksport G-code korzysta z lokalnie zapisanego profilu maszyny oraz kontroli planowania i danych wyjściowych aplikacji desktopowej. Nie może odczytać bieżącej pozycji maszyny. Informacje o wymaganiach dotyczących profilu i rozmieszczenia znajdziesz w sekcji Wyjście G-code.

Automatyzacja i konflikty

Transakcje projektu korzystają z bieżącej wersji projektu. Jeśli inna edycja, przełączenie projektu lub jego zamknięcie unieważni przechwycony projekt, transakcja zostanie odrzucona. Przed ponowną próbą odśwież stan i ponownie oceń operację. Nie nadpisuj jednoczesnych edycji użytkownika starą migawką.

Polecenia, które mogą poruszyć maszynę, uruchomić laser, wysłać surowy G-code lub zmienić nadmuch powietrza, wymagają odpowiednich flag potwierdzenia. Przed ich podaniem sprawdź pomoc polecenia i zamierzone działanie.

CLI nie wybiera narzędzi obszaru roboczego, nie zmienia rozmieszczenia paneli ani nie uruchamia skrótów. Są to działania interfejsu aplikacji desktopowej.

Korzystanie z CLI