Vývoj bloků nativní pro AI
Soubory a žádný krok sestavení – přesně to agentům vyhovuje.
Popište blok, získejte blok
Kódovací agenti s umělou inteligencí mohou z jediného zadání připravit kostru bloků, stránek a vzorů. Bez grafického rozhraní a databáze, jen soubory.
~/starter-theme
❯ Vytvořte cenový blok se třemi tarify, přepínačem měsíční/roční platby a výzvou k akci pro každý tarif.
✓ Vytvořeno pricing/block.json
✓ Vytvořeno pricing/index.php
✓ Vytvořeno pricing/style.css
❯ Teď vytvořte stránku s cenami, úvodní sekcí a sekcí FAQ.
✓ Vytvořeno pages/pricing/page.json
✓ Vytvořeno pages/pricing/index.php
Soubory
blockstudio/
├── pricing/ Nové
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nové
├── page.json
└── index.php
Všechno založené na souborech
Bloky, stránky, vzory a rozšíření jsou adresáře s konfigurací JSON a šablonami. Agenti je přirozeně čtou a upravují.
Bez konfigurace databáze
Žádné proklikávání administračních panelů. Každé nastavení je klíč JSON, takže agent může připravit knihovnu bez prohlížeče.
Předvídatelná struktura
Každý blok se řídí stejnou konvencí: block.json, šablona a volitelné styly. Naučte se tento vzor jednou.
Kontext místo odhadů
Stručný index dokumentace a celý text pro nástroje, které jej potřebují kompletní.
Index, který agent přečte jako první
blockstudio-llm.txt uvádí každý dokument jednou, včetně jeho trasy, zdrojového souboru, účelu a nastavení, hooků, funkcí PHP a příkazů CLI, které spravuje. Při velikosti asi 11k tokenů jej agent přečte celý a pak otevře jen potřebnou stránku.
blockstudio-llm-full.txt obsahuje každý dokument a schéma JSON v jednom souboru o velikosti asi 169k tokenů pro nástroje, které potřebují celý korpus. Zapněte ai.enableContextGeneration a váš web bude poskytovat obojí.
# 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.Smlouva pro váš projekt
Dokumentace popisuje Blockstudio. AGENTS.md popisuje projekt, který se agent chystá změnit.
Jeden příkaz vytvoří AGENTS.md
vendor/bin/blockstudio-agents popisuje projekt, ve kterém běží: jeho obsah, funkce, které blockstudio.json povoluje, co analýza odmítne a příslušné příkazy.
Každý řádek vychází z vašich souborů, nastavení nebo zvolené předvolby analýzy. Opětovné vygenerování zachová ručně napsané poznámky a --check selže, pokud je smlouva zastaralá.
# 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 zachycené před potvrzením
Čtyři předvolby analýzy, z nichž každá zahrnuje předchozí, a hook, který je spustí při každém commitu.
Analýza, která zná block.json
Předvolby blockstudio/phpstan čtou vaše bloky, stránky a nastavení. Analýza selže, pokud šablona čte pole, které její block.json nedeklarovalo, nebo jej vypíše bez escapování.
Šablony čtou typovaný $a načtený z přilehlého block.json, s konkrétním typem PHP pro každý typ pole, a Db::get() vrací záznamy odpovídající struktuře db.php. Při překlepu v cestě k nastavení nebo názvu hooku se zobrazí návrh nejbližšího existujícího názvu.
Nastavte githooks.commit a spusťte vendor/bin/blockstudio-githooks sync: spravovaný hook před potvrzením spustí stejnou analýzu, takže se chybný blok 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ý klíč $a, který šablona čte, existuje v block.json; hooky, cesty nastavení a značky bloků jsou skutečné.
theme
Hlavičky šablon, deklarované prostředky, rozsah %selector%, výchozí hodnoty polí a limity opakovačů.
extreme-theme
Maximum PHPStan, escapovaný výstup, žádné spouštění shellu, platné třídy Tailwind a čisté JavaScript.
wordpress-render
Šablona Extreme a živá renderovací sonda WordPress, kterou dodáte. Spouští se bez shellu a neúspěšné vykreslení se zaznamená jako nález.
Twig, Blade a skripty
Twig, Blade i značky bloků se kontrolují podle stejných polí. Vrstva Extreme také porovnává JavaScript a direktivy Interactivity s vaším značkováním a úložišti.
Stávající projekty
Základní konfigurace PHPStan potlačí dříve zaznamenané nálezy, zatímco nový kód musí splňovat celý profil. blockstudioScanRoots načítá knihovny bloků mimo kořenovou složku a přibalené definice typů pokrývají veřejné API.
Inventář a vykreslování z PHP
Několik volání umožní agentovi zjistit, co projekt registruje, vykreslit libovolnou jeho část a zkontrolovat, co uložil.
Zeptejte se na projekt, vykreslete odpověď
Canvas::inventory() vrací každou stránku, blok, vzor, šablonu editoru webu, část šablony a příklad UI registrovaný projektem, aniž by cokoli vykreslovalo.
Render::document() vykreslí kteroukoli z nich jako kompletní dokument HTML s přesně těmi prostředky, které použil, takže agent může zkontrolovat svou práci mimo editor.
Canvas::documents() vykreslí přesně ty záznamy, které vyberete. Render::composition() a Render::content() vracejí vnořené deklarace nebo serializovaný obsah bloku jako HTML a Ui::inventory() a Ui::examples() vypisují rodiny přibalených komponent, každou s jednou deklarací připravenou k vykreslení.
Pro jeden blok vracejí bs_block_fields(), bs_block_extension_fields(), bs_block_values() a bs_block_assets() jeho pole, hodnoty a assety, aniž by jej vykreslily; bs_validate_block() kontroluje uložené atributy před jejich 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=jsonMéně než polovina tokenů na stránku
Agenti píší prosté HTML. Blockstudio je při synchronizaci převede na serializované značky bloků WordPress: méně kódu ke generování a méně prostoru pro chyby.
Blockstudio
Co 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
Co pro něj zapisuje parser
<!-- 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ěřeno na dvou panelech výše: 540 znaků HTML oproti 1,233 znakům značek bloku, které pro něj zapisuje standardní parser; výsledek se dělí čtyřmi, což je obvyklý odhad počtu znaků na token. Značky jsou zobrazené s přidanými zalomeními řádků pro lepší čitelnost.
Méně výstupu ke generování
Agenti píší HTML bez oddělovačů bloků, generovaných tříd a obalových značek.
Méně prostoru pro chyby
Parser z jednoduššího vstupu zaručí platný výstup bloku.
Rychlejší a levnější
Méně výstupních tokenů znamená rychlejší odpovědi a nižší náklady na model.
Funguje s každým nástrojem AI pro programování
Každý agent, který umí číst a zapisovat soubory, funguje s Blockstudio ihned po instalaci.
Navrženo pro pracovní postupy s AI
Bloky, stránky, vzory, nastavení. Všechno je soubor, který agent může číst, zapisovat a upravovat.
Dva soubory na blok
Konfigurace JSON a šablona tvoří celý blok. Malý rozsah zajišťuje spolehlivé generování napoprvé.
27 typů polí
Text, soubory, opakovače, barvy, data a další položky definované v JSON. Výběrová pole čerpají možnosti z příspěvků, termínů a uživatelů.
Ověřování schématu JSON
Každá konfigurace má schéma, které agentům poskytuje přesná pravidla a okamžitě zachytí chyby.
Automatická registrace
Vložte soubory do adresáře a bloky se zaregistrují automaticky bez dalšího seznamu konfigurace.
Přehled plátna
Všechny spravované stránky, případně všechny bloky včetně jejich výchozích hodnot, v jednom zobrazení s možností přibližování.
Živé plátno
Živý režim obnoví dotčená kreslicí plátna prostřednictvím Server-Sent Events zhruba sekundu po uložení. Kliknutím na popisek zaměříte jedno kreslicí plátno.
Vestavěné Tailwind
TailwindPHP kompiluje třídy použité na každé stránce bez konfigurace Node.
Element Grabber
Zkopírujte cestu k šabloně a značky prvku jako okamžitý kontext pro agenta.
HTML na bloky
Stránky a vzory jsou obyčejné soubory, které se mění v nativní bloky WordPress.
Testovací vykreslení
wp bs blocks render vykreslí každý blok stejně jako stránka a skončí s kódem 1, pokud šablona vyvolá oznámení, varování nebo chybu.
Kontroly uloženého obsahu
wp bs blocks validate kontroluje uložená pole příspěvků a stránek; sync upozorní na atributy, které blok ukládá, ale nikdy nevykreslí.
Kontrola z terminálu
Vypište nastavení, vlastní pole a assety pomocí wp bs a zkompilujte úryvek nebo soubor příkazem wp bs tailwind compile či wp bs scss compile.
Oficiální sada rozšíření
Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.
- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord