Vývoj blokov s natívnou podporou AI
Súbory a žiadny krok zostavenia, presne to, s čím si agenti vedia poradiť.
Opíšte blok a získajte blok
Programovacie agenti s AI dokážu z jedného zadania pripraviť základy blokov, stránok a vzorov. Bez grafického rozhrania a databázy, iba súbory.
~/starter-theme
❯ Vytvorte cenový blok s tromi úrovňami, prepínačom mesačného/ročného predplatného a výzvou na akciu pre každú úroveň.
✓ Vytvorené pricing/block.json
✓ Vytvorené pricing/index.php
✓ Vytvorené pricing/style.css
❯ Teraz vytvorte stránku s cenami, úvodnou sekciou a sekciou FAQ.
✓ Vytvorené pages/pricing/page.json
✓ Vytvorené pages/pricing/index.php
Súbory
blockstudio/
├── pricing/ Nové
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nové
├── page.json
└── index.php
Všetko založené na súboroch
Bloky, stránky, vzory a rozšírenia sú priečinky s konfiguráciou JSON a šablónami. Agenti ich dokážu priamo čítať aj upravovať.
Bez konfigurácie databázy
Žiadne administračné panely na preklikávanie. Každé nastavenie je kľúč JSON, takže agent môže pripraviť knižnicu bez prehliadača.
Predvídateľná štruktúra
Každý blok sa riadi rovnakou konvenciou: block.json, šablóna a prípadné štýly. Vzor sa naučíte raz.
Kontext namiesto hádania
Stručný index dokumentácie a celý text pre nástroje, ktoré potrebujú všetko.
Index, ktorý agent najprv prečíta
blockstudio-llm.txt uvádza každý dokument práve raz spolu s jeho trasou, zdrojovým súborom, účelom a nastaveniami, hookmi, funkciami PHP a príkazmi CLI, ktoré spravuje. Pri rozsahu približne 11k tokenov ho agent prečíta celý a potom otvorí iba potrebnú stránku.
blockstudio-llm-full.txt obsahuje všetky dokumenty aj schému JSON v jednom súbore s rozsahom približne 169k tokenov pre nástroje, ktoré potrebujú celý korpus. Zapnite ai.enableContextGeneration a váš web bude poskytovať oboje.
# 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.Zmluva pre váš projekt
Dokumentácia opisuje Blockstudio. AGENTS.md opisuje projekt, ktorý sa agent chystá zmeniť.
Jeden príkaz vytvorí AGENTS.md
vendor/bin/blockstudio-agents opisuje projekt, v ktorom sa spúšťa: čo obsahuje, ktoré funkcie povoľuje blockstudio.json, čo analýza odmietne a ktoré príkazy platia.
Každý riadok vychádza z vašich súborov, nastavení alebo vybranej analytickej predvoľby. Opätovné vytvorenie zachová ručne napísané poznámky a --check zlyhá, keď sú zmluvné podmienky zastarané.
# 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 --checkChyby odhalené pred potvrdením zmien
Štyri predvoľby analýzy, pričom každá zahŕňa predchádzajúcu, a hák, ktorý ich spúšťa pri každom potvrdení zmien.
Analýza, ktorá pozná block.json
Predvoľby blockstudio/phpstan čítajú vaše bloky, stránky a nastavenia. Analýza zlyhá, ak šablóna načíta pole, ktoré jej block.json nikdy nedefinovala, alebo ho vypíše bez escapovania.
Šablóny načítavajú typovaný $a zo súboru block.json, ktorý sa nachádza vedľa nich, pričom každý typ poľa má konkrétny typ PHP, a Db::get() vracia záznamy v tvare určenom pomocou db.php. Nesprávne napísaná cesta k nastaveniu alebo názov hooku vyvolá chybu s návrhom najbližšieho platného názvu.
Nastavte githooks.commit a spustite vendor/bin/blockstudio-githooks sync: spravovaný hook pred potvrdením zmien spustí rovnakú analýzu, takže chybný blok sa nikdy nedostane do commitu.
{
"$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
Každý kľúč $a, ktorý šablóna používa, existuje v block.json; hooky, cesty nastavení a značky blokov sú skutočné.
theme
Hlavičky tém, deklarované zdroje, rozsah %selector%, predvolené hodnoty polí a limity opakovačov.
extreme-theme
Maximum PHPStan, escapovaný výstup, bez spúšťania príkazov shellu, platné triedy Tailwind a čisté JavaScript.
wordpress-render
Téma Extreme a živá renderovacia sonda WordPress, ktorú dodáte. Spúšťa sa bez shellu a neúspešné vykreslenie sa zaznamená ako nález.
Twig, Blade a skripty
Twig, Blade aj značky blokov sa kontrolujú podľa rovnakých polí. Vrstva Extreme kontroluje aj JavaScript a direktívy Interactivity voči vášmu značkovaniu a úložiskám.
Existujúce projekty
Východiskové nastavenie PHPStan potláča už zaznamenané nálezy, kým nový kód musí spĺňať celý predvolený profil. blockstudioScanRoots načítava knižnice blokov aj mimo koreňového adresára a pribalené stuby typujú verejné API.
Inventár a vykresľovanie z PHP
Niekoľko volaní umožní agentovi zistiť, čo projekt registruje, vykresliť ľubovoľnú jeho časť a skontrolovať, čo uložil.
Opýtajte sa projektu a vykreslite odpoveď
Canvas::inventory() vráti každú stránku, blok, vzor, šablónu editora webu, časť šablóny a príklad UI zaregistrovaný projektom bez vykreslenia čohokoľvek.
Render::document() vykreslí ľubovoľný z nich ako kompletný dokument HTML s presne tými zdrojmi, ktoré použil, takže agent môže skontrolovať svoju prácu mimo editora.
Canvas::documents() vykreslí presne tie záznamy, ktoré vyberiete. Render::composition() a Render::content() vracajú vnorené deklarácie alebo serializovaný obsah bloku ako HTML a Ui::inventory() aj Ui::examples() vypisujú rodiny pribalených komponentov, každú s jednou deklaráciou pripravenou na vykreslenie.
Pre jeden blok vracajú bs_block_fields(), bs_block_extension_fields(), bs_block_values() a bs_block_assets() jeho polia, hodnoty a prostriedky bez vykreslenia a bs_validate_block() kontroluje uložené atribúty pred ich uložením.
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=jsonMenej než polovica tokenov na stránku
Agenti píšu obyčajné HTML. Blockstudio pri synchronizácii prevedie text na serializované značky blokov WordPress: menej textu na vytvorenie a menej priestoru na chyby.
Blockstudio
Čo zapisujú agenti
<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
Čo zaň zapisuje analyzátor
<!-- 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 -->Meranie z dvoch panelov vyššie: 540 znakov v HTML oproti 1,233 znakom značiek bloku, ktoré zaň zapisuje štandardný analyzátor; výsledok sa delí štyrmi, čo je bežný odhad počtu znakov na token. Značky sú zobrazené s pridanými zalomeniami riadkov, aby sa dali ľahšie čítať.
Menej výstupu na vytvorenie
Agenti píšu HTML bez oddeľovačov blokov, generovaných tried či obalových značiek.
Menej priestoru na chyby
Parser zjednoduší vstup a zaručí platný výstup blokov.
Rýchlejšie a lacnejšie
Menej výstupných tokenov znamená rýchlejšie odpovede a nižšie náklady na model.
Funguje s každým nástrojom na programovanie s AI
Každý agent, ktorý dokáže čítať a zapisovať súbory, funguje s Blockstudio hneď po inštalácii.
Navrhnuté pre pracovné postupy s AI
Bloky, stránky, vzory, nastavenia. Všetko je súbor, ktorý agent dokáže čítať, zapisovať a upravovať.
Dva súbory na blok
Celý blok tvorí konfigurácia JSON a šablóna. Malý rozsah zjednodušuje spoľahlivé generovanie na prvý pokus.
27 typov polí
Text, súbory, opakovače, farby, dátumy a ďalšie, definované v JSON. Zoznamy možností sa napĺňajú z príspevkov, výrazov a používateľov.
Overovanie schémy JSON
Každá konfigurácia má schému s presnými pravidlami pre agentov, ktorá okamžite odhalí chyby.
Automatická registrácia
Vložte súbory do priečinka a bloky sa zaregistrujú automaticky bez ďalšieho konfiguračného zoznamu.
Prehľad na plátne
Každá spravovaná stránka alebo každý blok s predvolenými hodnotami v jednom zobrazení, ktoré možno približovať.
Živé plátno
Živý režim obnoví dotknuté kresliace plochy cez Server-Sent Events približne sekundu po uložení. Kliknutím na štítok zaostríte na jednu kresliacu plochu.
Súčasťou je Tailwind
TailwindPHP skompiluje triedy používané na každej stránke bez konfigurácie Node.
Element Grabber
Skopírujte cestu k šablóne a značky prvku ako okamžitý kontext pre agenta.
HTML do blokov
Stránky a vzory sú obyčajné súbory, ktoré sa menia na natívne bloky WordPress.
Testovacie vykreslenie
wp bs blocks render vykreslí každý blok tak, ako by sa zobrazil na stránke, a skončí s kódom 1, ak šablóna vyvolá oznámenie, varovanie alebo chybu.
Kontroly uloženého obsahu
wp bs blocks validate kontroluje uložené polia príspevkov a pages sync upozorní na atribúty, ktoré blok ukladá, no nikdy nevykresľuje.
Kontrola z terminálu
Vypíšte nastavenia, vlastné polia a prostriedky pomocou wp bs a skompilujte úryvok alebo súbor príkazom wp bs tailwind compile alebo wp bs scss compile.
Oficiálna súprava rozšírení
Prémiové šablóny webov, systémové pokyny pre AI a súkromná komunita Discord. Jednorazový nákup, aktualizácie na celý život.
- 500+ šablón stránok
- Systémové pokyny pre AI
- Doživotné aktualizácie
- Súkromná komunita Discord