Ugrás a tartalomhoz
Ellenőrizve

A Studio LLM útmutatója

A prog dokumentummodell, az xu-* attribútum-referencia és a munkafolyamat-szabályok, amelyeket egy AI-ügynök az első eszközhívása előtt megtanul.

Minden Studio-projekt, és benne minden tábla, képernyő, szkript és útvonal, egyetlen CouchDB JSON-dokumentum, amelyet prog néven nevezünk (docType: "studio"). Ez az oldal ugyanaz a referencia, amelyet egy AI-ügynök kap, amikor ilyet épít, dokumentációvá átírva: a dokumentum alakja, a felületét hajtó attribútumok, a műveletek, amelyeket egy munkafolyamat végrehajthat, és a hibák, amelyek valódi buildekben előjönnek.

Hogyan kapja meg az AI-ügynök ezt az útmutatót

Csatlakoztasson egy MCP-klienst a Xudához, és az első válasz, az initialize hívás, ezt az útmutatót a munkamenet instructions mezőjeként hordozza, frissen összefésülve a platform saját élő szabályaiból, így soha nem írhat le olyasmit, amit a telepített ellenőrző már nem kényszerít ki. Lásd: AI-kliens csatlakoztatása MCP-n keresztül.

Egy munkamenet belsejéből két metódus közvetlenül eléri ugyanezt az anyagot, MCP-n vagy egyszerű REST-en keresztül, és a normál API-kulcson túl semmit sem igényel:

Az előírt sorrend: olvassa el azt a témát, amely megfelel annak, amit épít, kérjen le egy illő példát, hozza létre a progot a gyáron keresztül (create_prog), építsen a tartalmi szakaszain belül, érvényesítsen (validate_prog) és javítson ki mindent, amit jelez, mentsen (save_prog), majd kérje le újra az ellenőrzéshez. A -409 értéket visszaadó mentés azt jelenti, hogy a dokumentum az olvasás óta megváltozott: kérje le újra, alkalmazza újra, próbálja újra.

A prog dokumentummodell

A boríték

Ezeket a mezőket a szerver- és gyárkód birtokolja; egy szerzői build csak az alattuk lévő tartalmi szakaszokat szerkeszti.

json
{
  "_id": "392_cmp_f15654997737",
  "_rev": "3-...",
  "docType": "studio",
  "stat": 3,
  "app_id": "prj...",
  "properties": { "menuType": "component", "menuName": "Orders", "menuTitle": "Orders" },
  "studio_meta": { "created": 1750000000000, "createdByUid": "...", "savedByUid": "...", "parentId": "programs" }
}
  • Az _id formája <az app_id utolsó 3 karaktere>_<3 betűs típusrövidítés>_<12 hex>, például 392_cmp_... egy komponenshez, 392_tbl_... egy táblához, 392_jvs_... egy javascript proghoz, 392_gtd_... / 392_std_... a get_data / set_data progokhoz, 392_fld_... egy mappához. Az azonosítókat a gyár generálja, egy build soha nem talál ki ilyet.
  • A stat értéke 3 az aktívra, 4 a puha törlésre (ezt állítja be egy prog törlése). A Studio fája csak a stat: 3 elemeket mutatja.
  • A properties.menuType értéke globals, table, get_data, set_data, batch, alert, javascript, folder, route, api, component, ai_agent egyike.
  • A studio_meta.parentId helyezi el a csomópontot a Studio fájában: vagy egy másik prog azonosítója (általában egy mappáé), vagy a típusgyökerek egyike: programs (logika és komponensek), database (táblák), routes, globals, ai_agents. Egy fel nem ismert parentId láthatatlanul hagyja a csomópontot a fában, és ellenőrzői hiba.

Tartalmi szakaszok menuType szerint

A globals dokumentum

