# Tehisintellekti-põhine plokiarendus

Failid ja ehitussammu puudumine – just sellega agendid hästi toime tulevad.

[Loe dokumentatsiooni](https://blockstudio.dev/et/docs/dev/ai/)

Vaikne ekraanisalvestis: koodi kirjutav agent loob ühe viiba põhjal täieliku WordPress saidi 10 kohandatud ploki ja 6 leheküljega.

## Kirjelda plokki, loo plokk

Tehisintellektiga koodi kirjutavad agendid saavad ühe viiba põhjal luua plokkide, lehtede ja mustrite põhistruktuuri. Graafilist kasutajaliidest ega andmebaasi pole, ainult failid.

~/starter-theme

❯ Loo hinnaplokk kolme paketiga, kuu/aasta lülitiga ja iga paketi tegevusele kutsuva nupuga.

✓ Loodud pricing/block.json

✓ Loodud pricing/index.php

✓ Loodud pricing/style.css

❯ Loo nüüd hinnaleht kangelase ja korduma kippuvate küsimuste jaotisega.

✓ Loodud pages/pricing/page.json

✓ Loodud pages/pricing/index.php

Failid

blockstudio/

├── pricing/ Uus

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Uus

├── page.json

└── index.php

## Kõik põhineb failidel

Plokid, lehed, mustrid ja laiendused on kataloogid, kus on JSON seadistus ja mallid. Agendid loevad ja kirjutavad neid otse.

## Andmebaasi seadistust pole

Pole adminipaneele, kus klõpsida. Iga seadistus on JSON võti, nii et agent saab teegi luua ilma brauserita.

## Ennustatav struktuur

Iga plokk järgib sama tava: block.json, mall ja valikulised stiilid. Õpi muster korra selgeks.

## Kontekst, mitte oletamine

Dokumentatsiooni kompaktne register ning täistekst tööriistadele, mis vajavad kogu sisu.

### Register, mida agent loeb kõigepealt

`blockstudio-llm.txt` loetleb iga dokumendi üks kord koos selle marsruudi, lähtefaili, eesmärgi ning selle hallatavate seadistuste, hook’ide, PHP funktsioonide ja CLI käskudega. Umbes 11k märgi suurusena loeb agent selle tervikuna läbi, seejärel avab ainult vajaliku lehe.

`blockstudio-llm-full.txt` sisaldab kõiki dokumente ja JSON skeemi ühes failis, umbes 169k märki, tööriistade jaoks, mis vajavad kogu korpust. Lülita sisse `ai.enableContextGeneration` ja sinu sait pakub mõlemat.

[Tehisintellekti integratsiooni dokumendid](https://blockstudio.dev/et/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.
```

## Sinu projekti leping

Dokumentatsioon kirjeldab Blockstudio-i. AGENTS.md kirjeldab projekti, mida agent hakkab muutma.

### Üks käsk kirjutab AGENTS.md

`vendor/bin/blockstudio-agents` kirjeldab projekti, milles see töötab: mida see sisaldab, millised funktsioonid `blockstudio.json` lubab, mille analüüs tagasi lükkab ja millised käsud kehtivad.

Iga rida pärineb sinu failidest, seadistustest või valitud analüüsi eelseadistusest. Uuesti genereerimine säilitab sinu käsitsi kirjutatud märkmed ja `--check` annab vea, kui leping on aegunud.

[Projekti leping](https://blockstudio.dev/et/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.
```

## Veatuvastus enne commit’i

Neli analüüsieelistust, millest iga järgmine hõlmab eelmist, ja hook, mis käivitab need iga commit’i korral.

### Analüüs, mis tunneb block.json-i

`blockstudio/phpstan` eelseadistused loevad sinu plokke, lehti ja seadistusi. Kui mall loeb välja, mida selle `block.json` ei deklareerinud, või väljastab selle paojadastamata, kukub analüüs läbi.

Mallid loevad nende kõrval asuvast `block.json`-st tüübistatud `$a` andmeid. Igal väljatüübil on konkreetne PHP tüüp ning `Db::get()` tagastab kirjed, mille kuju määrab `db.php`. Valesti kirjutatud seadistustee või hook’i nime korral kuvatakse soovitusena lähim tegelik nimi.

Määra `githooks.commit` ja käivita `vendor/bin/blockstudio-githooks sync`: hallatud commit’i-eelne hook teeb sama analüüsi, nii et vigane plokk ei jõua commit’i.

[Analüüsi eelseadistused](https://blockstudio.dev/et/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

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

Iga $a võti, mida mall loeb, leidub failis block.json; hook’id, seadistuste teed ja plokisildid on päriselt olemas.

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

Teema päised, deklareeritud varad, %selector% ulatuse piiramine, väljade vaikeväärtused ja kordajate piirangud.

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

PHPStan maksimum, väljundi paojada, shelli ei käivitata, kehtivad Tailwind klassid ja puhas JavaScript.

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

Extreme’i teema koos teie esitatud aktiivse WordPress renderdussondiga. See töötab ilma shellita ja ebaõnnestunud renderdus märgitakse leiuna.

## [Twig, Blade ja skriptid](https://blockstudio.dev/et/docs/dev/phpstan/#what-it-checks)

Twig, Blade ja plokisildid kontrollitakse samade väljade alusel. Extreme’i kiht kontrollib ka JavaScript-i ja interaktiivsuse direktiive teie märgenduse ning salvestite suhtes.

## [Olemasolevad projektid](https://blockstudio.dev/et/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

PHPStan lähtealus jätab salvestatud leiud kõrvale, samal ajal kui uus kood peab vastama kogu eelseadistusele. blockstudioScanRoots loeb plokiteeke ka väljaspool juurkausta ning kaasas olevad tühikfailid tüübistavad avaliku API.

## Inventar ja renderdamine PHP-ist

Mõne kutsega saab agent vaadata, mida projekt registreerib, renderdada selle mis tahes osa ja kontrollida, mida see salvestas.

### Küsi projektilt, renderda vastus

`Canvas::inventory()` tagastab kõik projektis registreeritud lehed, plokid, mustrid, Site Editori mallid, malliosad ja UI näited ilma midagi renderdamata.

`Render::document()` renderdab neist igaühe tervikliku HTML dokumendina koos täpselt kasutatud varadega, et agent saaks tulemust väljaspool redaktorit kontrollida.

`Canvas::documents()` renderdab täpselt teie valitud kirjed. `Render::composition()` ja `Render::content()` tagastavad pesastatud deklaratsioonid või jadastatud plokisisu kujul HTML ning `Ui::inventory()` ja `Ui::examples()` loetlevad komplekti kuuluvad komponendipered, igaühe kohta ühe renderdatava deklaratsiooniga.

Ühe ploki puhul tagastavad `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` ja `bs_block_assets()` selle väljad, väärtused ja varad ilma plokki renderdamata ning `bs_validate_block()` kontrollib salvestatud atribuute enne nende salvestamist.

[Programmaatiline renderdamine](https://blockstudio.dev/et/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']);
```

## Lehe kohta vähem kui pooled märgid

Agendid kirjutavad lihtsat HTML-i. Sünkroonimisel muudab Blockstudio selle serialiseeritud WordPress plokimärgistuseks: vähem genereeritavat ja vähem eksimisvõimalusi.

### Blockstudio

Mida agendid kirjutavad

Umbes 135 tokenit

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

Mida parser selle jaoks kirjutab

Umbes 310 tokenit

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õõdetud ülaltoodud kahe paneeli põhjal: HTML sisaldab 540 märki, samas kui plokimärgistus, mille tavaparser selle jaoks kirjutab, sisaldab 1,233 märki. Jagades selle neljaga, saame tavapärase hinnangu märkide arvule ühe tokeni kohta. Märgistus on loetavuse huvides esitatud reavahedega.

## Vähem genereeritavat väljundit

Agendid kirjutavad HTML-i ilma plokipiiritlejate, genereeritud klasside või ümbrismärgistuseta.

## Vähem eksimisvõimalusi

Parser tagab lihtsamast sisendist kehtiva plokiväljundi.

## Kiirem ja soodsam

Vähem väljundmärke tähendab kiiremaid vastuseid ja väiksemaid mudelikulusid.

## Töötab kõigi tehisintellektil põhinevate kodeerimistööriistadega

Iga agent, mis oskab faile lugeda ja kirjutada, töötab Blockstudio-iga kohe.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Loodud tehisintellekti töövoo jaoks

Plokid, lehed, mustrid, seadistused. Kõik on failid, mida agent saab lugeda, kirjutada ja muuta.

## Iga ploki kohta kaks faili

JSON seadistus ja mall moodustavad kogu ploki. Väike pindala muudab esmakordse genereerimise töökindlaks.

## 27 väljatüüpi

Tekst, failid, kordajad, värvid, kuupäevad ja muu määratletakse failis JSON. Valikute väärtused pärinevad postitustest, terminitest ja kasutajatest.

## JSON skeemi valideerimine

Igal seadistusel on skeem, mis annab agentidele täpsed reeglid ja tuvastab vead kohe.

## Automaatne registreerimine

Pane failid kataloogi ja plokid registreeritakse automaatselt, ilma eraldi seadistusloendita.

## Ülevaade lõuendil

Iga hallatava lehe või iga ploki kuvamine koos vaikeväärtustega ühel suurendataval vaatel.

## Aktiivne lõuend

Aktiivrežiim värskendab mõjutatud joonestuslaudu Server-Sent Events’i kaudu umbes sekundi jooksul pärast salvestamist. Joonestuslaua fookustamiseks klõpsake silti.

## Tailwind on sisse ehitatud

TailwindPHP kompileerib iga lehe kasutatavad klassid ilma Node’i seadistuseta.

## Element Grabber

Kopeeri elemendi mallitee ja märgistus, et anda agendile kohe vajalik kontekst.

## HTML plokkideks

Lehed ja mustrid on lihtsad failid, millest saavad natiivsed WordPress plokid.

## Renderduse suitsutest

wp bs blocks render renderdab kõik plokid nii, nagu leht seda teeks, ja väljub koodiga 1, kui mall annab teatise, hoiatuse või vea.

## Salvestatud sisu kontrollimine

wp bs blocks validate kontrollib postituste salvestatud välju ning pages sync annab hoiatuse atribuutide kohta, mida plokk salvestab, kuid kunagi ei renderda.

## Kontrollige terminalist

Loetlege seaded, kohandatud väljad ja varad käsuga wp bs ning kompileerige koodijupp või fail käsuga wp bs tailwind compile või wp bs scss compile.

Plus

## Ametlik laienduskomplekt

Esmaklassilised saidimallid, tehisintellekti süsteemijuhised ja privaatne Discord kogukond. Ühekordne ost, eluaegsed uuendused.

- 500+ saidimalli
- Tehisintellekti süsteemijuhised
- Eluaegsed uuendused
- Privaatne Discord-i kogukond

[Hangi Plus](https://blockstudio.dev/et/plus/)
