Så delar CLI:t och appen tillstånd
Beam Bench modell för agenttillstånd. Vad CLI:t ser, vad appen ser och var de möts.
Beam Bench CLI och skrivbordsappen är två klienter till samma backend. Båda kan granska samma projekt, samma maskinanslutning och samma kameratillstånd. Det är praktiskt att känna till hur de delar tillstånd när du vill styra appen från ett skript.
Modellen
Det finns en enda källa till sanning i Beam Bench som äger:
- Det aktiva projektet.
- Maskinanslutningen.
- Kameratillståndet.
- Agentens kapacitets- och tillståndsyta.
Skrivbordsappens gränssnitt är en konsument av detta tillstånd. CLI:t är en annan. HTTP- och WebSocket-API:et är samma yta.
Vad CLI:t kan göra
beambench-cli agent state --json returnerar det aktuella tillståndet för projekt, maskin, markering och kamera i ett stabilt JSON-schema. Använd detta för att granska vad appen har inläst.
beambench-cli agent capabilities --json returnerar ett register över vilka åtgärder som är tillgängliga och vilka CLI-underkommandon som motsvarar vilka backend-åtgärder.
beambench-cli agent guide --json returnerar en arbetsflödesanvisning för en extern agent (som Claude) om hur appen ska styras.
Vad CLI:t inte kan göra
CLI:t har inget eget gränssnittstillstånd. Det kan inte välja ett verktyg, öppna en panel eller öppna en dialogruta. Det är åtgärder på appsidan; utför dem i appen, inte från CLI:t.
När CLI:t behöver att appen körs
Vissa åtgärder kräver att appen utför det faktiska arbetet (renderar arbetsytan med överlagring eller tar en kamerabild). CLI:t skickar begäran vidare och appen utför arbetet; resultatet skickas tillbaka till CLI:t.
Kommandot camera overlay render fungerar på detta sätt. CLI:t väntar tills appen är klar eller tills tidsgränsen nås (15 s).
Kommandon som är huvudlösa respektive kräver appen
| Kräver appen att den körs? | Exempel |
|---|---|
| Nej (huvudlöst) | 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 (vid användning av inbyggd kamera), all inspektion av gränssnittstillstånd |