Minden projektnek pontosan egy global_<app_id> dokumentuma van (menuType: "globals"). A progFields mezői minden más progból @field_id formában olvashatók. Két rendszerglobális mező minden projekthez jár: az @SYS_GLOBAL_OBJ_LOGIN_USER_INFO a bejelentkezett felhasználóhoz, és az @SYS_GLOBAL_OBJ_REFS az xu-ref attribútummal regisztrált elemekhez. Sem a globals dokumentum, sem a fa gyökere nem törölhető.

Szerkezeti kötelezők

  • A properties, properties.menuType, properties.menuName, studio_meta és studio_meta.parentId minden dokumentumon kötelező.
  • Egy progFields bejegyzéshez egyedi id, data.field_id, virtual, table, expression vagy datasource értékű data.type, valamint string, number, boolean, array vagy object értékű props.fieldType kell.
  • A fenntartott futásidejű változónevek, _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL, soha nem definiálhatók újra mezőazonosítóként.
  • Az ismétlődő azonosítók, ismeretlen menuType értékek és hibás szakaszok mind súlyos hibák, amelyeket a validate_prog közvetlenül jelez.

Kifejezések és xu-* attribútumok

Kifejezésszintaxis

A kifejezések a prog saját adathalmazán futnak. Minden mező, legyen helyi, táblához kötött, globális vagy paraméter, @ jellel hivatkozható: @search_v, @ORD_Total, @SYS_GLOBAL_OBJ_LOGIN_USER_INFO, körülötte egyszerű JavaScripttel, @count_v > 0 ? 'has rows' : 'empty'. Egy objektumliterált zárójelbe kell tenni, ({ ORD_Status: @status_v }). Egy xu-for ciklus belsejében az aktuális elem @_FOR_VAL, a kulcsa vagy indexe @_FOR_KEY (átnevezhető az xu-for-key / xu-for-val attribútummal). Az xu-render és más feltételek közvetlenül az igaz vagy hamis értéket adják vissza, soha nem "Y" / "N" karakterláncot vagy további összehasonlítást.

Az xu-bind az egyetlen kivétel

Mindenhol máshol a mezőre @ jellel hivatkozik. Az xu-bind ehelyett a puszta mezőazonosítót veszi: xu-bind="search_v", soha nem xu-bind="@search_v".

Az xu attribútumok

Előtagcsaládok

Utótagot fogadó attribútumcsaládok. Az xu-on értékek mindig kezelőobjektumok tömbjei; az xu-exp értékek mindig kifejezés-karakterláncok.

json
"xu-on:click": [{
  "handler": "custom",
  "props": {},
  "workflow": [
    { "id": "1", "data": { "action": "update", "name": { "value": "@saving_v: true" }, "enabled": true }, "props": {} },
    { "id": "2", "data": { "action": "set_data", "name": { "prog": "392_std_...", "properties": {}, "parameters": {} }, "enabled": true }, "props": { "condition": "@form_valid_v" } }
  ]
}]

Az xu-on:* attribútum értéke mindig kezelőobjektumok tömbje, és minden workflow műveleti lépések tömbje (a teljes műveletreferencia lent található, a Logikai programok és munkafolyamatok alatt). Egy lépés props.condition értéke kapuzza; a props.async: true várakozás nélkül indítja.

