Windows (WSL)

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

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

الإعداد

ثبّت WSL

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

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

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

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

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

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

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

HanuBees_SERVER_PASSWORD=your-password HanuBees serve --hostname 0.0.0.0

عميل الويب + WSL

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

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

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

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

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

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

مثال:

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

نصائح

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