Brug af CLI

Styr Beam Bench fra en terminal. Åbn projekter, gengiv lærreder, inspicér tilstand, eksportér filer.

Binærfilen beambench-cli bygges sammen med Beam Bench-appen. Brug den til scripting, batchhandlinger og headless-gengivelse.

Det skal du bruge

Beam Bench installeret (eller repositoryet tjekket ud, hvis du bygger fra kildekoden).
En terminal (Terminal på macOS, PowerShell på Windows eller en valgfri shell på Linux).
Til nogle kommandoer: appen skal køre. De fleste kræver det ikke.

Hvor du finder den

Binærfilen hedder beambench-cli og installeres sammen med desktop-appen. Den præcise sti afhænger af platformens bundlelayout for din aktuelle build, så tjek installationsmappen.

Du kan placere den på din PATH eller oprette et alias for at skrive mindre:

alias bb=beambench-cli

Eksemplerne nedenfor bruger det fulde navn beambench-cli.

Trin

1. Kontrollér, at CLI'en virker

beambench-cli --help

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

2. Inspicér agentens tilstand

beambench-cli agent state --json

Returnerer et JSON-udtræk af det aktuelle projekt, maskinforbindelsen, markeringen og kameratilstanden. Nyttigt til scripting og fejlfinding.

3. Gengiv lærredet til en PNG (headless)

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

Gengiver det aktuelle projekts design (uden kameraoverlay) til en PNG. Virker uden at GUI'en kører.

4. Gengiv med kameraoverlay (kræver GUI)

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

Optager lærredet med den aktuelle kameravisnings ramme. Kræver, at desktop-appen kører. CLI'en sender en reverse-RPC til appen, som udfører gengivelsen og skriver filen.

5. Åbn et projekt

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

Stien angives som positionsargument. Hvis du vil gemme igen, skal du bruge beambench-cli project save (ingen argumenter, overskriver den åbne fil) eller beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Eksportér 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 bruger --path. G-code bruger to positionsargumenter: input .lzrproj og output .gcode.

7. Inspicér porte og funktioner

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

agent capabilities returnerer skemaet for, hvad CLI'en kan gøre. agent guide returnerer en opstartsarbejdsgang for eksterne agenter.

Det kan CLI'en ikke

Vælge et lærredsværktøj.
Åbne eller lukke et panel eller en dialog.
Udløse en genvejstast.
Trække og slippe på lærredet.

Til dette skal du styre GUI'en direkte, f.eks. via computer-use eller AppleScript, ikke via CLI'en.

Eksempler

Batchgengivelse af alle projekter i en mappe

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

Tag et øjebliksbillede af maskinens tilstand hvert minut

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

Kontrollér, at det virkede

beambench-cli --help kører uden fejl.
En design render producerer en PNG med en størrelse større end nul.
agent state returnerer gyldig JSON.