Dezvoltarea blocurilor nativă pentru AI
Fișiere și fără pas de compilare, exact ceea ce agenții fac bine.
Descrieți un bloc, obțineți un bloc
Agenții de programare AI pot crea structura blocurilor, paginilor și tiparelor pornind de la un singur prompt. Fără interfață grafică și fără bază de date, doar fișiere.
~/starter-theme
❯ Creează un bloc de prețuri cu trei niveluri, o comutare lunar/anual și un îndemn la acțiune pentru fiecare nivel.
✓ Creat pricing/block.json
✓ Creat pricing/index.php
✓ Creat pricing/style.css
❯ Acum creează o pagină de prețuri cu o secțiune principală și una de întrebări frecvente.
✓ Creat pages/pricing/page.json
✓ Creat pages/pricing/index.php
Fișiere
blockstudio/
├── pricing/ Nou
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nou
├── page.json
└── index.php
Totul bazat pe fișiere
Blocurile, paginile, tiparele și extensiile sunt directoare cu configurare și șabloane JSON. Agenții le citesc și le scriu nativ.
Fără configurare în baza de date
Fără panouri de administrare prin care să navigați. Fiecare setare este o cheie JSON, astfel încât un agent poate crea biblioteca fără browser.
Structură previzibilă
Fiecare bloc urmează aceeași convenție: block.json, un șablon și stiluri opționale. Învățați tiparul o singură dată.
Context, fără presupuneri
Un index compact al documentației, plus textul integral pentru instrumentele care au nevoie de tot conținutul.
Un index pe care agentul îl citește mai întâi
blockstudio-llm.txt listează fiecare document o singură dată, cu ruta, fișierul sursă, scopul și setările, hook-urile, funcțiile PHP și comenzile CLI pe care le gestionează. La aproximativ 11k tokenuri, un agent îl citește integral, apoi deschide doar pagina de care are nevoie.
blockstudio-llm-full.txt include toate documentele și schemele JSON într-un singur fișier de aproximativ 169k tokenuri, pentru instrumentele care au nevoie de întregul corpus. Activați ai.enableContextGeneration, iar site-ul le va oferi pe ambele.
# 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.Un contract pentru proiectul dumneavoastră
Documentația descrie Blockstudio. AGENTS.md descrie proiectul pe care agentul urmează să-l modifice.
O comandă scrie AGENTS.md
vendor/bin/blockstudio-agents descrie proiectul în care rulează: ce conține, ce funcționalități activează blockstudio.json, ce va respinge analiza și ce comenzi se aplică.
Fiecare linie provine din fișierele, setările sau presetarea de analiză selectată. Regenerarea păstrează notițele scrise manual, iar --check eșuează când contractul este învechit.
# 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 --checkGreșeli detectate înainte de commit
Patru presetări de analiză, fiecare incluzând-o pe cea precedentă, și un hook care le rulează la fiecare commit.
Analiză care înțelege block.json
Presetările blockstudio/phpstan analizează blocurile, paginile și setările. Dacă un șablon citește un câmp pe care block.json nu l-a declarat sau îl afișează fără escapare, analiza eșuează.
Șabloanele citesc un $a tipizat din block.json aflat lângă ele, cu un tip concret PHP pentru fiecare tip de câmp, iar Db::get() returnează înregistrări structurate conform db.php. O cale de setări sau un nume de hook scris greșit produce o eroare și sugerează cel mai apropiat nume valid.
Setați githooks.commit și rulați vendor/bin/blockstudio-githooks sync: hook-ul de pre-commit gestionat rulează aceeași analiză, astfel încât un bloc defect nu ajunge niciodată într-un commit.
{
"$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
Fiecare cheie $a citită de un șablon există în block.json; hook-urile, căile setărilor și etichetele blocurilor sunt reale.
theme
Antete de temă, resurse declarate, delimitare %selector%, valori implicite pentru câmpuri și limite pentru câmpuri repetabile.
extreme-theme
Limită PHPStan, ieșire escapata, fără apeluri externe, clase Tailwind valide și JavaScript curate.
wordpress-render
O temă Extreme și o sondă de randare WordPress activă, furnizată de dumneavoastră. Rulează fără shell, iar un eșec la randare devine o constatare.
Twig, Blade și scripturi
Twig, Blade și etichetele blocurilor sunt verificate în raport cu aceleași câmpuri. Stratul Extreme citește și JavaScript și directivele Interactivity în raport cu marcajul și stocările dumneavoastră.
Proiecte existente
O bază PHPStan reține constatările înregistrate, în timp ce codul nou respectă presetarea completă. blockstudioScanRoots citește biblioteci de blocuri din afara rădăcinii, iar stub-urile incluse tipizează API public.
Inventar și randare din PHP
Cu câteva apeluri, un agent poate vedea ce înregistrează un proiect, poate randa orice parte a acestuia și poate verifica ce a stocat.
Întrebați proiectul, redați răspunsul
Canvas::inventory() returnează fiecare pagină, bloc, tipar, șablon Site Editor, parte de șablon și exemplu UI înregistrat de proiect, fără să redea nimic.
Render::document() redă oricare dintre ele ca document HTML complet, împreună cu resursele folosite, astfel încât un agent să-și poată verifica munca în afara editorului.
Canvas::documents() randează exact înregistrările selectate. Render::composition() și Render::content() returnează declarații imbricate sau conținut de bloc serializat ca HTML, iar Ui::inventory() și Ui::examples() listează familiile de componente incluse, fiecare cu câte o declarație randabilă.
Pentru un singur bloc, bs_block_fields(), bs_block_extension_fields(), bs_block_values() și bs_block_assets() returnează câmpurile, valorile și resursele sale fără a-l randa, iar bs_validate_block() verifică atributele stocate înainte să le salvați.
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=jsonMai puțin de jumătate din tokenuri per pagină
Agenții scriu HTML simplu. La sincronizare, Blockstudio îl transformă în marcaj de blocuri WordPress serializat: mai puțin de generat și mai puține ocazii de a greși.
Blockstudio
Ce scriu agenții
<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
Ce scrie parserul pentru acesta
<!-- 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 -->Măsurat pe cele două panouri de mai sus: 540 caractere de HTML față de 1,233 caractere de marcaj de bloc pe care le scrie parserul standard, împărțite la patru, estimarea obișnuită a numărului de caractere per token. Marcajul este afișat cu întreruperi de rând adăugate pentru lizibilitate.
Mai puțin conținut de generat
Agenții scriu HTML fără delimitatori de blocuri, clase generate sau marcaj de încadrare.
Mai puține ocazii de a greși
Parserul garantează un rezultat valid pentru blocuri pornind de la o intrare mai simplă.
Mai rapid și mai ieftin
Mai puține tokenuri în rezultat înseamnă răspunsuri mai rapide și costuri mai mici pentru model.
Funcționează cu orice instrument AI de programare
Orice agent care poate citi și scrie fișiere funcționează cu Blockstudio imediat.
Creat pentru fluxul de lucru AI
Blocuri, pagini, tipare, setări. Totul este un fișier pe care un agent îl poate citi, scrie și modifica.
Două fișiere per bloc
O configurare JSON și un șablon alcătuiesc întregul bloc. Suprafața restrânsă face generarea din prima încercare fiabilă.
27 tipuri de câmpuri
Text, fișiere, câmpuri repetabile, culori, date și altele, definite în JSON. Listele de selecție se populează din articole, termeni și utilizatori.
Validarea schemei JSON
Fiecare configurare are o schemă, care oferă agenților reguli exacte și detectează imediat greșelile.
Înregistrare automată
Adăugați fișiere într-un director, iar blocurile se înregistrează automat, fără o altă listă de configurare.
Vedere generală a pânzei
Fiecare pagină gestionată sau fiecare bloc cu valorile implicite, într-o singură vizualizare cu zoom.
Pânză live
Modul live actualizează planșele grafice afectate prin Server-Sent Events la aproximativ o secundă după salvare. Faceți clic pe o etichetă pentru a focaliza o planșă grafică.
Tailwind integrat
TailwindPHP compilează clasele folosite de fiecare pagină, fără configurare Node.
Element Grabber
Copiați calea șablonului și marcajul unui element pentru a oferi instantaneu context unui agent.
HTML pentru blocuri
Paginile și tiparele sunt fișiere obișnuite care devin blocuri WordPress native.
Test rapid de randare
wp bs blocks render randează fiecare bloc așa cum ar face-o o pagină și se închide cu 1 când un șablon generează o notificare, un avertisment sau o eroare.
Verificări ale conținutului stocat
wp bs blocks validate verifică câmpurile salvate ale articolelor, iar pages sync avertizează cu privire la atributele stocate de un bloc, dar niciodată randate.
Inspectați din terminal
Listați setările, câmpurile personalizate și resursele cu wp bs și compilați un fragment sau un fișier cu wp bs tailwind compile ori wp bs scss compile.
Kitul oficial de extensii
Șabloane premium de site, instrucțiuni de sistem pentru AI și o comunitate privată Discord. Achiziție unică, actualizări pe viață.
- 500+ șabloane de site
- Instrucțiuni de sistem pentru IA
- Actualizări pe viață
- Comunitate privată Discord