AI-natív blokkfejlesztés
Fájlok és buildlépés nélkül: az ügynökök ebben jók.
Írd le a blokkot, és elkészül
A mesterséges intelligenciával működő kódolóügynökök egyetlen promptból vázolják fel a blokkokat, oldalakat és mintákat. Nincs grafikus felület és adatbázis, csak fájlok.
~/starter-theme
❯ Hozz létre egy árazási blokkot három csomaggal, havi/éves váltóval és minden csomaghoz egy CTA-val.
✓ Létrehozva pricing/block.json
✓ Létrehozva pricing/index.php
✓ Létrehozva pricing/style.css
❯ Most hozz létre egy árazási oldalt nyitó szakasszal és GYIK-résszel.
✓ Létrehozva pages/pricing/page.json
✓ Létrehozva pages/pricing/index.php
Fájlok
blockstudio/
├── pricing/ Új
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Új
├── page.json
└── index.php
Minden fájlalapú
A blokkok, oldalak, minták és bővítmények könyvtárak JSON konfigurációval és sablonokkal. Az ügynökök közvetlenül tudják olvasni és írni őket.
Nincs adatbázis-konfiguráció
Nincs végigkattintandó adminisztrációs felület. Minden beállítás egy JSON kulcs, így egy ügynök böngésző nélkül is létrehozhatja a könyvtár vázát.
Kiszámítható felépítés
Minden blokk ugyanazt a konvenciót követi: block.json, egy sablon és opcionális stílusok. Elég egyszer megtanulni a mintát.
Kontextus, nem találgatás
A dokumentáció tömör indexe, valamint a teljes szöveg azoknak az eszközöknek, amelyek mindent igényelnek.
Egy index, amelyet először az ügynök olvas el
A blockstudio-llm.txt egyszer sorolja fel az összes dokumentumot, az útvonallal, a forrásfájllal, a céllal, valamint az általa kezelt beállításokkal, hookokkal, PHP-függvényekkel és CLI-parancsokkal együtt. Körülbelül 11k tokenből az ügynök végig tudja olvasni, majd csak a szükséges oldalt nyitja meg.
A blockstudio-llm-full.txt egyetlen fájlban tartalmaz minden dokumentumot és JSON sémát, körülbelül 169k token terjedelemben, azon eszközök számára, amelyek a teljes korpuszt igénylik. Kapcsold be a ai.enableContextGeneration-t, és a webhely mindkettőt kiszolgálja.
# Blockstudio documentation index
This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.
Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.Előírás a projektedhez
A dokumentáció a Blockstudio-t írja le. A AGENTS.md azt a projektet, amelyet az ügynök éppen módosítani készül.
Egy parancs létrehozza a AGENTS.md fájlt
A vendor/bin/blockstudio-agents leírja a projektet, amelyben fut: mit tartalmaz, mely funkciókat engedélyezi a blockstudio.json, mit utasít el az elemzés, és mely parancsok alkalmazhatók.
Minden sor a fájljaidból, beállításaidból vagy a kiválasztott elemzési előbeállításból származik. Az újragenerálás megőrzi a kézzel írt megjegyzéseket, és a --check hibát jelez, ha az előírás elavult.
# Blockstudio contract for Acme
## Project
- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.
## What this project contains
- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.# Write or refresh the contract
vendor/bin/blockstudio-agents
# Fail CI when it no longer matches the project
vendor/bin/blockstudio-agents --checkA hibák felismerése commit előtt
Négy elemzési előbeállítás, mindegyik az előző bővítése, valamint egy hook, amely minden commitnál lefuttatja őket.
Az elemzés ismeri a block.json-t
A blockstudio/phpstan előbeállításai beolvassák a blokkokat, oldalakat és beállításokat. Az elemzés hibát jelez, ha egy sablon olyan mezőt olvas, amelyet az block.json nem deklarált, vagy escape nélkül írja ki.
A sablonok a mellettük lévő block.json fájlból beolvasott, $a típusú adatot kapnak; minden mezőtípushoz konkrét PHP-típus tartozik, a Db::get() pedig a db.php által formázott rekordokat adja vissza. Az elírt beállítási útvonal vagy hooknév hibát okoz, és felajánlja a hozzá legközelebb álló valós nevet.
Állítsd be a githooks.commit-t, és futtasd a vendor/bin/blockstudio-githooks sync-t: a kezelt pre-commit hook ugyanazt az elemzést végzi, így hibás blokk nem kerül commitba.
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"phpstan": { "preset": "extreme-theme" },
"githooks": { "commit": true }
}$ vendor/bin/blockstudio-githooks sync
$ vendor/bin/blockstudio-phpstan -- --no-progress
Line blockstudio/hero/index.php
3 Dynamic Blockstudio attributes must be escaped before output.
blockstudio.output.unescaped
3 Field "subtitle" does not exist in block.json (block: acme/hero).
blockstudio.fieldbase
Minden, a sablon által olvasott $a kulcs megtalálható a block.json fájlban; a hookok, beállítási útvonalak és blokkcímkék valósak.
theme
Témák fejlécei, deklarált eszközök, %selector% hatókör, alapértelmezett mezőértékek és ismétlőelemek korlátai.
extreme-theme
Legfeljebb PHPStan, escape-elt kimenet, külső parancsok futtatása nélkül, érvényes Tailwind osztályok és tiszta JavaScript.
wordpress-render
Extreme téma és az Ön által megadott, élő WordPress renderelési próba. Shell nélkül fut, a sikertelen renderelés pedig hibajelzést eredményez.
Twig, Blade és szkriptek
A Twig, a Blade és a blokkcímkék ugyanazokkal a mezőkkel szemben kerülnek ellenőrzésre. Az extreme réteg a JavaScript elemet és az Interactivity direktívákat is összeveti a jelölőnyelvvel és a tárolókkal.
Meglévő projektek
A PHPStan alapállapot megőrzi a rögzített hibajelzéseket, miközben az új kód megfelel a teljes előre beállított konfigurációnak. A blockstudioScanRoots a gyökérkönyvtáron kívüli blokkkönyvtárakat is beolvassa, a mellékelt csonkok pedig típusozzák a nyilvános API elemet.
Leltár és megjelenítés innen: PHP
Néhány hívással az ügynök megtekintheti, mit regisztrál egy projekt, megjelenítheti annak bármely részét, és ellenőrizheti, mit tárolt.
Kérdezd meg a projektet, jelenítsd meg a választ
A Canvas::inventory() megjelenítés nélkül visszaad minden regisztrált oldalt, blokkot, mintát, Site Editor-sablont, sablonrészt és UI-példát.
A Render::document() bármelyiket teljes HTML dokumentumként jeleníti meg, pontosan a felhasznált eszközökkel együtt, így az ügynök a szerkesztőn kívül is ellenőrizheti a munkáját.
A Canvas::documents() pontosan az Ön által kiválasztott rekordokat rendereli. A Render::composition() és a Render::content() beágyazott deklarációkat vagy szerializált blokktartalmat ad vissza HTML formájában, a Ui::inventory() és a Ui::examples() pedig felsorolja a mellékelt komponenscsaládokat, mindegyikhez egy renderelhető deklarációval.
Egyetlen blokk esetén a bs_block_fields(), a bs_block_extension_fields(), a bs_block_values() és a bs_block_assets() renderelés nélkül adja vissza a mezőket, értékeket és eszközöket, a bs_validate_block() pedig ellenőrzi a tárolt attribútumokat mentés előtt.
use Blockstudio\Canvas;
use Blockstudio\Render;
$project = Canvas::inventory(['blocks' => true]);
foreach ($project['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
$doc = Render::document(
['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
['title' => 'Hero preview']
);
file_put_contents('hero.html', $doc['html']);$fields = bs_block_fields('acme/card');
$extended = bs_block_extension_fields('core/paragraph');
$assets = bs_block_assets('acme/card');
$block = parse_blocks($post->post_content)[0];
$a = bs_block_values($block['blockName'], $block['attrs']);
$findings = bs_validate_block($block['blockName'], $block['attrs']);$ wp bs blocks render
$ wp bs blocks render acme/card --attributes='{"variant":"wide"}'
$ wp bs blocks validate 42 57 --format=jsonOldalanként kevesebb mint feleannyi token
Az ügynökök egyszerű HTML-t írnak. Szinkronizáláskor a Blockstudio szerializált WordPress blokkjelöléssé alakítja: kevesebbet kell generálni és elrontani.
Blockstudio
Amit az ügynökök írnak
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<block name="core/columns">
<block name="core/column">
<h3>Lightning Fast</h3>
<p>Pages load in under one second.</p>
</block>
<block name="core/column">
<h3>Easy to Use</h3>
<p>No technical skills required.</p>
</block>
<block name="core/column">
<h3>SEO Optimized</h3>
<p>Built-in best practices from day one.</p>
</block>
</block>
<img src="/dashboard.jpg" alt="Dashboard" />WordPress
Amit a parser ír hozzá
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
<!-- wp:column -->
<div class="wp-block-column">
<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">Lightning Fast</h3>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>Pages load in under one second.</p>
<!-- /wp:paragraph -->
</div>
<!-- /wp:column -->
<!-- wp:column -->
<div class="wp-block-column">
<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">Easy to Use</h3>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>No technical skills required.</p>
<!-- /wp:paragraph -->
</div>
<!-- /wp:column -->
<!-- wp:column -->
<div class="wp-block-column">
<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">SEO Optimized</h3>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>Built-in best practices from day one.</p>
<!-- /wp:paragraph -->
</div>
<!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->A fenti két panel alapján mérve: a HTML 540 karaktere osztva néggyel, ami a karakter/token szokásos becsült aránya, szemben a blokkjelölés 1,233 karakterével, amelyet a kész parser ír hozzá. A jelölés olvashatósági okokból sortörésekkel jelenik meg.
Kevesebb generálandó kimenet
Az ügynökök HTML-t írnak blokkhatárolók, generált osztályok és burkoló jelölés nélkül.
Kevesebb hibalehetőség
Az egyszerűbb bemenetből az elemző érvényes blokk-kimenetet állít elő.
Gyorsabb és olcsóbb
A kevesebb kimeneti token gyorsabb válaszokat és alacsonyabb modellköltséget jelent.
Minden AI-kódoló eszközzel működik
Bármely fájlokat olvasni és írni képes ügynök azonnal használhatja a Blockstudio-t.
Az AI-munkafolyamatra készült
Blokkok, oldalak, minták, beállítások. Minden fájl, amelyet egy ügynök elolvashat, megírhat és módosíthat.
Blokkonként két fájl
Egy JSON konfiguráció és egy sablon alkotja a teljes blokkot. A kis felület megbízhatóvá teszi az első generálást.
27 mezőtípus
Szöveg, fájlok, ismétlők, színek, dátumok és más típusok, JSON-ban definiálva. A kiválasztólisták bejegyzésekből, kifejezésekből és felhasználókból töltődnek fel.
JSON sémavalidálás
Minden konfigurációhoz tartozik séma, amely pontos szabályokat ad az ügynököknek, és azonnal felismeri a hibákat.
Automatikus regisztráció
Helyezd a fájlokat egy könyvtárba, és a blokkok automatikusan regisztrálódnak, külön konfigurációs lista nélkül.
Vászonáttekintés
Minden kezelt oldal, vagy az alapértelmezett értékekkel rendelkező blokkok egyetlen nagyítható nézetben.
Élő vászon
Az élő mód a mentés után körülbelül egy másodperccel frissíti az érintett rajztáblákat Server-Sent Events használatával. Kattintson egy címkére az adott rajztábla fókuszálásához.
Tailwind beépítve
A TailwindPHP összeállítja az egyes oldalakon használt osztályokat, Node.js-konfiguráció nélkül.
Element Grabber
Másold ki egy elem sablonjának útvonalát és jelölését, hogy az ügynök azonnal megkapja a szükséges kontextust.
HTML blokkokká
Az oldalak és minták egyszerű fájlok, amelyek natív WordPress blokkokká válnak.
Renderelési füstteszt
A wp bs blocks render minden blokkot úgy renderel, ahogyan egy oldal tenné, és 1-es kilépési kóddal áll le, ha egy sablon értesítést, figyelmeztetést vagy hibát vált ki.
Tárolt tartalom ellenőrzései
A wp bs blocks validate ellenőrzi a bejegyzések mentett mezőit, az oldalak sync pedig figyelmeztet azokra az attribútumokra, amelyeket egy blokk tárol, de soha nem renderel.
Vizsgálat a terminálból
Listázza a beállításokat, az egyéni mezőket és az eszközöket a wp bs használatával, és fordítson le egy kódrészletet vagy fájlt a wp bs tailwind compile vagy a wp bs scss compile paranccsal.
A hivatalos bővítőkészlet
Prémium webhelysablonok, MI-rendszerutasítások és privát Discord közösség. Egyszeri vásárlás, élethosszig tartó frissítések.
- 500+ webhelysablon
- AI-rendszerutasítások
- Élettartamra szóló frissítések
- Privát Discord közösség