البدء

مرحبًا بك في RoqueOS! سيساعدك هذا الدليل على البدء في أقل من 5 دقائق.

---

الخيار 1: الوصول الفوري عبر الويب

أسرع طريقة لتجربة RoqueOS هي الوصول مباشرة عبر المتصفح، دون أي تثبيت:

👉 roqueos.com.br

أنشئ حسابًا ببريدك الإلكتروني وستكون داخل سطح المكتب الشخصي على الويب فورًا.

---

الخيار 2: التثبيت كتطبيق (PWA)

للحصول على تجربة أقرب إلى التطبيق الأصلي، قم بتثبيت RoqueOS كتطبيق ويب تقدمي (PWA):

1. ادخل إلى roqueos.com.br في Chrome أو Edge أو Safari.
2. انقر على أيقونة التثبيت في شريط العناوين (أو في قائمة المتصفح).
3. اختر "تثبيت" أو "إضافة إلى الشاشة الرئيسية".

---

الخيار 3: التطبيقات الأصلية

قم بتنزيل RoqueOS مباشرة من متاجر التطبيقات للحصول على أفضل تجربة على كل منصة:

المنصة	الرابط
Windows	Microsoft Store
iOS / macOS	Apple App Store
Android	Google Play

---

التعرف على الواجهة

عند الدخول إلى RoqueOS لأول مرة، سترى:

العناصر الرئيسية

• سطح المكتب — منطقة العمل مع اختصارات قابلة للتخصيص
• شريط المهام — في الأسفل، مع التطبيقات المفتوحة والساعة
• Launchpad — شبكة جميع التطبيقات المتاحة
• Spotlight — البحث السريع (اختصار في أعلى الشاشة)

---

التطبيقات المضمنة

يأتي RoqueOS مع 48 تطبيقًا مدمجًا ومنظمًا حسب الفئة:

الفئة	التطبيقات
النظام	مدير الملفات، الإعدادات، Link Catalog
الوسائط	مشغل الموسيقى، مشغل الفيديو، الكاميرا، مسجل الصوت، عارض الصور، التقاط الشاشة
الإنتاجية	دردشة AI، الملاحظات اللاصقة، الآلة الحاسبة، محرر النصوص، عارض PDF، رمز QR، تطبيقات Google
التطوير	VS Code، طرفية Linux، حاويات Docker، Roque Code، Roqueman
الخادم	المتصفح البعيد، سطح المكتب البعيد
الترفيه	Games، KaRoque، Rubik 3D
الذكاء الاصطناعي	RoqueClaw (وكيل AI)

👉 راجع التوثيق الكامل للتطبيقات للحصول على أدلة مفصلة لكل واحد.

---

الاتصال بالخادم (وضع الاستضافة الذاتية)

تريد إطلاق العنان للإمكانات الكاملة — طرفية Linux حقيقية، VS Code مع امتدادات، أكثر من 155 تطبيق Docker جاهز، متصفح بعيد، وكيل RoqueClaw AI؟

🚀 هل تريد اختبار وضع الخادم دون تثبيت أي شيء؟

سجّل الدخول إلى /app، افتح الإعدادات → الخادم واختر خادم DEMO المُهيأ مسبقًا بالفعل. إنه خادم عام مشترك لاستكشاف Terminal، VS Code، Containers، Docker App Store. جيد لتقرر ما إذا كان يستحق تثبيت خادمك الخاص.

حدود الديمو: تتم إعادة تعيين البيانات كل ~24 ساعة تقريبًا، مشتركة بين جميع الزوار. للاستخدام الحقيقي، قم بتثبيت خادمك الخاص (التعليمات أدناه).

الخطوة 1: تشغيل الخادم

Linux / macOS (سطر واحد):

curl -fsSL https://roqueos.com.br/install.sh | bash

Windows (PowerShell):

irm https://roqueos.com.br/install.ps1 | iex

خلال ~2 دقيقة يعمل roqueos-server على http://localhost:27021. التفاصيل: مثبت Linux/macOS أو Windows.

☁️ هل تفضل عدم إدارة الخادم؟

RoqueOS Cloud هو الإصدار المُدار — نحن نعتني بالبنية التحتية والنسخ الاحتياطية التلقائية والدعم. الخطط تبدأ من R$ 59/شهر. الخادم متاح في ~3 دقائق بعد الدفع.

الخطوة 2: الاتصال عبر المعالج

في RoqueOS (/app):

1. الإعدادات → الخادم → إضافة خادم (زر "+" في الأعلى)
2. الصق عنوان URL للخادم (http://localhost:27021 إذا كان محليًا، أو https://your-tunnel.com.br إذا كان عامًا)
3. يكتشف المعالج تلقائيًا ما إذا كان الخادم يحتاج إلى إعداد أو تم تكوينه بالفعل
4. خادم جديد: ينشئ المعالج أول admin key لك — انسخها والصقها في 1Password
5. خادم مُكوّن بالفعل: الصق apiKey + apiSecret الموجودين
6. أعطه اسمًا ودودًا (مثل: "البيت"، "VPS Hetzner") → اتصال

تفاصيل التدفق الكامل: Add Server Wizard — بما في ذلك تحذير مهم حول HTTP مقابل HTTPS.

الخطوة 3: الاستمتاع

بعد الاتصال، تظهر Terminal و VS Code و App Store Docker و Remote Browser و Remote Desktop و RoqueClaw في Launchpad. كل شيء "plug and play".

---

الخطوات التالية

• مثبت Linux/macOS — سطر واحد مع --update، --with-roqueclaw، إلخ.
• مثبت Windows — مكافئ PowerShell
• App Store Docker — أكثر من 155 تطبيق جاهز لنقرة واحدة
• وكيل AI RoqueClaw — يثبت الحاويات عبر اللغة الطبيعية
• Cloud (مُدار) — إذا كنت تفضل عدم إدارة الخادم