البداية مع Ars Umbris: ثبّت واستكشف بيئة تطوير متكاملة مُنَمَّطة ومبنية للوكلاء

شنو هو Ars Umbris؟

Ars Umbris هو IDE مرن ومبني على الوكلاء للمعرفة الموصوفة بالأنواع. كيجمع المعرفة، والأنواع، والمهارات، والأدوات، ومكوّنات واجهة المستخدم فمستودعات قابلة للتركيب، وقد يعتمد بعضها على بعض.

المشروع كيقرا هاد المستودعات على شكل رسم بياني موحّد ومكتوب بالأنواع. كيتحقق من الحقول والمراجع، ومن بعد كيوفّر تشخيصات يقدرو الوكلاء يتصرفو بناءً عليها. البشر والوكلاء يقدرو يستعملو نفس البدائيات وSDKs باش يبنيو الأدوات، ويزيدو العروض، ويعدلو التطبيق.

Ars Umbris مازال دابا فمرحلة ألفا مبكرة، لذلك توقّع وجود أخطاء وتغييرات ممكن تكسر التوافق. ودابا كيدعم macOS فقط.

كيفاش كتركب المعمارية

Ars Umbris منظم فثلاث طبقات رئيسية. فهم هاد الطبقات كيساعدك تعرف فين تقلب ملي بغيت تهيّأ النظام ولا توسّعو.

1. au-engine

au-engine هو محرّك الرسم البياني بين المستودعات، مبني فوق طبقة ملفات مكتوبة بالأنواع. كيفهرس الملفات عبر المستودعات وكيحوّلها لرسم بياني حي، قابل للاستعلام، ومكتوب بالأنواع.

المحرّك كينفّذ حتى لغة كتابة أنواع مخصّصة لملفات Markdown وYAML. لمزيد من التفاصيل، قرا au-engine.md.

2. au-host

au-host هو تطبيق المضيف المبني بـ Electron. كيركّب إسقاطات مكتوبة بالأنواع، أو عروض، فوق الرسم البياني، وكيقدر يدير تركيبات معتمدة على الإعدادات فوق البيانات المكتوبة بالأنواع.

هاد التركيبات قابلة للتعديل، ويقدرو البشر والوكلاء بجوج يتحكمو فيها. شوف au-host.md باش تقرا توثيق المضيف.

3. au-mcp

au-mcp كيوفّر طبقة الوكلاء القابلة للتوسيع. كيكشف الأدوات والمهارات المكتوبة بالأنواع عبر MCP، وكيخدم مع بيئة الوكيل اللي تختار من خلال المحوّلات.

قرا au-mcp.md باش تعرف أكثر على طبقة MCP.

التحضير للتثبيت

عملية التثبيت كتستعمل جوج ديال المجلدات:

• ~/arsumbris/ كيجمع بزاف ديال مستودعات Ars Umbris.
• ~/.arsumbris/ كيجمع ملفات إعداد Ars Umbris.

حيت المشروع خدام غير على macOS ومازال فالتطوير النشيط، راجع المتطلبات الأولية قبل ما تدير تغييرات فالنظام. تعليمات التثبيت الحالية فالمستودع هي المصدر المعتمد للبرامج المطلوبة وترتيب الإعداد.

تثبيت مستودع نقطة الدخول

الـREADME كيوصي بأنك تطلب من الوكيل ديالك يدير التثبيت بهاد التعليمات:

عاونّي نثبّت Ars Umbris.

1) صايب جوج ديال المجلدات إلا ماكانوش موجودين من قبل:
   - ~/arsumbris/ غادي يجمع بزاف ديال المستودعات.
   - ~/.arsumbris/ غادي يجمع الإعدادات.

2) نسخ مستودع نقطة الدخول:
   git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
   إلا كان داك المسار موجود من قبل، فحصو قبل ما تكمل؛ ما تكتبش فوقو.

3) قرا ~/arsumbris/arsumbris/INSTALL.md وتبع مسار الإعداد الحالي ديالو.
   تحقق من المتطلبات وشرح ليا أي تغييرات خاصها تدار فالجهاز ديالي قبل ما تديرها.

الخطوة المهمة ديال السلامة هي تفحص مجلد ~/arsumbris/arsumbris إلا كان موجود قبل عملية النسخ. ما تكتبش فوق checkout موجود. من بعد ما يولي المستودع متاح، حلّ INSTALL.md وتبع التعليمات الحالية ديالو بالترتيب الموثّق.

تبع مسار الإعداد الحالي ديال المستودع

1. تأكد بأنك خدام على macOS.
2. صايب ~/arsumbris/ و~/.arsumbris/ إلا ماكانوش موجودين من قبل.
3. تحقق واش ~/arsumbris/arsumbris موجود من قبل.
4. إلا ماكانش موجود، نسخ المستودع بهاد الأمر: git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris.
5. إلا كان موجود، فحصو بلا ما تعوّضو.
6. قرا ~/arsumbris/arsumbris/INSTALL.md.
7. تحقق من المتطلبات اللي محددها داك الملف وثبّتها، وراجع تغييرات الجهاز المقترحة قبل ما تطبقها.
8. كمّل خطوات الإعداد الباقية بالترتيب الموثّق فـINSTALL.md.

