شنو هو iCode؟
iCode هو تطبيق مفتوح المصدر خدام فالترمينال، مخصص لتنسيق وكلاء الذكاء الاصطناعي وسيرورات العمل. كيجمّع المحادثات، بروفايلات النماذج، إعداد الوكلاء، الولوج للـ shell، الفروقات ديال الملفات، أدوات التراجع، وتحليل التنفيذ فواجهة وحدة.
الخدمة مازال مستمرة: الواجهات، صيغ الملفات، والإعدادات الافتراضية ديال iCode يقدرو يتبدلو بين الإصدارات.
iCode ما فيه حتى نموذج ذكاء اصطناعي. عوض ذلك، كتربط مزودي النماذج بوحدك وكتختار شنو هو البروفايل المهيأ اللي خاص الوكيل يستعمل.
أهم الميزات
- محادثة فالترمينال: شوف أجوبة Markdown غنية، فيها لوائح ومخططات منسقة.
- وكلاء قابلين للإعداد: حدد التعليمات، الأدوات، الوكلاء الفرعيين، المهارات، خوادم MCP، والذاكرة بلا ما تكتب كود ديال الوكيل.
- بروفايلات متعددة للنماذج: هيّأ بروفايلات من مزودين مختلفين وبدّل النماذج وسط المحادثة.
- تصوير سيرورات العمل: تبّع سيرورات العمل عقدة بعقدة وعاين النموذج، استدعاءات الأدوات، واستهلاك الرموز ديال كل عقدة وكيل.
- مراجعة التغييرات: عاين كل ملف تبدل من طرف وكيل فواجهة فروقات موحدة أو مقسومة.
- التراجع: اختار دور سابق، راجع التغييرات اللي غادي يتدار عليها التراجع، وحيد المحادثة من بعد داك الدور.
- تحليل المسار: حلل توزيع الوقت، الرموز، التخزين المؤقت، والتوازي، وزيد عليهم استدعاءات النماذج، الخطافات، واستدعاءات الأدوات.
- Shell مدمج: شغّل ترمينال حقيقي داخل iCode، حتى التطبيقات اللي كتستعمل الشاشة كاملة.
المتطلبات المسبقة
المتطلب الوحيد هو uv. كيجهز Python 3.14 للمشروع، وبهذا ما محتاجش تثبت هاد الإصدار ديال Python بوحدو.
استعمل ترمينال حديث باش تاخذ أحسن تجربة. ملف README كيوصي بـ Windows Terminal فـ Windows أو Ghostty فـ macOS وLinux.
ثبّت وشغّل iCode
بدا بنسخة محلية من مستودع المشروع. حل ترمينال فالمجلد الجذر ديالو وزامن المشروع مع جميع الإضافات المطلوبة:
uv sync --extra allاستعمل --extra all بالضبط كيف ما باين. المشروع كينبه بوضوح من استعمال uv sync بوحدو أو تبديل الخيار بـ --all-extras.
من بعد، نزّل الملف التنفيذي المدمج ديال ripgrep. فـ macOS أو Linux، شغّل:
./scripts/fetch_rg.shفـ Windows، شغّل سكريبت PowerShell عوضو:
.\scripts\fetch_rg.ps1فالأخير، شغّل iCode:
uv run icodeالاسم البرمجي ديال المشروع هو Chrys، وبهذا هاد الأمر كيشغّل نفس التطبيق:
uv run chrysهيّأ أول نموذج ديالك
iCode كيتشحن بلا بروفايلات ديال النماذج. فأول تشغيل، ضغط على F4 باش تحل إعدادات النماذج وتزيد بروفايل لمزود النماذج اللي كتستعمل.
من بعد ما تهيّأ البروفايلات، تقدر تخلي بروفايلات من مزودين مختلفين حدّ بعضياتها وتبدّل بينهم وسط المحادثة. حيث iCode ما كيوفر حتى نموذج، فالاتصال بالمزود اللي هيّأتي هو اللي كيحدد فين كتمشي طلبات النماذج.
الاستعمال الأساسي
تنقّل من شريط الإدخال
الشاشة الرئيسية كتبرز الوكيل الحالي، النموذج، وضعية الموافقة، والجلسة. كاينين بادئات كتوصلك بسرعة للوظائف المهمة:
#كيوصل للوكلاء.$كيوصل للنماذج./كيوصل للأوامر.@كيوصل للملفات.!كيوصل للـ shell.
بدا محادثة
اختار وكيل ونموذج مهيأ، ومن بعد دخل الطلب ديالك فشريط الإدخال. الأجوبة كتبرز مباشرة فالترمينال بصيغة Markdown غنية. ملي كيبدل الوكيل الملفات، iCode كيسجل هاد التغييرات باش تقدر تراجعها حسب كل دور أو كاملين مجموعين.
هيّأ وكيل
ضغط على F2 باش تحل إعدادات الوكيل. الوكيل هو إعدادات ماشي كود ديال التطبيق. من هاد الشاشة، تقدر تبدل التعليمات، الأدوات، الوكلاء الفرعيين، المهارات، خوادم MCP، والذاكرة ديالو.
خلي تعليمات الوكيل منسجمة مع الغرض ديالو، وفعّل غير الأدوات والتكاملات اللي محتاجها. هاد الشي مهم حتى للخصوصية، حيث الأدوات والخوادم الخارجية يقدرو يعالجو البيانات بشكل مستقل.
راجع تغييرات الملفات
استعمل عارض الفروقات باش تعاين الملفات اللي بدلها الوكيل. تقدر تراجع التغييرات دور بدور أو تجمعها فواجهة شاملة. كاين العرض الموحد والعرض المقسوم بجوج.
شغّل وعاين سيرورات العمل
وضعية سيرورات العمل كتخليك تشوف سيرورة العمل وهي كتتنفذ عقدة بعقدة. وبالنسبة لكل عقدة وكيل، يقدر iCode يبيّن النموذج المختار، استدعاءات الأدوات ديالو، والرموز اللي تستهلكات.
راجع مزيان التراجعات المقترحة على الملفات قبل ما تأكد، خصوصاً إلا كانت عدة دورات بدلات نفس الملفات.
حلّل التنفيذ باستعمال Trajectory
ضغط على F12 باش تحل عرض المسار. النظرة العامة ديالو كاتشرح فين مشى الوقت والتوكنات، وكتفرّق بين نشاط النموذج، وتنفيذ الأدوات، والانتظار. وكيعطي حتى استعمال التوكنات والكاش لكل دورة، مع معلومات على التوازي.
الخط الزمني كيدخل فالتفاصيل ديال استدعاءات النموذج، والخطافات، واستدعاءات الأدوات داخل كل دورة. استعملو باش تحقق فالتفاعلات اللي كتستهلك بزاف ولا بطيئة، وتفهم تسلسل العمليات.
استعمل الصدفة المدمجة
دخل للصدفة باستعمال !. راه طرفية حقيقية وماشي غير لوحة محدودة لإخراج الأوامر، وبهذا تقدر البرامج اللي كتخدم فملء الشاشة تخدم فبلاصتها وتستقبل كل ضغطة على لوحة المفاتيح.
تذكّر بلي الأوامر، والسكربتات ديال المهارات، وسيرورات العمل هي برامج مستقلة وعندها الولوج للشبكة ديالك. راجع شنو كيديرو قبل ما تشغلهم، خصوصاً فالأوساط الحساسة.
حلّ دليل المستخدم الكامل
ضغط على F8 داخل iCode باش تحل دليل المستخدم المدمج. نفس التوثيق متوفر فمجلد docs/ ديال المستودع بالإنجليزية والصينية المبسطة.
الخصوصية والاتصالات الخارجية
iCode ما فيه لا تتبّع، لا تحليلات، لا تقارير الأعطال، وما كيجمعش البيانات ديالك. بشكل افتراضي، ما كيرسل والو، بما فيه بيانات الاستعمال، للمشروع ولا لأي طرف ثالث آخر.
ومع ذلك، يمكن إرسال البيانات للوجهات اللي كتكوّن، بما فيها مزوّدو النماذج، وخوادم MCP، والخطافات، ومصدّرات OpenTelemetry. أدوات الويب معطلة بشكل افتراضي. إلا فعلتيها، كتمشي عمليات البحث للمزوّد اللي كوّنتيه، ولا لخدمة Exa العامة mcp.exa.ai إلا ما كان حتى مزوّد مكوّن، بينما الصفحات كيتطلبو مباشرة من المواقع ديالها.
الامتثال والتراخيص
iCode أداة للتنسيق وما كتوفّرش نموذج ذكاء اصطناعي. ملي كتربط النماذج بالاستعمال التجاري ولا الهندسي، كتكون مسؤول على الامتثال لقانون الذكاء الاصطناعي الأوروبي وأي متطلبات قانونية ولا تنظيمية أخرى واجبة التطبيق.
المشروع مفتوح المصدر بموجب ترخيص Apache 2.0. مكوّنات الأطراف الثالثة المدمجة كاتبقى خاضعة للتراخيص الخاصة بها، واللي موثقة فملف NOTICE ديال المستودع.
الخلاصة
مع uv، وطرفية عصرية، وملف تعريف نموذج مكوّن، تقدر تستعمل iCode كواجهة مركزية للوكلاء وسيرورات العمل ديال الذكاء الاصطناعي المبنية على الطرفية. بدا بمحادثة بسيطة، وراجع كل تغيير فالملفات اللي تولّد، ومن بعد استكشف إعدادات الوكلاء، وسيرورات العمل، والتراجع، والولوج للصدفة، وتحليل المسار ملي كتولي المهام ديالك أكثر تعقيداً.