Använda CLI:t

Inspektera och redigera den körande appen via dess lokala API, eller exportera G-code direkt.

Binärfilen beambench-cli distribueras tillsammans med skrivbordsappen. De flesta kommandon för projekt, design, maskin, profiler och tillstånd är klienter till appens lokala API. De kräver att appen körs med Inställningar > Allmänt > Lokalt API aktiverat.

Låt Tillåt nätverksenheter att ansluta vara avstängt för skript som körs på samma dator. CLI:t läser den konfigurerade API-porten från appinställningarna; standardvärdet är 5900.

Hitta tillgängliga kommandon

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

Hjälpen fungerar utan appen. Funktioner och aktivt tillstånd använder API:t. Kör ett underkommando med --help för att se parametrarna för den installerade versionen.

Öppna och inspektera ett projekt

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

Att öppna ett projekt ändrar projektet i skrivbordsappen. Spara arbetet innan du kör skript som ersätter eller redigerar det.

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

Rendera och exportera

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

Dessa kommandon använder skrivbordsappens körande projekt via API:t. Designrendering kräver inte en synlig arbetsyta, men servern krävs fortfarande.

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

Rendering av kameraöverlägg kräver också att appens frontend hanterar renderingsbegäran. Den är inte en ersättning utan grafiskt gränssnitt för kameraarbetsflödet.

Kommandon som fungerar utan appen

Listning av serieportar, hjälp och den positionsbaserade G-code-exporten har direkta lokala vägar:

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

Fristående G-code-export använder en lokalt sparad maskinprofil samt skrivbordets planerings- och utdatakontroller. Den kan inte läsa av en aktiv maskinposition. Läs G-code-utdata om krav på profil och placering.

Automatisering och konflikter

Designtransaktioner använder den aktuella projektrevisionen. Om en annan redigering, ett projektbyte eller en stängning gör den insamlade projektinformationen ogiltig avvisas transaktionen. Uppdatera tillståndet och ompröva åtgärden innan du försöker igen; skriv inte över samtidiga användarredigeringar med en gammal snapshot.

Kommandon som kan flytta maskinen, avfyra lasern, skicka rå G-code eller ändra luftassistansen kräver motsvarande bekräftelseflaggor. Kontrollera kommandohjälpen och den avsedda åtgärden innan du anger dem.

CLI:t väljer inte arbetsytans verktyg, ordnar inte om paneler och utlöser inte kortkommandon. Detta är åtgärder i skrivbordsgränssnittet.