🚀 إضافة Da7e AI (مساعد دحيح البرمجي والتحكم بالهاتف)

إضافة متطورة وشاملة لـ Visual Studio Code تجمع بين الذكاء الاصطناعي للمساعدة البرمجية وإمكانية التحكم الكامل بـ VS Code ومحرر الكود من هاتفك الذكي (iPhone أو Android) بشرط أن يكون الهاتف والكمبيوتر متصلين على نفس شبكة الواي فاي (Local Wi-Fi / LAN).

⚡ كيف تشغل الإضافة الآن في ثوانٍ؟

لديك طريقتان سهلتان جداً:

الطريقة الأولى (الأسرع للتجربة فوراً):

1. افتح هذا المجلد في Visual Studio Code.
2. اضغط على زر F5 في لوحة المفاتيح.
3. ستفتح نافذة جديدة لـ VS Code وستجد إضافة Da7e AI مفعلة وتعمل مباشرة!

الطريقة الثانية (تثبيت دائم في جهازك):

1. قم بتشغيل الملف install.bat (اضغط عليه مرتين).
2. سيتم نسخ الإضافة فوراً إلى مسار إضافات VS Code.
3. افتح VS Code وستجد الإضافة مثبتة دائماً في الشريط الجانبي!

📱 كيف تتصل من الهاتف (iPhone / Android)؟

1. الشرط الأساسي: تأكد أن هاتفك وجهاز اللابتوب/الكمبيوتر متصلان بـ نفس شبكة الواي فاي (Wi-Fi).
2. عند تشغيل الإضافة في VS Code:
   • ستظهر أيقونة Da7e AI في الشريط الجانبي (Activity Bar).
   • اضغط عليها لمشاهدة رمز الباركود (QR Code) ورمز الحماية (PIN).
   • أو اضغط على شريط الحالة بالأسفل: 📱 Da7e AI: 192.168.x.x:38888.
3. افتح كاميرا هاتفك (آيفون أو أندرويد) ووجّهها نحو الباركود واضغط على الرابط الذي يظهر.
4. ستفتح لك لوحة تحكم كاملة بتصميم عصري على هاتفك:
   • أدخل رمز الـ PIN الموضح في الشاشة لتأكيد الاتصال الآمن.

🌟 مميزات إضافة Da7e AI على الهاتف:

1. 🤖 محادثة ذكية متصلة بمشروعك (Da7e AI Chat):

• اسأل الذكاء الاصطناعي عن أي جزء في الكود، أو اطلب كتابة ميزة أو دالة جديدة.
• زر إرسال الكود للكمبيوتر: كل كود يكتبه الذكاء الاصطناعي يحتوي على زر ⚡ أرسل إلى VS Code ليتم إدراجه في الملف المفتوح على لابتوبك بلمسة واحدة!
• الكتابة بالصوت (🎙️ Voice-to-Text): يمكنك الضغط على الميكروفون والتحدث باللغة العربية أو الإنجليزية ليقوم الذكاء الاصطناعي بتحويل كلامك لكود فوراً.

2. 📝 التحكم بالمحرر (Remote Editor):

• معرفة اسم الملف المفتوح حالياً في VS Code.
• كتابة أي كود على هاتفك وإدراجه مباشرة في مكان المؤشر أو استبدال الكود المحدد.
• أزرار سريعة: حفظ الملف (Ctrl+S)، تنسيق الكود (Format)، تراجع (Undo)، إعادة (Redo).

3. 💻 تشغيل الأكواد والطرفية (Terminal & Run):

• تشغيل الملف الحالي بضغطة زر (يدعم تلقائياً Python, Node.js, TypeScript, إلخ).
• تنفيذ أوامر سريعة مثل npm start, git status, clear.
• كتابة أي أمر مخصص وتنفيذه ومتابعة المخرجات مباشرة على شاشة الهاتف.

4. 📁 متصفح الملفات (Workspace Files):

• استعراض ملفات المشروع من الهاتف والضغط على أي ملف لفتحه في VS Code على الكمبيوتر.

⚙️ ربط الذكاء الاصطناعي (Gemini / Groq / OpenAI / Ollama):

الإضافة تعمل افتراضياً بمساعد ذكي داخلي، وللحصول على أقصى ذكاء:

1. في VS Code، اضغط على Ctrl + , (الإعدادات).
2. ابحث عن da7e.
3. يمكنك وضع مفتاحك المجاني من Google AI Studio (Gemini) في خانة da7e.apiKey.
4. يدعم أيضاً Groq و OpenAI وموديلات Ollama المحلية بدون إنترنت.

🛠️ كيف يتم بناء إضافة VS Code من الصفر؟ (How to make a VS Code Extension):

1. ملف package.json:
   • هو قلب الإضافة (Manifest)، يحدد اسم الإضافة، الأيقونة، الأوامر (commands)، والقوائم وإعدادات التكوين (configuration).
2. ملف المدخل extension.js:
   • يحتوي على دالتين أساسيتين:
     • activate(context): يتم استدعاؤها عند تشغيل الإضافة لتسجيل الأوامر وتشغيل الخدمات.
     • deactivate(): يتم استدعاؤها عند إغلاق VS Code لتنظيف الموارد وإيقاف السيرفر.
3. خادم الشبكة المحلية server.js:
   • يقوم بمعرفة عنوان الـ IP المحلي لجهازك عبر os.networkInterfaces().
   • يقوم بإنشاء خادم http.createServer ينصت على المنفذ 38888.
   • يخدم صفحة الهاتف ويستقبل طلبات التحكم من الهاتف وينفذها في VS Code عبر واجهة vscode.window و vscode.workspace.
4. توليد الباركود qrCode.js:
   • خوارزمية مدمجة تحول رابط الشبكة المحلية http://192.168.x.x:38888?pin=... إلى صورة SVG نظيفة ليتم مسحها بكاميرا الهاتف.