Ugrás a fő tartalomhoz
Minden Base44-alkalmazásnak van egy sandboxa: egy privát felhőkörnyezet, amely az alkalmazás kódját tárolja, és futtatja a fejlesztői szerverét. Ez ugyanaz a környezet és ugyanaz a kód, amelyet az alkalmazásszerkesztő használ, nincs elágazás vagy másolat, amelyet szinkronban kellene tartani. A CLI-vel, egy MCP-klienssel vagy az API-val csatlakozhat hozzá, hogy bármelyik gépről olvasson, keressen, szerkesszen és parancsokat futtasson az alkalmazáson, helyi checkout és telepítés nélkül. Ha a sandboxon keresztül ír egy fájlt, közvetlenül a valódi alkalmazást módosítja, ugyanúgy, ahogy az alkalmazásszerkesztő tenné. Ennek leggyakoribb oka, hogy saját kódolóügynökét használja egy alkalmazásszerkesztőben épített alkalmazással.
Ahhoz, hogy az alkalmazásszerkesztőn kívülről elérje egy alkalmazás sandboxát, Builder csomagra vagy magasabbra van szüksége. Enélkül a parancsok PREMIUM_REQUIRED hibával hiúsulnak meg.

Mikor használja a sandboxot

Egy alkalmazásszerkesztőben épített alkalmazás kódján a következő módokon dolgozhat: A sandbox és a GitHub-integráció fedi át egymást a leginkább, mert mindkettővel saját eszközeivel dolgozhat. A különbség az, hogy munka közben hol van a kód. A GitHub-integrációval egy helyi klónban fejleszt, és a módosítások akkor jutnak el a Base44-be, amikor a main ágba olvasztják őket. A sandboxszal helyben dolgozik az alkalmazás kódján. Nincs mit letölteni, webes asszisztens is használhatja, és minden módosítás azonnal megjelenik az alkalmazásszerkesztő élő előnézetében.

Csatlakozási módok

A sandboxot a következő módokon érheti el: Az összekötők nem a sandbox fájlrendszerén keresztül működnek, ezért nem szerepelnek a fenti táblázatban. Ha összekötőt szeretne beállítani egy így használt alkalmazáson, használja inkább a connectors initiate parancsot. Ez közvetlenül ugyanazt az alkalmazásazonosítót célozza, sandbox és helyi projekt nélkül.

Ágak

A sandbox-parancsok az alkalmazás main ágát célozzák, hacsak mást nem ad meg. Ha egy másik ágon szeretne dolgozni, a branches list paranccsal keresse meg a pontos nevét, majd minden sandbox-parancsnál adja meg a --branch <name> kapcsolót. Az olvasások és szerkesztések ekkor csak arra az ágra vonatkoznak.

A módosítások automatikusan mentődnek

A sandbox write vagy a sandbox edit hívás ugyanannak a kérésnek a részeként, a parancs visszatérése előtt véglegesíti a módosítást, így nincs külön mentési, telepítési vagy feltöltési lépés. A sandbox run paranccsal végzett fájlmódosítás, például rm vagy mv, néhány másodperccel később véglegesítődik, amint lezárul egy rövid késleltetési időszak. Ha azelőtt ír vagy szerkeszt újra, hogy egy korábbi késleltetett véglegesítés befejeződött volna, az új hívás megvárja azt, és COMMIT_FLUSH_PENDING hibával hiúsul meg, ha nem tudja időben megerősíteni a véglegesítést. A strukturált erőforrások ugyanígy szinkronizálódnak. Helyi projektben egy fájl hozzáadása után futtatná az entities push vagy a functions deploy parancsot. A sandboxban a base44/functions/send-email/entry.ts létrehozása elég a függvény hozzáadásához.
Két szabály a sandboxban végzett szerkesztéshez:
  • Ne futtassa a deploy, a functions deploy, az entities push vagy a többi feltöltési parancsot olyan alkalmazáson, amelyet a sandboxában szerkeszt. Ezek a parancsok egy helyi projektet szinkronizálnak a Base44-gyel, sandboxszal dolgozva pedig nincs helyi projekt.
  • Ha az utolsó művelete nem write vagy edit hívás, hanem a sandbox run paranccsal futtatott shellparancs volt, annak véglegesítése még egy kicsit késik. A kapcsolat bontása előtt várjon néhány másodpercet.

Szerkesztés és közzététel

A sandboxon keresztüli szerkesztés nem azonos a közzététellel. A szerkesztés azonnal az alkalmazás kódjának része lesz, és megjelenik az alkalmazásszerkesztőben és annak élő előnézetében. Ahhoz, hogy az alkalmazás nyilvános webhelyén is megjelenjen, ugyanaz a közzétételi lépés kell, mint az alkalmazásszerkesztőben végzett módosításoknál.

