شرح Capri: تحكّم فالملفات والمشاريع والكود باستعمال وكيل ذكاء اصطناعي على Windows

شنو هي Capri؟

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

Capri كتخدم كواجهة وطبقة ديال الأدوات، بينما مساعد خارجي كيوفر الاستدلال ديال الذكاء الاصطناعي. كتدعم Claude Code وCodex وAntigravity من الأول. ويمكن ربط مساعدين آخرين عن طريق محولات مخصصة.

Capri مشروع مستقل وغير رسمي من صنع المعجبين، مستوحى من نوع السايبربانك ومن Cyberpunk: Edgerunners. ما عندها حتى علاقة بـ CD PROJEKT RED أو Netflix أو Studio Trigger أو Anthropic أو OpenAI أو Google، وماشي معتمدة من طرفهم.

أهم المزايا

• محركات ذكاء اصطناعي متعددة: ربط Claude Code أو Codex أو Antigravity أو أي مساعد آخر عن طريق محول مخصص.
• واجهة أصلية لـ Windows: استعمل تطبيق سطح مكتب مثبت بلا ما تخدم مباشرة فالطرفية.
• أدوات الملفات والمشاريع: قلب على الملفات أو مجلدات المشاريع كاملة، قراها، نظمها وعدلها.
• سير عمل الوكيل: Capri تقدر تخطط لمهمة، تطلب الأدوات، تراجع النتيجة، وتخبرك بشنو وقع.
• مساعدة فالكود: طلب من المحرك المختار يكتب الكود، يعاود ينظمو، يصلحو، ويشغلو.
• التحكم فالموافقة: راجع العمليات الحساسة ووافق عليها أو رفضها قبل ما تبدل Capri النظام ديالك.
• نطاق قابل للإعداد: حدد الولوج لمجلدات معينة واختار واش الصلاحيات تكون بالسؤال، أو أوتوماتيكية، أو للقراءة فقط.

المتطلبات

Capri دابا كتحتاج Windows 10 أو أحدث. كتتوزع على شكل مثبت Windows بامتداد .exe. نسخ macOS وLinux موجودة فخارطة طريق المشروع، ولكن مازال ما توفراش.

خاصك حتى حساب ديالك أو مفتاح API ديال مساعد ذكاء اصطناعي مدعوم. Capri نفسها مفتوحة المصدر برخصة MIT، ولكن مزود الذكاء الاصطناعي المرتبط بها يقدر يفرض عليك رسوم الاستعمال حسب التسعيرة ديالو.

تثبيت Capri على Windows

1. تحميل المثبت

حل آخر إصدار ديال Capri وحمل Capri-Setup.exe. استعمل صفحة الإصدارات ديال المستودع الرسمي، وما تحملش من مصدر مجهول تابع لجهة خارجية.

2. تشغيل معالج الإعداد

1. حل Capri-Setup.exe.
2. تبع خطوات معالج التثبيت.
3. من بعد التثبيت، حل Capri من قائمة Start ديال Windows.

حيت Capri تطبيق جديد وممكن مازال ما عندهاش سمعة كبيرة فالتحميلات، يقدر Windows SmartScreen يبين تحذير. إلا حملتي المثبت من صفحة الإصدار الرسمية، اختار More info ومن بعد Run anyway باش تكمل.

3. ربط محرك الذكاء الاصطناعي

فأول تشغيل، Capri كتطلب منك تختار مساعد. اختار Claude Code أو Codex أو Antigravity أو خيار آخر مدعوم، ومن بعد دخل للحساب أو قدم مفتاح API المطلوب.

الطلبات ديالك كيعالجها المساعد اللي ربطتي. لذلك شروط المزود وسياسة الخصوصية والتسعيرة وقواعد الحساب ديالو هي اللي كتطبق على هاد المعالجة.

كيفاش Capri كتتعامل مع مهمة

1. كتشرح الهدف: دخل طلب بلغة عادية فالتطبيق ديال سطح المكتب.
2. Capri كتختار المحرك: الطلب كيتوجه لمساعد الذكاء الاصطناعي اللي عيّنتي.
3. المحرك كينشئ خطة: المساعد كيحدد الخطوات والأدوات اللازمة.
4. Capri كتعرض العمليات الحساسة: على حسب الصلاحيات ديالك، تقدر تراجع عمليات الملفات أو النظام المطلوبة.
5. كتوافق أو كترفض: العمليات اللي وافقت عليها كتتنفذ عبر طبقة الأدوات ديال Capri.
6. Capri كتعرض النتيجة: الوكيل كيراجع النتيجة وكيختصر ليك شنو دار.

أمثلة على الاستعمال الأساسي

تنظيم مجلد

باش تنظم مجلد، حدد المكان المستهدف وشرح التنظيم اللي بغيتي:

نظّم مجلد Downloads ديالي وجمّع الملفات حسب النوع. ورّيني الخطة قبل ما تحرك أي حاجة.

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

البحث فالكود وإصلاحو

حل مجلد المشروع المعني أو عطِ الولوج ليه، ومن بعد قدم لـ Capri طلب مركز:

قلب على الخطأ فهاد المشروع، شرح السبب، صلح المشكل، وشغل الاختبارات المتاحة.

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

تلخيص الوثائق

Capri تقدر تخدم على ملفات متعددة داخل مجلد مسموح به. مثلا:

لخّص كل ملفات PDF فهاد المجلد وكتب وثيقة ملخصة وحدة.

