BeamBench: Bruke CLI

Styr Beam Bench fra en terminal. Åpne prosjekter, gjengi arbeidsområder, inspiser tilstand og eksporter filer.

Binærfilen beambench-cli bygges sammen med Beam Bench-appen. Bruk den til skripting, satsvise operasjoner og gjengivelse uten grafisk grensesnitt.

Dette trenger du

Beam Bench installert (eller repositoriet sjekket ut hvis du bygger fra kildekode).
En terminal (Terminal på macOS, PowerShell på Windows eller et valgfritt skall på Linux).
For enkelte kommandoer: appen må kjøre. De fleste krever ikke dette.

Hvor du finner den

Binærfilen heter beambench-cli og installeres sammen med skrivebordsappen. Den nøyaktige banen avhenger av plattformens pakkeoppsett for gjeldende bygg, så sjekk installasjonsmappen.

Du kan legge den til i PATH eller opprette et alias for kortere kommandoer:

alias bb=beambench-cli

Eksemplene nedenfor bruker det fullstendige navnet beambench-cli.

Fremgangsmåte

1. Bekreft at CLI fungerer

beambench-cli --help

Viser alle underkommandoer. Hver underkommando har sin egen --help.

2. Inspiser agenttilstanden

beambench-cli agent state --json

Returnerer en JSON-dump av gjeldende prosjekt, maskintilkobling, utvalg og kameratilstand. Nyttig for skripting og feilsøking.

3. Gjengi arbeidsområdet til en PNG-fil (uten grafisk grensesnitt)

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

Gjengir gjeldende prosjekts design, uten kameraoverlegg, til en PNG-fil. Fungerer uten at det grafiske grensesnittet kjører.

4. Gjengi med kameraoverlegg (krever grafisk grensesnitt)

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

Tar et bilde av arbeidsområdet med gjeldende kameraoverlegg. Krever at skrivebordsappen kjører. CLI-en sender en omvendt RPC-forespørsel til appen, som utfører gjengivelsen og skriver filen.

5. Åpne et prosjekt

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

Banen oppgis som et posisjonelt argument. Hvis du vil lagre tilbake, bruker du beambench-cli project save (ingen argumenter, overskriver den åpne filen) eller beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Eksporter filer

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

Eksport til SVG, DXF, PDF, EPS og AI bruker --path. G-code bruker to posisjonelle argumenter: .lzrproj som inndata og .gcode som utdata.

7. Inspiser porter og funksjoner

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

agent capabilities returnerer skjemaet for hva CLI-en kan gjøre. agent guide returnerer en oppstartsarbeidsflyt for eksterne agenter.

Dette kan CLI-en ikke gjøre

Velge et verktøy på arbeidsområdet.
Åpne eller lukke et panel eller en dialogboks.
Utløse en hurtigtast.
Dra og slippe på arbeidsområdet.

For dette må du styre det grafiske grensesnittet direkte, for eksempel via computer-use eller AppleScript, ikke via CLI-en.

Eksempler

Gjengi alle prosjekter i en mappe satsvis

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

Ta et øyeblikksbilde av maskintilstanden hvert minutt

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

Bekreft at det fungerte

beambench-cli --help kjører uten feil.
design render produserer en PNG-fil med størrelse større enn null.
agent state returnerer gyldig JSON.

Bruke CLI