Dokumentacija Beam Bench

Kako CLI in aplikacija delita stanje

Model stanja agenta v Beam Bench. Kaj vidi CLI, kaj vidi aplikacija in kje se stikata.

CLI Beam Bench in namizna aplikacija sta odjemalca iste zaledne storitve. Oba lahko pregledujeta isti projekt, isto povezavo z napravo in isto stanje kamere. Razumevanje, kako si delita to stanje, je koristno, kadar želite aplikacijo upravljati iz skripta.

Model

V Beam Bench je en sam vir resnice, ki upravlja:

  • Aktivni projekt.
  • Povezavo z napravo.
  • Stanje kamere.
  • Površino zmožnosti in stanja agenta.

Uporabniški vmesnik namizne aplikacije je eden od uporabnikov tega stanja. CLI je drugi. API HTTP / WebSocket je isti vmesnik.

Kaj lahko CLI naredi

beambench-cli agent state --json vrne trenutno stanje projekta, naprave, izbora in kamere v stabilni shemi JSON. Uporabite ga za pregled tega, kar je trenutno naloženo v aplikaciji.

beambench-cli agent capabilities --json vrne register razpoložljivih operacij in podukazov CLI, ki so povezani s posameznimi zalednimi operacijami.

beambench-cli agent guide --json vrne namig za potek dela zunanjemu agentu (na primer Claude), kako upravljati aplikacijo.

Česa CLI ne more narediti

CLI nima lastnega stanja uporabniškega vmesnika. Ne more izbrati orodja, odpreti podokna ali odpreti pogovornega okna. To so dejanja na strani aplikacije, zato jih izvedite v aplikaciji in ne iz CLI-ja.

Kdaj mora biti aplikacija zagnana

Nekatere operacije zahtevajo, da aplikacija opravi dejansko delo, na primer izris platna s prekrivnim slojem ali zajem posnetka kamere. CLI posreduje zahtevo, aplikacija opravi delo, rezultat pa se vrne v CLI.

Ukaz camera overlay render deluje na ta način. CLI čaka, dokler aplikacija ne konča ali poteče časovna omejitev (15 s).

Ukazi brez aplikacije in ukazi, ki jo potrebujejo

Mora biti aplikacija zagnana?Primeri
Ne (brez grafičnega vmesnika)beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state
Dabeambench-cli camera overlay render, beambench-cli camera capture (pri uporabi nativne kamere), vsak pregled stanja uporabniškega vmesnika

Sorodno

On this page