Πώς το CLI και η εφαρμογή μοιράζονται την κατάσταση
Το μοντέλο κατάστασης agent του Beam Bench. Τι βλέπει το CLI, τι βλέπει η εφαρμογή και πού συναντώνται.
Το CLI του Beam Bench και η εφαρμογή για υπολογιστή είναι δύο πελάτες του ίδιου backend. Και τα δύο μπορούν να ελέγχουν το ίδιο έργο, την ίδια σύνδεση μηχανήματος και την ίδια κατάσταση κάμερας. Η κατανόηση του τρόπου με τον οποίο μοιράζονται αυτή την κατάσταση είναι χρήσιμη όταν θέλετε να χειρίζεστε την εφαρμογή από ένα script.
Το μοντέλο
Υπάρχει μία μοναδική πηγή αλήθειας μέσα στο Beam Bench, η οποία διαχειρίζεται:
- Το ενεργό έργο.
- Τη σύνδεση μηχανήματος.
- Την κατάσταση κάμερας.
- Την επιφάνεια δυνατοτήτων και κατάστασης του agent.
Το περιβάλλον χρήστη της εφαρμογής για υπολογιστή είναι ένας καταναλωτής αυτής της κατάστασης. Το CLI είναι ένας ακόμη. Το API HTTP / WebSocket είναι η ίδια επιφάνεια.
Τι μπορεί να κάνει το CLI
Το beambench-cli agent state --json επιστρέφει την τρέχουσα κατάσταση του έργου, του μηχανήματος, της επιλογής και της κάμερας, σε σταθερό σχήμα JSON. Χρησιμοποιήστε το για να ελέγξετε τι έχει φορτώσει αυτή τη στιγμή η εφαρμογή.
Το beambench-cli agent capabilities --json επιστρέφει ένα μητρώο των διαθέσιμων λειτουργιών και δείχνει σε ποιες λειτουργίες του backend αντιστοιχούν οι υποεντολές του CLI.
Το beambench-cli agent guide --json επιστρέφει μια υπόδειξη ροής εργασίας για έναν εξωτερικό agent, όπως το Claude, σχετικά με τον τρόπο χειρισμού της εφαρμογής.
Τι δεν μπορεί να κάνει το CLI
Το CLI δεν διαθέτει δική του κατάσταση περιβάλλοντος χρήστη. Δεν μπορεί να επιλέξει ένα εργαλείο, να ανοίξει ένα πλαίσιο ή να ανοίξει ένα παράθυρο διαλόγου. Αυτές είναι ενέργειες στην εφαρμογή, επομένως εκτελέστε τες στην εφαρμογή και όχι από το CLI.
Πότε χρειάζεται να εκτελείται η εφαρμογή μαζί με το CLI
Ορισμένες λειτουργίες απαιτούν από την εφαρμογή να εκτελέσει πραγματική εργασία, όπως την απόδοση του καμβά με επικάλυψη ή τη λήψη ενός καρέ από την κάμερα. Το CLI προωθεί το αίτημα και η εφαρμογή εκτελεί την εργασία. Στη συνέχεια, το αποτέλεσμα επιστρέφει στο CLI.
Η εντολή camera overlay render λειτουργεί με αυτόν τον τρόπο. Το CLI περιμένει μέχρι να ολοκληρώσει η εφαρμογή ή μέχρι να λήξει το χρονικό όριο (15 s).
Εντολές χωρίς εφαρμογή και εντολές που χρειάζονται την εφαρμογή
| Χρειάζεται να εκτελείται η εφαρμογή; | Παραδείγματα |
|---|---|
| Όχι (χωρίς γραφικό περιβάλλον) | beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state |
| Ναι | beambench-cli camera overlay render, beambench-cli camera capture (όταν χρησιμοποιείται η εγγενής κάμερα), οποιοσδήποτε έλεγχος της κατάστασης του περιβάλλοντος χρήστη |