Ellenőrzőpontok

Az ellenőrzőpont egy visszaállítási pont az alkalmazás verzióelőzményeiben, egy adott commithoz rögzítve. A sandbox checkpoint paranccsal hozhat létre egyet egy ismert, jó állapot megjelölésére, majd ha egy későbbi módosítás elront valamit, visszaállíthatja az alkalmazásszerkesztőből. A függőben lévő módosítások az ellenőrzőpont létrehozása előtt véglegesítődnek, így mindig a legfrissebb kódot rögzíti.

Munka az alkalmazásszerkesztővel párhuzamosan

A kódolóügynöke és a Base44 alkalmazásszerkesztő egyszerre dolgozhat ugyanazon az alkalmazáson. Nincs zárolás, amelyet meg kellene szerezni, és nincs munkamenet, amelyet fel kellene oldani. Mindkét oldal módosításai ugyanoda kerülnek, ezért kezelje úgy, mintha egy kolléga szerkesztené ugyanazt a projektet.
Nincs összefésülési lépés. Ha a kódolóügynök és az alkalmazásszerkesztő egyszerre módosítja ugyanazt a fájlt, az utolsóként beérkező írás nyer, a korábbi módosítás pedig elvész. Kerülje, hogy egy munkaszakaszban mindkét oldal ugyanazt a fájlt módosítsa.

Indítás és leállítás

A sandbox futó folyamat, nem csak tárhely. Ha egy ideig tétlen, leáll, és a következő parancsra újraindul. A kódot ez egyik esetben sem érinti. A véglegesített módosítások a gitben vannak, és egy újraindított sandbox mindig a legutóbbi commitból indul. Ha a sandbox nem fut, az első parancs elindítja, ezért ez a hívás valószínűleg tovább tart, mint az utána következők.

Jogosultságok

A sandbox elérését két külön ellenőrzés szabályozza. Az egyik, hogy egyáltalán hozzáfér-e az alkalmazáshoz, a másik, hogy az aktuális munkamenete kapott-e írási hozzáférést.

Hozzáférés az alkalmazáshoz

Adminisztrátori hozzáférésre van szüksége magához az alkalmazáshoz, munkaterület-adminisztrátorként vagy az adott alkalmazás közreműködőjeként. A hozzáférést minden hívásnál ellenőrizzük, így a munkaterületi szerepkör módosítása azonnal érvényes. Egy egyszerű munkaterületi megtekintő egyáltalán nem érheti el a sandboxot. Az egyetlen kivétel az a megtekintő, akinek egy régi, alkalmazásonkénti szerkesztői szerepköre is van abból az időből, mielőtt a munkaterület szerepköralapú hozzáférésre váltott. Ez a kombináció továbbra is olvashat a sandboxból, de semmit sem módosíthat. A Superagentek nem támogatják a sandbox-parancsokat.

A munkamenet hatóköre

Az alkalmazáshoz való hozzáférésen túl a sandbox olvasása és módosítása eltérő jogosultságokat igényel a munkamenettől: A munkamenet jogosultságai a létrehozáskor rögzülnek, és később nem bővíthetők. A CLI a base44 login során kéri a sandbox:write jogosultságot, MCP-n keresztül pedig az OAuth hozzájárulási lépésnél adja meg. Egy meglévő munkamenet megújítása nem adja hozzá. Ha tehát az olvasási parancsok működnek, de a módosítók NOT_AUTHORIZED hibával hiúsulnak meg, olyan munkamenetet használ, amely soha nem kapott sandbox:write jogosultságot. Futtassa újra a base44 login parancsot, vagy csatlakoztassa újra az MCP-szervert, és hagyja jóvá a sandbox-hozzáférést, hogy ezzel rendelkező munkamenetet indítson.

Korlátok és védőkorlátok

A fájlparancsok az alkalmazás gyökérkönyvtárára korlátozódnak. Az abszolút útvonalakat és a gyökér fölé vezető útvonalakat PATH_OUTSIDE_SANDBOX hibával utasítja el a rendszer. Az .agents és a .git könyvtár nem érhető el a fájlparancsokkal, és PROTECTED_PATH hibát ad, mert az alkalmazás titkos adatait és a tároló hitelesítő adatait tartalmazzák. Az egyetlen kivétel az .agents/skills, amelyet olvashat és írhat. A teljes funkcióra vonatkozóan alkalmazásonként percenként legfeljebb 120 olvasási kérés, 60 módosítási kérés és 30 futtatási parancs engedélyezett. Bármelyik túllépése RATE_LIMITED hibát ad. Az egyes parancsok saját referenciaoldala ismerteti a méret- és darabszámkorlátokat, például hogy hány útvonalat fogad el a sandbox read, vagy mekkora fájlt enged a sandbox write.

Lásd még

Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.