Uporaba CLI-ja: BeamBench

Upravljajte Beam Bench iz terminala. Odprite projekte, upodabljajte platna, pregledujte stanje in izvažajte datoteke.

Binarna datoteka beambench-cli se zgradi skupaj z aplikacijo Beam Bench. Uporabljajte jo za skriptiranje, paketne operacije in upodabljanje brez grafičnega vmesnika.

Kaj potrebujete

Nameščen Beam Bench (ali klon repozitorija, če gradite iz izvorne kode).
Terminal (Terminal v sistemu macOS, PowerShell v sistemu Windows ali katera koli lupina v sistemu Linux).
Pri nekaterih ukazih mora aplikacija delovati. Večina ukazov tega ne zahteva.

Binarna datoteka se imenuje beambench-cli in je nameščena skupaj z namizno aplikacijo. Natančna pot je odvisna od postavitve paketa na platformi za vašo trenutno gradnjo, zato preverite namestitveni imenik.

Morda jo boste želeli dodati v svoj PATH ali ji določiti vzdevek za krajšo uporabo:

alias bb=beambench-cli

V spodnjih primerih je uporabljeno polno ime beambench-cli.

Koraki

1. Preverite delovanje CLI-ja

beambench-cli --help

Izpiše vse podukaze. Vsak podukaz ima svoj --help.

2. Preglejte stanje agenta

beambench-cli agent state --json

Vrne izpis JSON trenutnega projekta, povezave z napravo, izbire in stanja kamere. Uporabno za skriptiranje in odpravljanje napak.

3. Upodobite platno v PNG (brez grafičnega vmesnika)

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

Upodobi zasnovo trenutnega projekta brez prekrivnega prikaza kamere v PNG. Deluje tudi brez zagnanega grafičnega vmesnika.

4. Upodobite s prekrivnim prikazom kamere (zahteva grafični vmesnik)

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

Zajame platno z okvirjem trenutnega prekrivnega prikaza kamere. Namizna aplikacija mora delovati, CLI pa aplikaciji pošlje reverse-RPC, da izvede upodabljanje in zapiše datoteko.

5. Odprite projekt

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

Pot je pozicijski argument. Če želite shraniti spremembe nazaj, uporabite beambench-cli project save (brez argumentov, prepiše odprto datoteko) ali beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Izvozite datoteke

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

Pri izvozih SVG, DXF, PDF, EPS in AI uporabite --path. Izvoz G-code zahteva dva pozicijska argumenta: vhodni .lzrproj in izhodni .gcode.

7. Preglejte vrata in zmožnosti

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

agent capabilities vrne shemo tega, kar lahko CLI izvede. agent guide vrne zagonski potek dela za zunanje agente.

Česa CLI ne more

Izbrati orodja za platno.
Odpreti ali zapreti plošče oziroma pogovornega okna.
Sprožiti bližnjične tipke.
Povleči in spustiti elementov na platno.

Za to neposredno upravljajte grafični vmesnik, na primer prek computer-use ali AppleScript, ne prek CLI-ja.

Primeri

Paketno upodabljanje vseh projektov v mapi

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

Posnetek stanja naprave vsako minuto

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

Preverite delovanje

beambench-cli --help se izvede brez napake.
design render ustvari PNG z velikostjo, večjo od nič.
agent state vrne veljaven JSON.

Uporaba CLI-ja