Windows (WSL)

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

الإعداد

ثبّت WSL

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

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

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

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

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

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

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

CODETUTOR_SERVER_PASSWORD=your-password codetutor serve --hostname 0.0.0.0

عميل الويب + WSL

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

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

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

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

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

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

مثال:

cd /mnt/c/Users/YourName/Documents/project
opencode

نصائح

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