انتقل إلى المحتوى

تطوير كتل ملائم للذكاء الاصطناعي

ملفات بلا خطوة بناء، وهذا ما تجيده الوكلاء.

تسجيل شاشة صامت: وكيل برمجة يبني موقع WordPress كاملًا يضم 10 كتل مخصصة و6 صفحات انطلاقًا من توجيه واحد.

صِف كتلة، واحصل على كتلة

يمكن لوكلاء البرمجة بالذكاء الاصطناعي إنشاء هيكل أولي للكتل والصفحات والأنماط من توجيه واحد. بلا واجهة رسومية أو قاعدة بيانات، مجرد ملفات.

~/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-llm.txt
# 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 عندما يكون العقد قديمًا.

AGENTS.md
# 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.

اكتشاف الأخطاء قبل الإيداع

أربعة إعدادات مسبقة للتحليل، كل واحد منها أوسع نطاقًا من السابق، وخطاف يشغّلها عند كل عملية إيداع.

تحليل يفهم block.json

تقرأ إعدادات blockstudio/phpstan المسبقة كتلَك وصفحاتك وإعداداتك. يفشل التحليل إذا قرأ قالب حقلًا لم يعلنه block.json أو أخرجه دون تهريب.

تقرأ القوالب قيمة $a محددة النوع من block.json المجاور لها، مع نوع PHP ملموس لكل نوع حقل، ويعيد Db::get() سجلات مصاغة وفق db.php. يؤدي الخطأ الإملائي في مسار الإعدادات أو اسم الخطاف إلى إظهار أقرب اسم صحيح مقترح.

اضبط githooks.commit وشغّل vendor/bin/blockstudio-githooks sync: ينفّذ خطاف ما قبل الإيداع المُدار التحليل نفسه، فلا تصل كتلة معطوبة إلى الإيداع.

blockstudio.json
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}

الجرد والعرض من 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() من السمات المخزنة قبل حفظها.

inspect.php
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']);

أقل من نصف الرموز لكل صفحة

يكتب الوكلاء HTML عاديًا. يحوّله Blockstudio عند المزامنة إلى ترميز كتل WordPress متسلسل، ما يقلل ما يلزم توليده والأخطاء المحتملة.

Blockstudio

ما يكتبه الوكلاء

نحو 135 رمزًا
index.php
<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

ما يكتبه المحلل النحوي لها

نحو 310 رموز
post_content
<!-- 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 فورًا.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

مصمم لسير عمل الذكاء الاصطناعي

الكتل والصفحات والأنماط والإعدادات: كل شيء ملف يستطيع الوكيل قراءته وكتابته وتعديله.

ملفان لكل كتلة

إعداد 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.

Plus

حزمة الإضافات الرسمية

قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.

  • أكثر من 500+ قالب موقع
  • تعليمات نظام الذكاء الاصطناعي
  • تحديثات مدى الحياة
  • مجتمع Discord خاص