CLI:n käyttö

Ohjaa Beam Benchia päätelaitteesta. Avaa projekteja, hahmonna piirtoalueita, tarkastele tilaa ja vie tiedostoja.

beambench-cli-binääri rakennetaan Beam Bench -sovelluksen rinnalla. Käytä sitä skriptaukseen, erätoimintoihin ja käyttöliittymättömään hahmonnukseen.

Mitä tarvitset

Beam Bench asennettuna (tai repositorio ladattuna, jos käännät sovelluksen lähdekoodista).
Päätelaite (Terminal macOS:ssä, PowerShell Windowsissa tai mikä tahansa komentotulkki Linuxissa).
Joitakin komentoja varten sovelluksen on oltava käynnissä. Useimmat komennot eivät sitä vaadi.

Mistä löydät sen

Binäärin nimi on beambench-cli, ja se asennetaan työpöytäsovelluksen rinnalle. Tarkka polku riippuu nykyisen koontiversiosi käyttöjärjestelmän pakettirakenteesta. Tarkista asennushakemisto.

Voit lisätä sen PATH-muuttujaan tai määrittää sille lyhyemmän aliaksen:

alias bb=beambench-cli

Alla olevissa esimerkeissä käytetään koko nimeä beambench-cli.

Vaiheet

1. Varmista, että CLI toimii

beambench-cli --help

Luettelee kaikki alikomennot. Jokaisella alikomennolla on oma --help-ohjeensa.

2. Tarkastele agentin tilaa

beambench-cli agent state --json

Palauttaa JSON-vedoksen nykyisestä projektista, konetilestä, valinnasta ja kameran tilasta. Hyödyllinen skriptauksessa ja virheenkorjauksessa.

3. Hahmonna piirtoalue PNG-tiedostoksi (käyttöliittymätön tila)

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

Hahmontaa nykyisen projektin suunnitelman (ilman kameran peitekuvaa) PNG-tiedostoksi. Toimii ilman graafista käyttöliittymää.

4. Hahmonna kameran peitekuvan kanssa (vaatii graafisen käyttöliittymän)

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

Kaappaa piirtoalueen nykyisen kameran peitekuvaruudun kanssa. Työpöytäsovelluksen on oltava käynnissä. CLI lähettää sovellukselle käänteisen RPC-kutsun, sovellus suorittaa hahmonnuksen ja kirjoittaa tiedoston.

5. Avaa projekti

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

Polku annetaan sijaintiparametrina. Tallenna takaisin käyttämällä komentoa beambench-cli project save (ei argumentteja, korvaa avoinna olevan tiedoston) tai komentoa beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Vie tiedostoja

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

SVG-, DXF-, PDF-, EPS- ja AI-viennit käyttävät --path-parametria. G-code käyttää kahta sijaintiparametria: syötteenä .lzrproj ja tulosteena .gcode.

7. Tarkastele portteja ja toimintoja

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

agent capabilities palauttaa skeeman CLI:n tuetuista toiminnoista. agent guide palauttaa ulkoisille agenteille tarkoitetun aloitustyönkulun.

Mitä CLI ei voi tehdä

Valita piirtoalueen työkalua.
Avata tai sulkea paneelia tai valintaikkunaa.
Käynnistää pikanäppäintä.
Raahata ja pudottaa piirtoalueella.

Näitä varten ohjaa graafista käyttöliittymää suoraan (esimerkiksi computer-use-toiminnolla tai AppleScriptillä), älä CLI:n kautta.

Esimerkkejä

Hahmonna kansion jokainen projekti eräajona

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

Tallenna koneen tilannekuva minuutin välein

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

Varmista toiminta

beambench-cli --help suoritetaan ilman virheitä.
design render tuottaa PNG-tiedoston, jonka koko on suurempi kuin nolla tavua.
agent state palauttaa kelvollista JSON-muotoa.