تخطَّ إلى المحتوى
Vikasit Code
app.header.homeapp.header.docs

Windows (WSL)

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

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

الإعداد

  1. ثبّت WSL

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

  2. ثبّت Vikasit Code داخل WSL

    بعد إعداد WSL، افتح terminal داخل WSL وثبّت Vikasit Code باستخدام إحدى طرق التثبيت.

    Terminal window
    curl -fsSL https://opencode.ai/install | bash

  3. استخدم Vikasit Code من WSL

    انتقل إلى مجلد مشروعك (يمكنك الوصول لملفات Windows عبر /mnt/c/ و/mnt/d/ وغيرها) ثم شغّل Vikasit Code.

    Terminal window
    cd /mnt/c/Users/YourName/project
    vikasit

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

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

  1. ابدأ الخادم داخل WSL مع --hostname 0.0.0.0 للسماح بالاتصالات الخارجية:

    Terminal window
    vikasit serve --hostname 0.0.0.0 --port 4096

  2. اربط تطبيق سطح المكتب على http://localhost:4096

عميل الويب + WSL

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

  1. شغّل vikasit web من terminal داخل WSL بدلًا من PowerShell:

    Terminal window
    vikasit web --hostname 0.0.0.0

  2. افتحه من متصفح Windows عبر http://localhost:<port> (يعرض Vikasit Code الرابط)

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

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

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

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

مثال:

Terminal window
cd /mnt/c/Users/YourName/Documents/project
vikasit

نصائح

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