Χρήση του CLI

Χειριστείτε το Beam Bench από ένα τερματικό. Ανοίξτε έργα, αποδώστε καμβάδες, επιθεωρήστε την κατάσταση και εξαγάγετε αρχεία.

Το δυαδικό αρχείο beambench-cli δημιουργείται μαζί με την εφαρμογή Beam Bench. Χρησιμοποιήστε το για δημιουργία σεναρίων, μαζικές λειτουργίες και απόδοση χωρίς γραφικό περιβάλλον.

Τι χρειάζεστε

Εγκατεστημένο Beam Bench (ή το αποθετήριο με ελεγμένο τον κώδικα, αν δημιουργείτε την εφαρμογή από τον πηγαίο κώδικα).
Ένα τερματικό (Τερματικό σε macOS, PowerShell σε Windows, οποιοδήποτε κέλυφος σε Linux).
Για ορισμένες εντολές: η εφαρμογή να εκτελείται. Οι περισσότερες δεν το απαιτούν.

Το δυαδικό αρχείο ονομάζεται beambench-cli και εγκαθίσταται μαζί με την εφαρμογή για υπολογιστές. Η ακριβής διαδρομή εξαρτάται από τη διάταξη του πακέτου της πλατφόρμας για την τρέχουσα έκδοσή σας. Ελέγξτε τον κατάλογο εγκατάστασης.

Ίσως θέλετε να το προσθέσετε στο PATH σας ή να του δημιουργήσετε ένα ψευδώνυμο για συντομία:

alias bb=beambench-cli

Τα παρακάτω παραδείγματα χρησιμοποιούν το πλήρες όνομα beambench-cli.

Βήματα

1. Επαληθεύστε ότι λειτουργεί το CLI

beambench-cli --help

Εμφανίζει όλες τις υποεντολές. Κάθε υποεντολή διαθέτει τη δική της επιλογή --help.

2. Επιθεωρήστε την κατάσταση του agent

beambench-cli agent state --json

Επιστρέφει μια απόθεση JSON του τρέχοντος έργου, της σύνδεσης με το μηχάνημα, της επιλογής και της κατάστασης της κάμερας. Είναι χρήσιμο για δημιουργία σεναρίων και εντοπισμό σφαλμάτων.

3. Αποδώστε τον καμβά σε PNG (χωρίς γραφικό περιβάλλον)

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

Αποδίδει το σχέδιο του τρέχοντος έργου, χωρίς επικάλυψη κάμερας, σε PNG. Λειτουργεί χωρίς να εκτελείται το γραφικό περιβάλλον.

4. Αποδώστε με επικάλυψη κάμερας (απαιτείται το γραφικό περιβάλλον)

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

Καταγράφει τον καμβά με το τρέχον πλαίσιο επικάλυψης κάμερας. Απαιτείται να εκτελείται η εφαρμογή για υπολογιστές. Το CLI στέλνει ένα reverse-RPC στην εφαρμογή, η οποία πραγματοποιεί την απόδοση και γράφει το αρχείο.

5. Ανοίξτε ένα έργο

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

Η διαδρομή είναι ορισματική. Για να αποθηκεύσετε ξανά, χρησιμοποιήστε beambench-cli project save (χωρίς ορίσματα, αντικαθιστά το ανοιχτό αρχείο) ή beambench-cli project save-as /abs/path/to/new.lzrproj.

6. Εξαγάγετε αρχεία

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

Οι εξαγωγές SVG, DXF, PDF, EPS και AI λαμβάνουν --path. Η εξαγωγή G-code λαμβάνει δύο ορισματικές τιμές: το αρχείο εισόδου .lzrproj και το αρχείο εξόδου .gcode.

7. Επιθεωρήστε τις θύρες και τις δυνατότητες

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

Το agent capabilities επιστρέφει το σχήμα των λειτουργιών που μπορεί να εκτελέσει το CLI. Το agent guide επιστρέφει μια αρχική ροή εργασίας για εξωτερικούς agent.

Τι δεν μπορεί να κάνει το CLI

Να επιλέξει ένα εργαλείο καμβά.
Να ανοίξει ή να κλείσει ένα πλαίσιο ή παράθυρο διαλόγου.
Να ενεργοποιήσει μια συντόμευση πληκτρολογίου.
Να εκτελέσει μεταφορά και απόθεση στον καμβά.

Για αυτές τις ενέργειες, χειριστείτε απευθείας το γραφικό περιβάλλον, για παράδειγμα μέσω computer-use ή AppleScript, και όχι μέσω του CLI.

Παραδείγματα

Μαζική απόδοση κάθε έργου σε έναν φάκελο

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

Λήψη στιγμιότυπου της κατάστασης του μηχανήματος κάθε λεπτό

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

Επαληθεύστε ότι λειτούργησε

Το beambench-cli --help εκτελείται χωρίς σφάλμα.
Η εντολή design render παράγει ένα PNG μη μηδενικού μεγέθους.
Η εντολή agent state επιστρέφει έγκυρο JSON.