Разработка на блокове с AI
Файлове и без стъпка за компилация — точно с това агентите се справят добре.
Опишете блок и ще получите блок
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 и сайтът ви ще предоставя и двата файла.
# 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 дава грешка, ако договорът е остарял.
# 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 --checkГрешките се улавят преди комит
Четири предварителни настройки за анализ, всяка включваща предишната, и hook, който ги изпълнява при всеки commit.
Анализ, който познава block.json
Предварителните настройки blockstudio/phpstan анализират блоковете, страниците и настройките ви. Ако шаблон използва поле, което неговият block.json не е декларирал, или го извежда без екраниране, анализът се проваля.
Шаблоните четат типизиран $a от block.json до тях, с конкретен тип PHP за всеки тип поле, а Db::get() връща записи, оформени според db.php. При грешно изписан път до настройка или име на hook се показва най-близкото съществуващо име.
Задайте githooks.commit и изпълнете vendor/bin/blockstudio-githooks sync: управляваната кука за предварително изпращане проверява със същия анализ, така че повреден блок никога не стига до комит.
{
"$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
Всеки ключ $a, който шаблонът използва, съществува в block.json; куковете, пътищата до настройките и етикетите на блоковете са реални.
theme
Заглавки на теми, декларирани ресурси, обхват чрез %selector%, стойности по подразбиране за полета и ограничения за повтарящи се полета.
extreme-theme
Максимум PHPStan, екраниран изход, без изпълнение на външни команди, валидни класове Tailwind и чист JavaScript.
wordpress-render
Тема Extreme и предоставена от вас активна проба за рендиране на WordPress. Тя се изпълнява без shell, а неуспешното рендиране се отчита като констатация.
Twig, Blade и скриптове
Twig, Blade и block таговете се проверяват спрямо същите полета. Слоят Extreme проверява и JavaScript, както и директивите за Interactivity, спрямо вашите маркировки и хранилища.
Съществуващи проекти
Базовата линия на 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() проверява съхранените атрибути, преди да ги запазите.
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=jsonПод половината токени за страница
Агентите пишат обикновен HTML. При синхронизация Blockstudio го преобразува в сериализирана маркировка на блокове WordPress: по-малко за генериране и по-малко възможности за грешка.
Blockstudio
Какво генерират агентите
<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
Какво генерира парсерът за него
<!-- 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 веднага.
Създадено за работния процес с 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.
Официалният комплект за разширения
Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.
- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord