Jak CLI a aplikace sdílejí stav
Model stavu agenta Beam Bench. Co vidí CLI, co vidí aplikace a kde se jejich pohledy setkávají.
CLI Beam Bench a desktopová aplikace jsou dva klienti stejného backendu. Oba mohou prohlížet stejný projekt, stejné připojení stroje a stejný stav kamery. Znalost toho, jak tento stav sdílejí, je užitečná, když chcete aplikaci ovládat ze skriptu.
Model
Uvnitř Beam Bench existuje jediný zdroj pravdy, který vlastní:
- Aktivní projekt.
- Připojení stroje.
- Stav kamery.
- Povrch schopností / stavu agenta.
Uživatelské rozhraní desktopové aplikace je jedním odběratelem tohoto stavu. CLI je druhým. HTTP / WebSocket API je stejným rozhraním.
Co CLI umí
beambench-cli agent state --json vrací aktuální stav projektu, stroje, výběru a kamery ve stabilním schématu JSON. Pomocí tohoto příkazu můžete zjistit, co má aplikace právě načtené.
beambench-cli agent capabilities --json vrací registr dostupných operací a uvádí, které podpříkazy CLI odpovídají kterým operacím backendu.
beambench-cli agent guide --json vrací externímu agentovi (například Claudeovi) nápovědu k pracovnímu postupu, jak aplikaci ovládat.
Co CLI neumí
CLI nemá vlastní stav uživatelského rozhraní. Nemůže vybrat nástroj, otevřít panel ani otevřít dialogové okno. To jsou akce na straně aplikace; provádějte je v aplikaci, nikoli z CLI.
Kdy CLI potřebuje spuštěnou aplikaci
Některé operace vyžadují, aby aplikace provedla skutečnou práci (vykreslení plátna s překryvnou vrstvou, pořízení snímku z kamery). CLI požadavek předá aplikaci, ta práci provede a výsledek se vrátí do CLI.
Příkaz camera overlay render funguje tímto způsobem. CLI čeká, dokud aplikace operaci nedokončí nebo nevyprší časový limit (15 s).
Příkazy bez aplikace a příkazy vyžadující aplikaci
| Vyžaduje spuštěnou aplikaci? | Příklady |
|---|---|
| Ne (bezobslužné) | beambench-cli design render --png, beambench-cli project save, beambench-cli export svg, beambench-cli agent state |
| Ano | beambench-cli camera overlay render, beambench-cli camera capture (při použití nativní kamery), jakákoli kontrola stavu uživatelského rozhraní |
Související
Galvo versus portálová konstrukce
Dvě architektury laserových strojů se zcela odlišnými přednostmi. Znalost rozdílu pomůže vyhnout se nákupu nevhodného stroje.
Souřadnicové systémy
Souřadnice pracovního prostoru, práce, absolutní a obrazovkové souřadnice. Které ovládací prvky používají jednotlivé systémy a jak se převádějí.