Windows (WSL)

شغّل AicippY على Windows باستخدام WSL لأفضل تجربة.

رغم أن AicippY يمكن تشغيله مباشرة على Windows، نوصي باستخدام Windows Subsystem for Linux (WSL) للحصول على أفضل تجربة. يوفر WSL بيئة Linux تعمل بسلاسة مع ميزات AicippY.

الإعداد

ثبّت WSL

إذا لم تقم بذلك بعد، ثبّت WSL باستخدام دليل Microsoft الرسمي.
ثبّت AicippY داخل WSL

بعد إعداد WSL، افتح terminal داخل WSL وثبّت AicippY باستخدام إحدى طرق التثبيت.
Terminal window
```
curl -fsSL https://code.aicippy.com/install | bash
```
استخدم AicippY من WSL

انتقل إلى مجلد مشروعك (يمكنك الوصول لملفات Windows عبر /mnt/c/ و/mnt/d/ وغيرها) ثم شغّل AicippY.
Terminal window
```
cd /mnt/c/Users/YourName/project
aicippy-code
```

تطبيق سطح المكتب + خادم WSL

إذا كنت تفضّل تطبيق AicippY لسطح المكتب لكن تريد تشغيل الخادم داخل WSL:

ابدأ الخادم داخل WSL مع --hostname 0.0.0.0 للسماح بالاتصالات الخارجية:
Terminal window
```
aicippy-code serve --hostname 0.0.0.0 --port 4096
```
اربط تطبيق سطح المكتب على http://localhost:4096

عند استخدام --hostname 0.0.0.0، اضبط AICIPPY_CODE_SERVER_PASSWORD لحماية الخادم.

AICIPPY_CODE_SERVER_PASSWORD=your-password aicippy-code serve --hostname 0.0.0.0

عميل الويب + WSL

لأفضل تجربة ويب على Windows:

شغّل aicippy-code web من terminal داخل WSL بدلًا من PowerShell:
Terminal window
```
aicippy-code web --hostname 0.0.0.0
```
افتحه من متصفح Windows عبر http://localhost:<port> (يعرض AicippY الرابط)

تشغيل aicippy-code web من WSL يضمن وصولًا صحيحًا لنظام الملفات وتكاملًا أفضل مع terminal، مع بقائه متاحًا من متصفح Windows.

الوصول إلى ملفات Windows

يمكن لـ WSL الوصول إلى جميع ملفات Windows عبر مجلد /mnt/:

قرص C: → /mnt/c/
قرص D: → /mnt/d/
وهكذا…

مثال:

cd /mnt/c/Users/YourName/Documents/project
aicippy-code

نصائح

شغّل AicippY داخل WSL للمشاريع المخزنة على أقراص Windows حتى يكون الوصول للملفات سلسًا
استخدم إضافة WSL في VS Code مع AicippY لسير عمل تطوير متكامل
إعدادات AicippY وجلساته تُخزَّن داخل بيئة WSL في ~/.local/share/aicippy-code/