تطوير كتل ملائم للذكاء الاصطناعي
ملفات بلا خطوة بناء، وهذا ما تجيده الوكلاء.
صِف كتلة، واحصل على كتلة
يمكن لوكلاء البرمجة بالذكاء الاصطناعي إنشاء هيكل أولي للكتل والصفحات والأنماط من توجيه واحد. بلا واجهة رسومية أو قاعدة بيانات، مجرد ملفات.
~/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اكتشاف الأخطاء قبل الإيداع
أربعة إعدادات مسبقة للتحليل، كل واحد منها أوسع نطاقًا من السابق، وخطاف يشغّلها عند كل عملية إيداع.
تحليل يفهم block.json
تقرأ إعدادات blockstudio/phpstan المسبقة كتلَك وصفحاتك وإعداداتك. يفشل التحليل إذا قرأ قالب حقلًا لم يعلنه block.json أو أخرجه دون تهريب.
تقرأ القوالب قيمة $a محددة النوع من block.json المجاور لها، مع نوع PHP ملموس لكل نوع حقل، ويعيد Db::get() سجلات مصاغة وفق db.php. يؤدي الخطأ الإملائي في مسار الإعدادات أو اسم الخطاف إلى إظهار أقرب اسم صحيح مقترح.
اضبط 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 توفّره. يعمل دون صدفة أوامر، ويُسجَّل العرض الفاشل كإشكالية.
Twig وBlade والبرامج النصية
تُراجع Twig وBlade وعلامات الكتل مقارنة بالحقول نفسها. كما تقرأ طبقة Extreme توجيهات JavaScript وInteractivity وتقارنها بالترميز والتخزين لديك.
المشاريع الحالية
يمنع خط أساس PHPStan ظهور الإشكاليات المسجلة، بينما يجب أن يستوفي الكود الجديد الإعداد المسبق بالكامل. يقرأ blockstudioScanRoots مكتبات الكتل الموجودة خارج الجذر، وتحدّد الهياكل الجاهزة أنواع الواجهة العامة 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 دون فواصل الكتل أو الفئات المُنشأة أو ترميز الأغلفة.
أخطاء أقل
يضمن المحلل إخراج كتل صالحًا من مدخل أبسط.
أسرع وأقل تكلفة
تعني رموز المخرجات الأقل استجابات أسرع وتكاليف نماذج أقل.
يعمل مع كل أدوات البرمجة بالذكاء الاصطناعي
يعمل أي وكيل يستطيع قراءة الملفات وكتابتها مع Blockstudio فورًا.
مصمم لسير عمل الذكاء الاصطناعي
الكتل والصفحات والأنماط والإعدادات: كل شيء ملف يستطيع الوكيل قراءته وكتابته وتعديله.
ملفان لكل كتلة
إعداد 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.
حزمة الإضافات الرسمية
قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.
- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص