Preskočiť na obsah

Vývoj blokov s natívnou podporou AI

Súbory a žiadny krok zostavenia, presne to, s čím si agenti vedia poradiť.

Nahrávka obrazovky bez zvuku: programovací agent vytvorí kompletný web WordPress s 10 vlastnými blokmi a 6 stránkami na základe jediného zadania.

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

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é.

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.

Chyby 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.

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

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.

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

Menej 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

Približne 135 tokenov
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

Čo zaň zapisuje analyzátor

Približne 310 tokenov
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 -->

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.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

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.

Plus

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