# DI pritaikytas blokų kūrimas

Failai ir jokių kūrimo etapų – agentams tai puikiai tinka.

[Skaityti dokumentaciją](https://blockstudio.dev/lt/docs/dev/ai/)

Tylus ekrano įrašas: programavimo agentas pagal vieną užklausą sukuria visą WordPress svetainę su 10 tinkintų blokų ir 6 puslapiais.

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

[DI integravimo dokumentacija](https://blockstudio.dev/lt/docs/dev/ai/)

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

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

[Projekto sutartis](https://blockstudio.dev/lt/docs/dev/phpstan/#project-contract-for-coding-agents)

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

## Klaidos 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šą.

[Analizės išankstiniai nustatymai](https://blockstudio.dev/lt/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

## [base](https://blockstudio.dev/lt/docs/dev/phpstan/#analysis-presets)

Kiekvienas šablono skaitomas $a raktas yra block.json; kabliai, nustatymų keliai ir blokų žymos yra tikri.

## [theme](https://blockstudio.dev/lt/docs/dev/phpstan/#analysis-presets)

Temų antraštės, deklaruoti ištekliai, %selector% aprėptis, numatytosios laukų reikšmės ir kartotuvo ribos.

## [extreme-theme](https://blockstudio.dev/lt/docs/dev/phpstan/#analysis-presets)

PHPStan maksimumas, ekranuota išvestis, be išorinių komandų, tinkamos Tailwind klasės ir švarus JavaScript.

## [wordpress-render](https://blockstudio.dev/lt/docs/dev/phpstan/#live-wordpress-rendering)

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](https://blockstudio.dev/lt/docs/dev/phpstan/#what-it-checks)

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](https://blockstudio.dev/lt/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

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.

[Programinis atvaizdavimas](https://blockstudio.dev/lt/docs/blocks/rendering/#structured-compositions-and-complete-documents)

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

## Maž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

Apie 135 žetonų

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

Ką analizatorius sukuria šiam blokui

Apie 310 žetonų

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

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.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

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

Plus

## 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ė

[Gaukite Plus](https://blockstudio.dev/lt/plus/)
