Treci la conținut

Dezvoltarea blocurilor nativă pentru AI

Fișiere și fără pas de compilare, exact ceea ce agenții fac bine.

O înregistrare silențioasă a ecranului: un agent de programare construiește un site WordPress complet, cu 10 blocuri personalizate și 6 pagini, pornind de la un singur prompt.

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-llm.txt
# 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.

AGENTS.md
# 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.

Greș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.

blockstudio.json
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}

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.

inspect.php
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']);

Mai 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

Aproximativ 135 tokenuri
index.php
<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

Aproximativ 310 tokenuri
post_content
<!-- 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.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

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.

Plus

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