Die CLI verwenden

Untersuchen und bearbeiten Sie die laufende App über ihre lokale API oder exportieren Sie G-code direkt.

Die Binärdatei beambench-cli wird zusammen mit der Desktop-App verteilt. Die meisten Befehle für Projekte, Designs, Maschinen, Profile und Zustände greifen als Clients auf die lokale API der App zu. Die App muss mit aktivierter Option Settings > General > Local API ausgeführt werden.

Lassen Sie Allow network devices to connect für Skripte, die auf demselben Computer ausgeführt werden, deaktiviert. Die CLI liest den konfigurierten API-Port aus den App-Einstellungen. Der Standardwert ist 5900.

Verfügbare Befehle finden

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

Die Hilfe funktioniert ohne die App. Funktionen und der Live-Zustand verwenden die API. Führen Sie einen Unterbefehl mit --help aus, um seine Parameter für die installierte Version anzuzeigen.

Ein Projekt öffnen und untersuchen

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

Das Öffnen eines Projekts ändert das Projekt in der Desktop-App. Speichern Sie Ihre Arbeit, bevor Sie Skripte ausführen, die das Projekt ersetzen oder bearbeiten.

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

Rendern und exportieren

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

Diese Befehle verwenden über die API das Projekt der laufenden App. Das Design-Rendering benötigt keine sichtbare Zeichenfläche, aber weiterhin den Server.

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

Das Rendering einer Kameraüberlagerung erfordert außerdem, dass das Frontend der App die Rendering-Anfrage verarbeitet. Es ist kein Ersatz für den Kamera-Workflow ohne Benutzeroberfläche.

Befehle, die ohne die App funktionieren

Die Auflistung serieller Anschlüsse, die Hilfe und der positionsbasierte G-code-Export verfügen über direkte lokale Pfade:

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

Der eigenständige G-code-Export verwendet ein lokal gespeichertes Maschinenprofil sowie die Planungs- und Ausgabeprüfungen der Desktop-App. Er kann die Position einer laufenden Maschine nicht auslesen. Lesen Sie G-code-Ausgabe, um Anforderungen an Profil und Platzierung zu erfahren.

Automatisierung und Konflikte

Design-Transaktionen verwenden die aktuelle Projektrevision. Wenn eine andere Bearbeitung, ein Projektwechsel oder das Schließen den erfassten Projektzustand ungültig macht, wird die Transaktion abgelehnt. Aktualisieren Sie den Zustand und bewerten Sie den Vorgang erneut, bevor Sie ihn wiederholen. Überschreiben Sie keine gleichzeitigen Benutzerbearbeitungen mit einem alten Snapshot.

Befehle, die die Maschine bewegen, den Laser auslösen, rohen G-code senden oder die Druckluftunterstützung ändern können, erfordern die zugehörigen Bestätigungsflags. Prüfen Sie die Befehlshilfe und die beabsichtigte Aktion, bevor Sie diese Flags angeben.

Die CLI wählt keine Zeichenflächenwerkzeuge aus, ordnet Panels nicht neu an und löst keine Tastenkürzel aus. Dies sind Aktionen der Desktop-Oberfläche.