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

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

[اقرأ التوثيق](https://blockstudio.dev/ar/docs/dev/ai/)

تسجيل شاشة صامت: وكيل برمجة يبني موقع 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` ليعرض موقعك كليهما.

[مستندات تكامل الذكاء الاصطناعي](https://blockstudio.dev/ar/docs/dev/ai/)

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` عندما يكون العقد قديمًا.

[عقد المشروع](https://blockstudio.dev/ar/docs/dev/phpstan/#project-contract-for-coding-agents)

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`: ينفّذ خطاف ما قبل الإيداع المُدار التحليل نفسه، فلا تصل كتلة معطوبة إلى الإيداع.

[إعدادات التحليل المسبقة](https://blockstudio.dev/ar/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

## [base](https://blockstudio.dev/ar/docs/dev/phpstan/#analysis-presets)

كل مفتاح $a يقرؤه قالب موجود في block.json؛ الخطافات ومسارات الإعدادات ووسوم الكتل حقيقية.

## [theme](https://blockstudio.dev/ar/docs/dev/phpstan/#analysis-presets)

ترويسات القوالب، والأصول المعلنة، وتحديد النطاق باستخدام %selector%، والقيم الافتراضية للحقول، وحدود الحقول المتكررة.

## [extreme-theme](https://blockstudio.dev/ar/docs/dev/phpstan/#analysis-presets)

الحد الأقصى لـ PHPStan، ومخرجات مهروبة، ومن دون تشغيل أوامر الصدفة، وفئات Tailwind صالحة، وJavaScript نظيف.

## [wordpress-render](https://blockstudio.dev/ar/docs/dev/phpstan/#live-wordpress-rendering)

قالب Extreme مع مسبار عرض مباشر لـ WordPress توفّره. يعمل دون صدفة أوامر، ويُسجَّل العرض الفاشل كإشكالية.

## [Twig وBlade والبرامج النصية](https://blockstudio.dev/ar/docs/dev/phpstan/#what-it-checks)

تُراجع Twig وBlade وعلامات الكتل مقارنة بالحقول نفسها. كما تقرأ طبقة Extreme توجيهات JavaScript وInteractivity وتقارنها بالترميز والتخزين لديك.

## [المشاريع الحالية](https://blockstudio.dev/ar/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

يمنع خط أساس 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()` من السمات المخزنة قبل حفظها.

[العرض البرمجي](https://blockstudio.dev/ar/docs/blocks/rendering/#structured-compositions-and-complete-documents)

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 خاص

[احصل على Plus](https://blockstudio.dev/ar/plus/)
