# Разработка на блокове с AI

Файлове и без стъпка за компилация — точно с това агентите се справят добре.

[Прочетете документацията](https://blockstudio.dev/bg/docs/dev/ai/)

Беззвучен запис на екрана: агент за програмиране изгражда цялостен сайт на WordPress с 10 персонализирани блока и 6 страници от една-единствена подкана.

## Опишете блок и ще получите блок

AI агентите за програмиране могат да създават начална структура за блокове, страници и шаблони от една подкана. Без графичен интерфейс и база данни, само файлове.

~/starter-theme

❯ Създай блок за ценообразуване с три плана, превключвател за месечно/годишно плащане и призив за действие за всеки план.

✓ Създадено pricing/block.json

✓ Създадено pricing/index.php

✓ Създадено pricing/style.css

❯ Сега създай страница за ценообразуване с водеща секция и секция с често задавани въпроси.

✓ Създадено pages/pricing/page.json

✓ Създадено pages/pricing/index.php

Файлове

blockstudio/

├── pricing/ Ново

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Ново

├── page.json

└── index.php

## Всичко на база файлове

Блоковете, страниците, шаблоните и разширенията са директории с конфигурация JSON и шаблони. Агентите ги четат и записват директно.

## Без конфигурация на базата данни

Без администраторски панели, през които да щракате. Всяка настройка е ключ JSON, така че агент може да подготви библиотеката без браузър.

## Предвидима структура

Всеки блок следва една и съща конвенция: block.json, шаблон и незадължителни стилове. Научете модела веднъж.

## Контекст, а не догадки

Компактен индекс на документацията плюс пълният текст за инструменти, които искат всичко.

### Индекс, който агентът чете първо

`blockstudio-llm.txt` изброява всеки документ веднъж заедно с маршрута, изходния файл, предназначението, настройките, куковете, функциите PHP и командите CLI, за които отговаря. При около 11k токена агентът го прочита целия, след което отваря само нужната страница.

`blockstudio-llm-full.txt` съдържа всеки документ и всяка схема JSON в един файл с около 169k токена за инструменти, които искат целия корпус. Активирайте `ai.enableContextGeneration` и сайтът ви ще предоставя и двата файла.

[Документация за интеграция с AI](https://blockstudio.dev/bg/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.
```

## Договор за проекта ви

Документацията описва Blockstudio. AGENTS.md описва проекта, който агентът предстои да промени.

### Една команда записва AGENTS.md

`vendor/bin/blockstudio-agents` описва проекта, в който работи: съдържанието му, функциите, активирани от `blockstudio.json`, какво ще отхвърли анализът и приложимите команди.

Всеки ред идва от вашите файлове, настройки или избраната предварителна настройка за анализ. При повторно генериране се запазват ръчно написаните бележки, а `--check` дава грешка, ако договорът е остарял.

[Договор на проекта](https://blockstudio.dev/bg/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.
```

## Грешките се улавят преди комит

Четири предварителни настройки за анализ, всяка включваща предишната, и hook, който ги изпълнява при всеки commit.

### Анализ, който познава block.json

Предварителните настройки `blockstudio/phpstan` анализират блоковете, страниците и настройките ви. Ако шаблон използва поле, което неговият `block.json` не е декларирал, или го извежда без екраниране, анализът се проваля.

Шаблоните четат типизиран `$a` от `block.json` до тях, с конкретен тип PHP за всеки тип поле, а `Db::get()` връща записи, оформени според `db.php`. При грешно изписан път до настройка или име на hook се показва най-близкото съществуващо име.

Задайте `githooks.commit` и изпълнете `vendor/bin/blockstudio-githooks sync`: управляваната кука за предварително изпращане проверява със същия анализ, така че повреден блок никога не стига до комит.

[Предварителни настройки за анализ](https://blockstudio.dev/bg/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

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

Всеки ключ $a, който шаблонът използва, съществува в block.json; куковете, пътищата до настройките и етикетите на блоковете са реални.

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

Заглавки на теми, декларирани ресурси, обхват чрез %selector%, стойности по подразбиране за полета и ограничения за повтарящи се полета.

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

Максимум PHPStan, екраниран изход, без изпълнение на външни команди, валидни класове Tailwind и чист JavaScript.

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

Тема Extreme и предоставена от вас активна проба за рендиране на WordPress. Тя се изпълнява без shell, а неуспешното рендиране се отчита като констатация.

## [Twig, Blade и скриптове](https://blockstudio.dev/bg/docs/dev/phpstan/#what-it-checks)

Twig, Blade и block таговете се проверяват спрямо същите полета. Слоят Extreme проверява и JavaScript, както и директивите за Interactivity, спрямо вашите маркировки и хранилища.

## [Съществуващи проекти](https://blockstudio.dev/bg/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Базовата линия на PHPStan задържа записаните констатации, докато новият код покрива целия preset. blockstudioScanRoots открива библиотеки с блокове извън основната директория, а включените stub файлове типизират публичния API.

## Инвентаризация и визуализиране от PHP

С няколко извиквания агентът може да види какво регистрира даден проект, да визуализира всяка негова част и да провери какво е запазил.

### Попитайте проекта и визуализирайте отговора

`Canvas::inventory()` връща всяка страница, блок, шаблон, шаблон на редактора на сайта, част от шаблон и пример UI, регистрирани от проекта, без да визуализира нищо.

`Render::document()` визуализира всеки от тях като цялостен документ HTML с точно използваните от него ресурси, така че агентът да може да провери работата си извън редактора.

`Canvas::documents()` рендира точно избраните от вас записи. `Render::composition()` и `Render::content()` връщат вложени декларации или сериализирано съдържание на блок като HTML, а `Ui::inventory()` и `Ui::examples()` изброяват пакетните семейства компоненти с по една декларация, готова за рендиране.

За един блок `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` и `bs_block_assets()` връщат полетата, стойностите и ресурсите му, без да го рендират, а `bs_validate_block()` проверява съхранените атрибути, преди да ги запазите.

[Програмно визуализиране](https://blockstudio.dev/bg/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']);
```

## Под половината токени за страница

Агентите пишат обикновен HTML. При синхронизация Blockstudio го преобразува в сериализирана маркировка на блокове WordPress: по-малко за генериране и по-малко възможности за грешка.

### Blockstudio

Какво генерират агентите

Около 135 токена

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

Какво генерира парсерът за него

Около 310 токена

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

Измерено по двата панела по-горе: 540 знака от HTML спрямо 1,233 знака маркировка на блока, генерирана от стандартния парсер, разделено на четири — обичайната оценка за брой знаци на токен. Маркировката е показана с добавени нови редове за по-лесно четене.

## По-малко изход за генериране

Агентите пишат HTML без разделители на блокове, генерирани класове или обвиваща маркировка.

## По-малко възможности за грешка

Парсерът гарантира валиден изход на блокове от по-простия вход.

## По-бързо и по-евтино

По-малко изходни токени означават по-бързи отговори и по-ниски разходи за моделите.

## Работи с всеки инструмент за програмиране с AI

Всеки агент, който може да чете и записва файлове, работи с Blockstudio веднага.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Създадено за работния процес с AI

Блокове, страници, шаблони, настройки. Всичко е файл, който агентът може да чете, записва и променя.

## Два файла за блок

Конфигурация JSON и шаблон — това е целият блок. Малкият обхват прави генерирането от първия опит надеждно.

## 27 типа полета

Текст, файлове, повтарящи се полета, цветове, дати и още, дефинирани в JSON. Списъците с опции се попълват от публикации, термини и потребители.

## Валидиране на схема JSON

Всяка конфигурация има схема, която задава точни правила за агентите и улавя грешките веднага.

## Автоматична регистрация

Поставете файловете в директория и блоковете ще се регистрират автоматично, без допълнителен списък с конфигурации.

## Общ преглед на платното

Всяка управлявана страница или всеки блок със стойностите си по подразбиране в един мащабируем изглед.

## Платно в реално време

Режимът в реално време обновява засегнатите монтажни области чрез Server-Sent Events около секунда след запазване. Щракнете върху етикет, за да фокусирате монтажна област.

## Вграден Tailwind

TailwindPHP компилира класовете, използвани от всяка страница, без конфигурация на Node.

## Element Grabber

Копирайте пътя до шаблона и маркировката на елемент, за да предоставите незабавно контекст на агент.

## HTML към блокове

Страниците и шаблоните са обикновени файлове, които се превръщат във вградени блокове WordPress.

## Бърза проверка на рендирането

wp bs blocks render рендира всеки блок така, както би се показал на страница, и приключва с код 1, ако шаблон изведе известие, предупреждение или грешка.

## Проверки на съхраненото съдържание

wp bs blocks validate проверява запазените полета на публикациите, а pages sync предупреждава за атрибути, които блокът съхранява, но никога не рендира.

## Проверка от терминала

Изброявайте настройките, персонализираните полета и ресурсите с wp bs, а компилирайте откъс или файл с wp bs tailwind compile или wp bs scss compile.

Plus

## Официалният комплект за разширения

Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.

- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord

[Вземете Plus](https://blockstudio.dev/bg/plus/)
