Slik deler CLI-en og appen tilstand
Beam Bench sin agenttilstandsmodell. Hva CLI-en ser, hva appen ser, og hvor de møtes.
Beam Bench CLI og skrivebordsappen er to klienter for den samme bakenden. Begge kan inspisere det samme prosjektet, den samme maskintilkoblingen og den samme kameratilstanden. Det er nyttig å vite hvordan de deler denne tilstanden når du vil styre appen fra et skript.
Modellen
Det finnes én kilde til sannhet i Beam Bench som eier:
- Det aktive prosjektet.
- Maskintilkoblingen.
- Kameratilstanden.
- Agentens funksjonalitet og tilstandsflate.
Skrivebordsappens brukergrensesnitt er én forbruker av denne tilstanden. CLI-en er en annen. HTTP- og WebSocket-API-et er den samme flaten.
Hva CLI-en kan gjøre
beambench-cli agent state --json returnerer gjeldende tilstand for prosjekt, maskin, utvalg og kamera i et stabilt JSON-skjema. Bruk dette til å inspisere hva appen har lastet inn.
beambench-cli agent capabilities --json returnerer et register over hvilke operasjoner som er tilgjengelige, og hvilke CLI-underkommandoer som tilsvarer hvilke bakendoperasjoner.
beambench-cli agent guide --json returnerer et arbeidsflyttips til en ekstern agent, for eksempel Claude, om hvordan appen kan styres.
Hva CLI-en ikke kan gjøre
CLI-en har ikke sin egen brukergrensesnittstilstand. Den kan ikke velge et verktøy, åpne et panel eller åpne en dialogboks. Dette er handlinger på appsiden, så gjør dem i appen, ikke fra CLI-en.
Når CLI-en trenger at appen kjører
Noen operasjoner krever at appen utfører faktisk arbeid, som å gjengi lerretet med overlegg eller ta et kamerabilde. CLI-en sender forespørselen videre, og appen utfører arbeidet. Resultatet sendes tilbake til CLI-en.
Kommandoen camera overlay render fungerer på denne måten. CLI-en blokkerer til appen er ferdig eller tidsavbruddet inntreffer (15 s).
Hodeløse kommandoer og kommandoer som trenger appen
| Trenger appen å kjøre? | Eksempler |
|---|---|
| Nei (hodeløs) | beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state |
| Ja | beambench-cli camera overlay render, beambench-cli camera capture (ved bruk av innebygd kamera), all inspeksjon av brukergrensesnittstilstand |