قبل ما توافق على المهمة، تأكد من المجلد اللي غادي تقراه Capri وفين ناوية تحفظ الوثيقة المنشأة.

إنشاء مشروع ويب

تقدر حتى تطلب سير عمل كامل ديال التطوير:

وجد تطبيق ويب جديد فهاد المجلد، ثبت الاعتماديات ديالو، وشغلو.

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

إعداد الصلاحيات والنطاق

ملف README كيعطي مثال الإعداد التالي:

engine: claude-code

permissions:
  mode: ask
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

القيمة ديال engine كتختار المساعد المربوط. القيم الموثقة كتشمل claude-code وcodex وantigravity وcustom.

قسم الصلاحيات كيدعم ثلاثة ديال الأوضاع الموثقة:

• ask: Capri كيسول قبل ما يدير أي إجراء. هادي هي أحسن بداية ملي كتكون كتتعلم كيفاش كيخدم الوكيل.
• auto: الإجراءات تقدر تدوز أوتوماتيكياً. استعمل هاد الوضع غير ملي تكون فاهم المهمة ومحدد النطاق ديالها مزيان.
• read-only: استعمل Capri للفحص والتحليل بلا ما تسمح ليه يدير تعديلات.

اللائحة ديال allowed_folders كتحدد الأماكن اللي يقدر الوكيل يوصل ليها. حسن تمنحو الولوج لمجلد خدمة محدد بلاصة قرص كامل ولا بروفايل المستخدم كامل.

نصائح متقدمة

كتب التعليمات بحدود واضحة

حدد المجلد المستهدف، والنتيجة المطلوبة، وطريقة التحقق، والإجراءات اللي خاصها تأكيد. الطلب الدقيق كينقص الغموض:

راجع المشروع اللي فمجلد Projects ديالي. حدد سبب الاختبارات اللي ما كتدوزش، وشرح التعديلات اللي كاتقترح، وتسنى الموافقة قبل ما تبدل الملفات. من بعد الموافقة، شغل مجموعة الاختبارات الموجودة.

بدا بوضع القراءة فقط

إلى كان المستودع ولا مجموعة الوثائق ما مألوفاش ليك، بدا بولوج read-only. طلب من Capri يفحص المحتوى ويقترح خطة. بدل وضع الصلاحيات غير ملي تكون واجد باش تسمح بالتعديلات.

استعمل مجلد مشروع معزول

نسخ الخدمة التجريبية لمجلد مخصص ومنح Capri الولوج غير لهاد المجلد. هاد الشي كيحد من التغييرات غير المقصودة وكيخلي مراجعة الفروقات الناتجة فالملفات أسهل.

فرق بين التخطيط والتنفيذ

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

بدل المحركات فاش كيكون مناسب

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

استعمل المحولات المخصصة بحذر

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

ما تفترضش أن كل ميزة فخارطة الطريق متاحة

خارطة الطريق كاتذكر نظام الإضافات، والتحكم الصوتي، وجدولة المهام، ومعرض السمات، ونسخ macOS وLinux كميزات مخطط لها وماشي مكتملة. راجع آخر ملاحظات الإصدار قبل ما تصمم سير عمل مبني على هاد الميزات.

إرشادات السلامة

• راجع كل إجراء حساس: رد بالك خصوصاً للحذف، والنقل، والاستبدال، وأوامر shell، وتثبيت التبعيات.
• حد من الولوج للمجلدات: كشف غير الملفات الضرورية للمهمة الحالية.
• خلي نسخ احتياطية: دير نسخة احتياطية للبيانات المهمة قبل التنظيم بالجملة، أو التعديل الآلي، أو أي عمليات كبيرة أخرى.
• حمي بيانات الدخول: عمرَك تشارك مفاتيح API، أو رموز الحسابات، ولا أي أسرار أخرى.
• فحص الأوامر المولدة: فهم أمر shell قبل ما تسمح لـ Capri يشغلو.
• استعمل التحكم فالإصدارات: فمشاريع الكود، دير commit ولا حفظ بطريقة أخرى للحالة الحالية قبل ما تطلب تعديلات مهمة.

إلى اكتاشفتي مشكل أمني، تبع تعليمات التبليغ عن المشاكل الأمنية ديال المشروع وبلغ عليه بشكل خاص.

حل المشاكل وموارد المشروع

إلى ما خدمش المثبت، ولا الربط بالمحرك، ولا سير عمل الوكيل كيفما متوقع، راجع مستودع Capri على GitHub وآخر ملاحظات الإصدار. تقدر تصيفط الأخطاء وأفكار الميزات عبر نماذج مسائل المشروع.

المساهمات مرحب بها فمجالات بحال التبليغ عن الأخطاء، والتوثيق، والسمات، واقتراحات الميزات، ومحولات المحركات. راجع دليل المساهمة ديال المستودع قبل ما تصيفط التغييرات.

الخلاصة

Capri كيعطي لمستخدمي Windows واجهة مكتبية لتوجيه مساعدين الذكاء الاصطناعي المدعومين باش يخدمو مع الملفات والمشاريع والكود. ثبت التطبيق، وربط المحرك المفضل ديالك، وحدد الولوج غير للمجلدات اللي محتاجها، وبدا بصلاحيات كتطلب الموافقة ولا بصلاحيات القراءة فقط. التعليمات الواضحة، والمراجعات الدقيقة، والنسخ الاحتياطية، وحدود الولوج الضيقة أمور أساسية ملي كتسمح لأي وكيل ديال الذكاء الاصطناعي يتصرف فالحاسوب ديالك.