حيت Ars Umbris مازال فالتطوير النشيط، تجنّب الاعتماد على تعليمات إعداد قديمة من مصادر خارجية. استعمل دليل التثبيت الموجود فالمستودع اللي نسخت، واللي كيتعلق بالنسخة اللي كتثبت.

مفاهيم الاستعمال الأساسي

Ars Umbris مصمم حول مستودعات فيها معرفة وقدرات مكتوبة بالأنواع. المستودع يقدر يحتوي على المعرفة، وتعريفات الأنواع، والمهارات، والأدوات، ومكوّنات واجهة المستخدم. ويقدر حتى يعتمد على مستودعات أخرى، وهاد الشي كيخلي القدرات والمعرفة قابلة لإعادة الاستعمال بين المشاريع.

بشكل عام، سير العمل المعتاد كيكون هكذا:

1. حطّ أو نسخ المستودعات المرتبطة داخل ~/arsumbris/.
2. خلّي au-engine يفهرس طبقة الملفات عبر هاد المستودعات.
3. استعمل الرسم البياني الناتج والمكتوب بالأنواع باش تخدم مع البيانات والحقول والمراجع المرتبطة.
4. استعمل au-host باش تركّب الإسقاطات والعروض فوق الرسم البياني.
5. ربط بيئة وكيل عبر au-mcp ومحوّلات MCP.
6. استعمل الوكلاء أو المستخدمين البشر باش يفحصو التشخيصات، ويبنو الأدوات، ويزيدو العروض، ويعدلو التطبيق.

الـREADME ماكيفرضش مشروع نموذجي واحد ولا مسار عمل واحد بسطر الأوامر. الأوامر الدقيقة والإسقاطات المتاحة عندك كيعتمدو على الإعداد الموصوف فـINSTALL.md وعلى المستودعات اللي غادي تربط.

الخدمة مع الوكلاء عبر MCP

Ars Umbris مبني باش يتربط مع بيئة وكيل عبر Model Context Protocol. طبقة au-mcp كتوفر الأدوات والمهارات المكتوبة بالأنواع، بينما المحوّلات كتوصل هاد القدرات ببيئة الوكيل اللي كتختار.

هاد الشي كيخلي الوكيل يخدم بنفس البدائيات الأساسية وSDKs المستعملة فبناء التطبيق. عملياً، يقدر الوكيل يشارك فبناء الأدوات، وإضافة العروض، وتعديل التطبيق، حسب القدرات والإعدادات المتاحة فالتثبيت ديالك.

نصائح متقدمة واعتبارات السلامة

خلّي المستودعات قابلة لإعادة الاستعمال

نظّم المعرفة والقدرات فمستودعات يمكن تعاود تستعملها وتربطها ببعضياتها. التبعيات بين المستودعات جزء أساسي من نموذج المشروع، لذلك اعتابر المستودعات أجزاء من رسم بياني واحد ومُنمَّط، ماشي مجلدات معزولة.

استعمل التشخيصات كملاحظات توجيهية

المحرّك كيتحقق من الحقول والمراجع عبر الرسم البياني المُنمَّط. اعتابر التشخيصات ديالو ملاحظات توجيهية ملي كتعدّل Markdown المُنمَّط أو YAML أو محتوى آخر مرتبط بالمستودع، خصوصاً ملي كيكون وكيل كيدير التغييرات.

قرا توثيق كل طبقة

ملي كتحتاج تفهم السلوك، رجع للتوثيق ديال الطبقة المعنية: المحرّك، المضيف، ولا طبقة وكيل MCP.

راجع التغييرات قبل ما تطبّقها

موجّه التثبيت كيوصي بشكل واضح بشرح التغييرات المطلوبة فالجهاز قبل ما تدار. تبع نفس النهج الحذر ملي كتسمح للوكلاء يبدّلو المستودعات ولا الإعدادات.

خُد بعين الاعتبار نموذج الأمان الحالي

Ars Umbris كيشغّل الكود فالجهاز ديالك وحالياً ما فيه حتى عزل أمني. راجع SAFETY.md قبل ما تستعمل المشروع، خصوصاً ملي كتربط الوكلاء ولا كتخدم بمستودعات ما عندكش تحكم كامل فيها.

الخلاصة

Ars Umbris كيجمع بين رسم بياني مُنمَّط وعابر للمستودعات، ومضيف مبني على Electron، وطبقة وكيل MCP، باش يكون بيئة تطوير تجريبية للمعرفة المُنمَّطة. باش تبدا، وجّد جوج ديال مجلدات الإعدادات، ونسخ مستودع نقطة الدخول بلا ما تكتب فوق الملفات الموجودة، وتبع ملف INSTALL.md الحالي ديالو. من بعد التثبيت، استكشف كيفاش كيتعاونو المستودعات والإسقاطات والأدوات والمهارات والوكلاء، مع الانتباه لحالة المشروع التجريبية ونموذج التنفيذ الحالي بلا عزل أمني.