CLI verwenden

Steuern Sie Beam Bench über ein Terminal. Öffnen Sie Projekte, rendern Sie Arbeitsflächen, prüfen Sie den Status und exportieren Sie Dateien.

Die Binärdatei beambench-cli wird zusammen mit der Beam Bench-App erstellt. Verwenden Sie sie für Skripte, Stapelverarbeitung und Headless-Rendering.

Voraussetzungen

Beam Bench ist installiert (oder das Repository ist ausgecheckt, wenn Sie aus dem Quellcode kompilieren).
Ein Terminal (Terminal unter macOS, PowerShell unter Windows oder eine beliebige Shell unter Linux).
Für einige Befehle: Die App muss ausgeführt werden. Für die meisten ist dies nicht erforderlich.

Die Binärdatei heißt beambench-cli und wird zusammen mit der Desktop-App installiert. Der genaue Pfad hängt von der Bundle-Struktur der Plattform für Ihren aktuellen Build ab. Prüfen Sie das Installationsverzeichnis.

Sie können die Binärdatei zu Ihrem PATH hinzufügen oder der Kürze halber einen Alias dafür anlegen:

alias bb=beambench-cli

In den folgenden Beispielen wird der vollständige Name beambench-cli verwendet.

Schritte

1. Funktion der CLI überprüfen

beambench-cli --help

Listet alle Unterbefehle auf. Jeder Unterbefehl verfügt über eine eigene Option --help.

2. Agent-Status prüfen

beambench-cli agent state --json

Gibt eine JSON-Ausgabe des aktuellen Projekts, der Maschinenverbindung, der Auswahl und des Kamerastatus zurück. Dies ist für Skripte und die Fehlerbehebung hilfreich.

3. Arbeitsfläche als PNG rendern (Headless)

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

Rendert das Design des aktuellen Projekts (ohne Kameraüberlagerung) als PNG. Funktioniert, ohne dass die grafische Benutzeroberfläche ausgeführt wird.

4. Mit Kameraüberlagerung rendern (GUI erforderlich)

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

Erfasst die Arbeitsfläche mit dem aktuellen Einzelbild der Kameraüberlagerung. Die Desktop-App muss ausgeführt werden. Die CLI sendet einen Reverse-RPC an die App, die das Rendering ausführt und die Datei schreibt.

5. Projekt öffnen

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

Der Pfad ist ein Positionsargument. Verwenden Sie zum Speichern in derselben Datei beambench-cli project save (ohne Argumente; überschreibt die geöffnete Datei) oder beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Dateien exportieren

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

Für SVG-, DXF-, PDF-, EPS- und AI-Exporte wird --path verwendet. G-code erfordert zwei Positionsargumente: die .lzrproj-Eingabedatei und die .gcode-Ausgabedatei.

7. Anschlüsse und Funktionen prüfen

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

agent capabilities gibt das Schema der verfügbaren CLI-Funktionen zurück. agent guide gibt einen Bootstrap-Workflow für externe Agenten zurück.

Einschränkungen der CLI

Ein Werkzeug für die Arbeitsfläche auswählen.
Einen Bereich oder ein Dialogfeld öffnen oder schließen.
Einen Tastaturkurzbefehl auslösen.
Elemente per Drag-and-drop auf der Arbeitsfläche verschieben.

Steuern Sie für diese Aktionen die grafische Benutzeroberfläche direkt (z. B. über Computer-Use oder AppleScript), nicht über die CLI.

Beispiele

Alle Projekte in einem Ordner stapelweise rendern

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

Maschinenstatus jede Minute erfassen

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

Ergebnis überprüfen

beambench-cli --help wird fehlerfrei ausgeführt.
design render erzeugt eine PNG-Datei mit einer Größe größer als null.
agent state gibt gültiges JSON zurück.