# MI videi pielāgota bloku izstrāde

Faili un bez būvēšanas posma — tieši tas, ko aģenti prot labi.

[Lasīt dokumentāciju](https://blockstudio.dev/lv/docs/dev/ai/)

Klusais ekrāna ieraksts: kodēšanas aģents, izmantojot vienu uzvedni, izveido pilnu WordPress vietni ar 10 pielāgotiem blokiem un 6 lapām.

## Aprakstiet bloku, un tas tiks izveidots

AI kodēšanas aģenti ar vienu uzvedni var izveidot bloku, lapu un paraugu pamata struktūru. Bez grafiskā interfeisa un datubāzes — tikai faili.

~/starter-theme

❯ Izveidojiet cenu bloku ar trim līmeņiem, mēneša/gada pārslēgu un CTA katram līmenim.

✓ Izveidots pricing/block.json

✓ Izveidots pricing/index.php

✓ Izveidots pricing/style.css

❯ Tagad izveidojiet cenu lapu ar galveno sadaļu un bieži uzdoto jautājumu sadaļu.

✓ Izveidots pages/pricing/page.json

✓ Izveidots pages/pricing/index.php

Faili

blockstudio/

├── pricing/ Jauns

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Jauns

├── page.json

└── index.php

## Viss balstīts failos

Bloki, lapas, raksti un paplašinājumi ir direktorijas ar JSON konfigurāciju un veidnēm. Aģenti tās lasa un raksta tieši.

## Datubāzes konfigurācija nav vajadzīga

Nav jāklikšķina cauri administrācijas paneļiem. Katrs iestatījums ir JSON atslēga, tāpēc aģents var izveidot bibliotēkas karkasu bez pārlūka.

## Paredzama struktūra

Katram blokam ir viena un tā pati konvencija: block.json, veidne un neobligāti stili. Iemācieties šo rakstu vienreiz.

## Konteksts, nevis minējumi

Kompakts dokumentācijas indekss un pilns teksts rīkiem, kam vajadzīgs viss saturs.

### Indekss, ko aģents lasa vispirms

`blockstudio-llm.txt` vienreiz uzskaita katru dokumentu, norādot tā maršrutu, avota failu, nolūku un tam piederošos iestatījumus, āķus, PHP funkcijas un CLI komandas. Ar aptuveni 11k tokeniem aģents to izlasa pilnībā un pēc tam atver tikai vajadzīgo lapu.

`blockstudio-llm-full.txt` vienā failā ietver visus dokumentus un visas JSON shēmas, aptuveni 169k tokenu apjomā, rīkiem, kuriem vajadzīgs viss korpuss. Ieslēdziet `ai.enableContextGeneration`, un jūsu vietne nodrošinās abus.

[MI integrācijas dokumentācija](https://blockstudio.dev/lv/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.
```

## Jūsu projekta līgums

Dokumentācija apraksta Blockstudio. AGENTS.md apraksta projektu, ko aģents tūlīt mainīs.

### Viena komanda izveido AGENTS.md

`vendor/bin/blockstudio-agents` apraksta projektu, kurā tas darbojas: kas tajā ietilpst, kuras funkcijas iespējo `blockstudio.json`, ko analīze noraidīs un kuras komandas ir piemērojamas.

Katra rinda nāk no jūsu failiem, iestatījumiem vai atlasītā analīzes profila. Ģenerējot vēlreiz, ar roku rakstītās piezīmes tiek saglabātas, bet `--check` neizdodas, ja līgums ir novecojis.

[Projekta līgums](https://blockstudio.dev/lv/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.
```

## Kļūdas atklātas pirms komita

Četri analīzes iestatījumi, katrs ietver iepriekšējo, un āķis, kas tos izpilda pēc katras komita.

### Analīze, kas pārzina block.json

`blockstudio/phpstan` profili pārbauda jūsu blokus, lapas un iestatījumus. Ja veidne nolasa lauku, ko tās `block.json` nav deklarējis, vai izvada to bez ekrānēšanas, analīze neizdodas.

Veidnes nolasa `$a` tipu, kas iegūts no līdzās esošā `block.json`, katram lauka tipam izmantojot konkrētu PHP tipu, savukārt `Db::get()` atgriež ierakstus, kuru struktūru nosaka `db.php`. Ja iestatījumu ceļā vai āķa nosaukumā ir drukas kļūda, tiek piedāvāts tuvākais pareizais nosaukums.

Iestatiet `githooks.commit` un palaidiet `vendor/bin/blockstudio-githooks sync`: pārvaldītais pirmskomita āķis veic to pašu analīzi, tāpēc bojāts bloks nenonāk komitā.

[Analīzes profili](https://blockstudio.dev/lv/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

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

Katra veidnes nolasītā $a atslēga ir atrodama block.json; āķi, iestatījumu ceļi un bloku tagi ir reāli.

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

Tēmas galvenes, deklarētie resursi, %selector% tvērums, lauku noklusējuma vērtības un atkārtotāju robežas.

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

PHPStan maksimums, izvades aizsardzība, bez čaulas komandu izpildes, derīgas Tailwind klases un tīrs JavaScript.

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

Extreme motīvs kopā ar jūsu nodrošinātu tiešsaistes WordPress renderēšanas pārbaudi. Tā darbojas bez čaulas, un neveiksmīga renderēšana tiek reģistrēta kā problēma.

## [Twig, Blade un skripti](https://blockstudio.dev/lv/docs/dev/phpstan/#what-it-checks)

Twig, Blade un bloku tagi tiek pārbaudīti pēc tiem pašiem laukiem. Extreme slānis arī salīdzina JavaScript un Interactivity direktīvas ar jūsu marķējumu un datu krātuvēm.

## [Esošie projekti](https://blockstudio.dev/lv/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

PHPStan bāzlīnija saglabā iepriekš reģistrētās problēmas, kamēr jaunais kods atbilst pilnai iepriekšiestatīto noteikumu kopai. blockstudioScanRoots nolasa bloku bibliotēkas ārpus saknes direktorija, un komplektā iekļautās aizstājējdeklarācijas definē publisko API tipu.

## Inventārs un renderēšana no PHP

Ar dažiem izsaukumiem aģents var noskaidrot, ko projekts reģistrē, atveidot jebkuru tā daļu un pārbaudīt, ko tas ir saglabājis.

### Vaicājiet projektam, renderējiet atbildi

`Canvas::inventory()` atgriež visas projektā reģistrētās lapas, blokus, rakstus, vietnes redaktora veidnes, veidņu daļas un UI piemērus, neko nerenderējot.

`Render::document()` renderē jebkuru no tiem kā pilnu HTML dokumentu ar precīzi tiem resursiem, ko tas izmantojis, lai aģents varētu pārbaudīt savu darbu ārpus redaktora.

`Canvas::documents()` renderē tieši jūsu atlasītos ierakstus. `Render::composition()` un `Render::content()` atgriež ligzdotas deklarācijas vai serializētu bloka saturu kā HTML, savukārt `Ui::inventory()` un `Ui::examples()` uzskaita komplektā iekļautās komponentu saimes, katrai norādot vienu renderējamu deklarāciju.

Vienam blokam `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` un `bs_block_assets()` atgriež tā laukus, vērtības un resursus, to nerenderējot, bet `bs_validate_block()` pārbauda saglabātos atribūtus pirms to saglabāšanas.

[Programmatiskā renderēšana](https://blockstudio.dev/lv/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']);
```

## Mazāk nekā puse tokenu katrai lapai

Aģenti raksta vienkāršu HTML. Sinhronizējot Blockstudio to pārveido serializētā WordPress bloku marķējumā: mazāk jāģenerē un mazāk iespēju kļūdīties.

### Blockstudio

Ko ģenerē aģenti

Apmēram 135 tokenu

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

Ko tam ģenerē parsētājs

Apmēram 310 tokenu

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ērīts abos augstāk redzamajos paneļos: HTML ir 540 rakstzīmju, bet bloka marķējuma struktūra, ko standarta parsētājs tam ģenerē, ir 1,233 rakstzīmju. Dalot ar četri, iegūst parasto rakstzīmju skaita aplēsi uz vienu tokenu. Marķējuma struktūra ir parādīta ar lasāmībai pievienotiem rindu pārtraukumiem.

## Jāģenerē mazāk izvades

Aģenti raksta HTML bez bloku norobežotājiem, ģenerētām klasēm vai ietveroša marķējuma.

## Mazāk iespēju kļūdīties

Parsētājs no vienkāršākas ievades garantē derīgu bloka izvadi.

## Ātrāk un lētāk

Mazāk izvades tokenu nozīmē ātrākas atbildes un zemākas modeļa izmaksas.

## Darbojas ar ikvienu MI kodēšanas rīku

Jebkurš aģents, kas spēj lasīt un rakstīt failus, darbojas ar Blockstudio uzreiz.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Radīts MI darbplūsmai

Bloki, lapas, raksti, iestatījumi. Viss ir fails, ko aģents var lasīt, rakstīt un mainīt.

## Divi faili katram blokam

Bloku veido JSON konfigurācija un veidne. Nelielā virsma padara ģenerēšanu ar pirmo mēģinājumu uzticamu.

## 27 lauku veidi

Teksts, faili, atkārtotāji, krāsas, datumi un citi, definēti JSON. Atlases saraksti tiek aizpildīti no ierakstiem, terminiem un lietotājiem.

## JSON shēmas validācija

Katrai konfigurācijai ir shēma, kas sniedz aģentiem precīzus noteikumus un uzreiz atklāj kļūdas.

## Automātiska reģistrācija

Ievietojiet failus direktorijā, un bloki reģistrēsies automātiski, bez papildu konfigurācijas saraksta.

## Audekla pārskats

Visas pārvaldītās lapas vai visi bloki ar to noklusējuma vērtībām vienā pietuvināmā skatā.

## Tiešsaistes kanva

Tiešsaistes režīmā pēc saglabāšanas aptuveni sekundi vēlāk tiek atsvaidzināti ietekmētie montāžas laukumi, izmantojot Server-Sent Events. Noklikšķiniet uz etiķetes, lai fokusētu vienu montāžas laukumu.

## Tailwind iekļauts

TailwindPHP kompilē katrā lapā izmantotās klases bez Node konfigurācijas.

## Element Grabber

Nokopējiet elementa veidnes ceļu un marķējumu, lai uzreiz sniegtu aģentam kontekstu.

## HTML par blokiem

Lapas un raksti ir vienkārši faili, kas kļūst par vietējiem WordPress blokiem.

## Renderēšanas ātrā pārbaude

wp bs blocks render renderē katru bloku tā, kā tas tiktu attēlots lapā, un beidz darbu ar kodu 1, ja veidne rada paziņojumu, brīdinājumu vai kļūdu.

## Saglabātā satura pārbaudes

wp bs blocks validate pārbauda ziņu saglabātos laukus, bet pages sync brīdina par atribūtiem, ko bloks saglabā, taču nekad nerenderē.

## Pārbaudiet terminālī

Uzskaitiet iestatījumus, pielāgotos laukus un resursus ar wp bs, kā arī kompilējiet koda fragmentu vai failu ar wp bs tailwind compile vai wp bs scss compile.

Plus

## Oficiālais paplašinājumu komplekts

Premium vietņu veidnes, AI sistēmas instrukcijas un privāta Discord kopiena. Vienreizējs pirkums, atjauninājumi uz mūžu.

- 500+ vietņu veidnes
- AI sistēmas instrukcijas
- Atjauninājumi visā lietošanas laikā
- Privāta Discord kopiena

[Iegūt Plus](https://blockstudio.dev/lv/plus/)
