Použití CLI

Ovládejte Beam Bench z terminálu. Otevírejte projekty, vykreslujte plátna, kontrolujte stav a exportujte soubory přímo pomocí příkazového řádku.

Binární soubor beambench-cli se sestavuje společně s aplikací Beam Bench. Používejte jej pro skriptování, dávkové operace a vykreslování bez grafického rozhraní.

Co potřebujete

Nainstalovaný Beam Bench (nebo naklonovaný repozitář, pokud sestavujete ze zdrojového kódu).
Terminál (Terminal v macOS, PowerShell ve Okna nebo libovolný shell v Linuxu).
U některých příkazů spuštěnou aplikaci. Většina příkazů ji nevyžaduje.

Kde jej najdete

Binární soubor se jmenuje beambench-cli a instaluje se společně s desktopovou aplikací. Přesná cesta závisí na rozvržení balíčku platformy pro aktuální sestavení; zkontrolujte instalační adresář.

Můžete jej přidat do proměnné PATH nebo si pro stručnější zápis vytvořit alias:

alias bb=beambench-cli

Níže uvedené příklady používají úplný název beambench-cli.

Postup

1. Ověřte, že CLI funguje

beambench-cli --help

Vypíše všechny podpříkazy. Každý podpříkaz má vlastní volbu --help.

2. Zkontrolujte stav agenta

beambench-cli agent state --json

Vrátí výpis JSON s informacemi o aktuálním projektu, připojení stroje, výběru a stavu kamery. Je užitečný pro skriptování a ladění.

3. Vykreslete plátno do PNG (bez grafického rozhraní)

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

Vykreslí návrh aktuálního projektu (bez překryvu kamery) do PNG. Funguje i bez spuštěného grafického rozhraní.

4. Vykreslete překryv kamery (vyžaduje grafické rozhraní)

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

Pořídí plátno s aktuálním překryvným rámečkem kamery. Vyžaduje spuštěnou desktopovou aplikaci; CLI odešle do aplikace zpětné RPC volání, aplikace vykreslí obraz a zapíše soubor.

5. Otevřete projekt

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

Cesta je poziční argument. Chcete-li projekt uložit zpět, použijte beambench-cli project save (bez argumentů, přepíše otevřený soubor) nebo beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Exportujte soubory

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

Exporty SVG, DXF, PDF, EPS a AI používají --path. G-code přijímá dva poziční argumenty: vstupní .lzrproj a výstupní .gcode.

7. Zkontrolujte porty a možnosti

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

agent capabilities vrátí schéma funkcí, které CLI podporuje. agent guide vrátí úvodní pracovní postup pro externí agenty.

Co CLI nedokáže

Vybrat nástroj plátna.
Otevřít nebo zavřít panel či dialogové okno.
Aktivovat klávesovou zkratku.
Přetahovat objekty na plátně.

V těchto případech ovládejte grafické rozhraní přímo (například pomocí computer-use nebo AppleScriptu), nikoli přes CLI.

Příklady

Dávkové vykreslení všech projektů ve složce

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

Uložení stavu stroje každou minutu

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

Ověřte výsledek

beambench-cli --help se spustí bez chyby.
Příkaz design render vytvoří PNG s nenulovou velikostí.
agent state vrátí platný JSON.