Yapay zekâ odaklı blok geliştirme
Dosyalar ve derleme adımı gerektirmemesi, ajanların iyi olduğu şeyler.
Bir bloğu tarif edin, bir blok alın
Yapay zekâ kodlama ajanları tek bir istemden bloklar, sayfalar ve kalıplar oluşturabilir. Grafik arayüzü veya veritabanı yok, yalnızca dosyalar var.
~/starter-theme
❯ Üç kademeli, aylık/yıllık geçiş düğmeli ve her kademe için bir CTA içeren bir fiyatlandırma bloğu oluşturun.
✓ Oluşturuldu pricing/block.json
✓ Oluşturuldu pricing/index.php
✓ Oluşturuldu pricing/style.css
❯ Şimdi giriş bölümü ve SSS bölümü olan bir fiyatlandırma sayfası oluşturun.
✓ Oluşturuldu pages/pricing/page.json
✓ Oluşturuldu pages/pricing/index.php
Dosyalar
blockstudio/
├── pricing/ Yeni
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Yeni
├── page.json
└── index.php
Her şey dosya tabanlı
Bloklar, sayfalar, desenler ve uzantılar, JSON yapılandırması ve şablonları içeren dizinlerdir. Ajanlar bunları doğrudan okuyup yazabilir.
Veritabanı yapılandırması gerekmez
Tıklayarak gezmeniz gereken yönetim panelleri yok. Her ayar bir JSON anahtarıdır; böylece bir ajan tarayıcı açmadan kitaplığı oluşturabilir.
Öngörülebilir yapı
Her blok aynı düzeni izler: block.json, bir şablon ve isteğe bağlı stiller. Düzeni bir kez öğrenin.
Tahmin değil, bağlam
Belgelerin kısa bir dizini ve tamamını isteyen araçlar için tam metin.
Ajanın önce okuduğu bir dizin
blockstudio-llm.txt her belgeyi bir kez listeler; belgeye ait yolu, kaynak dosyayı, amacı, ayarları, kancaları, PHP işlevlerini ve CLI komutlarını belirtir. Yaklaşık 11k token boyutundaki bu dizinin tamamını okuyan ajan, ardından yalnızca ihtiyaç duyduğu sayfayı açar.
blockstudio-llm-full.txt, araçların tüm içerik derlemini alabilmesi için her belgeyi ve JSON şemasını yaklaşık 169k token boyutunda tek bir dosyada sunar. ai.enableContextGeneration özelliğini etkinleştirin; siteniz her ikisini de sunar.
# 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.Projeniz için bir sözleşme
Belgeler Blockstudio konusunu açıklar. AGENTS.md ise ajanın değiştirmek üzere olduğu projeyi açıklar.
Tek komut AGENTS.md yazar
vendor/bin/blockstudio-agents, içinde çalıştığı projeyi açıklar: neler içerdiğini, blockstudio.json özelliklerinin hangilerini etkinleştirdiğini, hangi analizlerin reddedeceğini ve geçerli komutları.
Her satır dosyalarınızdan, ayarlarınızdan veya seçili analiz ön ayarından gelir. Yeniden oluşturma, elle yazdığınız notları korur; sözleşme güncel değilse --check başarısız olur.
# 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 --checkHatalar commit öncesinde yakalanır
Her biri bir öncekini kapsayan dört analiz ön ayarı ve her commit’te bunları çalıştıran bir kanca.
block.json bilen analiz
blockstudio/phpstan ön ayarları bloklarınızı, sayfalarınızı ve ayarlarınızı okur. block.json tarafından hiç tanımlanmamış bir alanı okuyan veya onu kaçışlamadan çıktıya veren bir şablon analizden geçemez.
Şablonlar, yanlarındaki block.json dosyasından yazılan tür tanımlı bir $a okur; her alan türü için somut bir PHP türü bulunur ve Db::get(), db.php tarafından biçimlendirilen kayıtları döndürür. Yanlış yazılmış bir ayar yolu veya kanca adı, en yakın geçerli ad önerilerek hata verir.
githooks.commit değerini ayarlayıp vendor/bin/blockstudio-githooks sync komutunu çalıştırın: yönetilen commit öncesi kancası aynı analizi yürütür, böylece bozuk bir blok commit’e ulaşmaz.
{
"$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
Bir şablonun okuduğu her $a anahtarı block.json içinde bulunur; kancalar, ayar yolları ve blok etiketleri gerçektir.
theme
Tema başlıkları, tanımlı varlıklar, %selector% kapsamı, alan varsayılanları ve tekrarlayıcı sınırları.
extreme-theme
PHPStan maksimumu, kaçışlanmış çıktı, harici komut çalıştırmama, geçerli Tailwind sınıfları ve temiz JavaScript.
wordpress-render
Extreme teması ve sizin sağladığınız canlı bir WordPress render yoklaması. Kabuk olmadan çalışır; başarısız bir render bulgu olarak kaydedilir.
Twig, Blade ve betikler
Twig, Blade ve blok etiketleri aynı alanlara göre denetlenir. Extreme katmanı ayrıca JavaScript ve Interactivity yönergelerini işaretlemenizle ve depolanan verilerle karşılaştırarak okur.
Mevcut projeler
Bir PHPStan temel çizgisi, kaydedilmiş bulguları engellerken yeni kodun tüm ön ayar koşullarını karşılamasını sağlar. blockstudioScanRoots, kök dizinin dışındaki blok kütüphanelerini okur; paketteki taslaklar da herkese açık API için tür tanımlarını sağlar.
PHP üzerinden envanter ve oluşturma
Birkaç çağrıyla bir aracı, projenin neler kaydettiğini görüp herhangi bir bölümünü oluşturabilir ve neleri depoladığını kontrol edebilir.
Projeye sorun, yanıtı oluşturun
Canvas::inventory(), bir projenin kaydettiği her sayfayı, bloğu, deseni, Site Editor şablonunu, şablon parçasını ve UI örneğini hiçbir şeyi oluşturmadan listeler.
Render::document() bunlardan herhangi birini, kullandığı öğelerle birlikte eksiksiz bir HTML belgesi olarak oluşturur; böylece ajan çalışmasını düzenleyicinin dışında denetleyebilir.
Canvas::documents(), tam olarak seçtiğiniz kayıtları render eder. Render::composition() ve Render::content(), iç içe bildirimleri veya serileştirilmiş blok içeriğini HTML olarak döndürür; Ui::inventory() ve Ui::examples() ise birlikte gelen bileşen ailelerini, her biri render edilebilir tek bir bildirimle listeler.
Tek bir blok için bs_block_fields(), bs_block_extension_fields(), bs_block_values() ve bs_block_assets() render etmeden alanlarını, değerlerini ve varlıklarını döndürür; bs_validate_block() ise kaydetmeden önce depolanmış öznitelikleri denetler.
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=jsonSayfa başına yarıdan az token
Ajanlar düz HTML yazar. Blockstudio, eşitleme sırasında bunu serileştirilmiş WordPress blok işaretlemesine dönüştürür: oluşturulacak ve yanlış yapılabilecek daha az şey.
Blockstudio
Ajanların yazdığı
<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
Ayrıştırıcının bunun için yazdığı
<!-- 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 -->Yukarıdaki iki panelde ölçüldü: HTML içindeki 540 karakter, stok ayrıştırıcının bunun için yazdığı blok biçimlendirmesindeki 1,233 karakterle karşılaştırıldı ve belirteç başına olağan karakter tahmini olan dörde bölündü. Biçimlendirme, okunması kolay olsun diye satır sonları eklenerek gösterilmiştir.
Daha az çıktı üretimi
Ajanlar blok ayraçları, oluşturulan sınıflar veya sarmalayıcı işaretlemesi olmadan HTML yazar.
Hata yapma olasılığı azalır
Ayrıştırıcı, daha basit girdiden geçerli blok çıktısı oluşturulmasını garanti eder.
Daha hızlı ve daha uygun maliyetli
Daha az çıktı token’ı, daha hızlı yanıtlar ve daha düşük model maliyetleri demektir.
Her yapay zekâ kodlama aracıyla çalışır
Dosyaları okuyup yazabilen her ajan, kutudan çıktığı gibi Blockstudio ile çalışır.
Yapay zekâ iş akışı için tasarlandı
Bloklar, sayfalar, desenler, ayarlar. Her şey bir ajanın okuyabileceği, yazabileceği ve değiştirebileceği bir dosyadır.
Blok başına iki dosya
Bir JSON yapılandırması ve bir şablon, bloğun tamamını oluşturur. Küçük kapsam, ilk denemede güvenilir üretim sağlar.
27 alan türü
Metinler, dosyalar, tekrarlayıcılar, renkler, tarihler ve daha fazlası JSON içinde tanımlanır. Seçenekler gönderilerden, terimlerden ve kullanıcılardan doldurulur.
JSON şema doğrulaması
Her yapılandırmanın bir şeması vardır; bu şema ajanlara kesin kurallar sunar ve hataları hemen yakalar.
Otomatik kayıt
Dosyaları bir dizine bırakın; bloklar ek bir yapılandırma listesine gerek kalmadan otomatik olarak kaydedilir.
Tuval genel görünümü
Yönetilen her sayfa veya varsayılan değerleriyle birlikte her blok, yakınlaştırılabilir tek bir görünümde.
Canlı tuval
Canlı mod, kaydetme işleminden yaklaşık bir saniye sonra etkilenen çalışma yüzeylerini Server-Sent Events üzerinden yeniler. Bir çalışma yüzeyine odaklanmak için etiketine tıklayın.
Yerleşik Tailwind
TailwindPHP her sayfanın kullandığı sınıfları, Node yapılandırması gerektirmeden derler.
Element Grabber
Bir öğenin şablon yolunu ve işaretlemesini kopyalayarak ajana anında bağlam sağlayın.
HTML bloklara
Sayfalar ve desenler, yerel WordPress bloklarına dönüşen düz dosyalardır.
Render duman testi
wp bs blocks render, her bloğu bir sayfanın render ettiği şekilde render eder ve bir şablon bildirim, uyarı veya hata oluşturduğunda 1 koduyla çıkar.
Depolanan içerik denetimleri
wp bs blocks validate, yazıların kaydedilmiş alanlarını denetler; pages sync ise bir bloğun depoladığı ancak hiç render etmediği öznitelikler hakkında uyarır.
Terminalden inceleyin
Ayarları, özel alanları ve varlıkları wp bs ile listeleyin; bir kod parçasını veya dosyayı wp bs tailwind compile ya da wp bs scss compile ile derleyin.
Resmî uzantı kiti
Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.
- 500+ site şablonu
- Yapay zekâ sistem talimatları
- Ömür boyu güncellemeler
- Özel Discord topluluğu