DI pritaikytas blokų kūrimas
Failai ir jokių kūrimo etapų – agentams tai puikiai tinka.
Apibūdinkite bloką, gaukite bloką
DI programavimo agentai pagal vieną užklausą gali sukurti pradinius blokų, puslapių ir šablonų variantus. Jokios grafinės sąsajos ar duomenų bazės – tik failai.
~/starter-theme
❯ Sukurkite kainodaros bloką su trimis planais, mėnesio ir metų pasirinkimo jungikliu bei raginimu veikti kiekvienam planui.
✓ Sukurta pricing/block.json
✓ Sukurta pricing/index.php
✓ Sukurta pricing/style.css
❯ Dabar sukurkite kainodaros puslapį su pagrindiniu skyriumi ir DUK skiltimi.
✓ Sukurta pages/pricing/page.json
✓ Sukurta pages/pricing/index.php
Failai
blockstudio/
├── pricing/ Naujas
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Naujas
├── page.json
└── index.php
Viskas paremta failais
Blokai, puslapiai, šablonai ir plėtiniai yra katalogai su JSON konfigūracija ir šablonais. Agentai juos skaito ir rašo tiesiogiai.
Jokios duomenų bazės konfigūracijos
Nereikia naršyti administravimo skydeliuose. Kiekvienas nustatymas yra JSON raktas, todėl agentas gali paruošti biblioteką be naršyklės.
Nuspėjama struktūra
Visi blokai kuriami pagal tą pačią tvarką: block.json, šablonas ir pasirenkami stiliai. Šį šabloną išmokite vieną kartą.
Kontekstas, ne spėlionės
Glausta dokumentacijos rodyklė ir visas tekstas įrankiams, kuriems reikia visko.
Rodyklė, kurią agentas perskaito pirmiausia
blockstudio-llm.txt pateikia kiekvieną dokumentą po vieną: jo maršrutą, šaltinio failą, paskirtį, nustatymus, kablius, PHP funkcijas ir jam priklausančias CLI komandas. Maždaug 11k žetonų apimties rodyklę agentas perskaito visą, o tada atveria tik reikiamą puslapį.
blockstudio-llm-full.txt viename faile pateikia visus dokumentus ir visas JSON schemas; apimtis – apie 169k žetonų. Tai skirta įrankiams, kuriems reikia viso turinio. Įjunkite ai.enableContextGeneration, ir jūsų svetainė pateiks abu failus.
# 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.Sutartis jūsų projektui
Dokumentacijoje aprašyta Blockstudio. AGENTS.md aprašo projektą, kurį agentas ketina keisti.
Viena komanda sukuria AGENTS.md
vendor/bin/blockstudio-agents aprašo projektą, kuriame veikia: jo turinį, funkcijas, kurias įjungia blockstudio.json, analizės atmetamas problemas ir taikomas komandas.
Kiekviena eilutė paimta iš jūsų failų, nustatymų arba pasirinkto analizės išankstinio nustatymo. Generuojant iš naujo išsaugomi jūsų ranka parašyti užrašai, o --check neveikia, jei sutartis pasenusi.
# 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 --checkKlaidos aptinkamos prieš įrašymą
Keturi analizės išankstinių nuostatų rinkiniai, kurių kiekvienas apima ankstesnį, ir kabliukas, kuris juos paleidžia per kiekvieną patvirtinimą.
Analizė, išmananti block.json
blockstudio/phpstan išankstiniai nustatymai nuskaito jūsų blokus, puslapius ir nustatymus. Jei šablonas skaito lauką, kurio jo block.json nedeklaravo, arba išveda jį neekranuotą, analizė nepavyksta.
Šablonai nuskaito tipizuotą $a iš šalia esančio block.json; kiekvienam lauko tipui priskirtas konkretus PHP tipas, o Db::get() grąžina pagal db.php suformuotus įrašus. Klaidingai parašius nustatymų kelią ar kablio pavadinimą, pateikiamas artimiausio tikro pavadinimo pasiūlymas.
Nustatykite githooks.commit ir paleiskite vendor/bin/blockstudio-githooks sync: valdoma kablio programa prieš įrašymą paleidžia tą pačią analizę, todėl sugadintas blokas nepatenka į įrašą.
{
"$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
Kiekvienas šablono skaitomas $a raktas yra block.json; kabliai, nustatymų keliai ir blokų žymos yra tikri.
theme
Temų antraštės, deklaruoti ištekliai, %selector% aprėptis, numatytosios laukų reikšmės ir kartotuvo ribos.
extreme-theme
PHPStan maksimumas, ekranuota išvestis, be išorinių komandų, tinkamos Tailwind klasės ir švarus JavaScript.
wordpress-render
Extreme tema ir jūsų pateiktas tiesioginis WordPress atvaizdavimo zondas. Jis veikia be komandų eilutės, o nesėkmingas atvaizdavimas užregistruojamas kaip problema.
Twig, Blade ir scenarijai
Twig, Blade ir blokų žymos tikrinamos pagal tuos pačius laukus. Extreme sluoksnis taip pat tikrina JavaScript ir interaktyvumo direktyvas pagal jūsų žymėjimą bei saugyklas.
Esami projektai
PHPStan bazinis rinkinys leidžia laikinai nepaisyti užregistruotų problemų, kol naujas kodas atitinka visus išankstinius reikalavimus. blockstudioScanRoots nuskaito blokų bibliotekas už šakninio katalogo ribų, o pateikiami aprašai apibrėžia viešąjį API.
Inventorizacija ir atvaizdavimas iš PHP
Kelios užklausos leidžia agentui matyti, ką projektas registruoja, atvaizduoti bet kurią jo dalį ir patikrinti, ką jis išsaugojo.
Paklauskite projekto, atvaizduokite atsakymą
Canvas::inventory() pateikia kiekvieną projekte užregistruotą puslapį, bloką, šabloną, Site Editor šabloną, šablono dalį ir UI pavyzdį nieko neatvaizduodama.
Render::document() bet kurį iš jų atvaizduoja kaip visą HTML dokumentą su tiksliai tais ištekliais, kuriuos jis naudojo, kad agentas galėtų patikrinti darbą ne redaktoriuje.
Canvas::documents() atvaizduoja tiksliai jūsų pasirinktus įrašus. Render::composition() ir Render::content() grąžina įdėtus aprašus arba nuosekliai išsaugotą blokų turinį kaip HTML, o Ui::inventory() ir Ui::examples() pateikia pridedamų komponentų grupių sąrašus, kurių kiekvienoje yra po vieną atvaizduojamą aprašą.
Vienam blokui bs_block_fields(), bs_block_extension_fields(), bs_block_values() ir bs_block_assets() pateikia jo laukus, reikšmes ir išteklius jo neatvaizduodami, o bs_validate_block() prieš išsaugant patikrina išsaugotus atributus.
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=jsonMažiau nei perpus mažiau žetonų vienam puslapiui
Agentai rašo paprastą HTML. Sinchronizuojant Blockstudio paverčia jį serijine WordPress blokų žyma: mažiau reikia sugeneruoti ir mažiau galimybių suklysti.
Blockstudio
Ką sukuria agentai
<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
Ką analizatorius sukuria šiam blokui
<!-- 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 -->Išmatuota pagal du aukščiau pateiktus skydus: 540 HTML simbolių, palyginti su 1,233 simbolių bloko žymėjimu, kurį jam sukuria standartinis analizatorius; šis skaičius padalytas iš keturių – įprasto simbolių skaičiaus žetone įverčio. Žymėjimas rodomas su skaitymui pridėtais eilučių lūžiais.
Mažiau išvesties generavimo
Agentai rašo HTML be blokų skirtukų, sugeneruotų klasių ar apgaubiančio žymėjimo.
Mažiau galimybių suklysti
Analizatorius iš paprastesnės įvesties garantuoja taisyklingą blokų išvestį.
Greitesnis ir pigesnis
Mažiau išvesties žetonų reiškia greitesnius atsakymus ir mažesnes modelio naudojimo išlaidas.
Veikia su visais DI kodavimo įrankiais
Bet kuris agentas, galintis skaityti ir rašyti failus, iškart veikia su Blockstudio.
Sukurta DI darbo eigai
Blokai, puslapiai, šablonai, nustatymai. Viskas yra failas, kurį agentas gali skaityti, rašyti ir keisti.
Du failai kiekvienam blokui
Visą bloką sudaro JSON konfigūracija ir šablonas. Nedidelė apimtis užtikrina patikimą generavimą iš pirmo karto.
27 laukų tipų
Tekstas, failai, kartotuvai, spalvos, datos ir daugiau – apibrėžta JSON. Pasirinkimų sąrašai pildomi iš įrašų, terminų ir naudotojų.
JSON schemos tikrinimas
Kiekviena konfigūracija turi schemą, kuri pateikia agentams tikslias taisykles ir iškart aptinka klaidas.
Automatinė registracija
Įkelkite failus į katalogą, ir blokai bus užregistruoti automatiškai – papildomo konfigūracijos sąrašo nereikia.
Drobės apžvalga
Visi valdomi puslapiai arba visi blokai su numatytosiomis reikšmėmis viename keičiamo mastelio rodinyje.
Tiesioginė drobė
Įjungus tiesioginį režimą, pakeistos maketavimo sritys atnaujinamos per Server-Sent Events maždaug po sekundės nuo išsaugojimo. Spustelėkite etiketę, kad pasirinktumėte vieną maketavimo sritį.
Integruota Tailwind
TailwindPHP sukompiliuoja kiekvieno puslapio naudojamas klases be Node konfigūracijos.
Element Grabber
Nukopijuokite elemento šablono kelią ir žymėjimą, kad agentui iškart suteiktumėte kontekstą.
HTML į blokus
Puslapiai ir šablonai yra paprasti failai, tampantys vietiniais WordPress blokais.
Atvaizdavimo patikra
wp bs blocks render atvaizduoja kiekvieną bloką taip, kaip puslapyje, ir baigia darbą su kodu 1, jei šablonas pateikia pranešimą apie pastabą, įspėjimą ar klaidą.
Išsaugoto turinio patikros
wp bs blocks validate tikrina įrašų išsaugotus laukus, o pages sync įspėja apie atributus, kuriuos blokas išsaugo, bet niekada neatvaizduoja.
Tikrinkite iš terminalo
Pateikite nustatymų, pasirinktinių laukų ir išteklių sąrašą naudodami wp bs, o fragmentą ar failą sukompiliuokite naudodami wp bs tailwind compile arba wp bs scss compile.
Oficialus plėtinių rinkinys
Aukščiausios klasės svetainių šablonai, DI sistemos instrukcijos ir privati Discord bendruomenė. Vienkartinis pirkimas, atnaujinimai visam laikui.
- 500+ svetainių šablonų
- AI sistemos instrukcijos
- Naujiniai visam laikui
- Privati Discord bendruomenė