Miten CLI ja sovellus jakavat tilan
Beam Benchin agentin tilamalli. Mitä CLI näkee, mitä sovellus näkee ja missä ne kohtaavat.
Beam Benchin CLI ja työpöytäsovellus ovat saman taustajärjestelmän kaksi asiakasohjelmaa. Molemmat voivat tarkastella samaa projektia, samaa laiteyhteyttä ja samaa kameran tilaa. Kun haluat ohjata sovellusta komentosarjasta, on hyödyllistä ymmärtää, miten ne jakavat tämän tilan.
Malli
Beam Benchissä on yksi totuuden lähde, joka hallitsee seuraavia:
- Aktiivinen projekti.
- Laiteyhteys.
- Kameran tila.
- Agentin ominaisuus- ja tilapinta.
Työpöytäsovelluksen käyttöliittymä on yksi tämän tilan käyttäjä. CLI on toinen. HTTP- ja WebSocket-rajapinta käyttää samaa pintaa.
Mitä CLI voi tehdä
beambench-cli agent state --json palauttaa projektin, laitteen, valinnan ja kameran nykyisen tilan vakaassa JSON-skeemassa. Käytä tätä tarkistaaksesi, mitä sovelluksessa on tällä hetkellä ladattuna.
beambench-cli agent capabilities --json palauttaa rekisterin käytettävissä olevista toiminnoista ja siitä, mitkä CLI-alikomennot vastaavat mitäkin taustajärjestelmän toimintoa.
beambench-cli agent guide --json palauttaa ulkoiselle agentille, kuten Claudelle, työnkulkuvihjeen sovelluksen ohjaamista varten.
Mitä CLI ei voi tehdä
CLI:llä ei ole omaa käyttöliittymätilaa. Sillä ei voi valita työkalua, avata paneelia tai avata valintaikkunaa. Nämä ovat sovelluksen toimintoja. Tee ne sovelluksessa, älä CLI:llä.
Milloin CLI tarvitsee käynnissä olevan sovelluksen
Jotkin toiminnot edellyttävät, että sovellus tekee varsinaisen työn, kuten piirtää piirtoalueen peittokuvan kanssa tai kaappaa kamerakuvan. CLI välittää pyynnön sovellukselle, joka tekee työn. Tulos palaa CLI:lle.
camera overlay render -komento toimii tällä tavalla. CLI odottaa, kunnes sovellus valmistuu tai aikakatkaisu tulee vastaan (15 s).
Komennot, jotka toimivat ilman sovellusta ja jotka tarvitsevat sovelluksen
| Tarvitaanko sovellus käynnissä? | Esimerkkejä |
|---|---|
| Ei (ilman käyttöliittymää) | beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state |
| Kyllä | beambench-cli camera overlay render, beambench-cli camera capture (kun käytetään natiivikameraa), kaikki käyttöliittymätilan tarkastelut |