Kritikus szemantika

  • Az xu-exp:class lecseréli a statikus class attribútumot, nem hozzáad. Az az elem, amely mindkettőt hordozza, a statikust figyelmen kívül hagyva kapja, ezért az elrendezési osztályok is a kifejezésbe tartoznak: xu-exp:class="'card p-4 ' + (@active_v ? 'ring' : '')".
  • Az xu-script puszta function (el) { ... } kifejezést vesz, eval-lal értékelve és a DOM-elemmel meghívva, amint a csomópont láthatóvá válik. Védekezzen az újrafutások ellen (if (el.__bound) return; el.__bound = true;), és minden lekérdezést el-re szűkítsen, soha ne document-re.
  • Az xu-style automatikusan hatókörös: minden szelektor megkapja a csomópont [xu-ui-id] előtagját, így az egyszerű elem- és osztályszelektorok helyiek maradnak, és soha nem szivárognak ki.
  • Sem az xu-script, sem az xu-style értéke nem tartalmazhat idézőjelet (' vagy "), a tervezővászon escape nélkül sorosítja az attribútumokat, és egyetlen idézőjel tönkreteszi a komponenst. Az alábbi JavaScript programok szakasz idézőjelmentes technikákat mutat.
  • A statikus szöveg az elem content tulajdonságába való. Az xu-exp:xu-content csak dinamikus szöveghez való.

Tagek

A szerzői tagek az egyszerű HTML mellett: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

  • Az xu-single-view egyetlen rekordot fog át (űrlapgyökér, beágyazva is használható).
  • Az xu-multi-view a gyermekeit a kötött adatok soronként egyszer ismétli.
  • Az xu-panel egy másik progot ágyaz be (program attribútum plusz xu-exp:<param> bemenetek). A paraméterkifejezéseken kívül csak szabványos HTML-attribútumok (class, id, style, title, hidden, slot, name, role, tabindex) tartoznak rá.
  • Az xu-teleport a gyermekeit egy másik DOM-célon jeleníti meg (to vagy xu-exp:to).
  • Egy nagybetűs tagnév (Button, Card) lefordított komponens, nem HTML-elem, lásd lent a Beágyazás részt.

Komponensek

A komponens (menuType: "component") egy felületi egység: egy elemfa (progUi), amely helyi állapothoz (progFields), opcionális adatokhoz (progDataSource), életciklus-logikához (progEvents) és bemeneti/kimeneti felülethez (properties.progParams) kötődik.

Tulajdonságok

json
{
  "menuType": "component", "menuName": "OrderList",
  "renderType": "form",
  "uiFramework": "@xuda.io/xuda-framework-plugin-tailwind",
  "rwMode": "R",
  "progParams": [{ "id": 1, "data": { "dir": "in", "parameter": "order_id_in", "type": "string" }, "props": {} }]
}
  • A renderType értéke form egyetlen rekordhoz (gyökérelem xu-single-view), vagy grid / list adatsoronként ismétlődőhöz (gyökérelem xu-multi-view).
  • Az rwMode értéke R olvasáshoz vagy U frissítéshez; az allowCreate megmondja, hogy beszúrható-e új sor, ha egyik sem egyezik.
  • A progParams elnevezési konvenciója: a paraméterek _in / _out végűek, a komponens-helyi virtuális mezők _v végűek.
  • A uiFramework azt tükrözi, amit a projekt meglévő komponensei már használnak. Egy meglévő projekt, amely kihagyja, hagyja is ki, mert olyan keretrendszer-bővítmény beállítása, amelyet a projekt drive-ja valójában nem szolgál ki, üres képernyőn akasztja meg az élő előnézetet.

Az elemfa (progUi)

json
{
  "id": "root", "type": "element", "tagName": "xu-single-view", "attributes": {},
  "children": [
    { "id": "ui-...", "type": "element", "tagName": "div",
      "attributes": { "class": "card", "xu-style": ".card { padding: 16px; border-radius: 12px; }" },
      "children": [
        { "id": "ui-...", "type": "element", "tagName": "h2", "content": "Orders", "attributes": {}, "children": [] },
        { "id": "ui-...", "type": "element", "tagName": "input", "children": [],
          "attributes": { "type": "text", "placeholder": "Search", "xu-bind": "search_v" } }
      ] }
  ]
}

A gyár root csomópontja marad; a build a children részén belül dolgozik. Minden csomópontnak egyedi azonosító (az új csomópontok ui-<uuid> formát használnak), type: "element" és tagName kell, comment vagy text csomóponttípus nincs, a statikus szöveg inkább a content részben él. Minden csomópontnak kell attributes: {} és children: [], akkor is, ha üres, a tervezővászon sorosítója minden csomóponton mindkettőt feloldja, és a kihagyás tönkreteszi a komponens saját előnézetét.

Beágyazás: xu-panel vagy lefordított komponens

Mindkettő átlátszóan csatolódik, burkolóelem nélkül, és mindkettőről egyetlen jel dönt: hogy a tagName nagybetűvel kezdődik-e.

  • Az xu-panel, kisbetűs tagName plusz egy program attribútum, egy másik progot ágyaz be, egy adatbázishoz kötött vagy állapottal rendelkező gyermeket saját mezőkkel és eseményekkel. A program a gyermek azonosítója (vagy xu-exp:prog dinamikus esetben), az értékek az _in paramétereihez az xu-exp:<param> útján jutnak el.
  • Egy nagybetűs tag plusz egy library attribútum lefordított komponenst csatol, egy tervezőrendszer-primitívet vagy egy alkatrészt, amelyet maga az alkalmazás fordított. Minden egyszerű attribútum propá válik (props.<name>), soha nem DOM-attribútummá, mivel a komponens nem jelenít meg saját elemet. Egy komponenscsomópontnak nincsenek kimeneti paraméterei, az xu-panel-lel ellentétben semmi sem ír vissza értéket a mezőibe.
Egyedül a nagybetű dönt

Egy elgépelt <Buton> is komponenstagként értelmeződik, soha nem tér vissza ismeretlen HTML-elemre, és csatoláskor hibát dob, amely megnevezi a taget, a könyvtárat és minden kipróbált forrást. A validate_prog ma nem ellenőrzi a komponenstageket vagy a library értékeket, az élő előnézet az egyetlen ellenőrzés.

progFields

json
[
  { "id": "<uuid>", "data": { "type": "virtual", "field_id": "search_v" }, "props": { "fieldType": "string" }, "workflow": [] },
  { "id": "<uuid>", "data": { "type": "table", "field_id": "ORD_Total" }, "props": { "fieldType": "number" }, "workflow": [] }
]

A data.type értéke virtual helyi állapothoz, table a kötött adatforrás egy oszlopához, vagy expression / datasource. A mező workflow része változáskor fut. Az alapértelmezést a props.fieldValue állítja be; a számított mező a props.fieldComputed: true értéket plusz a propExpressions.fieldValue értéket állítja.

progDataSource

Egyetlen rekord kulcs szerint (űrlap): dataSourceFilterModelType: "index" egy dataSourceIndexId értékkel, amely létezik a tábla saját tableIndexes részében. Szűrt lista (grid vagy list): dataSourceFilterModelType: "query" a filterModelMongoFx értékkel, ami egy Mongo-stílusú kifejezés-karakterlánc. A dataSourceType értéke table, array, json, csv, none, vagy üres egy tisztán megjelenítési komponensnél, amelynek egyáltalán nincs adatforrása.

progEvents és a három életciklus-horog

Eseménytípusok: on_load, on_exit, before_record, after_record, record_not_found, locate_not_found, screen_ready, on_refresh, on_unload, client_interval, user_defined. A user_defined események bárhonnan kiválthatók a raise_event művelettel; a screen_ready a szokásos csatolási horog.

A komponens három beépített horga megosztja a munkát, a rossz használata gyakori hibaforrás:

screen_ready

Példányonként egyszer fut. Itt hozza létre a DOM-ot és a widgeteket.

on_refresh

Minden betöltés után fut, az elsőt is beleértve, közvetlenül a screen_ready után. Itt adja át az új adatokat a már létező widgeteknek. Ha a frissítési munkát inkább a screen_ready részbe teszi, a létrehozó kód újra lefut a még létező DOM-on, és egy második widgetet halmoz.

on_unload

Akkor fut, amikor a példányt lebontják. Semmisítse meg azt, amit a prog létrehozott, widgeteket, időzítőket, document / window figyelőket, megfigyelőket. A motor csak azt tudja felszabadítani, amit létrehozott, a document elemhez kötött figyelő egyébként túléli a panelt.

Minták

  • Betöltési és üres állapotok: tegye az xu-ref="myref" attribútumot az adatkötött elemre, majd az xu-render segítségével kapuzza a vázlat- vagy üres elemeket a (@SYS_GLOBAL_OBJ_REFS).myref fölött, az adathalmaza az adatok megérkezésekor csatlakozik.
  • Modálisok: építse fel a párbeszédablakot külön komponensként, nyissa meg a call_modal művelettel.
  • Kötött sor mentése vagy törlése: invoke_action az act_save / act_delete értékkel, vagy egy dedikált set_data prog mindenhez, ami túlmegy az aktuális soron.

Logikai programok és munkafolyamatok

A logikai progtípusok a komponens adatgépezetét (progDataSource, progFields, progEvents, properties.progParams) használják felület nélkül:

Paraméterek

json
"progParams": [
  { "id": 1, "data": { "dir": "in",  "parameter": "order_id_in", "type": "string" }, "props": {} },
  { "id": 2, "data": { "dir": "out", "parameter": "total_out",   "type": "number" }, "props": {} }
]

A hívó az értékeket a művelet name.parameters részén adja át, { "order_id_in": { "value": "", "fx": "@selected_id_v" } }, value statikus értékhez, fx kifejezéshez. Az ellenőrző megvizsgálja, hogy a célprogram létezik-e, és a menuType értéke egyezik-e a művelettel.

Munkafolyamat-műveletek

A munkafolyamat lépések tömbje, { "id": "...", "data": { "action": "...", "name": { ... }, "enabled": true }, "props": {} }, sorrendben futtatva. A props.condition kapuzza a lépést, a props.async: true várakozás nélkül indítja. A munkafolyamatok az xu-on:* kezelőkben, a progEvents[].workflow részben és a mező saját workflow részében jelennek meg.

Az invoke_action elfogadja az act_next, act_prev, act_first, act_last, act_reload, act_refresh, act_print, act_save, act_delete értékeket (csak komponens-kontextusban).

Elavult műveletek, amelyeket az ellenőrző elutasít

alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element. A felületet mezőkön és xu-exp / xu-render útján vezérelje imperatív elemművelet helyett.

A call_ai_agent és a call_triage_agent nem valódi művelet

A Studio saját műveletválasztója a AI-ügynök hívása és a Szelektáló ügynök hívása lehetőséget is felkínálja a fenti műveletek mellett. Egyik sincs ebben a táblázatban, mert egyik sem az: a validate_prog nem ismeri őket, és invalid trigger type hibát jelez, a futásidejű munkafolyamat-motornak pedig szintén nincs kezelője hozzájuk, így egy elmentett lépés soha nem fut le, még ha a hibát figyelmen kívül is hagyják. Hogy egy prog elérjen egy közzétett ügynököt, adjon hozzá egy AI-ügynök eszközt egy másik ügynök saját eszközlistájához (egy menuType: "ai_agent" dokumentum agentConfig.agent_tools része), nem pedig munkafolyamat-lépést egy komponensen, get_data vagy bármely más progtípuson.

Az update name.value része pontosvesszővel elválasztott @field: expression párokkal vagy egy JSON5 objektummal rendel mezőket, "@saving_v: true; @status_v: 'sent'". Egy másik program hívásakor az a name.prog alatt szerepel, a művelet a program saját típusához igazítva (a get_data egy get_data progot igényel, a call_native_javascript egy javascript progot, és így tovább).

A call_library egy telepített bővítménymetódust hív: a name.plugin_name bővítményt meg kell vásárolni és telepíteni az alkalmazásra, különben az ellenőrző elutasítja a lépést, a name.library_method a bővítmény által exportált metódusok egyike, a name.library_props a deklarált mezői. Két prop-név bővítményeken átívelő konvenció, nem valamelyikre jellemző: az event_name_for_successful_callback azt az eseményt váltja ki a metódus válaszával, a field_id_to_return_result a választ közvetlenül abba a mezőbe írja, egyik sem kötelező.

progEvents típusok

on_load, on_exit, before_record, after_record, record_not_found, locate_not_found, screen_ready, on_refresh, on_unload, client_interval, user_defined. A screen_ready a szokásos init horog; a before_record / after_record / record_not_found / locate_not_found adat-életciklus, különösen a set_data és batch progokhoz; a client_interval ismétlődő időzítő; a user_defined a raise_event műveletből fut.

Táblák

A tábla prog (menuType: "table") egy adatbázistáblát határoz meg: az oszlopait (tableFields), az indexeit (tableIndexes) és a tárolására szolgáló adatbázis-bővítményt (properties.databaseSocket). Fában a szülő: database, vagy egy mappa alatta.

json
{
  "properties": { "menuType": "table", "menuName": "ORD - Orders", "databaseSocket": "@xuda.io/xuda-dbs-plugin-xuda" },
  "tableFields": [
    { "id": "<uuid>", "data": { "field_id": "ORD_Id" }, "props": { "fieldType": "string", "mandatory": true } }
  ],
  "tableIndexes": [
    { "id": "<uuid>", "data": { "name": "index_1", "unique": true, "keys": ["ORD_Id"] }, "props": {} }
  ]
}
  • A databaseSocket a projektre telepített adatbázis-bővítményt kell megnevezze, az @xuda.io/xuda-dbs-plugin-xuda a platform alapértelmezése; ugyanabban a projektben egy meglévő tábla a viszonyítási pont, melyik socketet érdemes újrahasználni.
  • Legalább egy mező és legalább egy index kötelező.
  • A field_id betűvel kezdődik, majd betűk, számjegyek, aláhúzás, kötőjel, kettőspont vagy pont következhet, és a táblán belül egyedi marad.
  • A fieldType értéke string, number, boolean, array, object vagy date; a mandatory: true kötelezővé teszi mentéskor.
  • Minden indexnek nem üres name és keys kell, és minden kulcsnak létező field_id kell legyen.

Konvenció: az oszlopokat előtagolja hárombetűs táblakóddal, az „ORD - Orders" nevű tábla ORD_Id, ORD_Total, ORD_Status mezőket kap. Adjon minden táblának egyedi <TBL>_Id mezőt egyedi indexszel, az egyrekordos komponenskötésnek erre van szüksége.

Egy táblát háromféleképpen használnak: egy komponens vagy lekérdezés progDataSource.dataSourceTableId értéke, egy get_data / set_data / batch prog soronkénti eléréshez munkafolyamatokból, vagy xu.dbs_create / dbs_read / dbs_update / dbs_delete egy szkriptből, ahogy a következő rész tárgyalja.

JavaScript programok

A javascript prog (menuType: "javascript") valódi JS-forrást tart a scriptData.value mezőben, mentéskor lefordítva. A save_prog elindítja ezt a buildet, és az eredményt data.compile formában adja vissza, { ok: true, dependencies } vagy { ok: false, error }. A sikertelen fordítás is menti a dokumentumot, ezért a build beolvassa a compile.ok értéket, és a továbblépés előtt kijavítja.

A végrehajtási szerződés

A forrás egyszerű aszinkron törzsként íródik, export és burkoló nélkül. Futásidőben így hajtódik végre:

js
async function (params, xu, SESSION_ID, SESSION_OBJ, jobNoP, $container, func, glb, APP_OBJ, evt) {
  /* source */
}

A params a hívó már kiértékelt bemenetei; az xu az alábbi futásidejű API; a visszatérési érték opcionális, az eredmények visszaadásának szokásos módja az xu.set_field_value a hívó komponens mezőin. Az idézőjelek itt rendben vannak, az xu-script attribútumértékkel ellentétben.

Az xu futásidejű API

js
const raw = await xu.get_field_value(`rows_json_v`);
const rows = typeof raw === `string` ? JSON.parse(raw || `[]`) : raw || [];
for (const row of rows) {
  await xu.dbs_create(`392_tbl_...`, { CNT_Name: row.name || ``, CNT_Email: row.email || `` });
}
// dbs_read resolves to an ARRAY of { id, value } rows: the row id on .id, table fields under .value.
const all = await xu.dbs_read(`392_tbl_...`, {}, [], null, 999);
await xu.set_field_value(`status_v`, `Saved ` + rows.length + ` rows`);

A dbs_* metódusok a tábla prog saját _id értékét veszik, soha nem nevet. A szelektorok Mongo-stílusú objektumok a mezőazonosítókon, az {} mindent visszaad (alapértelmezett limit 999). A fields vetítés opcionális, az [] minden mezőt visszaad, a mezőazonosítók listája csak azokat.

Adatok átadása: mezők, nem paraméterek

A call_native_javascript nem értékeli ki a {value, fx} paraméterburkolókat, a name.parameters nyersen jut el a szkripthez. A megbízható szerződés: a komponens előbb mezőbe teszi a tartalmat (egy update lépéssel vagy egy xu-bind bevitellel), a munkafolyamat üres parameters: {} értékkel hívja a progot, a szkript pedig az xu.get_field_value hívással olvassa, és az xu.set_field_value hívással jelent vissza. Ha másik szkriptből hív, az xu.call_javascript(prog_id, {...}) a paramétereket közvetlenül átadja.

Élő előnézeti furcsaságok

  • Az adatírások a valódi adatbázisba jutnak, de az xu.dbs_read egy helyi vázlattárolót olvas, amely lehet, hogy nem tartalmazza a friss szerversorokat, egy írás utáni olvasás üresen jöhet vissza az előnézetben, még ha az írás meg is érkezett (látható a tábla Data lapján a Studióban). A telepített alkalmazások ugyanabból a tárolóból olvasnak és írnak.
  • A lefordított szkriptek keményen gyorsítótárazódnak a fejlesztői előnézetekben, egy futó előnézet még a mentés utáni újrafordítás után, újratöltéseken át is az előző szkriptet futtathatja. A böngésző kemény frissítése törli.
  • Az xu.alert modal, toast vagy browser megjelenítéssel natív, blokkoló alert() formában jelenhet meg az előnézetben. Biztonságosabb módja a visszajelzésnek az xu.set_field_value egy állapotmezőbe.

javascript prog és xu-script attribútum

Idézőjelmentes technikák az xu-script / xu-style számára

A tervezővászon escape nélkül sorosítja az attribútumértékeket, így egyetlen idézőjel is tönkreteszi a komponens jelölését. A sablonliterálok teljesen elkerülik a karakterlánc-idézőjeleket (el.textContent = `Ready`); a literális " karakter, például CSV építésekor, a String.fromCharCode(34) hívásból jön; a CSS-attribútumszelektorok idézőjel nélkül is érvényesek (el.querySelector(`[data-role=import-btn]`)); az újrafutás-védő pedig, if (el.__bound) return; el.__bound = true;, megakadályozza, hogy a szkript újrarenderelésnél kétszer kötődjön.

Buktatók

Az alábbi bejegyzések mindegyike valamikor tönkretett egy valódi buildet. A validate_prog a legtöbbet elkapja, minden mentés előtt futtassa.

API-mechanika

  • Minden válasz { code, data }, a code < 0 hiba.
  • A create_prog az új dokumentumot a data.prog alatt adja vissza, ha a teljes választ menti el, az hibás dokumentumot ment, amelyben a properties a prog alá van temetve.
  • A save_prog az egész dokumentumot lecseréli. Mindig az aktuális dokumentumból induljon, soha ne kézzel összeállított vázból; a -409 azt jelenti, hogy az utolsó olvasás óta megváltozott, kérje le újra, alkalmazza újra, próbálja újra.
  • MCP-n a prog_json és a properties_json karakterláncként adandó át, az eszközsémaréteg eltávolítja az ismeretlen kulcsokat egy objektumparaméterből, és csendben egész szakaszokat dobhat el.
  • A delete_prog puha törlés, a stat: 4 értéket állítja be. A global_<app_id> csomópont nem törölhető.

Dokumentumtartalom

  • Ne legyen ' vagy " az xu-script vagy xu-style értékeken belül.
  • A $ előtagú kulcsok ($folded, $childrenClass, $nodeBackClass), valamint a path, code, editCode tervezői nézetállapotok, és soha nem tartoznak egy mentett progUi csomópontba.
  • Nincs comment vagy text csomóponttípus, csak elemek, a statikus szöveg a content részben.
  • Minden elemcsomópontnak kell attributes: {} és children: [], akkor is, ha üres.
  • Az xu-exp:class lecseréli a statikus class értéket, minden szükséges osztály a kifejezésbe tartozik.
  • Az xu-bind puszta mezőazonosító, @ nélkül, mindenhol máshol a mezők @ jelet használnak.
  • Csak a dokumentált xu-* attribútumok csinálnak bármit, a kitalált csendben figyelmen kívül marad, és a validate_prog figyelmeztet.
  • Egy ai_agent prog fagyökere az ai_agents, mentse a studio_meta.parentId: "ai_agents" értékkel (vagy egy alatta lévő mappa azonosítójával), ha az ellenőrző a parentId miatt jelez.

Futásidő és megjelenítés

  • Egy nagybetűs tagName mindig komponensként értelmeződik, még egy elgépelés is, és csatoláskor hibát dob, amely megnevezi a taget, a library értéket és minden kipróbált forrást, nincs csendes „nem jelenik meg", mint egy program nélküli xu-panel esetén.
  • A validate_prog nem ellenőrzi a komponenstageket vagy a library értékeket, csak az élő előnézet kapja el az elírást.
  • Futásidőben nincs utility CSS (Tailwind vagy más), hacsak a projekt uiFramework bővítménye ténylegesen nem adja, az olyan osztályok, mint a p-4, egyébként csendben hatástalanok. Az önálló stílusozás az xu-style, amelyet a [xu-ui-id] automatikusan hatókörbe zár.
  • Az xu-script elemenként egyszer, amikor láthatóvá válik, fut, és újrarenderelésnél újra elsülhet, védekezzen az el.__bound értékkel, és a lekérdezéseket szűkítse el-re.

Adatok és szkriptek

  • A call_native_javascript paraméterei nem értékelődnek ki, az adatokat inkább mezőkön adja át (lásd fent az Adatok átadása részt).
  • A dbs_read sorok {id, value} alakúak, a mezők a .value alatt vannak, a sorazonosító az .id mezőn. Ne adjon át fields vetítést, az megtöri a szerveroldali olvasást.
  • Az xu-for belsejében tegye zárójelbe az iterátort, a (@_FOR_VAL).CNT_Name kiértékelődik, a @_FOR_VAL.CNT_Name csendben elbukik, és a behelyettesített forrásszöveget jeleníti meg.
  • Az előnézeti írások a valódi adatbázisba kerülnek; az előnézeti olvasások helyi vázlattárolóból jönnek, amely közvetlenül egy írás után üresnek látszhat.
  • Az előnézetekben az állapotmezőt részesítse előnyben az xu.alert modális vagy toast megjelenítésével szemben, az natív, blokkoló alert() formában jelenhet meg.

A munkája ellenőrzése

Mentés után kérje le újra a get_prog hívással, és vesse össze a várttal. Felületi munkához nyissa meg a komponenst a Studióban, és nyomja meg az előnézet lejátszás gombját, vagy a projekt élő előnézeti URL-jét, ha elérhető. Javascript proghoz minden mentésnél ellenőrizze a data.compile.ok értéket. Javítson ki minden validate_prog hibát; a figyelmeztetéseit, idézőjeleket, $ kulcsokat, ismeretlen attribútumokat, kezelje azonnal javítandó tételként, ne zajként.