A CLI használata: BeamBench

A Beam Bench vezérlése terminálból. Projektek megnyitása, vásznak renderelése, állapot vizsgálata, fájlok exportálása.

A beambench-cli bináris a Beam Bench alkalmazással együtt készül. Szkripteléshez, kötegelt műveletekhez és grafikus felület nélküli rendereléshez használható.

Amire szükség van

Telepített Beam Bench, vagy a klónozott repó, ha forrásból készíted a programot.
Terminál, macOS-en Terminal, Windowson PowerShell, Linuxon bármely shell.
Egyes parancsokhoz futó alkalmazás. A legtöbb parancshoz nincs rá szükség.

Hol található

A bináris neve beambench-cli, és az asztali alkalmazás mellé települ. A pontos elérési út az aktuális build platformfüggő csomagelrendezésétől függ, ezért ellenőrizd a telepítési könyvtárat.

Érdemes lehet felvenni a PATH környezeti változóba, vagy rövidebb használathoz aliast létrehozni:

alias bb=beambench-cli

Az alábbi példákban a teljes beambench-cli nevet használjuk.

Lépések

1. A CLI működésének ellenőrzése

beambench-cli --help

Felsorolja az összes alparancsot. Minden alparancshoz saját --help súgó tartozik.

2. Az ügynök állapotának vizsgálata

beambench-cli agent state --json

JSON-formátumú pillanatképet ad az aktuális projektről, a gép kapcsolatáról, a kijelölésről és a kamera állapotáról. Szkripteléshez és hibakereséshez hasznos.

3. A vászon renderelése PNG-fájlba, grafikus felület nélkül

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

Az aktuális projekt tervét rendereli PNG-fájlba, kamerafedvény nélkül. A grafikus felület futtatása nélkül is működik.

4. Renderelés kamerafedvénnyel, grafikus felület szükséges

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

A vásznat az aktuális kamerafedvény keretével együtt rögzíti. Az asztali alkalmazásnak futnia kell, a CLI fordított RPC-kérést küld az alkalmazásnak, amely elvégzi a renderelést és kiírja a fájlt.

5. Projekt megnyitása

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

Az elérési út pozicionális argumentum. A visszamentéshez használd a beambench-cli project save parancsot, amely argumentum nélkül felülírja a megnyitott fájlt, vagy a beambench-cli project save-as /abs/path/to/new.lzrproj parancsot.

6. Fájlok exportálása

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

Az SVG, DXF, PDF, EPS és AI exportokhoz --path szükséges. A G-code két pozicionális argumentumot használ: a bemeneti .lzrproj és a kimeneti .gcode fájlt.

7. Portok és képességek vizsgálata

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

Az agent capabilities a CLI által végrehajtható műveletek sémáját adja vissza. Az agent guide külső ügynökök számára indítási munkafolyamatot ad vissza.

Amire a CLI nem képes

Vászoneszköz kijelölése.
Panel vagy párbeszédablak megnyitása, illetve bezárása.
Gyorsbillentyű aktiválása.
Fogd és vidd művelet végrehajtása a vásznon.

Ezekhez közvetlenül a grafikus felületet használd, például computer-use vagy AppleScript segítségével, ne a CLI-t.

Példák

A mappában lévő összes projekt kötegelt renderelése

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

A gépállapot pillanatképe percenként

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

A működés ellenőrzése

A beambench-cli --help hiba nélkül lefut.
A design render nem nulla méretű PNG-fájlt hoz létre.
Az agent state érvényes JSON-t ad vissza.

A CLI használata