MI videi pielāgota bloku izstrāde
Faili un bez būvēšanas posma — tieši tas, ko aģenti prot labi.
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.
# 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.
# 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 --checkKļū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ā.
{
"$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
Katra veidnes nolasītā $a atslēga ir atrodama block.json; āķi, iestatījumu ceļi un bloku tagi ir reāli.
theme
Tēmas galvenes, deklarētie resursi, %selector% tvērums, lauku noklusējuma vērtības un atkārtotāju robežas.
extreme-theme
PHPStan maksimums, izvades aizsardzība, bez čaulas komandu izpildes, derīgas Tailwind klases un tīrs JavaScript.
wordpress-render
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
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
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.
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=jsonMazā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
<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
<!-- 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.
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.
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