Usare la CLI

Ispeziona e modifica l'app in esecuzione tramite la sua API locale oppure esporta direttamente G-code.

Il binario beambench-cli viene distribuito insieme all'app desktop. La maggior parte dei comandi relativi a progetto, design, macchina, profilo e stato sono client dell'API locale dell'app. Richiedono che l'app sia in esecuzione con Settings > General > Local API abilitato.

Lascia disattivato Allow network devices to connect per gli script eseguiti sullo stesso computer. La CLI legge la porta API configurata nelle impostazioni dell'app; il valore predefinito è 5900.

Trovare i comandi disponibili

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

La guida funziona senza l'app. Le funzionalità e lo stato in tempo reale usano l'API. Esegui un sottocomando con --help per visualizzare i relativi parametri per la versione installata.

Aprire e ispezionare un progetto

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

L'apertura di un progetto modifica il progetto nell'app desktop. Salva il lavoro prima di eseguire script che lo sostituiscono o lo modificano.

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

Eseguire il rendering ed esportare

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

Questi comandi usano il progetto corrente dell'app tramite l'API. Il rendering del design non richiede un canvas visibile, ma richiede comunque il server.

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

Il rendering con sovrapposizione della fotocamera richiede anche che il frontend dell'app gestisca la richiesta di rendering. Non sostituisce il flusso di lavoro della fotocamera senza interfaccia.

Comandi che funzionano senza l'app

L'elenco delle porte seriali, la guida e l'esportazione G-code con argomenti posizionali hanno percorsi locali diretti:

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

L'esportazione G-code autonoma usa un profilo della macchina salvato localmente e i controlli di pianificazione e output dell'app desktop. Non può leggere la posizione corrente della macchina. Leggi Output G-code per i requisiti relativi al profilo e al posizionamento.

Automazione e conflitti

Le transazioni di Design usano la revisione corrente del progetto. Se un'altra modifica, il cambio di progetto o la chiusura invalida il progetto acquisito, la transazione viene rifiutata. Aggiorna lo stato e rivaluta l'operazione prima di riprovare; non sovrascrivere le modifiche simultanee dell'utente con un'istantanea precedente.

I comandi che possono spostare la macchina, attivare il laser, inviare G-code non elaborato o modificare l'assistenza aria richiedono i relativi flag di conferma. Esamina la guida del comando e l'azione prevista prima di fornirli.

La CLI non seleziona gli strumenti del canvas, non ridispone i pannelli e non attiva le scorciatoie. Queste sono azioni dell'interfaccia desktop.