MangoIDE

دليل Linux · MangoIDE 0.1.0

توثيق MangoIDE

تثبيت MangoIDE وإعداده واستخدامه على Linux

الانتقال إلى التنزيلات
01

التوافق والمتطلبات

الإصدار الحالي من Linux مخصص لأجهزة 64 بت.

  • معمارية x86_64 / amd64.
  • الإصدار 2.39 أو أحدث من glibc (libc6).
  • جلسة رسومية X11 أو Wayland.
  • اتصال بالإنترنت للوكلاء البعيدين وتنزيل الاعتماديات.
Terminal 
dpkg --print-architecture
ldd --version

تعمل Ubuntu وZorin OS وDebian فقط إذا كان الإصدار المثبت يوفر glibc 2.39 أو أحدث. قد لا يبدأ البرنامج على توزيعة أقدم.

02

تثبيت حزمة Debian ‏(.deb)

الطريقة الموصى بها للإصدارات المتوافقة من Ubuntu وZorin OS وDebian ومشتقاتها.

  • افتح صفحة التنزيل بلغتك.
  • نزّل حزمة Debian بمعمارية amd64.
  • افتحها بمدير البرامج أو استخدم الأمر أدناه.
  • شغّل MangoIDE من قائمة التطبيقات أو بالأمر mangoide.
Terminal 
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.deb
03

استخدام الأرشيف المحمول

لا يحتاج إلى تثبيت على النظام، لكنه يتطلب المعمارية وglibc نفسيهما.

  • نزّل أرشيف x86_64 المحمول.
  • فك الضغط في المجلد الذي تختاره.
  • شغّل الملف داخل المجلد الفرعي bin.
  • احتفظ بمجلد share بجوار الملف التنفيذي.
Terminal 
cd ~/Downloads
tar -xzf MangoIDE-linux-x86_64-0.1.0.tar.gz
cd MangoIDE-linux-x86_64-0.1.0
./bin/mangoide
04

البدء الأول والمشاريع

يعمل MangoIDE دائماً انطلاقاً من مجلد مشروع محدد.

  • استخدم ملف > مشروع جديد لإنشاء مشروع أو فتحه.
  • استخدم أيقونة المجلد لتغيير الدليل بسرعة.
  • يستعيد MangoIDE آخر مشروع ومحادثة بعد إعادة التشغيل.
  • يحصل كل مشروع جديد على AGENTS.md وagent-text وobsidian-brain.
  • تظهر المجلدات التقنية منفصلة عن شفرة التطبيق.
05

إعداد وكلاء الذكاء الاصطناعي

افتح الإعدادات ثم وكلاء الذكاء الاصطناعي لاستخدام وكيل مدمج أو إضافة وكيل.

  • اختر إضافة وكيل.
  • حدد اسماً واضحاً والمزود والنموذج.
  • أدخل مفتاح API عند الحاجة فقط. يمكن لـ Codex المحلي استخدام جلسة Codex المثبتة.
  • فعّل وحدة رؤية خارجية إذا احتاج نموذج نصي إلى تحليل الصور.
  • احفظ ثم اختر الوكيل والنموذج أسفل مربع المحادثة.
  • تعتمد النماذج على المزود والحساب والأدوات، ويمكن إدخال معرف النموذج يدوياً.
06

ذاكرة Obsidian وملف AGENTS.md

لكل مشروع ذاكرة تقنية خاصة محفوظة داخله.

  • يحفظ ./obsidian-brain الأخطاء والإصلاحات والقرارات والتحققات والأفكار.
  • ينقل AGENTS.md القواعد والأوامر ومكان الذاكرة إلى الوكلاء.
  • يجب أن تخص الملاحظات المشروع الحالي فقط.
  • تكون الذاكرة الخارجية القديمة للقراءة فقط ما لم تسمح بالكتابة صراحةً.
  • يحفظ agent-text المحادثات والمرفقات.

ضع AGENTS.md والملاحظات المفيدة تحت إدارة الإصدارات عند مشاركتها مع الفريق. لا تحفظ مفاتيح API أو الأسرار فيها.

07

المحادثة والطرفية والصلاحيات

تجمع Chat Agents النماذج والمرفقات والتقدم، وتنفذ الطرفية الأوامر داخل المشروع المفتوح.

  • يستخدم Single وكيلاً واحداً، وينسق Multi تعاوناً محدوداً بين الوكلاء المحددين.
  • أرفق عدة ملفات أو الصق لقطة شاشة.
  • تابع القراءة والتعديلات والأوامر والبناء والتحقق.
  • استخدم أقل صلاحية لازمة، وخصص Full للمهام التي تحتاج فعلاً إلى الشبكة أو وصول أوسع.
  • يجب تثبيت Node.js وnpm وJava وGradle وAndroid SDK على الجهاز.
  • استخدم الطرفية المدمجة لتشغيل أو إيقاف أوامر المشروع.
08

حل المشكلات

تحل هذه الفحوصات معظم المشكلات الشائعة.

  • رسالة “GLIBC_x.xx not found”: حدّث التوزيعة أو انتظر إصداراً يدعم glibc أقدم.
  • فشل تثبيت الحزمة: تحقق من amd64 واستخدم apt لمعرفة الاعتمادية المفقودة.
  • الوكيل لا يجيب: تحقق من المزود والنموذج ومفتاح API أو تسجيل الدخول المحلي.
  • npm أو Gradle غير موجود: ثبّت الأداة ثم أعد تشغيل MangoIDE.
  • فشل بناء يحتاج الشبكة: تحقق من الاتصال واستخدم Full عند الحاجة فقط.
  • فتح الوكيل مجلداً خاطئاً: افتح المشروع الصحيح قبل إرسال الطلب.

هل تحتاج إلى مساعدة؟

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

الإبلاغ عن خطأ