Tekoälyn ehdoilla tehty lohkojen kehitys
Tiedostot ja ei koontivaihetta – juuri sitä, missä agentit ovat hyviä.
Kuvaile lohko, luo lohko
Tekoälykoodausagentit voivat luoda lohkojen, sivujen ja mallien pohjat yhdellä kehotteella. Ei graafista käyttöliittymää eikä tietokantaa, vain tiedostoja.
~/starter-theme
❯ Luo hinnoittelulohko, jossa on kolme tasoa, kuukausi-/vuosivalitsin ja toimintakehote jokaiselle tasolle.
✓ Luotu pricing/block.json
✓ Luotu pricing/index.php
✓ Luotu pricing/style.css
❯ Luo nyt hinnoittelusivu, jossa on pääosio ja UKK-osio.
✓ Luotu pages/pricing/page.json
✓ Luotu pages/pricing/index.php
Tiedostot
blockstudio/
├── pricing/ Uusi
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Uusi
├── page.json
└── index.php
Kaikki tiedostopohjaista
Lohkot, sivut, kuviot ja laajennukset ovat hakemistoja, joissa on JSON-määritystiedosto ja malleja. Agentit lukevat ja muokkaavat niitä suoraan.
Ei tietokantamäärityksiä
Ei hallintapaneeleissa napsuttelua. Jokainen asetus on JSON-avain, joten agentti voi luoda kirjaston selainta käyttämättä.
Ennakoitava rakenne
Jokainen lohko noudattaa samaa käytäntöä: block.json, malli ja valinnaiset tyylit. Opettele käytäntö kerran.
Kontekstia, ei arvailua
Tiivis dokumentaation hakemisto sekä koko teksti työkaluja varten, jotka tarvitsevat kaiken.
Hakemisto, jonka agentti lukee ensin
blockstudio-llm.txt luettelee jokaisen dokumentin kerran sekä sen reitin, lähdetiedoston, tarkoituksen ja sen omistamat asetukset, koukut, PHP-funktiot ja CLI-komennot. Noin 11k tokenin kokoisena agentti lukee sen kokonaan ja avaa sitten vain tarvitsemansa sivun.
blockstudio-llm-full.txt sisältää kaikki dokumentit ja JSON-skeemat yhdessä tiedostossa, noin 169k tokenia, työkaluja varten, jotka tarvitsevat koko aineiston. Ota ai.enableContextGeneration käyttöön, niin sivustosi tarjoaa molemmat.
# 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.Sopimus projektillesi
Dokumentaatio kuvaa Blockstudio. AGENTS.md kuvaa projektia, jota agentti on muuttamassa.
Yksi komento luo tiedoston AGENTS.md
vendor/bin/blockstudio-agents kuvaa projektia, jossa se toimii: mitä se sisältää, mitkä ominaisuudet blockstudio.json ottaa käyttöön, mitä analyysi hylkää ja mitkä komennot pätevät.
Jokainen rivi perustuu tiedostoihisi, asetuksiisi tai valittuun analyysiasetukseen. Uudelleenluonti säilyttää itse kirjoittamasi muistiinpanot, ja --check epäonnistuu, jos sopimus on vanhentunut.
# 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 --checkVirheet havaitaan ennen committia
Neljä analyysin esiasetusta, joista kukin sisältää edellisen ominaisuudet, sekä koukku, joka suorittaa analyysit jokaisessa commitissa.
block.json tuntevaa analyysiä
blockstudio/phpstan-asetukset lukevat lohkosi, sivusi ja asetuksesi. Analyysi epäonnistuu, jos malli lukee kentän, jota sen block.json ei määritä, tai tulostaa sen escapettomana.
Mallit lukevat $a-tyypin, joka määritellään niiden vieressä olevassa block.json-tiedostossa, ja jokaisella kenttätyypillä on konkreettinen PHP-tyyppi; Db::get() palauttaa tietueita, joiden rakenne määräytyy db.php mukaan. Väärin kirjoitettu asetuspolku tai koukun nimi aiheuttaa virheen, jossa ehdotetaan lähintä oikeaa nimeä.
Aseta githooks.commit ja suorita vendor/bin/blockstudio-githooks sync: hallittu esikäsittelykoukku suorittaa saman analyysin, joten rikkinäinen lohko ei päädy commit-tapahtumaan.
{
"$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
Jokainen mallin lukema $a-avain löytyy block.json-määrityksestä; koukut, asetusten polut ja lohkotunnisteet ovat todellisia.
theme
Teeman otsakkeet, määritetyt resurssit, %selector%-rajaukset, kenttien oletusarvot ja toistimen rajat.
extreme-theme
PHPStan-enimmäismäärä, escapettu tuloste, ei komentotulkin käynnistyksiä, kelvolliset Tailwind-luokat ja siisti JavaScript.
wordpress-render
Extreme-teema ja toimittamasi live-WordPress-renderöinnin testauspiste. Se toimii ilman komentotulkkia, ja epäonnistunut renderöinti kirjataan löydökseksi.
Twig, Blade ja skriptit
Twig, Blade ja lohkotunnisteet tarkistetaan samoja kenttiä vasten. Extreme-kerros lukee lisäksi JavaScript-määritykset ja Interactivity-direktiivit merkinnästäsi ja tallennustiloista.
Olemassa olevat projektit
PHPStan-lähtötaso pitää kirjatut löydökset poissa tuloksista, kun uusi koodi täyttää koko esiasetuksen vaatimukset. blockstudioScanRoots lukee juuren ulkopuoliset lohkokirjastot, ja mukana toimitettavat tyngät tyypittävät julkisen API-rajapinnan.
Inventaario ja renderöinti PHP-ratkaisusta
Muutamalla kutsulla agentti näkee, mitä projektiin on rekisteröity, renderöi minkä tahansa osan ja tarkistaa tallennetut tiedot.
Kysy projektilta, tulosta vastaus
Canvas::inventory() palauttaa kaikki projektin rekisteröimät sivut, lohkot, kuviot, Site Editor -mallit, malliosat ja UI-esimerkit tulostamatta mitään.
Render::document() tulostaa minkä tahansa niistä täydellisenä HTML-dokumenttina, joka sisältää täsmälleen käytetyt resurssit, jotta agentti voi tarkistaa työnsä editorin ulkopuolella.
Canvas::documents() renderöi täsmälleen valitsemasi tietueet. Render::composition() ja Render::content() palauttavat sisäkkäiset määritykset tai serialisoidun lohkosisällön muodossa HTML, ja Ui::inventory() sekä Ui::examples() luettelevat mukana toimitettavat komponenttiperheet, joissa kussakin on yksi renderöitävä määritys.
Yhden lohkon tapauksessa bs_block_fields(), bs_block_extension_fields(), bs_block_values() ja bs_block_assets() palauttavat sen kentät, arvot ja resurssit renderöimättä lohkoa, ja bs_validate_block() tarkistaa tallennetut attribuutit ennen niiden tallentamista.
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=jsonAlle puolet tokeneista sivua kohti
Agentit kirjoittavat tavallista HTML-sisältöä. Blockstudio muuntaa sen synkronoinnin yhteydessä sarjallistetuksi WordPress-lohkomerkinnäksi: vähemmän tuotettavaa ja vähemmän virheitä.
Blockstudio
Mitä agentit kirjoittavat
<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
Mitä jäsennin kirjoittaa sitä varten
<!-- 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 -->Mitattu yllä olevista kahdesta paneelista: HTML sisältää 540 merkkiä, kun taas lohkon merkintäkieli, jonka vakiomuotoinen jäsennin kirjoittaa sitä varten, sisältää 1,233 merkkiä. Tämä jaetaan neljällä, joka on tavallinen arvio merkkien määrästä tokenia kohti. Merkintäkieli näytetään rivinvaihdoilla luettavuuden parantamiseksi.
Vähemmän tuotettavaa tulostetta
Agentit kirjoittavat HTML-sisältöä ilman lohkoerottimia, luotuja luokkia tai kääremerkintöjä.
Vähemmän virheitä
Jäsennin takaa kelvollisen lohkotulosteen yksinkertaisemmasta syötteestä.
Nopeampi ja edullisempi
Vähemmän tulostetokeneita tarkoittaa nopeampia vastauksia ja pienempiä mallikustannuksia.
Toimii kaikilla tekoälykoodaustyökaluilla
Mikä tahansa tiedostoja lukeva ja kirjoittava agentti toimii Blockstudio-ratkaisun kanssa suoraan.
Tehty tekoälyn työnkulkua varten
Lohkot, sivut, kuviot ja asetukset. Kaikki on tiedostoja, joita agentti voi lukea, kirjoittaa ja muokata.
Kaksi tiedostoa lohkoa kohti
JSON-määritystiedosto ja malli muodostavat koko lohkon. Pieni pinta-ala tekee ensimmäisestä generoinnista luotettavan.
27 kenttätyyppiä
Tekstit, tiedostot, toistimet, värit, päivämäärät ja paljon muuta määritetään JSON-tiedostossa. Valintalistat täyttyvät julkaisuista, termeistä ja käyttäjistä.
JSON skeeman tarkistus
Jokaisella määrityksellä on skeema, joka antaa agenteille täsmälliset säännöt ja havaitsee virheet heti.
Automaattinen rekisteröinti
Pudota tiedostot hakemistoon, niin lohkot rekisteröityvät automaattisesti ilman erillistä määritysluetteloa.
Kanvaksen yleiskuva
Kaikki hallitut sivut tai kaikkien lohkojen oletusarvot yhdessä zoomattavassa näkymässä.
Live-kanvaasi
Live-tila päivittää muutoksen kohteena olevat piirtoalueet Server-Sent Events -tekniikalla noin sekunti tallennuksen jälkeen. Napsauta selitettä kohdistaaksesi näkymän yhteen piirtoalueeseen.
Tailwind sisäänrakennettuna
TailwindPHP kääntää kunkin sivun käyttämät luokat ilman Node-määrityksiä.
Element Grabber
Kopioi elementin mallipolku ja merkkaus agentin välittömäksi kontekstiksi.
HTML lohkoiksi
Sivut ja kuviot ovat tavallisia tiedostoja, joista syntyy natiiveja WordPress-lohkoja.
Renderöinnin savutesti
wp bs blocks render renderöi jokaisen lohkon kuten sivu ja poistuu koodilla 1, jos malli antaa ilmoituksen, varoituksen tai virheen.
Tallennetun sisällön tarkistukset
wp bs blocks validate tarkistaa viestien tallennetut kentät, ja pages sync varoittaa attribuuteista, jotka lohko tallentaa mutta joita se ei koskaan renderöi.
Tarkastele komentoriviltä
Luettele asetukset, mukautetut kentät ja resurssit komennolla wp bs ja käännä koodikatkelma tai tiedosto komennoilla wp bs tailwind compile tai wp bs scss compile.
Virallinen laajennuspaketti
Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.
- 500+ sivustomallia
- Tekoälyn järjestelmäohjeet
- Elinikäiset päivitykset
- Yksityinen Discord-yhteisö