Použití CLI

Prohlížejte a upravujte spuštěnou aplikaci prostřednictvím jejího místního API nebo exportujte G-code přímo.

Binární soubor beambench-cli je distribuován spolu s desktopovou aplikací. Většina příkazů pro projekty, návrhy, stroje, profily a stav jsou klienty místního API aplikace. Vyžadují spuštěnou aplikaci s povoleným Settings > General > Local API.

Pro skripty spuštěné na stejném počítači ponechte Allow network devices to connect vypnuté. CLI načítá nakonfigurovaný port API z nastavení aplikace; výchozí hodnota je 5900.

Vyhledání dostupných příkazů

beambench-cli --help
beambench-cli agent capabilities --json
beambench-cli agent guide --json

Nápověda funguje bez aplikace. Informace o schopnostech a živý stav používají API. Spusťte podřízený příkaz s volbou --help, abyste zobrazili jeho parametry pro nainstalovanou verzi.

Otevření a kontrola projektu

beambench-cli project open /abs/path/project.lzrproj
beambench-cli agent state --json

Otevřením projektu změníte projekt v desktopové aplikaci. Před spuštěním skriptů, které projekt nahrazují nebo upravují, uložte práci.

beambench-cli project save
beambench-cli project save-as /abs/path/copy.lzrproj

Vykreslení a export

beambench-cli design render --png /tmp/design.png --pixels-per-mm 4
beambench-cli export svg --path /tmp/design.svg

Tyto příkazy používají prostřednictvím API projekt spuštěný v aplikaci. Vykreslování návrhu nevyžaduje viditelné plátno, stále však vyžaduje server.

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

Vykreslení překryvu kamery také vyžaduje, aby frontend aplikace obsloužil požadavek na vykreslení. Nejde o bezobslužnou náhradu pracovního postupu s kamerou.

Příkazy fungující bez aplikace

Výpis sériových portů, nápověda a poziční export G-code mají přímé místní cesty:

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

Samostatný export G-code používá místně uložený profil stroje a kontroly plánování a výstupu desktopové aplikace. Nemůže načíst živou polohu stroje. Požadavky na profil a umístění najdete v části Výstup G-code.

Automatizace a konflikty

Transakce návrhu používají aktuální revizi projektu. Pokud jiná úprava, přepnutí projektu nebo jeho zavření zneplatní zachycený projekt, transakce je zamítnuta. Před dalším pokusem obnovte stav a znovu posuďte operaci; nepřepisujte souběžné úpravy uživatele starým snímkem.

Příkazy, které mohou pohnout strojem, aktivovat laser, odeslat nezpracovaný G-code nebo změnit vzduchovou asistenci, vyžadují odpovídající příznaky potvrzení. Před jejich zadáním si prohlédněte nápovědu příkazu a zamýšlenou akci.

CLI nevybírá nástroje plátna, nepřeskupuje panely ani nespouští klávesové zkratky. Jde o akce desktopového uživatelského rozhraní.